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
09 · 终验收：联调就绪核验 + 报告聚合 + 移交
Type: task Status: resolved Blocked by: 05, 06, 08
Question
终验收，宣告「前端可联调」：
- 文档联调就绪核验脚本（对
D:\code\crm-api-docs\A4 客户管理\117 文件）：- 全仓 grep「非真实返回」= 0
- 嵌套 DTO 引用行全部有展开（grep
List<[A-Z]字段表行后必须跟子表/点路径行） - 字段表说明质量阈值过（票 06 口径）
- 结构对账：117/117 文件完整（meta/请求参数/字段表/示例四件套齐全），与 API-SUMMARY / 跨模块端点清单零缺零余
- 聚合报告
integration-ready-report.md：e2e r3 基线 + specimens 真值化 + 文档核验结果 + 原型台账 + 票 08 处置落点，单入口 - 移交前端：联调注意事项（鉴权 debug token、脱敏口径、乐观锁错误码、二进制端点用法）+ 双仓未提交变更清单（后端 @Schema + 文档仓写回，等用户审查提交）
产物：核验脚本 + 报告 + 移交清单。
Answer
终验收三件套齐备，宣告 A4 客户模块「前端可直接联调」：
- 核验：
verify_integration_ready.py六项全过——V1 结构对账 118↔118 零缺零余（含票 10 新增关联项目页签.bru）/ V2「非真实返回」0 命中 / V3 四件套 0 缺节（3 个二进制端点按票 05 口径豁免示例节）/ V4 嵌套 DTO 展开 0 缺子表 / V5 说明质量 0 空行断行 / V6 BOM 0 →verify-integration-ready.jsonALL_PASS。收口会话复跑复核：VERIFY_EXIT=0，ALL_PASS 保持。 - 报告：
integration-ready-report.md八章单入口——结论 / E2E 基线（r3 295 checks 0 回归 + 票 10 增量 58 checks + 265/265 模块测试）/ 文档真值化四票接力 / 原型处置落点 / 前端联调注意事项 10 条 / 双仓未提交清单 / 环境复跑指南 / 产物索引。 - 移交：鉴权 debug token、ADR-0017 扁平动词 + 表单绑定、雪花 id 字符串出参、脱敏 + reveal 明文端点、乐观锁 67005/67018、二进制端点 responseType:'blob'、N5 前端自带国标码表、记档项 G1-G6/N4/D-G1、字典驱动、demo 参考实现。
交付态事实：8080 在跑 verify profile（jar 2026-09-11 15:58 重建，含票 10 全部修复，收口时实测 LISTENING）；文档仓 117 个 .bru 修改 + 新目录 客户详情/关联项目/；后端 15 改 + 3 新 java + demo index.html（git status 实测与报告 §六逐一相符）。双仓均未提交，等用户审查。
验收口径：用户拍板 demo 走查。demo_walkthrough.py 于 8080 运行态 23/23 全绿（2026-09-11 16:38）：鉴权 / CRUD+67005 / 脱敏+reveal / 图谱 N1+N2+67018 / 关联项目 N3 / 三文档对拍全覆盖 / 正门清理。记录 demo-walkthrough.md（含 8 条实跑契约要点：edit 相似名闸门、contact data 直出 id、phone vs phoneMasked 字段名分场景、等级上级>下级、联系人自动落图、计数字符串出参、归档≠删除、冲突文案）+ 全量请求响应 demo-walkthrough-log.txt。报告 §五脱敏字段名已按实跑修正。夹具残留归零。用户验收通过，本图收官。