luoweijian
/
crm-backend-matt
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
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.
145 Commits
1 Branch
0 Tags
401 MiB
 
 
 
 
 
Tree: 746b032092
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '746b032092'
${ noResults }
crm-backend-matt/.scratch/customer-rework/HANDOFF-2026-09-04.md

3.9 KiB
Raw Blame History

客户模块验收返工 · 交接（HANDOFF-2026-09-04）

写给在新电脑上续接本 effort 的下一个 agent 会话。细节全部在图与票内，本文只做指针 + 换机特有事项，不复述。

如何续接

  1. 读 .scratch/customer-rework/map.md（图：destination / R1–R11 决策 / Decisions so far / 范围外）。
  2. 以 wayfinder skill（Work through the map 模式） 续接：地图路径 .scratch/customer-rework/；tracker 约定见 docs/agents/issue-tracker.md 的「Wayfinding operations」段。
  3. 一场只解一张票；先 Status: claimed 再动手；resolve 后 Answer + map 的 Decisions so far 追加。
  4. 用户已示谕按序取票：下一张 = 04 · 查重设置页端点 + QuickCreate.confirmSimilar（.scratch/customer-rework/issues/04-gap-fixes.md）。此后前沿为 05、06。

当前进度（详见各票，此处只给索引）

  • 01 resolved：AGENTS.md「Coding standards」新增「新模块接口接入 checklist」（新会话必读，本图后续所有票的规范镜头依据）。
  • 02 resolved：8 Controller 26 端点 + crm-rule 1 端点全部扁平动作动词化；workspace 进 CustomerWorkspacePageParam 字段；全仓唯一 @RequestBody 违规消灭。
  • 03 resolved：board summary/cards 对 pool 拒 67001（assertBoardAllowed 守卫）+ 2 新用例。票内有完整「误翻案→回滚」弧线记录。

测试基线：crm-rule 146 / crm-customer 135 / crm-opportunity 242，绿为准（数量随用例演进）。

换机特有事项（本文档存在的理由）

  • 同步方式：.scratch/ 被 git 跟踪，但本机尚有未提交改动（crm-customer/crm-rule 源码 + .scratch）。切换前先 commit + push，新机 pull；勿只拷 .scratch。
  • 本机独有路径：蓝湖原型缓存 D:\code\crm-需求梳理\lanhu-mcp\data\axure_extract_bade4454_screenshots\（.txt 为主）。新机若无此目录：关键证据截图已拷入本目录（a4-2-1_客户总览列表_卡片视图_.png、a4-1-1_客户公海列表.png）；需整页文本时用 lanhu-bridge 重提取，OCR 兜底。
  • bruno 产出仓 E:\code\crm-api-docs（07 号票）——盘符因机而异，跑 bruno-sync 前先确认产出路径。
  • bruno-sync.local.json 不入库（.gitignore）——07 号票跑全链前需按 skill 说明重建本机配置。
  • 环境：Windows + Git Bash + Maven。mvn test -pl crm-customer,crm-rule -am 为常用验收命令。

必读纪律（仓库内已有，勿另起）

  • AGENTS.md「新模块接口接入 checklist」（六条：扁平动词/深 tag/bruno 配置/表单绑定/对照时点）。
  • AGENTS.md「Tooling / harness」：edit 工具大块 CJK 走 temp 文件 + python heredoc（本图三张票全程用此模式）；中继流断流=重试即可。
  • AGENTS.md「Source file encoding」：.java 禁 BOM，mvn compile 前扫一遍。

用户协作备注

  • 中文交流；范围/口径以用户 HITL 拍板为准（图 R1–R11 为既定拍板，勿重开）。
  • 03 号票教训：用户的纠正若含范围歧义（如「原型上是有卡片视图的」未说哪页），先定位到具体页面再动手，不要外推；必要时一条问题问清。03 最终口径：卡片视图在总览/我的客户，公海没有。

Suggested skills

  • wayfinder（主流程，Work through the map）
  • grilling + domain-modeling（04/08 出现需决策项时；一次一问）
  • bruno-sync（07 号票全链产出）
  • lanhu-bridge / ocr-image（原型文本/截图，新机无缓存时）
  • code-review（09 号票修复完成后、10 回归前的可选自检）

验收速查

# 02/03 终检（零命中才算过）
grep -rn "PathVariable\|@PutMapping\|@DeleteMapping\|@RequestBody" crm-customer/ crm-rule/   # 期望空
mvn test -pl crm-customer,crm-rule -am                                                        # 期望 BUILD SUCCESS