Skip to content
bitzorcas
中EN

Reference

模块就绪矩阵

当前 36 个 Platform 根的 Ready / Out-of-Scope 矩阵、ProductionDepth 口径,以及门禁生产持久化的全仓库闭环状态。

Last updated

就绪矩阵跟踪 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 表面状态
AIManageYesReady
AnnouncementsYesReady
AuthorizationYesReady
BitzOrcas.Platform.Application共享 ApplicationOut of Scope
BitzOrcas.Platform.Contracts共享 ContractsOut of Scope
CatalogYesReady
ChatYesReady
CommentsYesReady
CommercialDistributionYesReady
DocumentStructureYesReady
DocumentsYesReady
FilesYesReady
GdprYesReady
GuidanceYesReady
I18nYesReady
IdentityYesReady
IndustryExtensions否(可选行业包)Out of Scope
LegalCalculators否(可选法律包)Out of Scope
LegalConnectorsYesReady
LicenseManagementYesReady
MasterDataYesReady
MenuYesReady
NumberingYesReady
NotificationsYesReady
OperationsYesReady
OpsExtensionYesReady
PlatformBillingYesReady
ReleaseManagementYesReady
ReportingYesReady
RiskControlYesReady
SearchYesReady
ToolConnectorsYesReady
TrackerYesReady
WebhooksYesReady
WebsiteYesReady
WorkflowYesReady

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 评审日志是内部流程产物,保留在源代码仓库中。

复核顺序与命令

先做目录与矩阵双向比较。新增目录如果没有分类,或删除目录后仍留旧行,架构测试都会失败:

Terminal window
# 36 个一级 Platform 根与权威矩阵必须双向一致。
find src/Platform -mindepth 1 -maxdepth 1 -type d -exec basename {} \; | sort
dotnet test tests/BitzOrcas.Architecture.Tests \
--filter FullyQualifiedName~PlatformModuleReadinessMatrixTests

再确认持久化闭环没有因新 Entity、mapping 或 translator 回退;零结果只是局部扫描,最终以 0006 清单双向校验为准:

Terminal window
# 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 流水账;行为证据回到模块测试,剩余风险回到专属清单。

另见

100%

滚轮或按钮缩放 · 放大后拖动画面 · 双击切换 100% / 200%