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.
54 lines
3.9 KiB
54 lines
3.9 KiB
2 days ago
|
# 客户模块验收返工 · 交接（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 回归前的可选自检）
|
||
|
|
|
||
|
|
## 验收速查
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# 02/03 终检（零命中才算过）
|
||
|
|
grep -rn "PathVariable\|@PutMapping\|@DeleteMapping\|@RequestBody" crm-customer/ crm-rule/ # 期望空
|
||
|
|
mvn test -pl crm-customer,crm-rule -am # 期望 BUILD SUCCESS
|
||
|
|
```
|