05 落地：重新生成并交付 D 盘文档仓

Status: resolved (2026-08-17) Type: task Blocked by: 03

Question

按 03 拍板的 8 项决议执行落地（本 effort 携带执行的终点）：

A. 后端源码（决议 1/2/8）

tags 全量重挂：LeadController 23 个既有接口按 research 02 矩阵四页保留集实挂；ColumnPreference 两方法改四菜单实挂；Region 两接口改「公共依赖/行政区划」tag；
新增 follow/batch、unfollow/batch（公海批量关注 / 我的关注批量取关）：Service + Controller + 实挂 tags + 单测（BatchResult 部分成功语义，与 claim-batch 同构）；
create 增 followOnCreate（Boolean 默认 false，原型「是否关注」复选，PRD §6.1）：Param DTO + service 创建后自关注；
mvn compile + 全量 BOM 扫描。

B. gen_bruno.py 改造（决议 1/3/5）

WSROOT e: → D:；布局切 Bruno 2 单仓（collection 在仓根）；
移除 MENU_EXPAND 全量副本机制，直接按源码 tags 分组生成；
region 生成到根级「公共依赖/行政区划/」；create 类 .bru docs 注明 region 依赖；列偏好按 scope 生成四份归各菜单文件夹；
完善度机制项：参数六元组、PageResult/BatchResult、status 七态枚举、典型报错（401/403/业务码）；

C. D 盘重生成与清理（决议 6）

D. 文档侧落盘

ADR-0024 修订（推翻决策 3，补记 region/列偏好例外）；CONTEXT.md / glossary 同步；.scratch/bruno-coldstart/PENDING 更新。

E. 交付

以 04「前端能直接联调」标准逐项自查；两个仓的 git 提交由用户执行（agent 不做 Git 操作）。

完成标准：前端打开 D 盘文档仓，按菜单文件夹逐页自助联调——不缺、不多、看得懂。

2026-08-17 全部执行完毕，五段落地：

A. 后端源码（6 文件，编译通过 + BOM 0 + 单测 68 全绿）

LeadController：25 个方法 tags 按 02 矩阵实挂（四页共有 page/detail/history/stats；claim/claim-batch→公海+我的关注；release→公海+我的线索；unfollow→公海+我的关注；follow→公海；create/delete→我的线索+管理；assign×4/activate×2/delete-batch→管理；edit/feedback×2/convert/release-batch→我的线索）；类注释写明实挂纪律
新增 POST /api/lead/follow-batch、POST /api/lead/unfollow-batch（runBatch + self 代理，与 claim-batch 同构）
createLead 增 followOnCreate（三参签名，创建同事务内幂等关注）
RegionController tag →「公共依赖/行政区划」；ColumnPreference/LeadPool 无需改（已符合）
测试：LeadBatchServiceTest +2（委派验证）、LeadServiceImplTest +2（followOnCreate=true/false）

B. gen_bruno.py 改造（838→862 行）

WSROOT e→D；Bruno 2 单仓（bruno.json 在仓根，无 workspace.yml；local.bru 只 _ensure 不覆盖）
MENU_EXPAND 全量副本机制移除 → MENU_BIND（folder 即菜单，自动绑 viewType/scopeKey + 【xx 页】前缀）
线索区块重写为按页分组；列偏好四页循环；region 归公共依赖；新增两个批量接口 .bru；create 补 followOnCreate + region 依赖提示；collection.bru 重写实挂规范 + 前端使用指引（03 两处失效文案随重写消失）

C. D 盘重建（92 个 .bru）

生成与矩阵完全吻合：公海 12 / 我的线索 14 / 我的关注 10 / 管理 15 / 设置 5 / 行政区划 2（线索域 58）+ 非线索域 34
清理：根目录重复权限点管理、旧平铺四文件夹（脚本 rmtree）+ 旧版生成器残留 11 文件 + 2 目录（同接口不同名：下载/直传/分片上传-×3、获取当前登录用户信息、权限点管理旧名×3、system/menus 旧×2、系统管理/角色管理/、system/roles/）——非线索域残留按 map 授权「05 执行判断」清除
抽查：公海/线索分页 viewType=PUBLIC_POOL 绑定+前缀 ✓；我的关注/批量取关新接口结构 ✓；我的线索/新建线索 followOnCreate+region 提示 ✓

D. 文档落盘

ADR-0024 追加修订段（决策 3 推翻、每页实挂、保留集、region/列偏好例外、D 盘/Bruno 2）；crm-lead/CONTEXT.md 菜单 tag 词条同步；PENDING-review-and-crm-dict.md 更新为 2026-08-17 状态

E. 交付

Effort 到达 Destination：前端打开 D 盘按菜单文件夹逐页自助联调——不缺、不多、看得懂。