base on Clean Architecture Solution Template for ASP.NET Core # Clean Architecture Solution Template [](https://github.com/jasontaylordev/CleanArchitecture/actions/workflows/build.yml) [](https://github.com/jasontaylordev/CleanArchitecture/actions/workflows/codeql.yml) [](https://www.nuget.org/packages/Clean.Architecture.Solution.Template) [](https://www.nuget.org/packages/Clean.Architecture.Solution.Template)  The goal of this template is to provide a straightforward and efficient approach to enterprise application development, leveraging the power of Clean Architecture and ASP.NET Core. Using this template, you can effortlessly create a Single Page App (SPA) with ASP.NET Core and Angular or React, while adhering to the principles of Clean Architecture. Getting started is easy - simply install the **.NET template** (see below for full details). If you find this project useful, please give it a star. Thanks! ⭐ ## Getting Started The following prerequisites are required to build and run the solution: - [.NET 10.0 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) (latest version) - [Node.js](https://nodejs.org/) (latest LTS, only required if you are using Angular or React) The easiest way to get started is to install the [.NET template](https://www.nuget.org/packages/Clean.Architecture.Solution.Template): ``` dotnet new install Clean.Architecture.Solution.Template ``` Once installed, create a new solution using the template. You can choose to use Angular, React, or create a Web API-only solution. Specify the client framework using the `-cf` or `--client-framework` option, and provide the output directory where your project will be created. Here are some examples: To create a Single-Page Application (SPA) with Angular and ASP.NET Core: ```bash dotnet new ca-sln --client-framework Angular --output YourProjectName ``` To create a SPA with React and ASP.NET Core: ```bash dotnet new ca-sln -cf React -o YourProjectName ``` To create a ASP.NET Core Web API-only solution: ```bash dotnet new ca-sln -cf None -o YourProjectName ``` Launch the app: ```bash cd src/Web dotnet run ``` To learn more, run the following command: ```bash dotnet new ca-sln --help ``` You can create use cases (commands or queries) by navigating to `./src/Application` and running `dotnet new ca-usecase`. Here are some examples: To create a new command: ```bash dotnet new ca-usecase --name CreateTodoList --feature-name TodoLists --usecase-type command --return-type int ``` To create a query: ```bash dotnet new ca-usecase -n GetTodos -fn TodoLists -ut query -rt TodosVm ``` To learn more, run the following command: ```bash dotnet new ca-usecase --help ``` ## Database The template supports [PostgreSQL](https://www.postgresql.org), [SQLite](https://www.sqlite.org/), and [SQL Server](https://learn.microsoft.com/en-us/sql/sql-server/what-is-sql-server) (default option). Specify the database to use with the `--database` option: ```bash dotnet new ca-sln --database [postgresql|sqlite|sqlserver] ``` On application startup, the database is automatically **deleted**, **recreated**, and **seeded** using `ApplicationDbContextInitialiser`. This is a practical strategy for early development, avoiding the overhead of maintaining migrations while keeping the schema and sample data in sync with the domain model. This process includes: - Deleting the existing database - Recreating the schema from the current model - Seeding default roles, users, and data For production environments, consider using EF Core migrations or migration bundles during deployment. For more information, see [Database Initialisation Strategies for EF Core](https://jasontaylor.dev/ef-core-database-initialisation-strategies). ## Deploy This template is structured to follow the Azure Developer CLI (azd). You can learn more about `azd` in the [official documentation](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli). To get started: ```bash # Log in to Azure azd auth login # Provision and deploy to Azure azd up ``` ## Technologies * [ASP.NET Core 9](https://docs.microsoft.com/en-us/aspnet/core/introduction-to-aspnet-core) * [Entity Framework Core 9](https://docs.microsoft.com/en-us/ef/core/) * [Angular 18](https://angular.dev/) or [React 18](https://react.dev/) * [MediatR](https://github.com/jbogard/MediatR) * [AutoMapper](https://automapper.org/) * [FluentValidation](https://fluentvalidation.net/) * [NUnit](https://nunit.org/), [Shoudly](https://docs.shouldly.org/), [Moq](https://github.com/devlooped/moq) & [Respawn](https://github.com/jbogard/Respawn) ## Versions The main branch is now on .NET 10.0. The following previous versions are available: * [9.0](https://github.com/jasontaylordev/CleanArchitecture/tree/net8.0) * [8.0](https://github.com/jasontaylordev/CleanArchitecture/tree/net8.0) * [7.0](https://github.com/jasontaylordev/CleanArchitecture/tree/net7.0) * [6.0](https://github.com/jasontaylordev/CleanArchitecture/tree/net6.0) * [5.0](https://github.com/jasontaylordev/CleanArchitecture/tree/net5.0) * [3.1](https://github.com/jasontaylordev/CleanArchitecture/tree/netcore3.1) ## Learn More * [Clean Architecture with ASP.NET Core 3.0 (GOTO 2019)](https://youtu.be/dK4Yb6-LxAk) * [Clean Architecture with .NET Core: Getting Started](https://jasontaylor.dev/clean-architecture-getting-started/) ## Support If you are having problems, please let me know by [raising a new issue](https://github.com/jasontaylordev/CleanArchitecture/issues/new/choose). ## License This project is licensed with the [MIT license](LICENSE). ", Assign "at most 3 tags" to the expected json: {"id":"1608","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"