tangweijie
3eccab2cf9
1. AGENTS.md 更新 - water-docs: 新增 specs/ 与 docs/design/ 生命周期规则章节 - water-backend: 更新协作引用（建设期/建成后、evidence 模块化） 2. specs/ 重复合并 - 006-reminder-event-design 合并入 003-rev006-reminder-event-design - 001-rev004-accounting 删除冗余 data-model.md + contracts/ - 002-rev005-invoice-flow 删除冗余 data-model.md + contracts/ 3. evidence 按模块归档 - 35 个 REV-004 文件归入 evidence/rev004-accounting/ - 7 个通用 bugfix 文件归入 evidence/bugfix/ 和 bugfix/frontend/ - 新建 rev005-invoice/、rev006-reminder/、rev007-statistics/ 目录 4. guides/ 清理 - 14 个 REV004_*.md 移入 evidence/rev004-accounting/ 5. 遗留文件处理 - docs/research/ 归档到 Archive/06_Migration_Plans/ - backend-check detached worktrees 清理 6. 交叉引用修复 - 006-reminder-event-design → 003-rev006-reminder-event-design - docs/guides/REV004_ → docs/evidence/rev004-accounting/REV004_ 7. DB 设计文档修正（01_Database_Design.md） - biz_invoice 明确为开票配置表，非发票记录表 - 新增 biz_invoice_record 为发票申请/结果主表 - 新增 biz_charge_invoice_rel 账单-发票关联说明 - REV-005 承接口径表名全部修正 8. 发票审计证据 - 新增 evidence/rev005-invoice/2026-06-16-invoice-document-audit.md
258 lines
7.6 KiB
Markdown
258 lines
7.6 KiB
Markdown
# REV004 / accountProcess 最终评审摘要（2026-04-13）
|
||
|
||
## 1. 评审目的
|
||
本摘要用于对外汇报 `REV004 / accountProcess` 当前后端交付状态，统一回答以下问题：
|
||
- 这一块后端接口是否已形成可联调的稳定口径？
|
||
- 关键页面/弹窗对应的接口是否已经落地？
|
||
- 真实数据库条件下，主链路是否已经被证明可运行？
|
||
- 当前仍有哪些剩余风险与建议后续动作？
|
||
|
||
---
|
||
|
||
## 2. 结论摘要
|
||
### 结论
|
||
`REV004 / accountProcess` 当前已经达到：
|
||
- **接口口径已基本收口**
|
||
- **页面/弹窗映射已梳理清楚**
|
||
- **主链路已完成真实数据库验证**
|
||
- **可进入联调 / 评审 / 阶段性验收**
|
||
|
||
### 当前结论边界
|
||
这里的“通过”是指：
|
||
- 后端接口已存在并按当前代码口径稳定返回
|
||
- 关键提交流程、撤销流程、日志二次动作、主要查询面均有真实库证据
|
||
- 不代表已经完成 UI 层面的最终视觉/交互验收
|
||
- 不代表所有页面文案、字典 label、边角筛选条件都已逐项核验
|
||
|
||
---
|
||
|
||
## 3. 当前已沉淀产物
|
||
### A. 集成测试累计证据
|
||
- `docs/evidence/rev004-accountprocess-integration-testing-bootstrap-2026-04-13.md`
|
||
|
||
### B. 接口真值矩阵
|
||
- `docs/evidence/rev004-accountprocess-interface-truth-matrix-2026-04-13.md`
|
||
|
||
### C. 页面元素勾稽矩阵
|
||
- `docs/evidence/rev004-accountprocess-ui-element-matrix-2026-04-13.md`
|
||
- `docs/evidence/rev004-accountprocess-dict-ui-consistency-summary-2026-04-13.md`
|
||
- `docs/evidence/rev004-accountprocess-page-label-audit-2026-04-13.md`
|
||
- `docs/evidence/rev004-accountprocess-ui-orchestration-checklist-2026-04-13.md`
|
||
|
||
### D. 真实库集成测试代码
|
||
- `sw-business-server/src/test/java/.../integration/rev004/accountprocess/Rev004AccountProcessCanaryQueryIntegrationTest.java`
|
||
|
||
---
|
||
|
||
## 4. 范围说明
|
||
本轮范围仅覆盖：
|
||
- `REV004/accountProcess`
|
||
|
||
具体包括四类页面/域：
|
||
- 预存调整（prestorage）
|
||
- 已销调整（sold）
|
||
- 未销调整（unsold）
|
||
- 账务日志（accountLog / log）
|
||
|
||
本轮明确不扩散到：
|
||
- accountProcess 之外的其它业务模块
|
||
- 全项目通用测试框架治理
|
||
- UI 自动化或前端渲染层验证
|
||
|
||
---
|
||
|
||
## 5. 环境口径
|
||
### 测试策略
|
||
- **数据库：真实 PostgreSQL**
|
||
- **数据库外依赖：替身化 / MockBean**
|
||
|
||
### 已明确替身边界
|
||
例如：
|
||
- `TransactionApi`
|
||
- `ApiErrorLogCommonApi`
|
||
- `DictDataCommonApi`
|
||
- `OperateLogCommonApi`
|
||
- `RedissonClient`
|
||
|
||
### 当前价值
|
||
这意味着：
|
||
- 账务状态变化、operat_log 留痕、查询回看等核心真值来自真实数据库
|
||
- 外部交易/缓存/公共 RPC 不会干扰主链路验证
|
||
|
||
---
|
||
|
||
## 6. 最新验证结果
|
||
### 最新 surefire 结果
|
||
- `Rev004AccountProcessCanaryQueryIntegrationTest`
|
||
- **21 tests / 0 fail / 0 skip**
|
||
- `Rev004AccountProcessIntegrationFixtureAssetsTest`
|
||
- **1 pass**
|
||
- `Rev004AccountProcessLiveDbReadinessTest`
|
||
- **1 pass**
|
||
|
||
### 最新整体验证结果
|
||
- `Rev004AccountProcess*`
|
||
- **总计 23 tests / 0 fail / 0 skip**
|
||
|
||
这代表当前仓库内，至少在真实数据库 + 外部依赖替身化前提下，主链路验证是通过的。
|
||
|
||
---
|
||
|
||
## 7. 主链路覆盖概览
|
||
### 7.1 prestorage
|
||
已验证：
|
||
- `prestorage-page`
|
||
- `prestorage-stat`
|
||
- `prestorage-detail`
|
||
- `prestorage-submit`
|
||
- `prestorage-revoke`
|
||
- `prestorage-process`
|
||
- `prestorage-attachments`
|
||
- 提交后 page/stat/detail/process/attachments 联动回看
|
||
|
||
已证明能力：
|
||
- 预存退款提交成功
|
||
- 余额真实回写
|
||
- 记录可回看
|
||
- 撤销后余额可恢复
|
||
|
||
### 7.2 sold
|
||
已验证：
|
||
- `sold-page`
|
||
- `sold-stat`
|
||
- `sold-submit`
|
||
- `sold-batch-revoke`
|
||
- 提交后 page/stat 能反映撤销能力
|
||
|
||
已证明能力：
|
||
- 已销调整申请可成功落日志
|
||
- 状态为 `PENDING_APPROVAL`
|
||
- 批量撤销以 `chargeIds[]` 可执行
|
||
|
||
### 7.3 unsold
|
||
已验证：
|
||
- `unsold-page`
|
||
- `unsold-stat`
|
||
- `unsold-adjust-submit`
|
||
- `unsold-split-submit`
|
||
- `unsold-late-fee-reduce-submit`
|
||
- `unsold-price-diff-submit`
|
||
- `unsold-bad-debt-submit`
|
||
- 调整后 page/stat 可回看金额变化
|
||
|
||
已证明能力：
|
||
- 五类未销动作 happy path 都可跑通
|
||
- 查询面能反映初始数据与提交后的更新结果
|
||
|
||
### 7.4 log / accountLog
|
||
已验证：
|
||
- `log-page`
|
||
- `log-stat`
|
||
- `log-detail`
|
||
- `log-process`
|
||
- `log-attachments`
|
||
- `log-refund`
|
||
- `log-prestorage`
|
||
- `log-revoke`
|
||
- 日志页 page/stat/detail/process/attachments 联动回看
|
||
|
||
已证明能力：
|
||
- 日志链路是当前最完整的一组闭环
|
||
- 支持二次动作（退款/转预存/撤销）
|
||
- 可查看流程摘要与附件引用
|
||
|
||
---
|
||
|
||
## 8. 页面 / 弹窗映射结论
|
||
### 已收口
|
||
目前页面与后端接口映射已经可明确回答：
|
||
- 哪个页面查哪个 `page/stat/detail`
|
||
- 哪个弹窗调哪个 `submit/revoke/process/attachments`
|
||
- 哪些动作依赖 `adjustmentNo`
|
||
- 哪些动作依赖 `chargeId/chargeIds`
|
||
|
||
### 特别提醒
|
||
- **已销批量撤销**：当前后端口径是 `chargeIds[]`，不是 `adjustmentNo[]`
|
||
- **日志页二次动作**：当前统一以 `adjustmentNo` 为主键
|
||
- **已销查询页** 本身不返回 `adjustmentNo`，若前端要保留申请单号，应使用提交返回值或转到日志视角查看
|
||
|
||
---
|
||
|
||
## 9. 接口字段口径结论
|
||
### 前端建议优先读取
|
||
对于动作提交类接口，前端建议主读：
|
||
- `adjustmentNo`
|
||
- `resultStatus`
|
||
- `approvalStatus`
|
||
- `writeBackStatus`
|
||
- `msg`
|
||
|
||
### 兼容字段
|
||
- `status`
|
||
- `message`
|
||
|
||
这些保留给旧调用方或兼容逻辑，不建议新页面作为主读来源。
|
||
|
||
### 预存工单状态口径
|
||
- `0 = 未处理`
|
||
- `1 = 已审核`
|
||
- `2 = 已完成`
|
||
- `3 = 已撤销`
|
||
|
||
### 页面状态与工单状态不要混用
|
||
- `prestorage-page.workOrderStatus` 是预存工单状态
|
||
- `log-page.statusCode/status` 是日志页状态投影
|
||
- 两者不是同一套语义
|
||
|
||
---
|
||
|
||
## 10. 当前最可信的证据类型
|
||
从强到弱排序：
|
||
1. **真实数据库 + MockMvc canary 测试**
|
||
2. **Controller / ReqVO / RespVO / Service 代码口径**
|
||
3. **矩阵文档归纳**
|
||
|
||
因此当前对外说法应以：
|
||
- 已跑通真实库的场景 = 强证据
|
||
- 仅代码里存在但未单独断言的字段 = 次强证据
|
||
|
||
---
|
||
|
||
## 11. 剩余风险 / 空白
|
||
### 仍未完全补齐
|
||
1. 字典 type / 值域已基本收口，剩余是页面文案逐页核对
|
||
2. 前端弹窗 A/B/C 切换路径尚未做 UI 编排级验证
|
||
3. 边角筛选条件并未全部逐项做真实库穷尽验证
|
||
|
||
### 风险等级判断
|
||
- **主功能联调风险：中低**
|
||
- **页面展示细节风险：中**
|
||
- **最终 UI 验收风险：中**
|
||
|
||
---
|
||
|
||
## 12. 对外建议说法
|
||
建议对前端 / 产品 / 评审会的说法：
|
||
|
||
> `REV004/accountProcess` 后端接口已基本收口，四条主链（prestorage / sold / unsold / log）均已有真实数据库验证证据；
|
||
> 当前可进入稳定联调和阶段性验收。
|
||
> 剩余工作主要集中在页面文案/字典展示的一致性核验，以及更贴近前端的 UI 编排级验证。
|
||
|
||
---
|
||
|
||
## 13. 建议下一步
|
||
按优先级建议：
|
||
1. 做页面文案 / 字典 label 的逐页验收核对
|
||
2. 已提供 UI 编排级验收清单，若需要再补自动化/UI录屏级验证
|
||
3. 评审会可直接使用本摘要 + 两份矩阵文档 + 集成测试证据 + 字典一致性摘要 + 页面文案核对表 + UI 编排验收清单
|
||
|
||
---
|
||
|
||
## 14. 关联文档
|
||
- `docs/evidence/rev004-accountprocess-integration-testing-bootstrap-2026-04-13.md`
|
||
- `docs/evidence/rev004-accountprocess-interface-truth-matrix-2026-04-13.md`
|
||
- `docs/evidence/rev004-accountprocess-ui-element-matrix-2026-04-13.md`
|
||
- `docs/evidence/rev004-accountprocess-dict-ui-consistency-summary-2026-04-13.md`
|
||
- `docs/evidence/rev004-accountprocess-page-label-audit-2026-04-13.md`
|
||
- `docs/evidence/rev004-accountprocess-ui-orchestration-checklist-2026-04-13.md`
|