许多企业级框架在入门文档设计上存在严重的“断层”:要么只给出几条毫无解释的 docker run 命令,导致开发者把 Demo 跑起来后依然对架构运转机制一无所知;要么陷入冗长的理论宣讲,让工程师在数十页的概念泥潭中丧失耐心。
BitzOrcas.Modern 采用“心智模型先行、流水线渐进落地”的布道体系。本章旨在引导架构师与核心研发人员在最短时间内建立起对 .NET 10 模块化单体的端到端掌控力:从底层的物理依赖隔离,到中层的 10 级应用执行管道,再到顶层的多租户垂直切片实战。
快速上手工程演进路线
从代码拉取到生产级多租户用例验证,标准开发生命周期划分为以下 5 个关键阶段:
模块篇章结构与导航
为确保在真实团队协作中不遗漏关键工程约束,建议按以下逻辑顺序阅读并实践:
-
认识 BitzOrcas.Modern
深入理解为何选择模块化单体与垂直切片架构,解构请求穿越 10 级治理管道的端到端时序,掌握跨模块协作的 5 条物理红线。 -
开发环境与前置依赖
核对 .NET 10 SDK、Node.js 22、Docker 容器引擎与 IDE 插件配置,建立符合 Native AOT 约束的本地编译工具链。 -
代码安装与本地配置
克隆仓库、通过 Docker Compose 启动按摘要锁定的容器基础设施(SQL Server 2022、Redis 7、RabbitMQ),执行--init-schema完成开箱建库与种子初始化。 -
5 分钟极速起飞
启动后端 Minimal API 宿主,获取 RSA-OAEP 公钥并执行端到端登录,发起首个受 10 级管道治理的业务切片请求。 -
预置演示账号与口令注入契约
掌握生产级“Fail-Closed 口令注入契约”,剖析特权超管与租户演示账号的生命周期,验证多租户资源防探测机制(404 代替 403)。 -
常见问题与排错手册
汇总端口占用、开发证书信任、Source Generator 增量编译缓存清理等高频阻塞点的秒级自愈方案。
本章快速索引
- 01/06
认识 BitzOrcas.Modern:设计哲学、架构拓扑与执行管道
深入解析 BitzOrcas.Modern 企业级架构全景:从单体与微服务的权衡痛点出发,掌握垂直切片、10 级应用执行管道、双 ORM 编译期生成与跨模块契约协作边界。
- 02/06
开发环境与前置依赖:跨平台工具链安装与验证
跨平台开发环境标准化搭建:.NET 10 SDK、C# 14 与 Native AOT 编译工具链、Node.js 22 LTS、Corepack (Yarn 4)、Docker 容器引擎与 IDE 生产力套件配置。
- 03/06
代码安装与本地配置:容器基础设施与数据库初始化
掌握 BitzOrcas.Modern 本地工程环境初始化:从镜像摘要锁定的 Docker Compose 基础设施拉起,到环境变量分层注入与 --init-schema 幂等建库与种子填充。
- 04/06
5 分钟极速起飞:Aspire 编排启动、数据持久化与首个认证请求
掌握 BitzOrcas.Modern 开发起飞流程:使用 .NET Aspire AppHost 一键编排拉起全套微服务拓扑、配置数据卷持久化与受控重置、并通过 RSA-OAEP 加密端点完成首个认证登录请求。
- 05/06
预置演示账号与口令注入契约:零信任种子与多租户隔离
深度解构 BitzOrcas.Modern 预置种子账号体系:Fail-Closed 环境变量口令注入契约、RSA-OAEP 传输加密防重放、以及多租户 404 防资源探测隔离机制。
- 06/06
常见问题与排错手册:环境、端口、编译与运行时诊断
汇总 BitzOrcas.Modern 开发与本地部署中最常见的故障场景:精准对齐真实端口矩阵(6881、6880、6800、1433)、SQL Server 连接诊断、Roslyn 生成器缓存清理与 HTTPS 证书修复。