CleanArchitecture

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

CleanArchitecture

★ 20,462 Open GitHub ↗

ASP.NET Core를 위한 클린 아키텍처 솔루션 템플릿

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Clean Architecture Solution Template

[![Build](https://github.com/jasontaylordev/CleanArchitecture/actions/workflows/build.yml/badge.svg)](https://github.com/jasontaylordev/CleanArchitecture/actions/workflows/build.yml)
[![CodeQL](https://github.com/jasontaylordev/CleanArchitecture/actions/workflows/codeql.yml/badge.svg)](https://github.com/jasontaylordev/CleanArchitecture/actions/workflows/codeql.yml)
[![Nuget](https://img.shields.io/nuget/v/Clean.Architecture.Solution.Template?label=NuGet)](https://www.nuget.org/packages/Clean.Architecture.Solution.Template)
[![Nuget](https://img.shields.io/nuget/dt/Clean.Architecture.Solution.Template?label=Downloads)](https://www.nuget.org/packages/Clean.Architecture.Solution.Template)
![Twitter Follow](https://img.shields.io/twitter/follow/jasontaylordev?label=Follow&style=social)

이 템플릿의 목표는 Clean Architecture와 ASP.NET Core의 강력한 기능을 활용하여 엔터프라이즈 애플리케이션 개발에 간단하고 효율적인 접근 방식을 제공하는 것입니다. 이 템플릿을 사용하면 ASP.NET Core 및 Aspire 기반의 Angular, React 또는 Web API 전용 새 앱을 손쉽게 만들 수 있습니다. 시작하는 방법은 간단합니다. **.NET template**을 설치하기만 하면 됩니다(자세한 내용은 아래 참조).

전체 문서를 보려면 **[cleanarchitecture.jasontaylor.dev](https://cleanarchitecture.jasontaylor.dev)**를 방문하세요.

이 프로젝트가 유용하다고 생각되신다면 별표(Star)를 눌러주세요. 감사합니다! ⭐

## 시작하기

### 사전 요구 사항

- [.NET 10.0 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) 이상
- [Node.js](https://nodejs.org/) (LTS) — Angular 또는 React 프론트엔드를 사용할 계획인 경우에만 필요합니다.
- [Docker Desktop](https://www.docker.com/products/docker-desktop/) 또는 [Podman](https://podman.io/) (또는 OCI 호환 컨테이너 런타임) — SQL Server 또는 PostgreSQL을 사용할 때만 필요합니다. SQLite(기본값)를 사용할 때는 필요하지 않습니다.

### 템플릿 설치

```bash
dotnet new install Clean.Architecture.Solution.Template
```

### 새 솔루션 생성

템플릿을 사용하여 새 솔루션을 만듭니다. `--client-framework` (`-cf`)을 사용하여 클라이언트 프레임워크를 지정하고, `--database` (`-db`)를 사용하여 데이터베이스 공급자를 지정합니다.

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

| 옵션 | 값 | 기본값 |
|---|---|---|
| `--client-framework` | `angular`, `react`, `none` | `angular` |
| `--database` | `postgresql`, `sqlite`, `sqlserver` | `sqlite` |

**예시:**

🅰️ ASP.NET Core Web API 및 PostgreSQL을 사용하는 Angular SPA:
```bash
dotnet new ca-sln -cf angular -db postgresql -o YourProjectName
```

⚛️ ASP.NET Core Web API 및 SQL Server를 사용하는 React SPA:
```bash
dotnet new ca-sln -cf react -db sqlserver -o YourProjectName
```

🔌 SQLite를 사용하는 ASP.NET Core Web API 전용:
```bash
dotnet new ca-sln -cf none -db sqlite -o YourProjectName
```

> 💡 **팁:** 사용 가능한 모든 템플릿 옵션을 보려면 `dotnet new ca-sln --help`를 실행하세요.

### 앱 실행

```bash
dotnet run --project .\src\AppHost
```

Aspire 대시보드가 자동으로 열리며 애플리케이션 URL과 로그가 표시됩니다.

자세한 내용을 알아보려면 [시작하기](https://cleanarchitecture.jasontaylor.dev/docs/getting-started/) 가이드와 [아키텍처](https://cleanarchitecture.jasontaylor.dev/docs/architecture/) 개요를 참조하세요.

## 기술 스택

* [ASP.NET Core 10](https://docs.microsoft.com/en-us/aspnet/core/introduction-to-aspnet-core)
* [Aspire](https://aspire.dev)
* [Entity Framework Core 10](https://docs.microsoft.com/en-us/ef/core/)
* [Angular 21](https://angular.dev/) 또는 [React 19](https://react.dev/)
* [MediatR](https://github.com/jbogard/MediatR)
* [AutoMapper](https://automapper.org/)
* [FluentValidation](https://fluentvalidation.net/)
* [NUnit](https://nunit.org/), [Shouldly](https://docs.shouldly.org/), [Moq](https://github.com/devlooped/moq) & [Respawn](https://github.com/jbogard/Respawn)
* [Scalar](https://scalar.com/)

## 버전

`main` 브랜치는 **.NET 10.0**을 사용합니다. 이전 버전도 사용할 수 있습니다:

| 버전 | 브랜치 |
|---|---|
| .NET 9.0 | [`net9.0`](https://github.com/jasontaylordev/CleanArchitecture/tree/net9.0) |
| .NET 8.0 | [`net8.0`](https://github.com/jasontaylordev/CleanArchitecture/tree/net8.0) |
| .NET 7.0 | [`net7.0`](https://github.com/jasontaylordev/CleanArchitecture/tree/net7.0) |
| .NET 6.0 | [`net6.0`](https://github.com/jasontaylordev/CleanArchitecture/tree/net6.0) |
| .NET 5.0 | [`net5.0`](https://github.com/jasontaylordev/CleanArchitecture/tree/net5.0) |
| .NET Core 3.1 | [`netcore3.1`](https://github.com/jasontaylordev/CleanArchitecture/tree/netcore3.1) |

## 아키텍처 결정

핵심 설계 결정은 [Architecture Decision Records](docs/decisions/)에 문서화되어 있습니다.

## 추가 정보

- 📖 [Clean Architecture Solution Template documentation](https://cleanarchitecture.jasontaylor.dev)

## 지원

문제가 발생하면 [새로운 이슈를 등록](https://github.com/jasontaylordev/CleanArchitecture/issues/new/choose)하여 알려주세요.

## 라이선스

이 프로젝트는 [MIT License](LICENSE)에 따라 라이선스가 부여됩니다.

CleanArchitecture

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

CleanArchitecture

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README