就绪矩阵跟踪 src/Platform 当前 36 个一级目录是否通过 Application 表面检查。Ready 意味着面向 Application 的表面通过了当前检查——它不意味着每个已注册的持久化、QueryShape、Native AOT、外部连接器或非对称存储清理都已完成。这些仍在各自清单和生产验收中跟踪。
“Ready” 的含义
一个模块只有在以下情况后才达到 Ready:
- 已检查 Application handler 是否存在可避免的 Result/template/list-query/tenant-context 摩擦;
- 存在模块专属架构测试,或该模块被显式排除在范围外;
- 针对变更行为运行了相关的 Application/Unit/Integration 测试;
- 通过了最低质量门禁。
仅当一个模块没有 Application 表面或是共享契约包时才允许 Out of Scope。
当前状态
全仓库持久化闭环:Closed。
| 模块 | Application 表面 | 状态 |
|---|---|---|
| AIManage | Yes | Ready |
| Announcements | Yes | Ready |
| Authorization | Yes | Ready |
| BitzOrcas.Platform.Application | 共享 Application | Out of Scope |
| BitzOrcas.Platform.Contracts | 共享 Contracts | Out of Scope |
| Catalog | Yes | Ready |
| Chat | Yes | Ready |
| Comments | Yes | Ready |
| CommercialDistribution | Yes | Ready |
| DocumentStructure | Yes | Ready |
| Documents | Yes | Ready |
| Files | Yes | Ready |
| Gdpr | Yes | Ready |
| Guidance | Yes | Ready |
| I18n | Yes | Ready |
| Identity | Yes | Ready |
| IndustryExtensions | 否(可选行业包) | Out of Scope |
| LegalCalculators | 否(可选法律包) | Out of Scope |
| LegalConnectors | Yes | Ready |
| LicenseManagement | Yes | Ready |
| MasterData | Yes | Ready |
| Menu | Yes | Ready |
| Numbering | Yes | Ready |
| Notifications | Yes | Ready |
| Operations | Yes | Ready |
| OpsExtension | Yes | Ready |
| PlatformBilling | Yes | Ready |
| ReleaseManagement | Yes | Ready |
| Reporting | Yes | Ready |
| RiskControl | Yes | Ready |
| Search | Yes | Ready |
| ToolConnectors | Yes | Ready |
| Tracker | Yes | Ready |
| Webhooks | Yes | Ready |
| Website | Yes | Ready |
| Workflow | Yes | Ready |
ProductionDepth 不是 Ready 的同义词
当前源码治理文档把对外生产深度分为四档:
- Core:默认 Profile 常用且生产路径证据充分;仍需目标租户和环境配置。
- Optional:按 Profile 或配置显式开启,未启用时应失败关闭。
- ConnectorRequired:必须接入真实 Provider、网关或密钥;接口存在不等于可生产使用。
- Sample:提供可扩展骨架或浅默认,不得宣传为大规模生产默认。
2026-08-03 的源码快照把 Identity、Authorization、Files、Notifications、Webhooks、Menu、MasterData、Numbering、ReleaseManagement、Announcements 与 Operations 的探针/配置列为 Core;Workflow、Chat、AIManage、Gdpr、RiskControl、Website、CommercialDistribution、LicenseManagement 与 PlatformBilling 列为 Optional——快照原文中的独立 Tickets 条目在其后已并入 Tracker,对应行列在上面;LegalConnectors 与 ToolConnectors 列为 ConnectorRequired;Search 与 Reporting 仍带 Sample/浅默认边界。未出现在快照列表中的 Ready 模块不能自动推断为 Core,应由 owner 给出真实部署证据。
持久化闭环
权威账本是 0006-persistence-surface-classification.json。当其 closureStatus 为 Closed 时,src/Platform 与 src/Modules 中不含 *Entity.cs、*PersistenceMappingSpecs.cs 或生产 QueryFilterTranslator 文件,且无 MigrationCandidate/DeleteCandidate/ParityBlocker/FrameworkMigrationSeam 条目残留。架构测试在源声明、映射文件与 translator 文件之间双向集合比对此清单。
产出此矩阵的逐 Sprint 评审日志是内部流程产物,保留在源代码仓库中。
复核顺序与命令
先做目录与矩阵双向比较。新增目录如果没有分类,或删除目录后仍留旧行,架构测试都会失败:
# 36 个一级 Platform 根与权威矩阵必须双向一致。find src/Platform -mindepth 1 -maxdepth 1 -type d -exec basename {} \; | sortdotnet test tests/BitzOrcas.Architecture.Tests \ --filter FullyQualifiedName~PlatformModuleReadinessMatrixTests再确认持久化闭环没有因新 Entity、mapping 或 translator 回退;零结果只是局部扫描,最终以 0006 清单双向校验为准:
# Platform/Modules 生产持久化迁移面应保持为零。rg --files src/Platform src/Modules | rg 'Entity\.cs$|PersistenceMapping(Specs)?\.cs$|QueryFilterTranslator'
# 运行清单、双 ORM 与例外账本架构门禁。dotnet test tests/BitzOrcas.Architecture.Tests \ --filter "FullyQualifiedName~PersistenceSurface|FullyQualifiedName~OrmParity"持续复核还包括 owner transfer、双 ORM parity、AOT 例外台账和最终 Docker 契约。Ready 行不应承载逐 Sprint 流水账;行为证据回到模块测试,剩余风险回到专属清单。