Repolode
fullstackhero

fullstackhero/dotnet-starter-kit

面向多租户 SaaS 的 .NET 10 模块化单体与 React 19 启动套件,内置身份认证、租户隔离、计费等模块。

Star
6,824
Fork
2,003
未关闭 Issue
26
最近提交
13天前

这是什么?

FullStackHero 是一套 .NET 10 启动套件,后端采用垂直切片的模块化单体架构,前端包含两个 React 19 应用:运营管理后台和租户应用。项目集成了基于 Finbuckle 的多租户、JWT 与 ASP.NET Identity 认证、计费、审计、Webhook、文件存储、聊天、实时通信、基于 Valkey 的缓存、Hangfire 后台任务,以及 OpenAPI(Scalar 文档界面)和 OpenTelemetry 可观测性。所有源码直接包含在项目中,没有隐藏在依赖包里。

本地开发时,.NET Aspire 的 AppHost 可通过一条命令启动 API、两个 React 应用、PostgreSQL、Valkey 和 RustFS。部署方面提供 Docker Compose 生产环境配置和面向 AWS 的 Terraform 脚本。架构测试用于约束模块边界,后端与前端都包含单元测试、集成测试及 Playwright 端到端测试。

项目可通过 fsh CLI 或 dotnet new 模板获取,适合需要开发多租户产品、希望基于结构清晰的代码进行定制的团队。

核心功能

  • 01基于 Finbuckle 的租户解析、隔离与按租户迁移
  • 02JWT 与 ASP.NET Identity 认证,支持角色与权限
  • 03通过 .NET Aspire 一条命令启动完整本地环境
  • 04两个 React 19 应用,结合 TanStack Query 与 SignalR/SSE 实时更新
  • 05提供 Docker Compose 与 AWS Terraform 部署配置
  • 06OpenAPI 文档(Scalar 界面)与 OpenTelemetry 可观测性

适用场景

  • 在 .NET 上启动多租户 SaaS 产品,省去从零搭建认证与租户体系的工作
  • 学习 .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

使用前须知

  • 本地运行需要 Docker(用于 Postgres、Valkey 和 RustFS),前端 React 应用还需要 .NET 10 SDK 和 Node 20+。
  • 后端是基于 .NET 10 和 PostgreSQL 的模块化单体,不适合希望使用其他技术栈的团队。

标签

常见问题

dotnet-starter-kit 是什么?
面向多租户 SaaS 的 .NET 10 模块化单体与 React 19 启动套件,内置身份认证、租户隔离、计费等模块。 FullStackHero 是一套 .NET 10 启动套件,后端采用垂直切片的模块化单体架构,前端包含两个 React 19 应用:运营管理后台和租户应用。项目集成了基于 Finbuckle 的多租户、JWT 与 ASP.NET Identity 认证、计费、审计、Webhook、文件存储、聊天、实时通信、基于 Valkey 的缓存、Hangfire 后台任务,以及 OpenAPI(Scalar 文档界面)和 OpenTelemetry 可观测性。所有源码直接包含在项目中,没有隐藏在依赖包里。
dotnet-starter-kit 可以免费使用吗?用的什么许可证?
dotnet-starter-kit 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
dotnet-starter-kit 还在维护吗?
活跃维护中。dotnet-starter-kit 最近一次提交是在 2026年10月9日。
dotnet-starter-kit 适合用来做什么?
在 .NET 上启动多租户 SaaS 产品,省去从零搭建认证与租户体系的工作 学习 .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

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目