# REV004 / accountProcess 页面文案与字典 label 核对表（2026-04-13）

## 1. 目的
本表站在前端/UAT 视角，回答：
- 页面上显示的文案/标签，当前应从哪个字段读取？
- 该字段是原始编码、字典 label，还是代码 fallback 值？
- 当前是否已具备稳定真值来源？

> 说明：本表是“字段/label 来源核对”，不是视觉稿验收。

---

## 2. 预存调整页
| 页面展示项 | 建议展示来源 | 类型 | 当前真值来源 | 状态 |
|---|---|---|---|---|
| 工单状态 | `workOrderStatus` -> `work_status` label | 字典 label | `DictTypeConstants.WORK_STATUS` + 正式设计文档 + seed SQL | 已确认 |
| 调整类型 | `adjustmentType` | 业务枚举/旧口径 | 代码已有字段，但 label 映射未单列文档 | 待前端确认展示文案 |
| 客户编号/名称/地址 | `custCode/custName/custAddress` | 直接值 | DB 真值 | 已确认 |
| 调整余额/期初/期末余额 | `adjustAmount/preBalance/postBalance` | 直接值 | DB 真值 | 已确认 |
| 是否可撤销 | `canRevoke` | 布尔能力 | Service 推导 | 已确认 |
| 是否可查看附件 | `canViewAttachment` | 布尔能力 | Service 推导 | 已确认 |
| 提交成功提示 | `msg` | 文本 | Action 返回 | 已确认 |
| 详情结果状态 | `resultStatus` | 字典 label 候选 | 当前后端主要返回 code；前端如需文案应绑 `account_adjust_result_status` | 已确认 |
| 详情审批状态 | `approvalStatus` | 字典 label 候选 | 绑 `account_adjust_approval_status` | 已确认 |
| 详情回写状态 | `writeBackStatus` | 字典 label 候选 | 绑 `account_adjust_writeback_status` | 已确认 |

### 预存页当前结论
- 工单状态四态已稳定：`0未处理 / 1已审核 / 2已完成 / 3已撤销`
- 详情三状态字段推荐前端统一走 REV004 新字典做 label 显示
- `prestorage-process / prestorage-attachments` 已有真实库证据，页面已具备展示基础

---

## 3. 已销调整页
| 页面展示项 | 建议展示来源 | 类型 | 当前真值来源 | 状态 |
|---|---|---|---|---|
| 用水性质 | `waterNature` | 当前为模板名/编码映射 | `PriceTemplate` 名称映射 | 已确认 |
| 收费方式 | `collectionMethod` | 字典 label | `charge_method` | 已确认 |
| 收费员 | `collector` | 直接值 | DB 字段 | 已确认 |
| 是否可调整 | `canAdjust` | 布尔能力 | Service 推导 | 已确认 |
| 是否可批量撤销 | `canBatchRevoke` | 布尔能力 | Service 推导 | 已确认 |
| 提交结果状态 | `resultStatus` | 字典 label 候选 | `account_adjust_result_status` | 已确认 |
| 提交审批状态 | `approvalStatus` | 字典 label 候选 | `account_adjust_approval_status` | 已确认 |

### 已销页当前结论
- 收费方式文案应以后端经 `charge_method` 解析后的 `collectionMethod` 为准
- 已销提交后的审批态展示建议直接使用返回 code + 新字典映射 label
- 批量撤销按钮能力应以后端 `canBatchRevoke` 和 `chargeIds[]` 入参约束为准

---

## 4. 未销调整页
| 页面展示项 | 建议展示来源 | 类型 | 当前真值来源 | 状态 |
|---|---|---|---|---|
| 用水性质 | `waterType` | 当前为模板编码 | 代码直接回 `priceTemplateCode` | 待前端决定是否需要 label 化 |
| 合计金额/账单金额/违约金 | `totalAmount/billAmount/penaltyAmount` | 直接值 | DB 真值 | 已确认 |
| 五类按钮显隐 | `canAdjust/canSplit/canLateFeeReduce/canPriceDiffAdjust/canBadDebtAdjust` | 布尔能力 | Service 推导 | 已确认 |
| 调整原因 | `applyReason -> 动态 reason 字典` | 字典 label | 见 REV004_DICT_BINDING_MATRIX | 已确认 |
| 分账原因 | `applyReason -> separate_reason` | 字典 label | 见 REV004_DICT_BINDING_MATRIX | 已确认 |
| 违约金减免原因 | `applyReason -> late_fee_reason` | 字典 label | 见 REV004_DICT_BINDING_MATRIX | 已确认 |
| 价差调整原因 | `applyReason -> price_reason` | 字典 label | 见 REV004_DICT_BINDING_MATRIX | 已确认 |
| 呆坏账原因 | `applyReason -> knotty_reason` | 字典 label | 见 REV004_DICT_BINDING_MATRIX | 已确认 |

### 未销页当前结论
- 五类弹窗的“原因”不能共用一个字典，应按 objectType/弹窗类型动态切换
- `waterType` 当前更像编码字段，如果前端要展示“中文用水性质”，需要确认是否再做模板名映射

---

## 5. 账务日志页
| 页面展示项 | 建议展示来源 | 类型 | 当前真值来源 | 状态 |
|---|---|---|---|---|
| 账务类型 | `accountType` | 字典 label | `account_adjust_object_type` | 已确认 |
| 处理方式 | `processMethod` | 代码映射 label | Service 内 legacy 映射 | 已确认 |
| 页面状态 | `status/statusCode` | 字典/兼容投影 | success/pending/rejected 由 Service 投影 | 已确认 |
| 目标户号 | `targetCustCode` | 直接值 | 日志明细/业务上下文 | 已确认 |
| 原/新预存、账单、水量、违约金 | 对应 original/new 字段 | 直接值 | DB + log detail 推导 | 已确认 |
| 是否可撤销/退款/预转存 | `canRevoke/canRefund/canPrestore` | 布尔能力 | Service 推导 | 已确认 |
| 结果状态 | `resultStatus` | 字典 label 候选 | `account_adjust_result_status` | 已确认 |
| 审批状态 | `approvalStatus` | 字典 label 候选 | `account_adjust_approval_status` | 已确认 |
| 回写状态 | `writeBackStatus` | 字典 label 候选 | `account_adjust_writeback_status` | 已确认 |
| 附件状态 | `resolved/message` | 直接值 | Attachment 解析逻辑 | 已确认 |

### 日志页当前结论
- `accountType` 与 `resultStatus/approvalStatus/writeBackStatus` 已有稳定字典来源
- `processMethod` 目前是代码映射，不完全等于字典 label，需要前端按当前返回文案展示，不建议自行二次翻译
- 日志页是当前最适合承接“状态展示 / 二次动作 / 留痕回看”的页面

---

## 6. 当前仍需前端/UAT逐页确认的点
1. 未销页 `waterType` 是否需要从编码升级为可读 label。
2. 预存页 `adjustmentType` 的页面中文文案是否已有既定口径。
3. 日志页 `processMethod/status` 是否与现有页面视觉稿/原型文案完全一致。
4. 历史页面或旧截图中若还出现“处理中”这类旧三态文案，应以后端新四态口径为准重新校对。

---

## 7. 结论
- 当前**状态字典与核心文案来源已经收口**，后端没有明显“真值不清”的问题。
- 剩余问题主要不在后端结构，而在：
  - 页面展示是否直接使用后端返回文案
  - 前端是否仍残留旧页面文案/旧字典绑定
  - 某些编码字段是否还需要做前端可读化处理