共同富裕成果 — 测试用例
依据：共同富裕成果功能需求.md、共同富裕成果技术方案.md
接口 Base Path（示例）：/commonProsperity/achievement；若含 context-path 或网关前缀须补齐。鉴权与若依一致（Cookie / Token）。
通用前置（无特殊说明）：具备本模块菜单与按钮权限的账号已登录。统计范围：YYYY-MM（如 2026-05），同月不可重复。比率字段（数字平台使用率、品牌产品溢价率）：0～1（如 0.85 表示 85%）。整数项（人数、个数等）：非负整数。金额/面积：≥ 0，建议最多 2 位小数。
界面（UI）测试：借助 Playwright 启动 Chromium（与 Google Chrome 同源内核）；可配置 channel: 'chrome' 调用本机已安装的谷歌浏览器。
一、单元测试用例
| 用例编号 |
测试模块 |
测试项 |
测试类型 |
测试工具 |
测试目的 |
前置条件 |
测试步骤 |
预期结果 |
| GTFY-CG-UT-001 |
参数校验 |
统计范围格式 |
单元测试 |
JUnit5 |
YYYY-MM |
无 |
2026-05 通过；2026-13、202605、2026/05、空 失败 |
与 §3.4 一致 |
| GTFY-CG-UT-002 |
参数校验 |
统计范围唯一 |
单元测试 |
JUnit5 |
§5.1 |
库中已有 2026-01 |
新增同 statPeriod |
失败；提示月份已存在 |
| GTFY-CG-UT-003 |
参数校验 |
集体经济收入 |
单元测试 |
JUnit5 |
≥0，2 位小数 |
无 |
-1、0、0.01、999999.99、三位小数 |
负/三位小数失败；0 及合法正数通过 |
| GTFY-CG-UT-004 |
参数校验 |
整数项非负 |
单元测试 |
JUnit5 |
人数/个数 |
无 |
employmentDrivenCount 为 -1、1.5、0、100 |
负/小数失败；0、100 通过 |
| GTFY-CG-UT-005 |
参数校验 |
绿化面积 |
单元测试 |
JUnit5 |
≥0 可小数 |
无 |
newGreenArea 为 -0.1、0、12.5 |
负失败；0、12.5 通过 |
| GTFY-CG-UT-006 |
参数校验 |
数字平台使用率 |
单元测试 |
JUnit5 |
[0,1] |
无 |
-0.01、0、0.85、1、1.01 |
越界失败；0、0.85、1 通过 |
| GTFY-CG-UT-007 |
参数校验 |
品牌产品溢价率 |
单元测试 |
JUnit5 |
[0,1] |
无 |
同 UT-006 规则 |
与 UT-006 一致 |
| GTFY-CG-UT-008 |
参数校验 |
必填项非空 |
单元测试 |
JUnit5 |
§5.1 全必填 |
无 |
缺 statPeriod 或任一整数字段 null |
失败 |
| GTFY-CG-UT-009 |
Service |
新增落库 |
单元测试 |
JUnit5+Mockito |
正常登记 |
合法实体、月份未占用 |
insert(...) |
各指标与入参一致；无发布状态字段 |
| GTFY-CG-UT-010 |
Service |
修改排除自身查重 |
单元测试 |
JUnit5+Mockito |
§5.3 |
id=1 为 2026-01；存在 2026-02 |
将 id=1 改为 2026-02 |
失败（与 id=2 冲突） |
| GTFY-CG-UT-011 |
Service |
修改同月保留 |
单元测试 |
JUnit5+Mockito |
不改月份 |
id=1 2026-01 |
改收入仍 2026-01 |
成功 |
| GTFY-CG-UT-012 |
Service |
删除记录 |
单元测试 |
JUnit5+Mockito |
§5.4 |
Mock Mapper |
deleteByIds([id]) |
调用删除；无附件清理 |
| GTFY-CG-UT-013 |
Service |
列表按年筛选 SQL |
单元测试 |
JUnit5 |
statYear |
无 |
检查 XML：statYear=2026 |
条件含 2026-% 或 LEFT(stat_period,4)=2026 |
| GTFY-CG-UT-014 |
Service |
列表排序 |
单元测试 |
JUnit5 |
技术方案 |
无 |
检查 ORDER BY |
stat_period DESC, create_time DESC |
| GTFY-CG-UT-015 |
修改守卫 |
无状态限制 |
单元测试 |
JUnit5 |
台账 |
任意记录 |
canEdit(any) 恒 true（若存在守卫） |
无「已发布不可改」类限制 |
二、接口测试用例
| 用例编号 |
测试模块 |
测试项 |
测试类型 |
测试工具 |
测试目的 |
前置条件 |
测试步骤 |
预期结果 |
| GTFY-CG-API-001 |
列表 |
默认分页排序 |
接口测试 |
Postman/curl |
§5.2 |
已登录；有多月数据 |
GET /commonProsperity/achievement/list |
rows≤20；statPeriod 月份倒序 |
| GTFY-CG-API-002 |
列表 |
统计年份筛选 |
接口测试 |
Postman |
按年 |
含 2025-12、2026-03 |
statYear=2026 |
仅 2026-xx 记录 |
| GTFY-CG-API-003 |
列表 |
年份为空不过滤 |
接口测试 |
Postman |
全量 |
已登录 |
不传 statYear |
含不同年份记录 |
| GTFY-CG-API-004 |
列表 |
无数据年份 |
接口测试 |
Postman |
边界 |
已登录 |
statYear=1999 |
rows 为空或 total=0 |
| GTFY-CG-API-005 |
新增 |
合法全字段 |
接口测试 |
Postman |
§5.1 |
已登录；2026-06 未占用 |
POST Body 全部必填合法 |
code 成功；详情字段一致 |
| GTFY-CG-API-006 |
新增 |
统计范围重复 |
接口测试 |
Postman |
唯一 |
已存在 2026-01 |
POST statPeriod=2026-01 |
失败；msg 可区分；库中仍 1 条 |
| GTFY-CG-API-007 |
新增 |
统计范围格式非法 |
接口测试 |
Postman |
YYYY-MM |
已登录 |
statPeriod=2026-13 或 202605 |
失败 |
| GTFY-CG-API-008 |
新增 |
比率大于 1 |
接口测试 |
Postman |
[0,1] |
已登录 |
digitalPlatformUsageRate=1.2 |
失败 |
| GTFY-CG-API-009 |
新增 |
比率为负 |
接口测试 |
Postman |
[0,1] |
已登录 |
brandPremiumRate=-0.1 |
失败 |
| GTFY-CG-API-010 |
新增 |
整数项含小数 |
接口测试 |
Postman |
整数 |
已登录 |
employmentDrivenCount=10.5 |
失败 |
| GTFY-CG-API-011 |
新增 |
收入为负 |
接口测试 |
Postman |
≥0 |
已登录 |
collectiveEconomyIncome=-1 |
失败 |
| GTFY-CG-API-012 |
新增 |
边界比率 0 和 1 |
接口测试 |
Postman |
闭区间 |
未占用两个月 |
分别新增 rate=0、rate=1 的两条 |
均成功 |
| GTFY-CG-API-013 |
详情 |
有效 id |
接口测试 |
Postman |
§5.5 |
已登录 |
GET /commonProsperity/achievement/{id} |
含 12 项指标及审计字段 |
| GTFY-CG-API-014 |
详情 |
无效 id |
接口测试 |
Postman |
异常 |
已登录 |
不存在 id |
404 或业务失败 |
| GTFY-CG-API-015 |
修改 |
合法修改指标 |
接口测试 |
Postman |
§5.3 |
已登录；有记录 |
PUT 改 collectiveEconomyIncome、人数等 |
成功；详情已更新 |
| GTFY-CG-API-016 |
修改 |
改月冲突 |
接口测试 |
Postman |
唯一 |
A=2026-01、B=2026-02 |
将 A 改为 2026-02 |
失败 |
| GTFY-CG-API-017 |
修改 |
校验仍生效 |
接口测试 |
Postman |
异常 |
已登录 |
PUT 比率改为 2 |
失败；原数据不变 |
| GTFY-CG-API-018 |
删除 |
单条删除 |
接口测试 |
Postman |
§5.4 |
已登录 |
DELETE .../achievement/{id} |
成功；详情 404 |
| GTFY-CG-API-019 |
删除 |
批量删除 |
接口测试 |
Postman |
批量 |
已登录 |
DELETE id1,id2 |
均不可查 |
| GTFY-CG-API-020 |
端到端 |
CRUD 串联 |
接口测试 |
Postman |
§4 |
已登录 |
新增→列表(statYear)→详情→改→删 |
全流程成功 |
| GTFY-CG-API-021 |
鉴权 |
未登录 |
接口测试 |
curl |
安全 |
无 Token |
GET .../list |
401 或统一未登录 |
| GTFY-CG-API-022 |
权限 |
无写权限 |
接口测试 |
Postman |
越权 |
仅 list |
POST .../achievement |
无权限失败 |
| GTFY-CG-API-023 |
响应 |
失败可读 |
接口测试 |
Postman |
§7 |
已登录 |
触发重复月份、比率越界 |
code、msg 可区分 |
| GTFY-CG-API-024 |
导出 |
按年导出（可选） |
接口测试 |
Postman |
§3.6 |
有 export 权限 |
POST .../export+statYear=2026 |
文件仅含 2026 年数据 |
三、界面测试用例（UI）
测试工具：Playwright + Chromium（channel: 'chrome' 使用本机 Google Chrome）。
| 用例编号 |
测试模块 |
测试项 |
测试类型 |
测试工具 |
测试目的 |
前置条件 |
测试步骤 |
预期结果 |
| GTFY-CG-UI-001 |
列表 |
默认分页排序 |
UI 测试 |
Playwright+Chrome |
§5.2 |
已登录；数据>20 |
进入「共同富裕成果」 |
每页 20；统计范围月份新在前 |
| GTFY-CG-UI-002 |
列表 |
统计年份筛选 |
UI 测试 |
Playwright+Chrome |
statYear |
含 2025、2026 数据 |
选年份 2026→查询 |
仅显示 2026-xx |
| GTFY-CG-UI-003 |
列表 |
重置筛选 |
UI 测试 |
Playwright+Chrome |
恢复 |
已按年筛选 |
重置 |
年份清空；显示全部 |
| GTFY-CG-UI-004 |
列表 |
操作按钮 |
UI 测试 |
Playwright+Chrome |
§6 |
有数据 |
查看操作列 |
查看/编辑/删除可见（按权限） |
| GTFY-CG-UI-005 |
新增 |
合法全指标提交 |
UI 测试 |
Playwright+Chrome |
§5.1 |
已登录 |
新增→选统计月份→填全部指标→确定 |
成功；列表出现该行 |
| GTFY-CG-UI-006 |
新增 |
统计范围必选 |
UI 测试 |
Playwright+Chrome |
必填 |
已登录 |
不选月份→提交 |
校验失败 |
| GTFY-CG-UI-007 |
新增 |
重复月份 |
UI 测试 |
Playwright+Chrome |
唯一 |
已有 2026-01 |
再新增 2026-01 |
提示月份已存在 |
| GTFY-CG-UI-008 |
新增 |
比率超 1 |
UI 测试 |
Playwright+Chrome |
0～1 |
已登录 |
使用率填 1.2→提交 |
校验失败 |
| GTFY-CG-UI-009 |
新增 |
整数项填小数 |
UI 测试 |
Playwright+Chrome |
整数 |
已登录 |
带动就业人数 10.5→提交 |
校验失败 |
| GTFY-CG-UI-010 |
新增 |
收入为负 |
UI 测试 |
Playwright+Chrome |
≥0 |
已登录 |
集体经济收入 -1→提交 |
校验失败 |
| GTFY-CG-UI-011 |
新增 |
比率边界 0/1 |
UI 测试 |
Playwright+Chrome |
闭区间 |
两个未占用月 |
分别填 0 和 1 提交 |
均成功 |
| GTFY-CG-UI-012 |
详情 |
字段完整 |
UI 测试 |
Playwright+Chrome |
§5.5 |
任意记录 |
点「查看」 |
12 项指标+审计信息齐全 |
| GTFY-CG-UI-013 |
详情 |
比率展示格式 |
UI 测试 |
Playwright+Chrome |
展示约定 |
使用率 0.85 |
查看详情 |
显示为 0.85 或 85%（与产品一致） |
| GTFY-CG-UI-014 |
修改 |
编辑成功 |
UI 测试 |
Playwright+Chrome |
§5.3 |
有记录 |
编辑→改收入/人数→保存 |
列表/详情已更新 |
| GTFY-CG-UI-015 |
修改 |
改月冲突 |
UI 测试 |
Playwright+Chrome |
唯一 |
已有 01、02 月 |
将 01 月改为 02 月保存 |
失败提示 |
| GTFY-CG-UI-016 |
修改 |
清空必填失败 |
UI 测试 |
Playwright+Chrome |
校验 |
有记录 |
清空某必填整数项→保存 |
校验失败 |
| GTFY-CG-UI-017 |
删除 |
单条确认删除 |
UI 测试 |
Playwright+Chrome |
§5.4 |
有记录 |
删除→确认 |
行消失 |
| GTFY-CG-UI-018 |
删除 |
取消删除 |
UI 测试 |
Playwright+Chrome |
确认框 |
有记录 |
删除→取消 |
行仍在 |
| GTFY-CG-UI-019 |
删除 |
批量删除 |
UI 测试 |
Playwright+Chrome |
批量 |
多条 |
勾选→批量删→确认 |
选中均消失 |
| GTFY-CG-UI-020 |
端到端 |
CRUD 串联 |
UI 集成 |
Playwright+Chrome |
§4 |
可新增 |
新增→按年查→详情→改→删 |
全流程成功 |
| GTFY-CG-UI-021 |
权限 |
只读账号 |
UI 测试 |
Playwright+Chrome |
§8 |
无 add/edit/remove |
登录进模块 |
无对应按钮或操作拒绝 |
| GTFY-CG-UI-022 |
导出 |
按年导出（可选） |
UI 测试 |
Playwright+Chrome |
export |
有导出权限 |
选年→点导出 |
下载文件且数据为所选年 |
| GTFY-CG-UI-023 |
表单 |
月份选择器 |
UI 测试 |
Playwright+Chrome |
YYYY-MM |
已登录 |
新增打开月份控件 |
仅能选到月；提交值为 YYYY-MM |
| GTFY-CG-UI-024 |
错误提示 |
业务失败可读 |
UI 测试 |
Playwright+Chrome |
§7 |
已登录 |
触发重复月提交 |
Message 含明确原因 |
Playwright 与谷歌浏览器（实施提示）
- 安装：
npm i -D @playwright/test；npx playwright install chromium；本机 Chrome：channel: 'chrome'。
- 菜单：
getByText('共同富裕成果') 或 goto('/commonProsperity/achievement')（以实际路由为准）。
- 统计年份：筛选区
el-select 或年份输入；统计范围表单用 type="month" 的 date-picker（若依 value-format="yyyy-MM"）。
- 比率输入：对数字输入框
fill('1.2') 后点确定，断言错误提示。
覆盖对照
| 类别 |
单元 UT |
接口 API |
界面 UI |
| 正常流程 |
UT-009～012、014 |
API-001～005、012～016、018～020 |
UI-001～006、011～014、017、020 |
| 异常流程 |
UT-001～008 |
API-006～011、017、021～023 |
UI-007～010、015～016、018～019、024 |
| 业务约束 |
UT-002、006～007、015 |
API-002～004、006～012、016 |
UI-002、007～011、015、023 |
功能需求追溯（自查）
| 需求章节 |
要点 |
主要对应用例 |
| §5.1 新增 |
12 项必填、YYYY-MM、整数/比率/金额规则、月唯一 |
UT-001～010；API-005～012；UI-005～011 |
| §5.2 列表 |
statYear、分页、月份倒序 |
API-001～004；UI-001～003 |
| §5.3 修改 |
全字段可改、改月查重 |
UT-010～011；API-015～017；UI-014～016 |
| §5.4 删除 |
确认、批量 |
UT-012；API-018～019；UI-017～019 |
| §5.5 详情 |
全指标展示 |
API-013～014；UI-012～013 |
| §6 矩阵 |
无发布状态 |
UT-015；无发布/下架用例 |
| §7 错误约定 |
code/msg |
API-023；UI-024 |
修订记录
| 版本 |
说明 |
| 1.0 |
初版：单元 15、接口 24、UI 24；台账无发布态；Playwright+Chrome；Base /commonProsperity/achievement |
