5.0 KiB

Raw Blame History

线索模块接口文档核对（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

01 原型页面清单与差异核对 — 15 页与快照完全吻合，无增删改名；「【旧版-线索】-20260813」就是最新权威原型（用户确认，勿被命名误导）；裁剪粒度 = 菜单文件夹（主页面 + 子页）。
04 文档完善度审计（前端视角） — D 盘 32 个 .bru 仅「目录级」（无参数/响应/枚举，前端无法联调）；141 版生成器已具备全部补齐能力，重生成即解决；真增量 = collection.bru 两处失效文案 + 可选典型报错行 + baseUrl 确认。
02 页面×接口需求矩阵 — 缺失 3（follow-batch/unfollow-batch/create+followOnCreate）；幻影坐实（每页文件夹 40%~60% 无入口，四页分别应裁 14/10/15/10）；修正 ticket 14 旧表 4 处误记；其余 21+2+5+2 接口全部有入口证据。
03 裁剪与补缺方案拍板 — 8 项决议：源码 tags 每页实挂 / 严格按矩阵裁 / region 独立「公共依赖/行政区划」+ 列偏好随 scope 归页 / 只删副本不设总览 / 维持 Bruno 2 单仓 / 线索域全清+去重 / 全量机制化补齐 / 缺失 3 项本期一并实现。推翻 ADR-0024 决策 3。
05 落地：重新生成并交付 D 盘文档仓 — 后端 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

（无——原两条雾已在 03 收口：清理范围拍定为线索域全清+去重；验收默认方案 = collection.bru 首页写清用法，前端自助联调，异议走 issue。）

Out of scope

G6 线索导入、G7 公海池导入、G8 公海池导出（维持 clue-module 既有判定：原型有按钮 ≠ 本期交付）。
权限码全集下发接口（另立 effort：.scratch/auth-perms/）。
sys_menu seed 菜单名「公海」→「线索公海」数据迁移（ADR-0024 遗留，属 DB 侧，不阻塞文档交付）。
非线索域文档的结构专项治理（system/、文件/、登录/ 等）——重生成时顺带覆盖与否由 05 执行判断。

5.0 KiB Raw Blame History