Skip to content

Latest commit

 

History

History
100 lines (75 loc) · 4.02 KB

readme.md

File metadata and controls

100 lines (75 loc) · 4.02 KB
Raw

Caju Caju: .NET apps with awesome architectures!

Service Template to help you build evolvable and maintainable applications. It follows the principles from the Clean Architecture book and built on Domain-Driven Design. This tool increases productivity on developing your next microservices.

dotnet new caju

Generate your own awesome Back-end!

NuGet Build Status Gitter

To generate your own awesome .NET Back-end simple run:

dotnet new -i Paulovich.Caju::0.6.0
dotnet new clean

The Architecture Styles

We prevent our software to be coupled from technology details like User Interface, Data Access frameworks, Service Bus or Web Servers. And there are some concepts that guided us:

  • Allow an application to equally be driven by users, programs, automated test or batch scripts, and to be developed and tested in isolation from its eventual run-time devices and databases.
  • The SOLID principles are all over the the solution.
  • The software implementation is agnostic from technology, framework, or database. The result is focus on the use cases with input/output ports.
  • Designed around the Business Domain, having Continous Delivery and Independent Deployment.

Sample applications

Run dotnet new -i Paulovich.Caju then try the following commands.

Clean Architecture Solution with basic use cases:

dotnet new clean --use-cases basic

Hexagonal Architecture Solution with all use cases:

dotnet new hexagonal --use-cases full

Empty Event-Sourcing Solution:

dotnet new eventsourcing --use-cases empty

For olher solution types check out the Caju Samples folder.

Switches

There are switches to generate your awesome application with your needs. Try after dotnet new clean or dotnet new hexagonal or dotnet new eventsourcing:

  • --use-cases full basic readonly none
  • --user-interface webapi none
  • --data-access mongo entityframework dapper none
  • --service-bus kafka none
  • --tips true false
  • --skip-restore true false

Use the switch --help for the complete list of options.

Roadmap

  • Allow to choose the architecture style
  • Allow to choose the built-in use cases sets
    • Full set of use cases ✅
    • Basic set of use cases ✅
    • Read Only ✅
    • None ✅
  • Allow to choose the data access frameworks
    • MongoDB ✅
    • Dapper ✅
    • Entity Framework Core ✅
    • Azure Cosmos DB
    • NHibernate Core
    • None ✅
  • Allow to choose the UI frameworks
    • Both
    • WebAPI ✅
    • Console
    • None ✅
  • Allow to choose the Service Bus frameworks
    • Kafka ✅
    • Azure Event Bus
    • None ✅
  • Allow to skip the dotnet restore after code generation ✅
  • Allow to include or to remove the architecture tips ✅

Common Issues

Check your .NET Core SDK. Our features are only supported in 2.1.4 SDK or plus.

$ dotnet --version
2.1.4