# REV004 字典绑定矩阵

## 1. 文档目的

本文件用于明确 REV004 当前接口、前端查询条件与下拉口径，应如何绑定到系统字典。

原则：
- 旧字典能承接的继续承接；
- 旧字典承接不了的，仅最小新增；
- 不迁移旧字典体系；
- 不要求所有旧页面一次性切换。

---

## 2. 本轮新增字典

| 字典类型 | 用途 |
|---|---|
| `redink_reason` | 红冲/冲正原因 |
| `account_adjust_object_type` | REV004 当前开放对象类型 |
| `account_adjust_result_status` | REV004 结果状态 |
| `account_adjust_approval_status` | REV004 审批状态 |
| `account_adjust_writeback_status` | REV004 回写状态 |

---

## 3. 继续复用的旧字典

| 字典类型 | 用途 |
|---|---|
| `deposit_reason` | 预付费退款原因 |
| `late_fee_reason` | 违约金减免原因 |
| `price_reason` | 价差调整原因 |
| `separate_reason` | 分账/拆分原因 |
| `separate_type` | 分账调整方式（按水量 / 按费用组成） |
| `knotty_reason` | 呆坏账原因 |
| `knotty_type` | 呆坏账类型（呆账/坏账/纠纷账） |
| `payment_reason` | 已销/核销调整原因（当前作为核销调整过渡复用） |
| `proc_type` | 账务处理方式 |
| `business_type` | 业务大类归属 |

---

## 4. REV004 接口字段绑定矩阵

### 4.1 核心接口字段

| 字段 | 字段语义 | 绑定字典 | 说明 |
|---|---|---|---|
| `objectType` | 调整对象 | `account_adjust_object_type` | 前端对象筛选、标签显示、下拉选择主来源 |
| `resultStatus` | 处理结果状态 | `account_adjust_result_status` | 前端结果状态筛选、展示主来源 |
| `approvalStatus` | 审批状态 | `account_adjust_approval_status` | 前端审批角标/审批筛选主来源 |
| `writeBackStatus` | 回写状态 | `account_adjust_writeback_status` | 前端回写状态展示与筛选主来源 |
| `reasonCode` | 调整原因编码 | **按 objectType 动态绑定** | 不统一绑一个 reason 字典，而是按对象类型切换 |

---

### 4.2 `reasonCode` 动态绑定规则

| objectType | 绑定字典 | 说明 |
|---|---|---|
| `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` | 复用分账调整原因 |

---

### 4.3 与辅助类型字段的关系

| 使用场景 | 字段/语义 | 绑定字典 |
|---|---|---|
| 违约金减免二级方式 | 按金额 / 按日期 | `late_fee_type` |
| 分账调整二级方式 | 按水量 / 按费用组成 | `separate_type` |
| 呆坏账细分类型 | 呆账 / 坏账 / 纠纷账 | `knotty_type` |
| 账务结果处理动作 | 转预存 / 转退款 / 转销账 / 线下退款 | `proc_type` |
| 历史业务归类 / 大类筛选 | 预存调整 / 呆坏账 / 违约金减免 / 价差调整 / 已销调整 / 分账调整 | `business_type` |

> 说明：`business_type` 不作为 `objectType` 的替代来源。
> `objectType` 以 `account_adjust_object_type` 为主，`business_type` 仅作为旧页面/旧日志/业务大类归类兼容口径。

---

## 5. 前端下拉与查询接入建议

### 5.1 建议读取接口

- 字典数据接口：
  - `GET /admin-api/system/dict-data/simple-list`

### 5.2 页面建议

#### REV004 查询页
- 对象类型下拉：`account_adjust_object_type`
- 结果状态下拉：`account_adjust_result_status`
- 审批状态下拉：`account_adjust_approval_status`
- 回写状态下拉：`account_adjust_writeback_status`

#### REV004 办理弹窗
- 原因下拉：根据当前 `objectType` 动态切换字典类型
  - 例如：`PRICE_DIFF_ADJUST -> price_reason`

---

## 6. 非目标说明

本轮不做：
- 旧字典批量改名
- 历史页面一次性切换到新字典
- 旧业务表字段语义迁移
- 全账务领域统一字典重构

---

## 7. 当前特别说明

### `WRITTENOFF_ADJUST`
当前建议临时复用：
- `payment_reason`

这是过渡方案，不代表“核销调整”和“已销调整”语义完全等价。
若后续核销调整独立场景长期存在，建议再单独补：
- `writtenoff_reason`

### `REDINK_RECORD`
当前库中无现成“红冲原因/冲正原因”专属字典，故本轮新增：
- `redink_reason`