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.
44 lines
5.0 KiB
44 lines
5.0 KiB
3 weeks ago
|
# 线索模块接口文档核对（wayfinder map）
|
||
|
|
|
||
|
|
Label: wayfinder:map · charted 2026-08-17 · **ARRIVED 2026-08-17（全部 5 票 resolved）**
|
||
|
|
|
||
|
|
## Destination
|
||
|
|
|
||
|
|
`D:\code\crm-api-docs`（前端实际消费的文档仓）中线索模块的 Bruno 文档与蓝湖原型**逐页对齐**：每个原型页面文件夹里的接口 = 该页实际需要的接口——缺失的补上、幻影的删掉、内容看得懂。本 effort **携带执行**（用户已确认）：决策拍板后直接改 gen_bruno.py + 源码 tags，在 D 盘重新生成交付。
|
||
|
|
|
||
|
|
## Notes
|
||
|
|
|
||
|
|
- **第一要义：让前端看懂**——一切取舍以「前端按菜单文件夹自助联调」为准绳。
|
||
|
|
- 蓝湖原型 MCP：`http://0.0.0.0:8000/mcp`（未注册进 Qoder，用 `python tmp/lanhu_mcp.py <tool名> '<json参数>'` 调用；PowerShell 先 `$env:PYTHONIOENCODING='utf-8'`）。
|
||
|
|
- 蓝湖项目 URL（PRD/Axure 原型）：`https://lanhuapp.com/web/#/item/project/product?tid=b013dded-642f-4899-b829-daa5c093fdf0&pid=e528bb49-1eea-4d76-b7e0-4055bc7c1b70&docId=8fce7f53-f59b-417b-870e-801b38f3604b&docType=axure`
|
||
|
|
- 现状事实（2026-08-17 charting 时核实）：
|
||
|
|
- `D:\code\crm-api-docs` = 前端实际看的仓（用户确认），当前是**旧平铺结构**：`线索管理/` 23 个 .bru 无菜单分组、`线索规则-公海池配置/`（旧名，ADR-0024 要求改名「线索管理/线索设置」）、`线索规则-行政区划/`、`列偏好/`、根目录与 `系统管理/` 下**重复**的 `权限点管理/`；线索相关文件夹全部 untracked，仓仅 1 个 commit。
|
||
|
|
- ADR-0024 记录的菜单化 141 .bru 版本生成在 `e:\code\crm-api-docs`——**该路径已不存在**；gen_bruno.py（`.scratch/bruno-coldstart/gen_bruno.py`）仍硬编码 e 盘 WSROOT。
|
||
|
|
- ADR-0024 决策 3「四菜单全量副本（不做接口级页面裁剪）」即用户所指迷惑之源；本次以**原型逐页交互**为真相源修订（用户已拍板方向）。
|
||
|
|
- 参考技能：/grilling、/domain-modeling；执行阶段参考 /bruno-sync 与 `.scratch/bruno-coldstart/gen_bruno.py`。
|
||
|
|
- 既有对照材料：`.scratch/clue-module/map.md`「逐页比对（ticket 14 收口）」15 页表（2026-08-13 基于本地文本快照）；`.scratch/lanhu-text/` 为当时的原型文本快照——**本次以 MCP 实时原型为准**，快照仅作交叉验证。
|
||
|
|
- 约定：agent 不做 Git 操作（文档仓/后端仓提交由用户执行）；.bru 副本由 gen_bruno.py 幂等维护，前端不手改。
|
||
|
|
|
||
|
|
## Decisions so far
|
||
|
|
|
||
|
|
<!-- 一行一个已关闭 ticket：要点 + 链接 -->
|
||
|
|
|
||
|
|
- [01 原型页面清单与差异核对](issues/01-prototype-page-inventory.md) — 15 页与快照完全吻合，无增删改名；「【旧版-线索】-20260813」就是最新权威原型（用户确认，勿被命名误导）；裁剪粒度 = 菜单文件夹（主页面 + 子页）。
|
||
|
|
- [04 文档完善度审计（前端视角）](issues/04-doc-completeness-audit.md) — D 盘 32 个 .bru 仅「目录级」（无参数/响应/枚举，前端无法联调）；141 版生成器已具备全部补齐能力，重生成即解决；真增量 = collection.bru 两处失效文案 + 可选典型报错行 + baseUrl 确认。
|
||
|
|
- [02 页面×接口需求矩阵](issues/02-page-endpoint-matrix.md) — 缺失 3（follow-batch/unfollow-batch/create+followOnCreate）；幻影坐实（每页文件夹 40%~60% 无入口，四页分别应裁 14/10/15/10）；修正 ticket 14 旧表 4 处误记；其余 21+2+5+2 接口全部有入口证据。
|
||
|
|
- [03 裁剪与补缺方案拍板](issues/03-trimming-scheme-grill.md) — 8 项决议：源码 tags 每页实挂 / 严格按矩阵裁 / region 独立「公共依赖/行政区划」+ 列偏好随 scope 归页 / 只删副本不设总览 / 维持 Bruno 2 单仓 / 线索域全清+去重 / 全量机制化补齐 / 缺失 3 项本期一并实现。推翻 ADR-0024 决策 3。
|
||
|
|
- [05 落地：重新生成并交付 D 盘文档仓](issues/05-regen-and-deliver.md) — 后端 6 文件（25+2 方法 tags 实挂、follow-batch/unfollow-batch 新接口、create+followOnCreate；编译过 + BOM 0 + 单测 68 全绿）；gen_bruno.py 改造（D 盘/Bruno 2/MENU_BIND）；D 盘重建 92 个 .bru（线索域 58 与矩阵完全吻合：12/14/10/15/5/2）+ 清理旧平铺与旧版残留；ADR-0024 修订段 + CONTEXT 词条 + PENDING 同步。git 提交待用户执行。
|
||
|
|
|
||
|
|
## Not yet specified
|
||
|
|
|
||
|
|
<!-- 雾：进 Scope 但还写不出 ticket 的 -->
|
||
|
|
|
||
|
|
- （无——原两条雾已在 03 收口：清理范围拍定为线索域全清+去重；验收默认方案 = collection.bru 首页写清用法，前端自助联调，异议走 issue。）
|
||
|
|
|
||
|
|
## Out of scope
|
||
|
|
|
||
|
|
- G6 线索导入、G7 公海池导入、G8 公海池导出（维持 clue-module 既有判定：原型有按钮 ≠ 本期交付）。
|
||
|
|
- 权限码全集下发接口（另立 effort：`.scratch/auth-perms/`）。
|
||
|
|
- `sys_menu` seed 菜单名「公海」→「线索公海」数据迁移（ADR-0024 遗留，属 DB 侧，不阻塞文档交付）。
|
||
|
|
- 非线索域文档的结构专项治理（system/、文件/、登录/ 等）——重生成时顺带覆盖与否由 05 执行判断。
|