BitzOrcas.Modern 是一套面向 .NET 10 的现代化多租户模块化单体架构基座。它融合了高内聚的垂直切片设计、编译期 Roslyn 代码生成与双 ORM 基础设施，既保证了单体开发调试的极致敏捷，又具备微服务级别的清晰物理边界与云原生 Native AOT 的卓越性能。
核心架构拓扑全景图
五大核心架构支点
1. 深模块物理边界（Deep Modules）
- 高内聚低耦合：每个模块独立包含
Contracts、Domain与Application工程； - 单向依赖铁律：跨模块调用只允许依赖目标模块的公开契约包（
*.Contracts），严禁跨模块直接引用实体或内部仓储； - ArchUnit 架构守卫：通过自动化架构测试在 CI 构建阶段 100% 杜绝违规依赖。
2. 垂直切片架构（Vertical Slice Architecture）
- 一用例一文件：告别传统 Controller → Service → DAO 的浅层水平切分；
- 完整自治：每个切片文件内聚包含 Minimal API 路由契约、RBAC 动作权限、
IRequestRule纯函数校验规则与 Handler 编排逻辑，多人协作零 Git 冲突。
3. 10 级标准化执行管道（Mediator Pipeline）
- 横切关注点透明治理：所有入站请求透明执行日志追踪、商业授权、代客模拟、强类型鉴权、三阶校验、幂等去重、事务提交、领域事件、审计 Diff 与只读充水；
- 业务代码零污染：业务 Handler 内部严禁手写任何事务提交、参数判空异常或手工审计代码。
4. Source Generator First 与 Native AOT 零反射
- 彻底告别运行时反射扫描：全面采用 Roslyn 增量代码生成器在编译期产出 Minimal API 端点映射、双 ORM Fluent 配置与 JSON 序列化元数据；
- 毫秒级冷启动与超低内存：原生适配 .NET 10 Native AOT 静态编译，容器启动耗时低于 50ms。
5. 统一聚合根与编译期双 ORM
- 聚合根即持久化模型：对 90% 以上的常规业务，
TAggregateRoot == TPersistenceModel，彻底废弃手写 1:1*Entity.cs与 Mapper； - 双 ORM 抽象无缝兼容：事务写入与复杂查询默认基于 SQL Server 2022，双 ORM 抽象层无缝兼容 PostgreSQL 等主流数据库。
架构深入导读路线
为全面掌握 BitzOrcas.Modern 的技术细节，建议按以下顺序深入阅读各专业章节：
| 章节与链接 | 核心探讨主题 | 适合角色 |
|---|---|---|
| 1. 模块化单体 | 模块物理划分、契约隔离原则与 ArchUnit 门禁机制 | 架构师 / 核心开发 |
| 2. 垂直切片架构 | 一用例一文件设计规范、10 级管道拦截与领域 Handler 编排 | 全员必读 |
| 3. 依赖注入与生命周期 | 编译期静态注入、服务作用域划分与 HTTP 中间件流转时序 | 后端开发 |
| 4. Host 组合与运行拓扑 | API、Gateway、JobHost 宿主拆解与 .NET Aspire 编排实践 | 运维 / 后端开发 |
| 5. 多租户架构深度剖析 | 8 步租户解析链、数据物理/逻辑隔离与代客模拟沙箱 | 安全 / 架构师 |
| 6. Source Generator 与 AOT | Roslyn 增量生成器实现原理、零反射持久化与 AOT 发布门禁 | 框架 / 性能专家 |
本章核心导航
- 01/07
模块化单体：物理工程隔离、契约边界与架构守护
深入解析 BitzOrcas.Modern 模块化单体体系：Contracts/Domain/Application 物理工程划分、跨模块依赖 5 条铁律、IAppModule 编译期发现机制与 ArchUnit 架构门禁。
- 02/07
垂直切片架构：以业务用例为核心的高内聚解耦
深度剖析 BitzOrcas.Modern 垂直切片架构（Vertical Slice Architecture）：一用例一文件组织形式、10 级管道守门机制、统一聚合根持久化与彻底告别分层架构。
- 03/07
多 ORM 双引擎架构与选型矩阵
深入解析 BitzOrcas.Modern 多持久化引擎架构：SqlSugar、EF Core、Dapper 与 Mongo 的职责边界、选型矩阵与双引擎并存规范。
- 04/07
依赖注入与生命周期：编译期装配与服务治理规范
详解 BitzOrcas.Modern 依赖注入体系：阶段性装配顺序、服务生命周期划分准则（Scoped / Singleton / Transient）、Roslyn 静态注册与 Native AOT 零反射注入。
- 05/07
Host 组合与运行拓扑：API、Gateway、JobHost 与 Aspire 编排
深入解析 BitzOrcas.Modern 的宿主组合架构：API Host、YARP Gateway、JobHost 物理职责划分、ServiceDefaults 共享基底与 .NET Aspire 本地编排拓扑。
- 06/07
多租户架构深度剖析：8 步解析链、数据隔离与代客模拟沙箱
深入解析 BitzOrcas.Modern 企业级多租户底层机制：8 步租户解析优先级链、双 ORM 自动化全局数据过滤（Global Query Filters）、跨租户防越权与操作员代客模拟安全沙箱。
- 07/07
Source Generator 与 Native AOT：零反射编译期代码生成
深入解析 BitzOrcas.Modern 编译期代码生成体系：Minimal API 端点生成器、双 ORM Fluent 静态映射器、JSON 序列化生成器与 .NET 10 Native AOT 极致性能实践。