# REV004 / accountProcess 字典 label 与 UI 文案一致性摘要（2026-04-13）

## 1. 目的
本摘要用于收敛 `accountProcess` 当前涉及的状态/标签类字段，确认：
- 代码侧字典 type 是否已统一
- 正式文档口径是否与代码一致
- 是否仍存在旧快照 / 旧产出中的历史口径残留

---

## 2. 当前已确认一致的口径

### A. 工单状态 `work_status`
代码侧：
- `DictTypeConstants.WORK_STATUS = "work_status"`
- 口径：`0-未处理 / 1-已审核 / 2-已完成 / 3-已撤销`

正式 SQL seed：
- `../water-docs/sql/rev004_account_adjust_dict_seed.sql`
- 已定义：
  - `0 -> 未处理`
  - `1 -> 已审核`
  - `2 -> 已完成`
  - `3 -> 已撤销`

正式数据库设计文档：
- `../water-docs/docs/design/03_Technical_Design/01_Database_Design.md`
- 当前已同步为四态：
  - `0-未处理（工单创建，待审核/待处理）`
  - `1-已审核（审核通过/无需审批，待完成）`
  - `2-已完成（处理成功且已回写完成）`
  - `3-已撤销（工单已撤销）`

结论：
- **代码 / seed SQL / 正式设计文档：已一致**

### B. REV004 账务调整核心状态字典
已确认存在统一 type：
- `account_adjust_object_type`
- `account_adjust_result_status`
- `account_adjust_approval_status`
- `account_adjust_writeback_status`

代码侧使用：
- `AccountingAdjustLogProcessServiceImpl`
- `AccountingAdjustSoldProcessServiceImpl`
中均已通过 `DictFrameworkUtils.parseDictDataLabel(...)` 或统一映射读取 label

正式 SQL seed：
- `../water-docs/sql/rev004_account_adjust_dict_seed.sql`
- 已定义：
  - objectType：如 `PREPAID_REFUND / REDINK_RECORD / BAD_DEBT_RECORD / WRITTENOFF_ADJUST / PRICE_DIFF_ADJUST / LATE_FEE_REDUCE / SPLIT_ADJUST`
  - resultStatus：`SUCCESS / PENDING_APPROVAL / FAIL`
  - approvalStatus：`NOT_REQUIRED / PENDING_APPROVAL / APPROVED / REJECTED`
  - writeBackStatus：`UPDATED / PENDING / SKIPPED`

结论：
- **REV004 核心状态字典类型与值域已成套收口**

### C. 收费方式 `charge_method`
代码侧：
- `DictTypeConstants.CHARGE_METHOD = "charge_method"`
- 已在 `AccountingAdjustSoldProcessServiceImpl` 中作为列表展示 label 来源

正式文档：
- `../water-docs/sql/lhc_数据库设计.md`
- `../water-docs/docs/design/04_Appendix/Archive/03_Design_Docs/数据库设计.md`
中可见 `charge_method` 语义为收费途径/收费方式

结论：
- **当前 sold 查询页“收费方式”展示依赖路径明确，代码口径稳定**

---

## 3. 当前已确认的“动态原因字典”绑定口径
参考：
- `../water-docs/docs/guides/REV004_DICT_BINDING_MATRIX.md`

当前已明确：
- `PREPAID_REFUND -> deposit_reason`
- `REDINK_RECORD -> redink_reason`
- `BAD_DEBT_RECORD -> knotty_reason`
- `WRITTENOFF_ADJUST -> payment_reason`（过渡复用）
- `PRICE_DIFF_ADJUST -> price_reason`
- `LATE_FEE_REDUCE -> late_fee_reason`
- `SPLIT_ADJUST -> separate_reason`

结论：
- **前端原因下拉不应绑定一个统一 reason 字典，而应按 objectType 动态切换**

---

## 4. 当前仍存在的不一致 / 残留风险

### A. 历史快照文档仍残留旧三态 `work_status`
在旧归档快照中，仍能看到：
- `../water-docs/docs/design/04_Appendix/Archive/08_Formal_Doc_Snapshots/RWB-02/2026-04-03-RWB-02-01_Database_Design.md`
- 其中 `work_status` 仍写作：`0-待处理 / 1-处理中 / 2-已完成`

这与当前正式口径不一致。

结论：
- **历史快照存在旧口径残留，但不应再作为当前真值来源**

### B. output 产物也有旧口径残留
例如：
- `../water-docs/output/01_Database_Design_processed.md`
中仍可见旧三态 `work_status`

结论：
- **产出型文件存在滞后，需要明确“正式设计文档 + REV004 seed + 代码”为真值源**

### C. UI 文案一致性尚未逐页核验
虽然字典 type / 值域已统一，但还没有逐页确认：
- 页面上显示的是字典 label 还是代码 fallback 值
- 页面文案是否与字典 label 完全一致
- 历史页面是否仍在用旧文案（例如“处理中”）

结论：
- **字典结构已较稳定，但 UI 最终展示一致性仍需前端/UAT 联合核验**

---

## 5. 当前建议真值源优先级
建议按以下优先级使用：
1. **后端代码中的 DictTypeConstants + Service 映射逻辑**
2. **`rev004_account_adjust_dict_seed.sql`**
3. **正式技术设计文档 `01_Database_Design.md`**
4. 历史快照 / output 产物（仅供追溯，不作为当前真值）

---

## 6. 对前端 / UAT 的建议
1. `work_status` 统一按四态使用：
   - 0 未处理
   - 1 已审核
   - 2 已完成
   - 3 已撤销
2. `objectType / resultStatus / approvalStatus / writeBackStatus` 使用 REV004 新字典，不再依赖旧业务大类字段硬编码。
3. “原因”下拉必须按 `objectType` 动态切换，不要做单字典通配。
4. 若页面仍显示“处理中”等旧文案，应优先视为前端展示遗留，而不是后端当前真值。

---

## 7. 当前结论
- **核心字典 type 与值域已基本收口**
- **正式文档与 seed SQL 已与代码当前口径对齐**
- **残留风险主要在旧快照/旧输出文件与前端展示层，而不在当前后端主实现**