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
6.5 KiB
6.5 KiB
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逐页确认的点
- 未销页
waterType是否需要从编码升级为可读 label。 - 预存页
adjustmentType的页面中文文案是否已有既定口径。 - 日志页
processMethod/status是否与现有页面视觉稿/原型文案完全一致。 - 历史页面或旧截图中若还出现“处理中”这类旧三态文案，应以后端新四态口径为准重新校对。
7. 结论
- 当前状态字典与核心文案来源已经收口，后端没有明显“真值不清”的问题。
- 剩余问题主要不在后端结构，而在：
- 页面展示是否直接使用后端返回文案
- 前端是否仍残留旧页面文案/旧字典绑定
- 某些编码字段是否还需要做前端可读化处理