# 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](../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 §八](../e2e-report.md)。

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