Merge PR #15: add REV004 go-live and joint-debug checklist\n\nConstraint: Keep the checklist aligned with verified mainline state and evidence set\nConfidence: high\nScope-risk: narrow\nDirective: Update this checklist only when mainline reality or release blockers change materially\nTested: PR #15 checklist cross-checked against final summary, truth matrix, and evidence set\nNot-tested: No document export/render pipeline executed at merge time

This commit is contained in:
tangweijie 2026-04-17 18:15:27 +08:00
commit 9946fa7572

View File

@ -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
- [ ] prestoragesubmit / revoke / page / detail / process / attachments
- [ ] bad debtsubmit / approve / reject / page / detail
- [ ] writtenoffsubmit / approve / reject / page / detail
- [ ] late fee reducesubmit / batch submit / page / detail
- [ ] splitsubmit / page / detail / result
- [ ] price diffsubmit / approve / reject / page / detail
- [ ] redinkexecute / 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`