Repolode
fullstackhero

fullstackhero/dotnet-starter-kit

인증과 결제 등을 미리 구성한, 멀티테넌트 SaaS 앱 개발을 위한 프로덕션 수준의 .NET 10 모듈형 모놀리스 및 React 19 스타터 키트입니다.

스타
6,824
포크
2,003
열린 이슈
26
마지막 커밋
13일 전

어떤 프로젝트인가요?

FullStackHero는 vertical slice 방식으로 구축한 모듈형 모놀리스 백엔드와 React 19 프런트엔드 앱 두 개(운영자용 관리자 콘솔과 테넌트 대시보드)를 제공하는 .NET 10 스타터 키트입니다. Finbuckle 기반 멀티테넌시, JWT 및 ASP.NET Identity 인증, 결제, 감사 로깅, 웹훅, 파일 저장소, 채팅, 실시간 업데이트, Valkey 캐싱, Hangfire 백그라운드 작업, Scalar UI를 통한 OpenAPI, OpenTelemetry 관측 기능을 포함합니다. 모든 소스 코드는 패키지에 숨겨져 있지 않고 프로젝트에 포함되어 있습니다.

로컬에서는 .NET Aspire AppHost를 사용해 명령 하나로 API, React 앱 두 개, PostgreSQL, Valkey, RustFS를 실행할 수 있습니다. 배포 옵션으로는 프로덕션용 Docker Compose 스택과 AWS용 Terraform 정의가 제공됩니다. 아키텍처 테스트로 모듈 경계를 검증하며, 백엔드와 프런트엔드에는 단위 테스트, 통합 테스트, Playwright E2E 테스트 스위트가 포함되어 있습니다.

이 키트는 fsh CLI와 dotnet new 템플릿으로 배포되며, 구조화된 코드베이스를 바탕으로 맞춤화할 멀티테넌트 제품을 시작하려는 팀에 적합합니다.

핵심 기능

  • 01테넌트 확인 및 테넌트별 마이그레이션을 통한 멀티테넌트 격리
  • 02역할과 권한을 지원하는 JWT 및 ASP.NET Identity 인증
  • 03명령 하나로 실행하는 .NET Aspire 기반 로컬 풀스택 오케스트레이션
  • 04TanStack Query와 SignalR/SSE 실시간 업데이트를 사용하는 React 19 앱 두 개
  • 05Docker Compose 및 Terraform(AWS) 배포 구성
  • 06Scalar UI를 통한 OpenAPI 문서화 및 OpenTelemetry 관측 기능

활용 사례

  • 인증과 테넌시를 처음부터 구현하지 않고 .NET 기반 멀티테넌트 SaaS 제품 시작하기
  • 깔끔한 vertical slice 및 .NET 모듈형 모놀리스 구조 학습하기
  • .NET API와 함께 내부 관리자 콘솔 및 테넌트 앱 구성하기

빠른 시작

  1. 1

    NuGet에서 fsh CLI를 설치합니다

    dotnet tool install -g FullStackHero.CLI
  2. 2

    fsh 마법사로 새 프로젝트를 만듭니다

    fsh new MyApp
  3. 3

    프로젝트 폴더로 이동합니다

    cd MyApp
  4. 4

    Aspire AppHost를 통해 전체 스택을 실행합니다

    dotnet run --project src/Host/MyApp.AppHost

사용 전 알아둘 점

  • 로컬 Postgres, Valkey, RustFS 서비스를 사용하려면 Docker가 필요하며, React 앱에는 .NET 10 SDK와 Node 20 이상이 필요합니다.
  • 백엔드는 PostgreSQL을 사용하는 .NET 10 모듈러 모놀리스이므로 다른 스택을 원하는 팀에는 적합하지 않습니다.

토픽

자주 묻는 질문

dotnet-starter-kit은(는) 무엇인가요?
인증과 결제 등을 미리 구성한, 멀티테넌트 SaaS 앱 개발을 위한 프로덕션 수준의 .NET 10 모듈형 모놀리스 및 React 19 스타터 키트입니다. FullStackHero는 vertical slice 방식으로 구축한 모듈형 모놀리스 백엔드와 React 19 프런트엔드 앱 두 개(운영자용 관리자 콘솔과 테넌트 대시보드)를 제공하는 .NET 10 스타터 키트입니다. Finbuckle 기반 멀티테넌시, JWT 및 ASP.NET Identity 인증, 결제, 감사 로깅, 웹훅, 파일 저장소, 채팅, 실시간 업데이트, Valkey 캐싱, Hangfire 백그라운드 작업, Scalar UI를 통한 OpenAPI, OpenTelemetry 관측 기능을 포함합니다. 모든 소스 코드는 패키지에 숨겨져 있지 않고 프로젝트에 포함되어 있습니다.
dotnet-starter-kit은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
dotnet-starter-kit은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
dotnet-starter-kit은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. dotnet-starter-kit의 마지막 커밋은 2026년 10월 9일입니다.
dotnet-starter-kit은(는) 어디에 사용할 수 있나요?
인증과 테넌시를 처음부터 구현하지 않고 .NET 기반 멀티테넌트 SaaS 제품 시작하기 깔끔한 vertical slice 및 .NET 모듈형 모놀리스 구조 학습하기 .NET API와 함께 내부 관리자 콘솔 및 테넌트 앱 구성하기
dotnet-starter-kit는 어떻게 설치하나요?
NuGet에서 fsh CLI를 설치합니다: dotnet tool install -g FullStackHero.CLI fsh 마법사로 새 프로젝트를 만듭니다: fsh new MyApp 프로젝트 폴더로 이동합니다: cd MyApp Aspire AppHost를 통해 전체 스택을 실행합니다: dotnet run --project src/Host/MyApp.AppHost
dotnet-starter-kit은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/fullstackhero/dotnet-starter-kit

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트