You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.1 KiB
2.1 KiB
04 文档仓重排执行落地
Type: task Status: claimed Blocked by: 01, 03
Question
按「一级目录改造机制选型」的结论与「蓝湖一级目录树冻结与全量接口映射表」的映射表，完成落地（票 01 已钉死分支：A 区路径进源码 tags，深 tag，bruno-sync 唯一权威通道）：
- 源码 tags 重构：按映射表逐 Controller 改 tag（1:1 控制器类级
@Tag改全路径；跨页/拆分控制器方法级多值@Operation(tags)；类级与方法级互斥）；SystemController无 tag 端点补显式深 tag；LeadPoolController按票 02 挂双 tag。回归编译与单测。 - 重建
D:\code\crm-api-docs：现有 .bru 先按映射表 git-mv 到目标路径（表述保留，bruno-sync 铁律 1）；再跑 bruno-sync 全量对账（钥匙 = METHOD+url+新文件夹名，命中仅结构 patch）；空分区（A1 / A1X / A4 / A5 / A6）手工放 folder.bru + README 占位（bruno-sync 不为无 tag 分区生成文件夹）；公共依赖合并（文件、行政区划并入「公共依赖」）；调试(验证专用) 保留顶层；二级及更深目录不动。 - 分区索引 README：A0-A7 每分区 → 已落地接口清单 → 空缺标注 → 对接工程师示位；生成方式（手写 vs 小脚本幂等产出）本票落地时定；bruno-sync 不生成 README。
- ADR-0024 修订：新增修订段——一级目录对齐原型 A 区（引用 v29 树工件）、深 tag 纪律（一级=分区原文，二级=页面，更深=页面内分组）、商机规则归 A7 的裁决、URL 回退通道关闭、双归属方法级多值 tags、未来新接口的一级挂载纪律（新 Controller 按页面全路径挂 tag）。
- 机制联动（票 01 已定）：
bruno-sync.config.jsonmenuBindings 四键随 tags 换A2 线索管理/…前缀；手工生成器家族（gen_bruno.py/gen_opp_*.py/gen_v2_*.py/bru_lib.py）退役留档。 - 验收：重建后文档仓目录树与映射表逐项一致；knife4j 分组 = 深路径 tag 原文；用户按分区索引 README 能确认各分区接口全集与空缺状态。