补齐行政区划三级联动接口文档与模板门禁(#6422)
changelog-filename-gate / validate (pull_request) Successful in 2s

这个提交包含在:
lc
2026-08-26 16:23:19 +08:00
父节点 ff16cfd94c
当前提交 3d6f6245a0
共修改 7 个文件,包含 1038 行新增和 160 行删除
+18
查看文件
@@ -75,6 +75,24 @@ pending → claimed → implemented → released → verified
- `FRONTEND_CONSUMPTION_STATUS_GUIDE.md`
- `BACKEND_CHANGELOG_DELIVERY_GUIDE.md`
## 接口文档模板门禁
新增、修改或删除接口的 Changelog 必须以仓库根目录
[`CHANGELOG_TEMPLATE.md`](CHANGELOG_TEMPLATE.md) 为结构基线,不能只写接口路径和一段变更摘要。
机器校验要求:
- 使用“二、变更接口清单”的标准六列表格;
- 清单中的每个 `METHOD /path` 都必须在“三、接口详情”中有且只有一个对应小节;
- 每个接口小节必须自含入参字段表、出参字段表、请求示例、响应示例、错误响应和业务边界;
- 含写接口时必须说明外部可观察的数据库行为,但不得泄露物理表结构;
- 修改或删除接口必须补“修改前后对比”和“影响评估”;
- 必须保留契约约束、边界行为、不影响范围、TEST 验证、相关文档及联系人章节。
缺少上述内容时 `check:frontmatter` 返回 `E_API_TEMPLATE`、`E_API_ENDPOINTS` 或
`E_API_DETAIL`,PR/push 检测失败。存量文件不全量追责,但任何接口类文件一旦新增或修改,
就必须补到当前模板标准。
已下发路径是消费契约的一部分,不通过重命名表达状态。历史路径已发生迁移时:
- `changelog-path-aliases.json` 是机器可识别的唯一映射源;