# 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`