# 04 文档仓重排执行落地

Type: task
Status: claimed
Blocked by: 01, 03

## Question

按「一级目录改造机制选型」的结论与「蓝湖一级目录树冻结与全量接口映射表」的映射表，完成落地（票 01 已钉死分支：**A 区路径进源码 tags，深 tag，bruno-sync 唯一权威通道**）：

1. **源码 tags 重构**：按映射表逐 Controller 改 tag（1:1 控制器类级 `@Tag` 改全路径；跨页/拆分控制器方法级多值 `@Operation(tags)`；类级与方法级互斥）；`SystemController` 无 tag 端点补显式深 tag；`LeadPoolController` 按票 02 挂双 tag。回归编译与单测。
2. **重建 `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 分区生成文件夹）；公共依赖合并（文件、行政区划并入「公共依赖」）；调试(验证专用) 保留顶层；二级及更深目录不动。
3. **分区索引 README**：A0-A7 每分区 → 已落地接口清单 → 空缺标注 → 对接工程师示位；生成方式（手写 vs 小脚本幂等产出）本票落地时定；bruno-sync 不生成 README。
4. **ADR-0024 修订**：新增修订段——一级目录对齐原型 A 区（引用 v29 树工件）、深 tag 纪律（一级=分区原文，二级=页面，更深=页面内分组）、商机规则归 A7 的裁决、URL 回退通道关闭、双归属方法级多值 tags、未来新接口的一级挂载纪律（新 Controller 按页面全路径挂 tag）。
5. **机制联动（票 01 已定）**：`bruno-sync.config.json` menuBindings 四键随 tags 换 `A2 线索管理/…` 前缀；手工生成器家族（`gen_bruno.py` / `gen_opp_*.py` / `gen_v2_*.py` / `bru_lib.py`）退役留档。
6. **验收**：重建后文档仓目录树与映射表逐项一致；knife4j 分组 = 深路径 tag 原文；用户按分区索引 README 能确认各分区接口全集与空缺状态。

## Answer

<!-- 解决时填写 -->