项目接管
权威来源和职责边界
为关键工程事实写下 owner、location、consumer 和 freshness。
项目接管的目标不是收集更多链接,而是让每项关键事实只指向一个可核对的来源。
建立 Contract Index
| Fact | Owner | Authoritative location | Consumers | Validation |
|---|---|---|---|---|
| Billing API | Billing Service | OpenAPI v2.4 | Web, BFF | contract tests |
| Authorization | IAM | policy repository | Web, Service | runtime permission cases |
| Deploy config | Platform | deployment repository | Service | staging smoke test |
对 API、Error Contract、权限 Policy、配置、部署、数据库 migration 和设计规范逐项填写。无法填写 owner 或 location 时,这一项仍是缺口。
判断是否越界
出现以下情况时先停下来:
- Web 项目开始复制服务端业务规则。
- BFF 把临时适配变成新的业务数据所有权。
- 服务自行定义本应由 IAM 或 Brand owner 管理的 Policy。
- 文档和实现各自声称是同一 Contract 的权威来源。
把冲突记录为 Drift,并指定谁负责裁决。不要用“以代码为准”掩盖 owner 缺失。