팀과 AI 에이전트가 도메인, 서비스, 이벤트, 메시지, 스키마를 카탈로그로 정리하는 소프트웨어 아키텍처 문서화 도구입니다.
ardalis/CleanArchitecture
Core, Use Cases, Infrastructure, Web 프로젝트를 분리한 ASP.NET Core용 Clean Architecture 솔루션 템플릿입니다.
- 스타
- 18,527
- 포크
- 3,142
- 열린 이슈
- 45
- 마지막 커밋
- 지난달
어떤 프로젝트인가요?
이 프로젝트는 의존성을 역전하는 스타일로, 헥사고날 아키텍처 또는 어니언 아키텍처라고도 불리는 Clean Architecture를 적용해 ASP.NET Core 애플리케이션을 구축하기 위한 시작점이 되는 솔루션 템플릿입니다. dotnet CLI 템플릿으로 배포되며, 전체 버전(clean-arch)과 최소 버전(min-clean)을 제공해 개발자가 각 계층을 직접 연결하지 않고도 새 솔루션을 생성할 수 있습니다.
솔루션은 Core(도메인 엔터티, 도메인 이벤트, 인터페이스), 애플리케이션 로직을 담당하는 Use Cases 계층, 데이터 액세스 및 외부 서비스를 위한 Infrastructure 프로젝트, HTTP 요청을 처리하는 Web 프로젝트로 나뉩니다. 테스트 프로젝트도 포함되어 있으며, 메인 브랜치의 템플릿은 .NET 9을 대상으로 합니다. 웹 계층에는 Ardalis.ApiEndpoints, 컨트롤러 또는 Razor Pages를 선택할 수 있습니다.
이 저장소는 Steve Smith가 관리하며, 저자의 Clean Architecture 및 DDD 강좌에서 참조 구현으로 사용됩니다.
핵심 기능
- 01전체 버전(clean-arch)과 최소 버전(min-clean)으로 구성된 dotnet CLI 템플릿을 제공합니다.
- 02도메인 코어, 유스케이스, 인프라, 웹을 각각 별도의 프로젝트로 분리합니다.
- 03솔루션에 도메인 이벤트와 테스트 프로젝트를 포함합니다.
- 04웹 계층에서 ApiEndpoints, 컨트롤러 또는 Razor Pages를 사용할 수 있습니다.
활용 사례
- 장기적인 유지보수성이 필요한 새 ASP.NET Core 백엔드를 시작할 때 사용합니다.
- Clean Architecture와 DDD를 활용해 .NET 애플리케이션을 구성하는 방법을 학습할 때 사용합니다.
- 팀 내부 프로젝트 템플릿의 기반으로 참조용 구조를 사용할 때 적합합니다.
빠른 시작
- 1
공식 문서의 시작하기 단계를 확인하세요
사용 전 알아둘 점
- main 브랜치는 .NET 9을 대상으로 합니다.
- 사이트는 HTTPS를 사용하며 localhost용 자체 서명 개발자 인증서가 필요합니다.
토픽
자주 묻는 질문
- CleanArchitecture은(는) 무엇인가요?
- Core, Use Cases, Infrastructure, Web 프로젝트를 분리한 ASP.NET Core용 Clean Architecture 솔루션 템플릿입니다. 이 프로젝트는 의존성을 역전하는 스타일로, 헥사고날 아키텍처 또는 어니언 아키텍처라고도 불리는 Clean Architecture를 적용해 ASP.NET Core 애플리케이션을 구축하기 위한 시작점이 되는 솔루션 템플릿입니다. dotnet CLI 템플릿으로 배포되며, 전체 버전(clean-arch)과 최소 버전(min-clean)을 제공해 개발자가 각 계층을 직접 연결하지 않고도 새 솔루션을 생성할 수 있습니다.
- CleanArchitecture은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- CleanArchitecture은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- CleanArchitecture은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. CleanArchitecture의 마지막 커밋은 2026년 9월 21일입니다.
- CleanArchitecture은(는) 어디에 사용할 수 있나요?
- 장기적인 유지보수성이 필요한 새 ASP.NET Core 백엔드를 시작할 때 사용합니다. Clean Architecture와 DDD를 활용해 .NET 애플리케이션을 구성하는 방법을 학습할 때 사용합니다. 팀 내부 프로젝트 템플릿의 기반으로 참조용 구조를 사용할 때 적합합니다.
- CleanArchitecture는 어떻게 설치하나요?
- 공식 문서의 시작하기 단계를 확인하세요
- CleanArchitecture은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ardalis/CleanArchitecture
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Clean Architecture를 따르는 ASP.NET Core 앱을 Angular, React 또는 API 전용 옵션으로 생성하는 .NET 솔루션 템플릿입니다.
.NET에서 배포 환경에 맞게 사용자 지정할 수 있는 고성능 HTTP 리버스 프록시 서버를 구축하기 위한 툴킷입니다.
Immich 서버의 사진을 슬라이드쇼로 보여주는 셀프 호스팅 디지털 액자 앱입니다.
가족과 친구 몇 명을 위해 설계된 셀프 호스팅 미디어 서버
인증과 결제 등을 미리 구성한, 멀티테넌트 SaaS 앱 개발을 위한 프로덕션 수준의 .NET 10 모듈형 모놀리스 및 React 19 스타터 키트입니다.