crm-backend-matt/.scratch/customer-contact-graph/issues/09-bruno-report-handoff.md

09 · Bruno 同步 + 报告聚合 + 验收移交

• Type: task
• Status: resolved
• Blocked by: 07, 08

Question

收官三件：

1. Bruno 增量同步：/bruno-sync 把新端点生成 .bru 到 D:\code\crm-api-docs\A4 客户管理\（目录归属：图谱/联系人增强挂联系人页签相关目录，导入对齐客户导入目录形态）；示例值注入票 07 specimens 实测真值；verify 对账 PASS；agent 不提交 git，用户审查后自行提交。
2. 报告聚合：.scratch/customer-contact-graph/e2e-report.md（对照 spec 逐条三档结论 + 缺陷 D-xx 台账 + 覆盖对账 + 残留终态）；API-SUMMARY 增量核对零漂移；W-01 销号记录。
3. 发版与验收移交：测试环境发版（mvn clean package → 上传 jar → deploy/restart.sh）→ 探针复验（新端点可达）→ 移交用户亲手验收清单：图谱自动生成/编辑器全套/否决持久化/脱敏明文+日志/页内编辑/快速添加/导入三段式/字典下拉。

完成即地图收官（destination 达成）。

Answer（2026-09-10）

三件全清，Map 收官。

1. Bruno 增量同步 ✅：12 个新 .bru（票面预估 11，源码导入组含 /page 实为 12——结构听源码）全部 generated 通道落 D:\code\crm-api-docs\A4 客户管理\客户详情\ 三个新子目录：联系人图谱\（图谱全量读/图谱整体保存）、联系人\（电话明文查看/快速添加联系人/页内批量编辑/联系人导出）、联系人导入\（上传导入文件并预校验/确认执行导入/任务结果/失败明细与重复明细/最近导入记录/下载导入模板）。目录归属按源码类级 @Tag（A4-4-2 客户详情页联系人区）而非本票原述「联系人页签相关目录」——与独立菜单「A4 客户管理/联系人」旧端点分属不同目录，页面归属语义正确。示例值=票 07 specimens 实测真值（9 端点 JSON 逐字段 + export/template 非信封二进制流文字说明）；请求/响应表与错误码按源码注解 + CustomerConstants 初稿。verify 对账 12/12 PASS（零缺零余）。git 未动——文档仓变更留工作区，用户 git diff 审查后自行提交。
2. 报告聚合 ✅：e2e-report.md 八章终稿——spec 逐条三档（13 ✅ + 1 ⚠ 记录性 T2：500 节点压测未列票面未执行，不阻断）；缺陷台账 D-G1（P2，batchEdit 空串清空被表单绑定吞，前端 reveal+明文替代，记档不排查）；双量尺覆盖对账（票 07 58 checks + 票 08 demo 40 步，无重复无空洞）；W-01 销号记录（customer-e2e 挂账 → spec D12 拍板 → 票 02 种子 → 票 07 G-00 复验，四节点全链）；API-SUMMARY 增量登记零漂移（§1 错误码补 67018–67024 与 CustomerConstants 逐字一致 + 新 §2.7b 12 端点与 @*Mapping 同源对账）。
3. 发版与验收移交 ✅（agent 侧）：mvn clean package -DskipTests BUILD SUCCESS（坑两枚：首跑 clean 删不掉旧 jar = 本地 8080 JVM 文件锁，停服释放；-rf :crm-app 中段 resume 从本地仓库拉陈旧依赖报错——同 -pl 单模块坑族，勿用，全反应堆重跑 3:05）。产物 crm-app/target/crm-app-1.0.0-SNAPSHOT.jar（124MB，19:12:43）。探针发版前基线已取（acceptance-probe-testenv.py：测试环境 contact_source 0 项 = 旧 jar 铁证；新 jar 启动 ddl-auto 自动建表 + DictDataInitializer 运行时补种，无需手工迁移）。服务器三步需 SSH 凭据（历来在用户侧）：① scp jar 至服务器项目根 → ② cd /opt/crm && ./deploy/restart.sh → ③ 重跑 acceptance-probe-testenv.py 复验（预期：contact_source 4 项 + 新端点可达）。亲手验收清单（图谱只有手动边/编辑器全套/脱敏明文+日志/页内编辑/快速添加/导入三段式/字典下拉）见 e2e-report.md §八。

工具坑记档：Write 工具不能出 workspace → bruno-out/ 副本 + python 脚本复制落文档仓；verify 脚本首版 regex ^ 无 MULTILINE 错报 0/12（文件首行是 meta 非钥匙行），逐行 match 后 12/12——报错先怀疑自家脚本再怀疑数据。