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