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.
47 lines
3.4 KiB
47 lines
3.4 KiB
1 day ago
|
# 06 — 收官移交（报告 + 发版 + 用户亲手验收指北）
|
||
|
|
|
||
|
|
Type: task
|
||
|
|
Status: resolved
|
||
|
|
Blocked by: 04, 05
|
||
|
|
|
||
|
|
## Question
|
||
|
|
|
||
|
|
收官移交，交用户在主 demo 亲手验收：
|
||
|
|
|
||
|
|
- 报告：e2e-report 增章（本 effort 台账 + 复跑结果）或新报告（票 04 产物齐后定形态）；API-SUMMARY 收口零漂移复核。
|
||
|
|
- 文档盘点：本 effort 是否涉 CONTEXT.md / 新 ADR（票 03 修复若动架构须补；纯字段/bug 修复则不动）。
|
||
|
|
- 发版：jar 重建（clean 全反应堆）+ 发版移交清单（scp jar → `./deploy/restart.sh` → `acceptance-probe-testenv.py` 复验对比基线）。
|
||
|
|
- 验收指北：本地起服保持运行 + 主 demo 亲手验收清单（入口/账号/每步看什么，对齐 e2e-report §八形态）。
|
||
|
|
- handoff 文档落 `.scratch/customer-frontend-handover/`（沿用 customer-contact-graph handoff 形态：一句话状态 + 权威入口 + 余项 + 环境事实）。
|
||
|
|
|
||
|
|
## Answer
|
||
|
|
|
||
|
|
2026-09-11。五项全交付，全图收官。
|
||
|
|
|
||
|
|
### 1. 报告：e2e-report 增章 + API-SUMMARY 零漂移复核
|
||
|
|
|
||
|
|
- `.scratch/customer-e2e/e2e-report.md` 增 **§九移交增章**：9.1 复跑台账（四套件 + 冒烟结果表）/ 9.2 Bruno 对账 / 9.3 验收增量五点 / 9.4 亲手指北；§八旧表中的 D:\ 旧机器 Bruno 路径以本章 E:\ 为准。
|
||
|
|
- API-SUMMARY 收口零漂移：§2.1 已含 focusFlag 登记（票 01 当轮写入）+ §2.12 必填前移（票 03）+ 85 端点对账 PASS（对账脚本提取源即本契约，等于契约↔文档双向对上）。
|
||
|
|
|
||
|
|
### 2. 文档盘点：CONTEXT.md / ADR 均不动
|
||
|
|
|
||
|
|
- crm-customer/CONTEXT.md 为概念/边界级文档（无逐字段清单），focusFlag 属纯字段级补列，无概念或边界变化 → 不动。
|
||
|
|
- 无新 ADR：票 03 修复为行为 bug（预检时机）非架构决策；票 05 目录归位遵循既有 ADR-0024，裁决理由已在票 05 Answer 记档。
|
||
|
|
|
||
|
|
### 3. 发版
|
||
|
|
|
||
|
|
- jar：复用票 04 全反应堆 clean package 产物（`crm-app/target/crm-app-1.0.0-SNAPSHOT.jar`，124MB，2026-09-11 0:57）；其后仅有票 05 两行 @Tag 注释级差异（springdoc 文档分组，无运行时行为影响）。**发版正确时点 = 用户提交 git 后重建**（清单第 0 步注明，命令已给），当前产物直接用亦可。
|
||
|
|
- 发版移交清单落 `handoff-2026-09-11.md`：scp jar 至服务器项目根 → `./deploy/restart.sh`（仅重建 crm-app）→ `acceptance-probe-testenv.py` 四件事复验 + 本图新增新鲜度手验（workspace/page 出参含 focusFlag = 票 01 已上）。
|
||
|
|
|
||
|
|
### 4. 验收指北
|
||
|
|
|
||
|
|
e2e-report §9.4：起服（verify profile，探针 ping 401=鉴权门活着）→ demo `?api=http://localhost:8080` → 页头 uid 直登（管理员 739564171091247104 罗伟健，debug token 免登）→ 步卡（列表/关注星标/详情页签/联系人面板五动作/图谱编辑/导入三段式/交割两段）→ 看什么（console 无 error、字段与 Bruno docs 一致、写操作 oplog 有痕）。
|
||
|
|
|
||
|
|
### 5. handoff 文档
|
||
|
|
|
||
|
|
`handoff-2026-09-11.md` 已落本目录：一句话状态 + 权威入口表 + 用户三步（审查提交/亲手验收/发版）+ 发版清单 + 余项记档 + 环境事实。
|
||
|
|
|
||
|
|
### 全图终态
|
||
|
|
|
||
|
|
01–06 全 resolved；Destination 五条达成：① focusFlag ✅ ② demo 单入口 12 端点+关注列 ✅（冒烟 35/35）③ E2E 全绿复跑 ✅ ④ A4 审计零缺接口、P1 清零 ✅ ⑤ Bruno 85/85 零缺零余 + 原型树对齐 ✅。双仓 git 留用户审查提交。
|