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.
3.3 KiB
3.3 KiB
03 蓝湖一级目录树冻结与全量接口映射表
Type: research Status: resolved Blocked by: 02
Question
产出执行票的唯一输入——权威映射表 .scratch/api-docs-reorg/mapping-table.md，内容：
- 冻结权威目录树：从
axure-v29.json（2026-08-31 快照）提取 A0-A7 前两层目录树为独立工件（.scratch/api-docs-reorg/lanhu-tree-v29.md），并记录与 v20 的差异清单（A3-4→A7-3-2 迁移、A1X 新增、A1-1 改名等），供映射表与 ADR 修订引用。 - 全量端点盘点：遍历 crm-auth / crm-file / crm-lead / crm-opportunity / crm-rule / crm-preference / crm-dict 全部 Controller，逐条记录：端点、当前 tag（或无 tag 时的 URL 兜底分组）、当前所在 Bruno 文件夹 → 目标一级目录（按已定裁决：A0 登录界面 / A2 线索管理 / A3 商机管理 / A7 后台管理 / 公共依赖 / 调试顶层）。
- 无 tag 接口的兜底归属：重点核实
system/users、system/depts（SystemController 等无 @Tag 端点，疑为 URL 兜底分组）→ 按原型 A7-1 用户管理归 A7；确认 ResourceController、DataScopeModuleController 的分组来源。 - 线索规则行已定（票 02 裁决，2026-08-31）：
LeadPoolController（tag「线索管理/线索设置」）目标一级目录为 A2 线索管理（主本）+ A7 后台管理/线索规则（副本）双归属——映射表需支持单 tag 多目标目录表达。
映射表每行即执行票的验收基线：重排后文档仓目录树须与映射表逐项一致。
Answer
（2026-08-31 解决）两工件落盘并通过零孤儿对账，映射表即执行票 04 的唯一输入与验收基线：
- 蓝湖 v29 权威目录树：A0-A7 每分区前两层（A2/A3/A7 附第三层明细）；v20→v29 差异 7 条（A3-4 商机管理设置整体迁 A7-3-2、A1X 新增、A1-1 改名工作台、A7-2 恢复两级、A7-3 扩四页、A0 增壳层、A3 内部重组；174→182 页）。
- 全量接口映射表（420 行）：
- 盘点基线：7 模块 161 端点 ↔ 文档仓 191 .bru，双向零孤儿（METHOD+url 钥匙互覆盖；
system/users、system/depts确为 SystemController 无 @Tag 端点的 URL 回退分组，ResourceController / DataScopeModuleController 分组来自方法级 @Operation(tags)，非 URL 回退）。 - §2 Controller tag 重构表 25 行（现 tag → 目标深 tag → 挂法）：AuthController 消除类级/方法级并存违规；LeadPoolController 5 方法挂双值 tags 双归属（票 02）；商机规则三控制器迁
A7 后台管理/商机规则/{公海规则,方案卡模板,阶段模板}。 - §3 端点级明细 161 行；§4 文档文件夹 git-mv 清单（线索管理/线索设置双输出特判）；§5 menuBindings 4 键前缀替换；§6 验收基线目标目录树（一级 → 二级 → .bru 数，空分区占位标注）。
- §7 判断点 7 条——部门管理归属为判断行（A7 后台管理/部门管理 vs 并入用户管理，执行时可调整，调整即同步改本表与 tag）；其余：菜单树随「登录/」整体换名进 A0、运维二级保留、A1X 不迁移工作计划（二级不动）、QueryController tag 收敛（6→3）、board 端点物理在 CollabController、字典不设「系统设置」中间层。
- 盘点基线：7 模块 161 端点 ↔ 文档仓 191 .bru，双向零孤儿（METHOD+url 钥匙互覆盖；