# 补贴发放记录 — 前端技术方案

> 依据：`doc/产业政策/补贴发放记录/补贴发放记录技术方案.md`；页面布局对齐 `ruoyi-ui/src/views/breedingStandards/breedingManage/index.vue`；请求与表单字段统一 **小驼峰**。

---

## 1. 页面与路由

| 项 | 说明 |
| --- | --- |
| **Vue 路径** | `ruoyi-ui/src/views/policy/subsidyRecord/index.vue` |
| **组件名** | `PolicySubsidyRecord` |
| **菜单配置** | 若依「菜单管理」组件路径：`policy/subsidyRecord/index` |
| **权限前缀** | `industryPolicy:subsidyRecord:` |

---

## 2. API 模块

| 项 | 说明 |
| --- | --- |
| **文件** | `ruoyi-ui/src/api/policy/subsidyRecord.js` |
| **Base Path** | `/industryPolicy/subsidyRecord` |

封装方法：`listSubsidyRecord`、`getSubsidyRecord`、`addSubsidyRecord`、`updateSubsidyRecord`、`delSubsidyRecord`。

---

## 3. 列表与查询

- **分页**：`pageNum`、`pageSize`（默认 20）。
- **筛选**：`recipientName`（受补贴人姓名模糊）；`subsidyType`（1～3 精确，可空）；`startDate`、`endDate`（发放日期闭区间，前端校验 start ≤ end）。
- **表格列**：补贴项目名称、补贴类型、受补贴人姓名、补贴金额、发放日期、联系电话、创建时间、操作列。
- **批量**：表格多选 + 批量删除（`ids` 逗号拼接调删除接口）。
- **导出**：`this.download('industryPolicy/subsidyRecord/export', queryParams)`（需后端提供导出接口）。

---

## 4. 表单与校验

| 字段 | 前端规则 |
| --- | --- |
| `subsidyProjectName` | 必填，1～20 字 |
| `subsidyType` | 必填，1～3 |
| `recipientName` | 必填，1～10 字 |
| `idCard` | 必填，18 位身份证正则 |
| `contactPhone` | 必填，`1[3-9]` 开头 11 位手机号 |
| `bankAccount` | 必填，16～19 位数字 |
| `subsidyAmount` | 必填，`el-input-number`，>0，2 位小数 |
| `grantDate` | 必填，不得晚于今天 |
| `remark` | 选填，≤500 字 |

本模块**无发布/下架**；任意记录均可编辑、删除。

---

## 5. 操作按钮与权限

| 按钮 | 权限标识 |
| --- | --- |
| 查询/列表 | `industryPolicy:subsidyRecord:list` |
| 查看 | `industryPolicy:subsidyRecord:query` |
| 新增 | `industryPolicy:subsidyRecord:add` |
| 编辑 | `industryPolicy:subsidyRecord:edit` |
| 删除（单条/批量） | `industryPolicy:subsidyRecord:remove` |
| 导出 | `industryPolicy:subsidyRecord:export` |

---

## 6. 国际化

| 项 | 说明 |
| --- | --- |
| **语言包** | `src/lang/zh/policy.js`、`src/lang/bo/policy.js` 中 `subsidyRecord` 节点 |
| **Mixin** | 复用 `policyPublicityLocaleMixin`（`pubT`） |
| **组件** | `data.pubNs = 'subsidyRecord'` |

---

## 7. 联调说明

1. 确认后端 `BizSubsidyGrantRecordController`（或等价类）已部署。
2. 菜单路径 `policy/subsidyRecord/index` 与权限字符与技术方案 §4 一致。
3. 列表排序以后端 `grant_date DESC` 为准；脱敏字段以后端返回为准，前端原样展示。

---

## 8. 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 初版：台账 CRUD；日期区间查询；身份证/手机/账户前端校验；批量删除与导出占位 |