CleanAspCoreWebApiTemplate

생산적인 ASP .NET 최소 API 템플릿

이것은 최소 API를 사용하여 ASP.NET을 사용하여 깨끗한 API를 구현할 수있는 방법을 보여주는 템플릿 저장소입니다. 이 템플릿의 '기능'에 중점을 둔 것은 Dev 생산성에 관한 것이며, API 자체의 실제 기능은 의도적으로 기본적으로 유지되었습니다. 이 저장소를 복사하거나 그 일부를 재사용하십시오. 그렇다면 별을주는 것을 잊지 마십시오.

이 템플릿의 일부 기능 :

• 수직 슬라이스 아키텍처 (기술 계층 대신 기능을 기반으로 그룹화)
• 사용하기 쉽고 빠르게 실행하는 통합 테스트 설정을 실행하기 몇 초 만에 실행되면 TestexamplesDotnet을 사용하는 유일한 종속성이 있습니다.
• JWT 토큰을 사용한 인증 및 승인. 테스트에서도 사용됩니다. 즉, 인증 및 승인이 테스트 내에서 제대로 작동하는지 확인할 수 있습니다.
• OpenTelemetry 준비
• DotNet Watch 용 LaunchProfile
• 코드 형식을 확인하고, 빌드 및 실행하는 GitHub 작업을 사용하여 자동 빌드.

실행 테스트

테스트를 실행하려면 Docker만이 필요합니다 (팁 : Podman은 자유롭게 사용할 수 있습니다). Docker 이미지가 다운로드 될 때 첫 번째 실행은 조금 더 오래 걸릴 수 있습니다. 테스트를 실행하려면 다음 명령을 실행하십시오.

dotnet test

앱 실행

1. 먼저 로컬 테스트에 사용할 수있는 JWT를 생성하십시오.

dotnet user-jwts create --role " read " --role " write "

참고 : 작업 및 부서 엔드 포인트에는 인증 만 필요하지만 직원 엔드 포인트에는 JWT 토큰에 올바른 청구가 있어야합니다.

2. 제공된 docker-compose.yaml을 사용하여 데이터베이스를 실행하십시오. 선택적으로 OpenTelemetry 출력을 쉽게 볼 수 있도록 Compose 파일에서 Aspire 대시 보드를 실행하십시오.
3. 앱을 실행하십시오. https://localhost:7162/swagger 에서 swagger를 사용하여 엔드 포인트를 탐색 할 수 있습니다.