# 补贴发放记录 — 测试用例

> 依据：`补贴发放记录功能需求.md`、`补贴发放记录技术方案.md`  
> **接口 Base Path（示例）**：`/policy/subsidyRecord`；若含 `context-path` 或网关前缀须补齐。鉴权与若依一致（Cookie / Token）。

**通用前置（无特殊说明）**：具备本模块菜单与按钮权限的账号已登录。**补贴类型**：`1` 农业生产、`2` 住房基建、`3` 民生保障。**测试数据**：合法 18 位身份证（含校验位）、11 位手机号、16～19 位数字银行账户、金额 > 0 且最多 2 位小数；发放日期默认 ≤ 当天。

**界面（UI）测试**：借助 **Playwright** 启动 **Chromium**（与 **Google Chrome 同源内核**）；可配置 `channel: 'chrome'` 调用本机已安装的谷歌浏览器。

---

## 一、单元测试用例

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ZCZX-BTJL-UT-001 | 参数校验 | 补贴项目名称长度 | 单元测试 | JUnit5 | 1～20 字 | 无 | 空串、1 字、20 字、21 字 | 空/21 失败；1～20 通过 |
| ZCZX-BTJL-UT-002 | 参数校验 | 受补贴人姓名长度 | 单元测试 | JUnit5 | 1～10 字 | 无 | 空串、1 字、10 字、11 字 | 空/11 失败；1～10 通过 |
| ZCZX-BTJL-UT-003 | 参数校验 | 补贴类型枚举 | 单元测试 | JUnit5 | 仅 1～3 | 无 | `subsidyType` 为 1/3 通过；0、4、null 失败 | 与技术方案 §2.2 一致 |
| ZCZX-BTJL-UT-004 | 参数校验 | 身份证号 | 单元测试 | JUnit5 | 18 位+校验位 | 无 | 合法号、17 位、非法校验位、含非法字符 | 仅合法通过 |
| ZCZX-BTJL-UT-005 | 参数校验 | 联系电话 | 单元测试 | JUnit5 | 大陆手机号 | 无 | 合法 11 位、10 位、非 1 开头 | 仅合法通过 |
| ZCZX-BTJL-UT-006 | 参数校验 | 银行账户 | 单元测试 | JUnit5 | 16～19 位数字 | 无 | 15 位、16 位、19 位、20 位、含字母 | 16～19 数字通过；其余失败 |
| ZCZX-BTJL-UT-007 | 参数校验 | 补贴金额 | 单元测试 | JUnit5 | >0，2 位小数 | 无 | 0、-1、0.01、999999.99、三位小数 | 0/负/三位小数失败；合法正数通过 |
| ZCZX-BTJL-UT-008 | 参数校验 | 发放日期 | 单元测试 | JUnit5 | 非未来 | 无 | 明天、今天、昨天、非法格式 | 未来/非法失败；今天及过去通过 |
| ZCZX-BTJL-UT-009 | 查询校验 | 日期区间 | 单元测试 | JUnit5 | §5.2 | 无 | `validateDateRange(start,end)`：start>end、仅 start、仅 end、相等 | 非法区间失败；合法通过 |
| ZCZX-BTJL-UT-010 | Service | 新增落库 | 单元测试 | JUnit5+Mockito | 正常登记 | 合法实体 | `insert(record)` | 各字段与入参一致；有 `create_time` |
| ZCZX-BTJL-UT-011 | Service | 修改全字段 | 单元测试 | JUnit5+Mockito | §5.3 | 已存在 id | `update(record)` 改金额/日期 | 更新成功；`update_time` 变化 |
| ZCZX-BTJL-UT-012 | Service | 删除记录 | 单元测试 | JUnit5+Mockito | §5.4 | Mock Mapper | `deleteByIds([id])` | 调用删除；无文件清理逻辑 |
| ZCZX-BTJL-UT-013 | Service | 列表排序 SQL | 单元测试 | JUnit5 | 技术方案 | 无 | 检查列表查询 ORDER BY | 含 `grant_date DESC`, `create_time DESC` |
| ZCZX-BTJL-UT-014 | 脱敏 | 身份证脱敏 | 单元测试 | JUnit5 | §3.4 可选 | 明文 18 位 | `maskIdCard(s)` | 前 4+后 4 可见，中间 `*` |
| ZCZX-BTJL-UT-015 | 脱敏 | 手机号脱敏 | 单元测试 | JUnit5 | §3.4 可选 | 11 位手机号 | `maskPhone(s)` | 前 3+后 4，中间 `****` |
| ZCZX-BTJL-UT-016 | 脱敏 | 无特权详情脱敏 | 单元测试 | JUnit5+Mockito | 权限 | 用户无完整查看权 | `toListVo(record,false)` | 敏感字段为脱敏值 |

---

## 二、接口测试用例

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ZCZX-BTJL-API-001 | 列表 | 默认分页排序 | 接口测试 | Postman/curl | §5.2 | 已登录；有多条不同发放日 | `GET /industryPolicy/subsidyRecord/list` | `rows`≤20；按 `grantDate` 新在前 |
| ZCZX-BTJL-API-002 | 列表 | 姓名模糊 | 接口测试 | Postman | 姓名筛选 | 已登录 | `recipientName=` 唯一片段 | 命中姓名含该片段记录 |
| ZCZX-BTJL-API-003 | 列表 | 类型筛选-农业 | 接口测试 | Postman | 精确 | 已登录 | `subsidyType=1` | 均为农业生产 |
| ZCZX-BTJL-API-004 | 列表 | 类型筛选-住房 | 接口测试 | Postman | 精确 | 已登录 | `subsidyType=2` | 均为住房基建 |
| ZCZX-BTJL-API-005 | 列表 | 类型筛选-民生 | 接口测试 | Postman | 精确 | 已登录 | `subsidyType=3` | 均为民生保障 |
| ZCZX-BTJL-API-006 | 列表 | 发放日期闭区间 | 接口测试 | Postman | start/end | 已知 grantDate 样本 | `startDate`、`endDate` 含样本日 | 仅区间内记录 |
| ZCZX-BTJL-API-007 | 列表 | 仅 startDate | 接口测试 | Postman | ≥开始 | 已登录 | 只传 `startDate` | 发放日 ≥ startDate |
| ZCZX-BTJL-API-008 | 列表 | 仅 endDate | 接口测试 | Postman | ≤结束 | 已登录 | 只传 `endDate` | 发放日 ≤ endDate |
| ZCZX-BTJL-API-009 | 列表 | 日期区间非法 | 接口测试 | Postman | 异常 | 已登录 | `startDate`>`endDate` | 失败；可读 `msg`；不返回业务数据 |
| ZCZX-BTJL-API-010 | 列表 | 组合查询 | 接口测试 | Postman | 多条件 | 已登录 | 姓名+类型+日期 | 同时满足 |
| ZCZX-BTJL-API-011 | 新增 | 合法全字段 | 接口测试 | Postman | §5.1 | 已登录 | `POST` Body 八项必填合法 | `code` 成功；详情可查 |
| ZCZX-BTJL-API-012 | 新增 | 项目名称非法 | 接口测试 | Postman | 1～20 | 已登录 | 项目名空/21 字 | 失败；无新记录 |
| ZCZX-BTJL-API-013 | 新增 | 姓名非法 | 接口测试 | Postman | 1～10 | 已登录 | 姓名空/11 字 | 失败 |
| ZCZX-BTJL-API-014 | 新增 | 类型非法 | 接口测试 | Postman | 枚举 | 已登录 | `subsidyType=0` 或 `99` | 失败 |
| ZCZX-BTJL-API-015 | 新增 | 身份证非法 | 接口测试 | Postman | 校验 | 已登录 | 错误 `idCard` | 失败；提示身份证类错误 |
| ZCZX-BTJL-API-016 | 新增 | 手机号非法 | 接口测试 | Postman | 校验 | 已登录 | 10 位或非手机号 | 失败 |
| ZCZX-BTJL-API-017 | 新增 | 银行账户非法 | 接口测试 | Postman | 16～19 | 已登录 | 15 位或含字母 | 失败 |
| ZCZX-BTJL-API-018 | 新增 | 金额非法 | 接口测试 | Postman | >0 | 已登录 | `subsidyAmount=0` 或负数 | 失败 |
| ZCZX-BTJL-API-019 | 新增 | 未来发放日 | 接口测试 | Postman | 日期 | 已登录 | `grantDate` 为明天 | 失败 |
| ZCZX-BTJL-API-020 | 详情 | 有效 id | 接口测试 | Postman | §5.5 | 已登录 | `GET .../subsidyRecord/{id}` | 含八项业务字段及审计字段 |
| ZCZX-BTJL-API-021 | 详情 | 无效 id | 接口测试 | Postman | 异常 | 已登录 | 不存在 id | 404 或业务失败 |
| ZCZX-BTJL-API-022 | 修改 | 合法修改 | 接口测试 | Postman | §5.3 | 已登录；有记录 | `PUT` 改金额、发放日 | 成功；详情已更新 |
| ZCZX-BTJL-API-023 | 修改 | 校验仍生效 | 接口测试 | Postman | 异常 | 已登录 | `PUT` 改手机号为非法 | 失败；原数据不变 |
| ZCZX-BTJL-API-024 | 删除 | 单条删除 | 接口测试 | Postman | §5.4 | 已登录 | `DELETE .../subsidyRecord/{id}` | 成功；列表无该 id |
| ZCZX-BTJL-API-025 | 删除 | 批量删除 | 接口测试 | Postman | 批量 | 已登录；多条 id | `DELETE .../id1,id2` | 成功；均不可查 |
| ZCZX-BTJL-API-026 | 端到端 | CRUD 串联 | 接口测试 | Postman | §4 | 已登录 | 新增→查列表→详情→改→删 | 全流程成功 |
| ZCZX-BTJL-API-027 | 鉴权 | 未登录 | 接口测试 | curl | 安全 | 无 Token | `GET .../list` | 401 或统一未登录响应 |
| ZCZX-BTJL-API-028 | 权限 | 无写权限 | 接口测试 | Postman | 越权 | 仅 list 权限 | `POST .../subsidyRecord` | 无权限失败 |
| ZCZX-BTJL-API-029 | 响应 | 失败可读 | 接口测试 | Postman | §7 | 已登录 | 触发身份证/区间等错误 | Body 含 `code`、`msg` 且可区分 |
| ZCZX-BTJL-API-030 | 脱敏 | 列表手机号（可选） | 接口测试 | Postman | §3.4 | 普通角色已登录 | `GET list` | `contactPhone` 为脱敏格式（若已实现） |

---

## 三、界面测试用例（UI）

**测试工具**：**Playwright** + **Chromium**（`channel: 'chrome'` 使用本机 **Google Chrome**）。

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ZCZX-BTJL-UI-001 | 列表 | 默认分页排序 | UI 测试 | Playwright+Chrome | §5.2 | 已登录；数据>20 | 进入「补贴发放记录」 | 默认每页 20；发放日期新在前 |
| ZCZX-BTJL-UI-002 | 列表 | 姓名模糊查询 | UI 测试 | Playwright+Chrome | 姓名筛选 | 存在姓名含关键词记录 | 输入姓名→查询 | 表格含该行 |
| ZCZX-BTJL-UI-003 | 列表 | 补贴类型筛选 | UI 测试 | Playwright+Chrome | 精确 | 多类型均有数据 | 选「农业生产」→查询 | 类型列均为农业生产 |
| ZCZX-BTJL-UI-004 | 列表 | 发放日期范围 | UI 测试 | Playwright+Chrome | 闭区间 | 已知样本日期 | 选 start/end→查询 | 仅区间内记录 |
| ZCZX-BTJL-UI-005 | 列表 | 日期区间非法 | UI 测试 | Playwright+Chrome | 异常 | 已登录 | start>end→查询 | 提示错误；列表不刷新或空 |
| ZCZX-BTJL-UI-006 | 列表 | 组合与重置 | UI 测试 | Playwright+Chrome | 恢复 | 已筛选 | 多条件查询→重置 | 条件清空；恢复默认列表 |
| ZCZX-BTJL-UI-007 | 列表 | 操作按钮 | UI 测试 | Playwright+Chrome | §6 | 有数据行 | 检查操作列 | 查看/编辑/删除可见（按权限） |
| ZCZX-BTJL-UI-008 | 新增 | 合法全字段提交 | UI 测试 | Playwright+Chrome | §5.1 | 已登录 | 新增→填八项必填→确定 | 成功；列表出现新记录 |
| ZCZX-BTJL-UI-009 | 新增 | 项目名空或超长 | UI 测试 | Playwright+Chrome | 1～20 | 已登录 | 项目名空/21 字→提交 | 校验失败 |
| ZCZX-BTJL-UI-010 | 新增 | 姓名超长 | UI 测试 | Playwright+Chrome | 1～10 | 已登录 | 姓名 11 字→提交 | 校验失败 |
| ZCZX-BTJL-UI-011 | 新增 | 身份证/手机非法 | UI 测试 | Playwright+Chrome | 校验 | 已登录 | 填错误身份证或手机号→提交 | 明确错误提示 |
| ZCZX-BTJL-UI-012 | 新增 | 金额与发放日 | UI 测试 | Playwright+Chrome | 异常 | 已登录 | 金额 0 或发放日选明天→提交 | 校验失败 |
| ZCZX-BTJL-UI-013 | 新增 | 类型必选 | UI 测试 | Playwright+Chrome | 约束 | 可清空类型时 | 不选类型→提交 | 必选提示 |
| ZCZX-BTJL-UI-014 | 详情 | 字段完整 | UI 测试 | Playwright+Chrome | §5.5 | 任意记录 | 点「查看」 | 项目、类型、姓名、证件、账户、金额、日期齐全 |
| ZCZX-BTJL-UI-015 | 详情 | 敏感信息脱敏（可选） | UI 测试 | Playwright+Chrome | §5.5 | 普通角色 | 查看详情 | 身份证/手机/账户为脱敏展示（若已实现） |
| ZCZX-BTJL-UI-016 | 修改 | 编辑成功 | UI 测试 | Playwright+Chrome | §5.3 | 有记录 | 编辑→改补贴金额→保存 | 列表/详情已更新 |
| ZCZX-BTJL-UI-017 | 修改 | 保存校验失败 | UI 测试 | Playwright+Chrome | 异常 | 有记录 | 清空银行账户→保存 | 校验失败 |
| ZCZX-BTJL-UI-018 | 删除 | 单条删除确认 | UI 测试 | Playwright+Chrome | §5.4 | 有记录 | 删除→确认 | 记录消失 |
| ZCZX-BTJL-UI-019 | 删除 | 取消删除 | UI 测试 | Playwright+Chrome | 确认框 | 有记录 | 删除→取消 | 记录仍在 |
| ZCZX-BTJL-UI-020 | 删除 | 批量删除（若支持） | UI 测试 | Playwright+Chrome | 批量 | 勾选多条 | 批量删除→确认 | 选中行均消失 |
| ZCZX-BTJL-UI-021 | 类型 | 三类均可登记 | UI 测试 | Playwright+Chrome | §2.1 | 已登录 | 各建类型 1/2/3 一条并筛选 | 筛选与展示正确 |
| ZCZX-BTJL-UI-022 | 端到端 | CRUD 串联 | UI 集成 | Playwright+Chrome | §4 | 可新增 | 新增→查→看→改→删 | 全流程界面无报错 |
| ZCZX-BTJL-UI-023 | 权限 | 只读账号 | UI 测试 | Playwright+Chrome | §8 | 无 add/edit/remove | 登录进模块 | 无新增/编辑/删除或操作拒绝 |
| ZCZX-BTJL-UI-024 | 导出 | 导出按钮（可选） | UI 测试 | Playwright+Chrome | 技术方案 | 有 export 权限 | 点导出 | 下载 Excel 或提示成功 |
| ZCZX-BTJL-UI-025 | 表单 | 金额两位小数 | UI 测试 | Playwright+Chrome | §5.1 | 已登录 | 输入 100.555→提交 | 前端或后端拒绝三位小数 |

---

## Playwright 与谷歌浏览器（实施提示）

- 安装：`npm i -D @playwright/test`；`npx playwright install chromium`；本机 Chrome：`channel: 'chrome'`。  
- 登录复用：`storageState: 'auth.json'`。  
- 路由示例：`page.goto('/policy/subsidyRecord')`（以菜单配置为准）。  
- 日期：`page.locator('.el-date-editor input').first().fill('2025-01-15')` 或项目日期组件封装。  
- 断言：`expect(page.getByText('农业生产')).toBeVisible()`。

---

## 覆盖对照

| 类别 | 单元 UT | 接口 API | 界面 UI |
| --- | --- | --- | --- |
| 正常流程 | UT-010～013 | API-001～008、010～011、020、022、024～026 | UI-001～004、008、014、016、018、021～022 |
| 异常流程 | UT-001～009 | API-009、012～019、021、023、029 | UI-005、009～013、017、019 |
| 业务约束 | UT-003～008、009 | API-003～005、009、015～019 | UI-003、005、011～013、025 |
| 脱敏/权限（可选） | UT-014～016 | API-030、027～028 | UI-015、023、024 |

---

## 功能需求追溯（自查）

| 需求章节 | 要点 | 主要对应用例 |
| --- | --- | --- |
| §5.1 新增 | 八项必填、格式校验 | UT-001～008；API-011～019；UI-008～013 |
| §5.2 列表 | 姓名模糊、类型、日期区间、排序 | UT-009、013；API-001～010；UI-001～006 |
| §5.3 修改 | 全字段可改 | UT-011；API-022～023；UI-016～017 |
| §5.4 删除 | 单条/批量、确认 | UT-012；API-024～025；UI-018～020 |
| §5.5 详情 | 全字段、脱敏 | API-020～021；UI-014～015 |
| §6 操作矩阵 | 无状态限制 | UI-007、023 |
| §7 错误约定 | code/msg | API-029 |

---

## 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 初版：单元 16、接口 30、UI 25；台账 CRUD 无发布下架；Playwright+Chrome；Base Path `/industryPolicy/subsidyRecord` |