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