18.5K ·GitHub
Что это такое?
Шаблон решения для ASP.NET Core, который даёт вам проверенную отправную точку в стиле Clean Architecture — слабо связанную структуру проекта с инверсией зависимостей, известную также как гексагональная архитектура, порты и адаптеры или «луковая» архитектура.
Шаблон решения для ASP.NET Core, который даёт вам проверенную отправную точку в стиле Clean Architecture — слабо связанную структуру проекта с инверсией зависимостей, известную также как гексагональная архитектура, порты и адаптеры или «луковая» архитектура.Это фреймворк или библиотека, которую я добавляю в свой проект?Ни то ни другое — это шаблон проекта для dotnet CLI. После установки он разворачивает готовое решение на ASP.NET Core (проекты Core, Use Cases, Infrastructure и Web плюс тестовые проекты), внутри которого вы затем строите своё приложение.
Ни то ни другое — это шаблон проекта для dotnet CLI. После установки он разворачивает готовое решение на ASP.NET Core (проекты Core, Use Cases, Infrastructure и Web плюс тестовые проекты), внутри которого вы затем строите своё приложение.Как начать с ним проект?Установите шаблон через dotnet CLI (dotnet new install Ardalis.CleanArchitecture.Template), затем создайте решение командой dotnet new clean-arch для полной версии или dotnet new min-clean для минимальной. Дальнейшие шаги описаны в разделе Getting Started официальной документации.
Установите шаблон через dotnet CLI (dotnet new install Ardalis.CleanArchitecture.Template), затем создайте решение командой dotnet new clean-arch для полной версии или dotnet new min-clean для минимальной. Дальнейшие шаги описаны в разделе Getting Started официальной документации.Нужна ли заранее установленная конкретная версия .NET?Да — .NET SDK. В README сказано, что основная ветка теперь использует .NET 9, что соответствует версии пакетов на NuGet 10.x, а для более старых окружений доступны прежние релизы шаблона.
Да — .NET SDK. В README сказано, что основная ветка теперь использует .NET 9, что соответствует версии пакетов на NuGet 10.x, а для более старых окружений доступны прежние релизы шаблона.Есть ли подводные камни при настройке?Сгенерированный сайт работает по HTTPS и ожидает самоподписанный сертификат разработчика для localhost — из-за этого в Chrome могут появляться ошибки; в README есть ссылка на инструкции, как это обойти.
Сгенерированный сайт работает по HTTPS и ожидает самоподписанный сертификат разработчика для localhost — из-за этого в Chrome могут появляться ошибки; в README есть ссылка на инструкции, как это обойти.Это привязывает меня к Windows и Visual Studio?Нет — всё делается через кроссплатформенный dotnet CLI, а CI в репозитории собирает и тестирует проект на разных платформах, так что Linux и macOS тоже подходят.
Нет — всё делается через кроссплатформенный dotnet CLI, а CI в репозитории собирает и тестирует проект на разных платформах, так что Linux и macOS тоже подходят.Чем полный шаблон отличается от минимального?clean-arch — это полное решение со всеми проектами и паттернами на месте, а min-clean — облегчённый вариант, где меньше шаблонного кода на удаление. Раздел Template Comparison в README (Which Template Should I Use?) поможет выбрать.
clean-arch — это полное решение со всеми проектами и паттернами на месте, а min-clean — облегчённый вариант, где меньше шаблонного кода на удаление. Раздел Template Comparison в README (Which Template Should I Use?) поможет выбрать.Меня заставят использовать minimal APIs, или можно взять Controllers и Razor Pages?Шаблон делает ставку на API-эндпоинты через пакет Ardalis.ApiEndpoints, но в README описано, как добавить Controllers или Razor Pages, если вы предпочитаете один из этих вариантов.
Шаблон делает ставку на API-эндпоинты через пакет Ardalis.ApiEndpoints, но в README описано, как добавить Controllers или Razor Pages, если вы предпочитаете один из этих вариантов.Шаблон заточен под domain-driven design?Скорее да: Domain Events входят в число документированных паттернов, и та же архитектура лежит в основе курса NimblePros' DDD Fundamentals от Стива Смита и Джули Лерман. Сама же Clean Architecture — это более широкая идея слабой связанности, а не конкретно DDD.
Скорее да: Domain Events входят в число документированных паттернов, и та же архитектура лежит в основе курса NimblePros' DDD Fundamentals от Стива Смита и Джули Лерман. Сама же Clean Architecture — это более широкая идея слабой связанности, а не конкретно DDD.У меня старая версия шаблона — обновление будет болезненным?Не особо: на официальном сайте документации есть Migration Guides для перехода между версиями, а README просит обновляющихся сначала с ними ознакомиться.
Не особо: на официальном сайте документации есть Migration Guides для перехода между версиями, а README просит обновляющихся сначала с ними ознакомиться.What are similar projects?aspnetboilerplate, modular-monolith-with-ddd, eShopOnWeb, CleanArchitecture, AspNetCore-Developer-Roadmap, domain-driven-hexagon, practical-aspnetcore, COLA
aspnetboilerplate, modular-monolith-with-ddd, eShopOnWeb, CleanArchitecture, AspNetCore-Developer-Roadmap, domain-driven-hexagon, practical-aspnetcore, COLAWhich topics is it in?domain-driven-design, asp-net-core, entity-framework, aspnet-core, ddd, clean-architecture, unit-testing, template, architecture, best-practices, dotnet, c#
domain-driven-design, asp-net-core, entity-framework, aspnet-core, ddd, clean-architecture, unit-testing, template, architecture, best-practices, dotnet, c#