인증과 결제 등을 미리 구성한, 멀티테넌트 SaaS 앱 개발을 위한 프로덕션 수준의 .NET 10 모듈형 모놀리스 및 React 19 스타터 키트입니다.
jasontaylordev/CleanArchitecture
Clean Architecture를 따르는 ASP.NET Core 앱을 Angular, React 또는 API 전용 옵션으로 생성하는 .NET 솔루션 템플릿입니다.
- 스타
- 20,651
- 포크
- 4,291
- 열린 이슈
- 9
- 마지막 커밋
- 12시간 전
어떤 프로젝트인가요?
이 템플릿은 도메인, 애플리케이션, 인프라, 웹 계층을 분리한 Clean Architecture 구조의 새 ASP.NET Core 솔루션을 생성합니다. dotnet CLI로 솔루션을 만들 때 클라이언트 프레임워크(Angular, React 또는 API 전용으로 클라이언트 없음)와 데이터베이스 공급자(SQLite 기본값, PostgreSQL, SQL Server)를 선택할 수 있습니다.
생성된 프로젝트는 데이터 액세스에 Entity Framework Core, 요청 처리에 MediatR, 매핑과 검증에 AutoMapper 및 FluentValidation, API 문서화에 Scalar를 사용합니다. 테스트는 NUnit, Shouldly, Moq, Respawn으로 구성됩니다. 로컬 개발 중에는 Aspire가 애플리케이션과 종속성을 오케스트레이션합니다.
이 템플릿은 NuGet 패키지로 배포되며 .NET 릴리스별로 버전이 관리됩니다. 이전 .NET 버전용 브랜치도 유지됩니다.
핵심 기능
- 01dotnet new를 통해 Angular, React 또는 API 전용 프런트엔드를 갖춘 솔루션을 생성합니다.
- 02데이터베이스 공급자로 SQLite, PostgreSQL, SQL Server를 지원합니다.
- 03코드를 도메인, 애플리케이션, 인프라, 웹 프로젝트로 계층화합니다.
- 04애플리케이션 로직에 MediatR, AutoMapper, FluentValidation을 포함합니다.
- 05로컬에서 Aspire로 실행하며, 대시보드에서 앱 URL과 로그를 확인할 수 있습니다.
- 06NUnit, Shouldly, Moq, Respawn을 사용하는 테스트 구성을 제공합니다.
활용 사례
- 처음부터 계층화된 구조가 필요한 엔터프라이즈 ASP.NET Core 프로젝트를 시작할 때.
- Angular 또는 React 단일 페이지 앱과 연동하는 Web API 백엔드를 만들 때.
- .NET 코드베이스에 Clean Architecture가 적용되는 방식을 학습할 때.
빠른 시작
- 1
.NET 템플릿을 설치합니다
dotnet new install Clean.Architecture.Solution.Template - 2
선택한 클라이언트 프레임워크와 데이터베이스로 새 솔루션을 만듭니다
dotnet new ca-sln --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName - 3
Aspire CLI로 앱을 실행합니다(권장)
aspire run
사용 전 알아둘 점
- .NET 10.0 SDK 이상이 필요합니다.
- SQL Server 또는 PostgreSQL을 사용하려면 Docker Desktop 또는 Podman이 필요합니다.
토픽
자주 묻는 질문
- CleanArchitecture은(는) 무엇인가요?
- Clean Architecture를 따르는 ASP.NET Core 앱을 Angular, React 또는 API 전용 옵션으로 생성하는 .NET 솔루션 템플릿입니다. 이 템플릿은 도메인, 애플리케이션, 인프라, 웹 계층을 분리한 Clean Architecture 구조의 새 ASP.NET Core 솔루션을 생성합니다. dotnet CLI로 솔루션을 만들 때 클라이언트 프레임워크(Angular, React 또는 API 전용으로 클라이언트 없음)와 데이터베이스 공급자(SQLite 기본값, PostgreSQL, SQL Server)를 선택할 수 있습니다.
- CleanArchitecture은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- CleanArchitecture은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- CleanArchitecture은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. CleanArchitecture의 마지막 커밋은 2026년 10월 21일입니다.
- CleanArchitecture은(는) 어디에 사용할 수 있나요?
- 처음부터 계층화된 구조가 필요한 엔터프라이즈 ASP.NET Core 프로젝트를 시작할 때. Angular 또는 React 단일 페이지 앱과 연동하는 Web API 백엔드를 만들 때. .NET 코드베이스에 Clean Architecture가 적용되는 방식을 학습할 때.
- 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를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
자체 호스팅이 가능한 기능 플래그 플랫폼으로, .NET, JavaScript, Python, Java, Go 등의 SDK와 A/B 실험을 제공합니다.
REST, gRPC, AMQP RPC, NATS RPC 전송 방식을 아우르는 Go 서비스용 Clean Architecture 프로젝트 템플릿입니다.
영화, TV 프로그램, 음악을 앱을 통해 기기로 스트리밍하는 무료 셀프 호스팅 미디어 서버 백엔드 및 API로, Plex와 Emby를 대체하는 오픈소스 프로젝트입니다.
C#과 XAML로 데스크톱, 모바일, 임베디드 및 WebAssembly 앱을 만드는 크로스 플랫폼 .NET UI 프레임워크입니다.
HTML을 PDF로 변환하는 대신, 타입이 명확한 fluent 코드로 PDF 문서를 생성하는 C# 라이브러리입니다.