资产标识与追踪标准
ID 格式
ADP-{DOMAIN}-{KIND}-{OWNER}-{NNNN} 是平台合同资产的稳定语义身份。ID 一经使用不得修改、复用或因章节重排重新编号。
允许的领域为 PLN/AUT/DLV/DEV/KNO/OPS;owner 为 WSC/DOC/PLN/PIP/DSP/CDX/CLD/WSI。资产种类及解释见资产类型。
章节号与原生 ID
章节编号用于阅读,可以改变。Plane UUID、ADP 工作项编号、Git commit、OpenAPI operationId、Figma node ID 和测试名称继续由原系统管理,通过 native_refs 关联,不能替代 Asset ID。
生命周期
draft:资产已登记但合同仍在评审。active:当前有效合同。deprecated:仍可定位,但不得用于新增依赖。retired:仅保留 tombstone;替代项使用supersedes,旧资产使用superseded_by指回后继资产。
关系质量
Requirement、Acceptance Criterion、Mechanism、API、Protocol 和 Schema 必须声明正式验证资产;跨仓关系只能引用中央索引中存在的 ID。任何重复、悬空、owner 不匹配或 locator 失效都会阻止构建。