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.
|
|
|
|
# 11 · `.scratch/customer-module` 文档同步收尾
|
|
|
|
|
|
|
|
|
|
- **Status:** resolved
|
|
|
|
|
- **Type:** task
|
|
|
|
|
- **Blocked by:** 09-audit-fixes
|
|
|
|
|
|
|
|
|
|
> 2026-09-05 SESSION 3 认领（交接篇 HANDOFF-2026-09-05-API-SUMMARY-WIP.md）。
|
|
|
|
|
|
|
|
|
|
## 目标
|
|
|
|
|
|
|
|
|
|
R1 要求的文档同步，收尾统一校验（各票随修随改，本票终验）。
|
|
|
|
|
|
|
|
|
|
## 清单
|
|
|
|
|
|
|
|
|
|
- [x] `map.md`（冻结图）：末尾增补「返工增补」段——R1–R11 决策指针（→ `.scratch/customer-rework/map.md`）+ 每张返工票执行结果的增量决策条目；
|
|
|
|
|
- [x] `API-SUMMARY.md`：全部端点 URL/方法/参数表按 02 号票改造后形态重写；§5 已知缺口清单销账（confirmSimilar、查重设置端点）；新增：形态偏好端点、列偏好 scopeKey、查重设置端点；
|
|
|
|
|
- [x] `HANDOFF-*.md`：新篇（日期=收工日）记录返工范围/决策/测试结果，链接 RETEST-REPORT；
|
|
|
|
|
- [x] `crm-customer/CONTEXT.md`（若存在接口清单段落）：同步新 URL 契约 + 偏好能力说明；
|
|
|
|
|
- [x] 交叉检查：文档中的 URL 与代码 `@*Mapping` 逐一对得上（脚本 grep 对账）。
|
|
|
|
|
|
|
|
|
|
## 验收
|
|
|
|
|
|
|
|
|
|
文档-代码对账零差异；旧 HANDOFF 不改写（历史只增）。
|
|
|
|
|
|
|
|
|
|
## Answer
|
|
|
|
|
|
|
|
|
|
五项清单全勾（SESSION 3，2026-09-05，接交接篇 HANDOFF-2026-09-05-API-SUMMARY-WIP.md §2 素材包执行）：
|
|
|
|
|
|
|
|
|
|
1. **map 增补段**：`.scratch/customer-module/map.md` 末尾原「返工增补指针」一行扩为「返工增补（2026-09-05 收官版）」完整节——R1–R11 决策指针 + 12 张返工票（01–10、12）一行增量决策；头部「返工中」警示同步改为「已收官」。
|
|
|
|
|
2. **API-SUMMARY.md 整篇重写**（194 行 → 208 行）：按交接篇 §2.2 计划段落结构 §0 通用约定 / §1 错误码 67001–67017 全表 / §2.1 三 workspace（F7 五视图表格化 Param + groupColumn 白名单 + pool 看板 67001）/ 2.2 公海与归属动作 / 2.3 新增编辑查重工商（F6 batch-update 上限 100 五状态）/ 2.4 商机快建 / 2.5 详情头部+8 页签（页签 6 引 §2.6；detailHead viewTouch 副作用）/ 2.6 战略协议五端点（AgreementDTO 字段 + 快照联动 + 67017）/ 2.7 联系人独立菜单 / 2.8 团队成员 / 2.9 关注重点 / 2.10 归档恢复 / 2.11 交割（D-07 标注）/ 2.12 导入（F8 duplicateStrategy 冻结语义）/ 2.13 规则设置两栈（reminder+dedup，64023）/ 2.14 偏好三件套（scopeKey 表 + saved-view JSON 例外）/ 2.15 ping；§3 值域（oplog **17 种真值**，@Schema 滞后 11 种注记在案）/ §4 联调速查 / §5 缺口销账（1/2 划线、3 改「页签 5 --、页签 6 上线」、4/5 划出保持、**新增 D-07 超时 + D-04/D-05 记档条目**）。旧文错值已纠：company-lookup 参数 `keyword=`→`companyName`、`PUT /{id}`→`POST /edit?id=` 等 URL 全量重塑。
|
|
|
|
|
3. **HANDOFF 新篇**：`.scratch/customer-module/HANDOFF-2026-09-05.md`（正式收工篇，链接 RETEST-REPORT；旧 HANDOFF-2026-09-03 未改写）。
|
|
|
|
|
4. **crm-customer/CONTEXT.md**：无接口清单段（语言文档，URL 同步不适用）；同步的是能力事实——规则族「唯一规则」→「两族规则」+ 新增「客户查重设置」「战略协议」两个 Language 词条 + 首段补三形态偏好平台接线（scopeKey）。
|
|
|
|
|
5. **URL 对账零差异**：旧机 `tmp/dump_api.py` 未随仓（换机），现场重建 `.scratch/customer-rework/dump_api.py`（dump_api_out.txt：crm-customer 61 + crm-rule 客户族 4 + crm-preference 8 = 73）+ `recon_urls.py`（文档侧提取 verb+path 集合比对，剥查询串）——**73=73，missing 0 / stale 0**；crm-rule 非客户族 32 端点按交接篇 §2.1 范围口径显式排除（脚本内 RULE_SCOPE_ALLOW 白名单，非静默忽略）。
|
|
|
|
|
|
|
|
|
|
**验收线核对**：文档-代码对账零差异 ✅；旧 HANDOFF 不改写 ✅（customer-module/HANDOFF-2026-09-03.md 与 customer-rework 两篇交接均原样）；五项清单全勾 ✅。rework map 加 11 行 + Status 收官 → **整张 map 完结**。
|
