diff --git a/docs/guides/REV004_GO_LIVE_CHECKLIST.md b/docs/guides/REV004_GO_LIVE_CHECKLIST.md new file mode 100644 index 0000000..fd60cb1 --- /dev/null +++ b/docs/guides/REV004_GO_LIVE_CHECKLIST.md @@ -0,0 +1,114 @@ +# REV004 上线前检查清单 / 联调问题清单 + +## 1. 当前基线 +### backend +- branch: `develop` +- latest verified merge: `ea159faa3bae2b7491d4e60cbe79e392e77e7345` + +### docs +- branch: `main` +- latest verified merge: `3741fd597df21c54356a1a09778074a8450c73cc` + +--- + +## 2. 已完成对象(当前可联调) +- prestorage +- bad debt +- writtenoff +- late fee reduce +- split adjust +- price diff +- redink + +说明:以上对象均已有主线 evidence 文档,可作为联调准入依据。 + +--- + +## 3. 上线前必查项 + +### A. 代码 / 构建 +- [ ] backend 当前部署分支确认包含:`ea159faa...` 及之后需要上线的提交 +- [ ] `mvn -pl sw-business/sw-business-server -DskipTests compile` 通过 +- [ ] 目标对象对应 targeted tests 通过 +- [ ] 关键接口 OpenAPI/Controller 路由与前端调用地址一致 + +### B. 数据库 / DDL +- [ ] 以下表在目标环境已存在: + - `biz_prestorage_adjust` + - `biz_prestorage_adjust_detail` + - `biz_bad_debt_adjust` + - `biz_bad_debt_adjust_detail` + - `biz_writtenoff_adjust` + - `biz_writtenoff_adjust_detail` + - `biz_latefee_reduce` + - `biz_latefee_reduce_detail` + - `biz_price_diff_adjust` + - `biz_price_diff_adjust_detail` + - `biz_redink_record` + - `biz_redink_record_detail` + - `biz_split_adjust` + - `biz_split_adjust_detail` +- [ ] 对应 deploy SQL 在目标环境幂等可重放 +- [ ] 字典已对齐前端绑定(尤其 `account_adjust_*`、`price_reason`、`redink_reason` 等) + +### C. 外部依赖 +- [ ] `business-bank-server` 可用(redink / refund 真实链路) +- [ ] Nacos 注册正常 +- [ ] Redis 可用 +- [ ] 目标环境数据库可写 +- [ ] 如涉及 XXL/定时组件,端口与注册不会冲突 + +### D. 联调 smoke +- [ ] prestorage:submit / revoke / page / detail / process / attachments +- [ ] bad debt:submit / approve / reject / page / detail +- [ ] writtenoff:submit / approve / reject / page / detail +- [ ] late fee reduce:submit / batch submit / page / detail +- [ ] split:submit / page / detail / result +- [ ] price diff:submit / approve / reject / page / detail +- [ ] redink:execute / get / page + +### E. 清理 +- [ ] 测试数据已清理 +- [ ] 临时端口实例已停止 +- [ ] evidence 已回写文档 + +--- + +## 4. 联调问题清单(当前已知) + +### 4.1 当前已闭环 +- prestorage `process / attachments` 已 strict formal-first +- redink 已补齐 live execute 成功补证 + +### 4.2 当前仍需关注 +- redink / refund 一旦切到真实环境,需确认 `business-bank-server` 服务实例与原交易数据确实可用 +- split 的 deploy SQL 来源需继续保持环境一致性(当前代码/对象域已独立,但表结构不在本轮 `sql/rev004` 内新增) +- 若未来要移除 legacy fallback,需先做历史数据兼容评估 + +--- + +## 5. 推荐联调顺序 +1. 字典与页面下拉/标签校验 +2. prestorage 全链路 +3. writtenoff / bad debt / price diff 审批链路 +4. redink live execute +5. split / late fee reduce 补充场景 + +--- + +## 6. 对外沟通口径(可直接复用) +> 当前 REV004 主线已经完成主要账务对象的 formal-table 恢复与查询真值收口,包含预存、坏账、已销/核销、违约金减免、分账、价差、红冲。\ +> 联调阶段请优先按各 evidence 文档验证目标环境的表结构、接口返回、fresh smoke 与清理结果;如涉及红冲/退款真实链路,请同时确认 `business-bank-server` 与原交易数据可用。 + +--- + +## 7. 证据索引 +- `docs/guides/REV004_FINAL_MAINLINE_DELIVERY_SUMMARY.md` +- `docs/guides/REV004_CURRENT_TRUTH_MATRIX.md` +- `docs/evidence/rev004-prestorage-formal-table-dev-db-apply-2026-04-16.md` +- `docs/evidence/rev004-prestorage-strict-formal-first-2026-04-17.md` +- `docs/evidence/rev004-bad-debt-formal-table-dev-db-apply-2026-04-17.md` +- `docs/evidence/rev004-writtenoff-formal-table-dev-db-apply-2026-04-17.md` +- `docs/evidence/rev004-price-diff-formal-table-dev-db-apply-2026-04-17.md` +- `docs/evidence/rev004-redink-formal-table-dev-db-apply-2026-04-17.md` +- `docs/evidence/rev004-latefee-formal-table-dev-db-apply-2026-04-15.md`