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.
149 Commits
1 Branch
0 Tags
405 MiB
 
 
 
 
 
 
Tree: a9f708f205
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'a9f708f205'
${ noResults }
crm-backend-matt/.scratch/customer-rework/issues/11-docs-sync.md

3.9 KiB
Raw Blame History

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 要求的文档同步，收尾统一校验（各票随修随改，本票终验）。

清单

  • map.md（冻结图）：末尾增补「返工增补」段——R1–R11 决策指针（→ .scratch/customer-rework/map.md）+ 每张返工票执行结果的增量决策条目；
  • API-SUMMARY.md：全部端点 URL/方法/参数表按 02 号票改造后形态重写；§5 已知缺口清单销账（confirmSimilar、查重设置端点）；新增：形态偏好端点、列偏好 scopeKey、查重设置端点；
  • HANDOFF-*.md：新篇（日期=收工日）记录返工范围/决策/测试结果，链接 RETEST-REPORT；
  • crm-customer/CONTEXT.md（若存在接口清单段落）：同步新 URL 契约 + 偏好能力说明；
  • 交叉检查：文档中的 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 完结。