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.
28 lines
3.3 KiB
28 lines
3.3 KiB
6 days ago
|
# 03 蓝湖一级目录树冻结与全量接口映射表
|
||
|
|
|
||
|
|
Type: research
|
||
|
|
Status: resolved
|
||
|
|
Blocked by: 02
|
||
|
|
|
||
|
|
## Question
|
||
|
|
|
||
|
|
产出执行票的唯一输入——权威映射表 `.scratch/api-docs-reorg/mapping-table.md`，内容：
|
||
|
|
|
||
|
|
1. **冻结权威目录树**：从 `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 修订引用。
|
||
|
|
2. **全量端点盘点**：遍历 crm-auth / crm-file / crm-lead / crm-opportunity / crm-rule / crm-preference / crm-dict 全部 Controller，逐条记录：端点、当前 tag（或无 tag 时的 URL 兜底分组）、当前所在 Bruno 文件夹 → **目标一级目录**（按已定裁决：A0 登录界面 / A2 线索管理 / A3 商机管理 / A7 后台管理 / 公共依赖 / 调试顶层）。
|
||
|
|
3. **无 tag 接口的兜底归属**：重点核实 `system/users`、`system/depts`（SystemController 等无 @Tag 端点，疑为 URL 兜底分组）→ 按原型 A7-1 用户管理归 A7；确认 ResourceController、DataScopeModuleController 的分组来源。
|
||
|
|
4. **线索规则行已定（票 02 裁决，2026-08-31）**：`LeadPoolController`（tag「线索管理/线索设置」）目标一级目录为 **A2 线索管理（主本）+ A7 后台管理/线索规则（副本）双归属**——映射表需支持单 tag 多目标目录表达。
|
||
|
|
|
||
|
|
映射表每行即执行票的验收基线：重排后文档仓目录树须与映射表逐项一致。
|
||
|
|
|
||
|
|
## Answer
|
||
|
|
|
||
|
|
**（2026-08-31 解决）两工件落盘并通过零孤儿对账，映射表即执行票 04 的唯一输入与验收基线：**
|
||
|
|
|
||
|
|
1. **[蓝湖 v29 权威目录树](../lanhu-tree-v29.md)**：A0-A7 每分区前两层（A2/A3/A7 附第三层明细）；v20→v29 差异 7 条（A3-4 商机管理设置整体迁 A7-3-2、A1X 新增、A1-1 改名工作台、A7-2 恢复两级、A7-3 扩四页、A0 增壳层、A3 内部重组；174→182 页）。
|
||
|
|
2. **[全量接口映射表](../mapping-table.md)**（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、字典不设「系统设置」中间层。
|