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.
3.1 KiB
3.1 KiB
联调 demo 走查记录（票 09 用户验收 · 2026-09-11）
环境：localhost:8080 verify profile（jar 2026-09-11 15:58 重建，含票 10 全部修复）+ 远程共享库 8.129.84.155。
脚本：demo_walkthrough.py（纯 API 级，即前端联调所见契约）；全量请求/响应 → demo-walkthrough-log.txt。
结果：23/23 全绿（16:38 终轮；此前四轮为脚本本身调试——industryCode 缺失 / 13 位电话 / 等级语义反置 / 断言笔误，非产品问题）。
走查步骤与结果
| # | 链路 | 要点 | 结果 |
|---|---|---|---|
| ① | 鉴权 | debug token → Bearer | PASS |
| ② | 核心 CRUD | create 表单绑定 / detail 全字段回显 / edit 带 version / 旧 version → 67005 | PASS |
| ③ | 脱敏/明文 | contact create（data 直出 id 字符串）/ 列表 phone 即脱敏值 / reveal 明文 |
PASS |
| ④ | 图谱 | 联系人自动落图 / save 建边 / N1 isInternal+giftRemark 出参 / N2 oplog GRAPH_EDIT / 旧 version → 67018 | PASS |
| ⑤ | 关联项目 N3 | project/page 反查 crm-project 真数据（阶段/状态/报备名回退链）/ detail-head.projectCount='1' | PASS |
| ⑥ | 文档对拍 | 《关联项目页签》15/15、《图谱全量读》13/13、《详情公共头部》23/23 文档示例字段 ⊆ 实跑响应 | PASS |
| ⑦ | 清理 | 项目夹具行 DB 删 + 客户 archive 正门（oplog ARCHIVE 行复核） | PASS |
走查反证的实跑契约要点（全部能在文档找到出处）
- edit 也走相似名闸门：
needConfirm=true + similarHits（code=0，未落库），带confirmSimilar=1重发才应用；命中含已归档客户（archiveStatus=2）——《编辑客户.bru》已写明。 - contact create 成功时
data直接是 id 字符串，非对象。 - 脱敏字段名分场景：联系人列表/详情出参
phone字段即脱敏串（130****5693）；图谱节点出参才叫phoneMasked；明文一律走 reveal。→ 报告 §五第 4 条已据此修正。 - 图谱等级语义：上级等级数值须严格大于下级（
1 ≤ 2报 67019 等级倒挂）。 - 联系人创建即自动落图：graph version 随 CONTACT_ADD 递增（非首读空白懒建）。
- 计数类一律字符串出参：
projectCount='1'、total='1'（ADR 长整型字符串口径，防 JS 精度丢失）。 - 归档 ≠ 删除：archive 后 detail/oplog 仍可读，oplog 落 ARCHIVE 行；归档客户对图谱读不可见（67002）。
- 冲突文案实测：67005「客户已被他人修改，请刷新后重试」/ 67018「图谱已被他人修改（版本冲突），请刷新后重试」。
对拍口径说明
《图谱全量读》对拍为 13/13「文档示例字段 ⊆ 实跑」且实跑恰多 edges[].parentId/childId 两键——纯数据态差异（走查建了真实边，文档示例 edges 为空），顶层键 version/nodes/edges 两侧完全一致，无契约漂移。
残留
全部归零：走查客户 5 例全走 archive 正门（含崩溃轮残留 753654021008392192），项目夹具行即插即删。归档夹具在回收站可查（e2c-集成走查-*）。