fujian_water_biz_doc/docs/evidence/rev004-accounting/rev004-accountprocess-dict-ui-consistency-summary-2026-04-13.md

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 已与代码当前口径对齐
• 残留风险主要在旧快照/旧输出文件与前端展示层，而不在当前后端主实现