Repolode
ardalis

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. 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 통계는 매일 갱신됩니다.

관련 프로젝트