Skip to main content

资产标识与追踪标准

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 失效都会阻止构建。