Matech.Clean.Architecture.Template
1.1.5
dotnet new install Matech.Clean.Architecture.Template::1.1.5
Clean Architecture Template
This is a solution template for creating a ASP.NET Core Web API following the principles of Clean Architecture. Create a new project based on this template by clicking the above Use this template button or by installing and running the associated NuGet package (see Getting Started for full details).
Technologies
- ASP.NET Core 6
- Entity Framework Core 6
- MediatR
- Mapster
- FluentValidation
- NUnit, FluentAssertions, Moq & Respawn
- Elasticsearch, Serilog, Kibana
- Docker
Getting Started
Install the NuGet package and run dotnet new cas
:
- Install the latest .NET SDK
- Run
dotnet new --install Matech.Clean.Architecture.Template
to install the project template - Create a folder for your solution and cd into it (the template will use it as project name)
- Run
dotnet new cas
to create a new project - Navigate to
src/Apps/CleanArchitecture.Api
and rundotnet run
to launch the back end (ASP.NET Core Web API) - Open web browser https://localhost:5021/api Swagger UI
Database Configuration
The template is configured to use an in-memory database by default. This ensures that all users will be able to run the solution without needing to set up additional infrastructure (e.g. SQL Server).
If you would like to use SQL Server, you will need to update WebApi/appsettings.json as follows:
"DbProvider": SqlServer
DbProvider
could be Sqlite
, SqlServer
, Npgsql
by default, which could be extended to more database providers that EF Core supports.
Verify that the DefaultConnection connection string within appsettings.json points to a valid SQL Server instance.
Verify that the DefaultConnection_Postgres connection string within appsettings.json points to a valid PostgresSQL instance.
Verify that the DefaultConnection_Sqlite connection string within appsettings.json points to a valid Sqlite connection or in-memory instance.
When you run the application the database will be automatically created (if necessary) and the latest migrations will be applied.
Database Migrations
By moving to multiple databases migrations, every db provider will have one migrations project as below.
Sqlite
: CleanArchitecture.Infrastructure.SqliteSqlServer
: CleanArchitecture.Infrastructure.SqlServerNpgsql
: CleanArchitecture.Infrastructure.Npgsql
Multiple databases migrations
To use dotnet-ef
for your migrations please add the following flags to your command (values assume you are executing from repository root)
--project src/Common/CleanArchitecture.Infrastructure.{DbProvider}
--startup-project src/Apps/CleanArchitecture.Api
For example, to add a new migration from the root folder:
set "DbProvider"
in appsettings.json of Api project to Sqlite
:
dotnet ef migrations add "CreateDb" --project src\Common\CleanArchitecture.Infrastructure.Sqlite --startup-project src\Apps\CleanArchitecture.Api
dotnet ef database update --project src\Common\CleanArchitecture.Infrastructure.Sqlite --startup-project src\Apps\WebApi
set "DbProvider"
in appsettings.json of Api project to SqlServer
:
dotnet ef migrations add "CreateDb" --project src\Common\CleanArchitecture.Infrastructure.SqlServe --startup-project src\Apps\CleanArchitecture.Api
dotnet ef database update --project src\Common\CleanArchitecture.Infrastructure.SqlServer --startup-project src\Apps\WebApi
set "DbProvider"
in appsettings.json of Api project to Npgsql
:
dotnet ef migrations add "CreateDb" --project src\Common\CleanArchitecture.Infrastructure.Npgsql --startup-project src\Apps\CleanArchitecture.Api
dotnet ef database update --project src\Common\CleanArchitecture.Infrastructure.Npgsql --startup-project src\Apps\WebApi
Overview
Domain
This will contain all entities, enums, exceptions, interfaces, types and logic specific to the domain layer.
Application
This layer contains all application logic. It is dependent on the domain layer, but has no dependencies on any other layer or project. This layer defines interfaces that are implemented by outside layers. For example, if the application need to access a notification service, a new interface would be added to application and an implementation would be created within infrastructure.
Infrastructure
This layer contains classes for accessing external resources such as file systems, web services, smtp, and so on. These classes should be based on interfaces defined within the application layer.
WebApi
This layer is a web api application based on ASP.NET 6.0.x. This layer depends on both the Application and Infrastructure layers, however, the dependency on Infrastructure is only to support dependency injection. Therefore only Startup.cs should reference Infrastructure.
Logs
Logging into Elasticsearch using Serilog and viewing logs in Kibana.
Prerequisites
- Download and Install Docker Desktop
Open CLI in the project folder and run the below comment.
PS CleanArchitecture> docker-compose up
docker-compose.yml
pull and run the ElasticSearch and Kibana images.
If you are running first time Windows 10 WSL 2 (Windows Subsystem for Linux) Linux Container for Docker, You will probably get the following error from the docker.
Error:
max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]
Solution:
Open the Linux WSL 2 terminal sudo sysctl -w vm.max_map_count=262144
and change the virtual memory for Linux.
Support
If you are having problems, please let us know by raising a new issue.
License
This project is licensed with the MIT license.
This package has no dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.1.5 | 2,052 | 9/26/2022 |
1.1.4 | 764 | 11/10/2021 |
1.1.3 | 461 | 10/8/2021 |
1.1.2 | 2,546 | 6/11/2021 |
1.1.1 | 596 | 3/13/2021 |
1.0.9 | 399 | 2/18/2021 |
1.0.8 | 616 | 12/21/2020 |
1.0.7 | 517 | 11/24/2020 |
1.0.6 | 492 | 11/11/2020 |
1.0.5 | 510 | 10/23/2020 |
1.0.4 | 556 | 10/16/2020 |
1.0.3 | 525 | 10/9/2020 |
1.0.2 | 522 | 10/9/2020 |
1.0.1 | 422 | 10/9/2020 |
1.0.0 | 456 | 9/30/2020 |
0.1.0 | 490 | 9/16/2020 |
0.0.8 | 509 | 9/16/2020 |
0.0.7 | 482 | 9/16/2020 |
0.0.6 | 464 | 9/16/2020 |