Repolode
jasontaylordev

jasontaylordev/CleanArchitecture

Шаблон решения .NET для создания приложения ASP.NET Core на основе Clean Architecture с Angular, React или только API.

Звёзды
20,651
Форки
4,291
Открытые issues
9
Последний коммит
12 часов назад

Что это?

Шаблон создаёт новое решение ASP.NET Core на основе Clean Architecture, разделяя его на слои домена, приложения, инфраструктуры и веб-интерфейса. При создании решения через dotnet CLI можно выбрать клиентский фреймворк (Angular, React или без него — только API) и провайдера базы данных (по умолчанию SQLite, а также PostgreSQL и SQL Server).

В сгенерированном проекте для доступа к данным используется Entity Framework Core, для обработки запросов — MediatR, для маппинга и валидации — AutoMapper и FluentValidation, а для документации API — Scalar. Тесты настроены с NUnit, Shouldly, Moq и Respawn. Во время локальной разработки Aspire управляет приложением и его зависимостями.

Шаблон распространяется как пакет NuGet и версионируется в соответствии с релизами .NET; для предыдущих версий сохраняются отдельные ветки.

Ключевые возможности

  • 01Создаёт решения с фронтендом на Angular или React либо только с API с помощью dotnet new.
  • 02Поддерживает SQLite, PostgreSQL и SQL Server в качестве провайдеров баз данных.
  • 03Разделяет код на проекты домена, приложения, инфраструктуры и веб-интерфейса.
  • 04Включает MediatR, AutoMapper и FluentValidation для реализации логики приложения.
  • 05Запускает приложение локально через Aspire; в дашборде отображаются URL и логи приложения.
  • 06В комплекте есть настройки тестирования с NUnit, Shouldly, Moq и Respawn.

Сценарии использования

  • Создание нового корпоративного проекта ASP.NET Core, которому с самого начала нужна слоистая архитектура.
  • Разработка бэкенда Web API в связке с одностраничным приложением на Angular или React.
  • Изучение применения Clean Architecture в кодовой базе на .NET.

Быстрый старт

  1. 1

    Установите шаблон .NET

    dotnet new install Clean.Architecture.Solution.Template
  2. 2

    Создайте новое решение с выбранным клиентским фреймворком и базой данных

    dotnet new ca-sln --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName
  3. 3

    Запустите приложение с помощью Aspire CLI (рекомендуется)

    aspire run

Что важно знать

  • Требуется .NET 10.0 SDK или более поздней версии.
  • Для использования SQL Server или PostgreSQL необходим Docker Desktop или Podman.

Темы

Частые вопросы

Что такое CleanArchitecture?
Шаблон решения .NET для создания приложения ASP.NET Core на основе Clean Architecture с Angular, React или только API. Шаблон создаёт новое решение ASP.NET Core на основе Clean Architecture, разделяя его на слои домена, приложения, инфраструктуры и веб-интерфейса. При создании решения через dotnet CLI можно выбрать клиентский фреймворк (Angular, React или без него — только API) и провайдера базы данных (по умолчанию SQLite, а также PostgreSQL и SQL Server).
CleanArchitecture можно использовать бесплатно? Какая у него лицензия?
CleanArchitecture распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
CleanArchitecture всё ещё поддерживается?
Активно поддерживается. Последний коммит в CleanArchitecture — 21 окт. 2026 г..
Для чего можно использовать CleanArchitecture?
Создание нового корпоративного проекта ASP.NET Core, которому с самого начала нужна слоистая архитектура. Разработка бэкенда Web API в связке с одностраничным приложением на Angular или React. Изучение применения Clean Architecture в кодовой базе на .NET.
Как установить CleanArchitecture?
Установите шаблон .NET: dotnet new install Clean.Architecture.Solution.Template Создайте новое решение с выбранным клиентским фреймворком и базой данных: dotnet new ca-sln --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName Запустите приложение с помощью Aspire CLI (рекомендуется): aspire run
Где скачать CleanArchitecture?
Исходный код и инструкции по установке — на GitHub: https://github.com/jasontaylordev/CleanArchitecture

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты