安装

确保你已完成环境准备。

选择哪种方式？

方式 1 — 克隆仓库

获取完整源代码，保留原始 BitzOrcas.Modern 项目名：

git clone <仓库地址> MyApp
cd MyApp
dotnet restore BitzOrcas.Modern.slnx
dotnet run --project src/Hosts/BitzOrcas.AppHost

这是阅读代码、贡献或按原样运行模板的路径。

方式 2 — dotnet new 模板（推荐新项目）

从模板包脚手架一个全新的、已重命名的项目：

dotnet new install BitzOrcas.Modern.Templates
dotnet new bitzorcas-modern -n MyApp
cd MyApp
dotnet restore MyApp.slnx
dotnet run --project src/Hosts/MyApp.AppHost

模板生成完整的解决方案结构，你的项目名称将应用到所有宿主、基础框架和模块命名空间。

验证是否正常运行

无论你通过哪种方式安装，启动项目：

dotnet run --project src/Hosts/<YourProject>.AppHost

Aspire 在容器中启动 SQL Server 和 RabbitMQ，自动配置连接串并启动 API。一切就绪后，API + Scalar 文档可在 https://localhost:7132/scalar 访问（具体端口以你的 launchSettings 为准）。

初始化数据库 schema 和种子数据：

dotnet run --project src/Hosts/<YourProject>.Api -- --seed-demo

这会创建所有表、审计分表，并填充 14 个平台种子表（租户、角色、权限、语言、国家/地区、通用代码等）。

下一步

• 快速开始 — 最简的克隆与运行指南。
• 演示数据参考 — 已种子的平台数据和可登录账号。
• 架构 — 模块化单体 + 垂直切片思维模型。