隔离圈位管理 — 测试用例
依据：隔离圈位管理功能需求.md、隔离圈位管理技术方案.md
接口 Base Path：/tradeMarket/isolationPen；鉴权与若依一致（Cookie / Token）。
通用前置（无特殊说明）：具备本模块权限的账号已登录（tradeMarket:isolationPen:list|query|add|edit|remove|config）。biz_isolation_pen 宜预置（del_flag=0）：
| 样本 |
编号 |
备注 |
要点 |
| P1 |
01 |
东侧一号栏 |
有备注 |
| P2 |
02 |
（空） |
无备注 |
| P3 |
03 |
西侧临时圈 |
用于模糊/修改 |
合法新增圈位 Body：{"remark":"测试圈位甲"} 或 {}（无备注）。
合法保存配置 Body：{"defaultDays":7,"remark":"常规检疫默认7天"}。
界面（UI）测试：Playwright + Chromium（channel: 'chrome' 使用本机 Google Chrome）。
一、单元测试用例
| 用例编号 |
测试模块 |
测试项 |
测试类型 |
测试工具 |
测试目的 |
前置条件 |
测试步骤 |
预期结果 |
| ZCZX-GLQWGL-UT-001 |
编号生成 |
首条编号 |
单元测试 |
JUnit5 |
§2.5 |
无未删圈位 |
PenCodeGenerator.next() |
返回 01 |
| ZCZX-GLQWGL-UT-002 |
编号生成 |
递增补零 |
单元测试 |
JUnit5 |
§2.5 |
最大号 08 |
next() |
返回 09 |
| ZCZX-GLQWGL-UT-003 |
编号生成 |
上限拒绝 |
单元测试 |
JUnit5 |
§2.5 |
最大号 99 |
next() |
抛异常；提示编号上限 |
| ZCZX-GLQWGL-UT-004 |
圈位校验 |
备注长度 |
单元测试 |
JUnit5 |
§3.1 |
无 |
51 字、50 字、空、仅空白 |
51 失败；50/空通过 |
| ZCZX-GLQWGL-UT-005 |
配置校验 |
默认天数下界 |
单元测试 |
JUnit5 |
§3.2 |
无 |
0、1、-1 |
0/负失败；1 通过 |
| ZCZX-GLQWGL-UT-006 |
配置校验 |
默认天数上界 |
单元测试 |
JUnit5 |
§3.2 |
无 |
3650、3651 |
3651 失败；3650 通过 |
| ZCZX-GLQWGL-UT-007 |
配置校验 |
非整数天数 |
单元测试 |
JUnit5 |
§3.2 |
无 |
7.5、null、非数字 |
均失败 |
| ZCZX-GLQWGL-UT-008 |
配置校验 |
配置备注长度 |
单元测试 |
JUnit5 |
§3.2 |
无 |
51 字、50 字 |
51 失败；50 通过 |
| ZCZX-GLQWGL-UT-009 |
Service |
新增圈位落库 |
单元测试 |
JUnit5+Mockito |
正常 |
Mock Mapper |
insert 合法行 |
del_flag=0；pen_code 非空 |
| ZCZX-GLQWGL-UT-010 |
Service |
修改禁改编号 |
单元测试 |
JUnit5 |
§3.1 |
记录 01 |
入参 penCode=99 更新 |
库仍为 01 |
| ZCZX-GLQWGL-UT-011 |
Service |
逻辑删除圈位 |
单元测试 |
JUnit5+Mockito |
§3.1 |
Mock |
remove(id) |
del_flag=2 |
| ZCZX-GLQWGL-UT-012 |
Service |
删除有关联 |
单元测试 |
JUnit5+Mockito |
§3.1 |
hasReference=true |
remove |
抛 ServiceException |
| ZCZX-GLQWGL-UT-013 |
Service |
配置首次保存 |
单元测试 |
JUnit5+Mockito |
§3.2 |
无 id=1 行 |
saveSetting |
INSERT；id=1 |
| ZCZX-GLQWGL-UT-014 |
Service |
配置覆盖更新 |
单元测试 |
JUnit5+Mockito |
§3.2 |
已有 7 天 |
saveSetting(14) |
仅一行；default_days=14 |
| ZCZX-GLQWGL-UT-015 |
Mapper |
模糊筛选 SQL |
单元测试 |
JUnit5 |
§3.3 |
无 |
检查 XML |
LIKE CONCAT('%',…,'%')；del_flag=0 |
| ZCZX-GLQWGL-UT-016 |
Mapper |
列表排序 |
单元测试 |
JUnit5 |
§3.1 |
无 |
检查 XML |
pen_code ASC, id ASC |
二、接口测试用例
| 用例编号 |
测试模块 |
测试项 |
测试类型 |
测试工具 |
测试目的 |
前置条件 |
测试步骤 |
预期结果 |
| ZCZX-GLQWGL-API-001 |
列表 |
默认分页排序 |
接口测试 |
Postman |
§3.1 |
有 P1～P3 |
GET /list |
code=200；≤20 条；penCode 升序 |
| ZCZX-GLQWGL-API-002 |
列表 |
编号模糊 |
接口测试 |
Postman |
§2.6 |
有 P1 01 |
penCode=1 |
含 P1；penCode=01 亦命中 |
| ZCZX-GLQWGL-API-003 |
列表 |
模糊无匹配 |
接口测试 |
Postman |
§2.6 |
已登录 |
penCode=不存在xyz |
rows 为空 |
| ZCZX-GLQWGL-API-004 |
列表 |
不含已删除 |
接口测试 |
Postman |
逻辑删除 |
某 id 已删 |
GET /list |
无该 id |
| ZCZX-GLQWGL-API-005 |
新增 |
有备注 |
接口测试 |
Postman |
§5.1 |
已登录 |
POST remark=测试圈位 |
code=200；返回 2 位 penCode |
| ZCZX-GLQWGL-API-006 |
新增 |
无备注 |
接口测试 |
Postman |
§5.1 |
已登录 |
POST {} |
成功；remark 为空 |
| ZCZX-GLQWGL-API-007 |
新增 |
备注超长 |
接口测试 |
Postman |
§5.1.3 |
已登录 |
remark 51 字 |
code≠200；msg 含长度 |
| ZCZX-GLQWGL-API-008 |
新增 |
传编号无效 |
接口测试 |
Postman |
§3.1 |
已登录 |
POST 含 penCode=88 |
忽略入参；按规则生成编号 |
| ZCZX-GLQWGL-API-009 |
详情 |
有效 id |
接口测试 |
Postman |
§5.4 |
有 P1 |
GET /{id} |
含 penCode、remark、审计字段 |
| ZCZX-GLQWGL-API-010 |
详情 |
无效/已删 id |
接口测试 |
Postman |
异常 |
已登录 |
不存在或已删 id |
失败或 data 为空 |
| ZCZX-GLQWGL-API-011 |
修改 |
改备注 |
接口测试 |
Postman |
§5.3 |
有 P2 |
PUT 改 remark |
成功；penCode 仍为 02 |
| ZCZX-GLQWGL-API-012 |
修改 |
传编号无效 |
接口测试 |
Postman |
§3.1 |
有 P1 |
PUT penCode=99 |
库仍为 01 |
| ZCZX-GLQWGL-API-013 |
修改 |
不存在 id |
接口测试 |
Postman |
异常 |
已登录 |
伪造 id PUT |
失败 |
| ZCZX-GLQWGL-API-014 |
删除 |
单条逻辑删 |
接口测试 |
Postman |
§5.5 |
无关联新行 |
DELETE /{id} |
成功；列表不可见 |
| ZCZX-GLQWGL-API-015 |
删除 |
有关联拒绝 |
接口测试 |
Postman |
§5.5 |
预置 hasReference |
DELETE |
失败；提示关联 |
| ZCZX-GLQWGL-API-016 |
删除 |
重复删除 |
接口测试 |
Postman |
幂等 |
已删 id |
再次 DELETE |
失败或不存在 |
| ZCZX-GLQWGL-API-017 |
配置 |
未配置查询 |
接口测试 |
Postman |
§5.6.3 |
无 setting 行 |
GET /setting |
data 为空或字段 null |
| ZCZX-GLQWGL-API-018 |
配置 |
首次保存 |
接口测试 |
Postman |
§5.6 |
无配置 |
PUT /setting defaultDays=7 |
成功；再 GET 为 7 |
| ZCZX-GLQWGL-API-019 |
配置 |
覆盖更新 |
接口测试 |
Postman |
§5.6 |
已有 7 天 |
PUT defaultDays=14 |
成功；仅一条；值为 14 |
| ZCZX-GLQWGL-API-020 |
配置 |
缺默认天数 |
接口测试 |
Postman |
§5.6.5 |
已登录 |
PUT 无 defaultDays |
失败 |
| ZCZX-GLQWGL-API-021 |
配置 |
天数非法 |
接口测试 |
Postman |
§5.6.5 |
已登录 |
0/3651/7.5 各测 |
均失败 |
| ZCZX-GLQWGL-API-022 |
配置 |
备注超长 |
接口测试 |
Postman |
§5.6.5 |
已登录 |
remark 51 字 |
失败 |
| ZCZX-GLQWGL-API-023 |
端到端 |
圈位 CRUD |
接口测试 |
Postman |
§4 |
已登录 |
POST→list→GET→PUT→DELETE |
每步 code=200 |
| ZCZX-GLQWGL-API-024 |
鉴权 |
未登录 |
接口测试 |
curl |
安全 |
无 Token |
GET /list |
401 或统一未登录 |
| ZCZX-GLQWGL-API-025 |
权限 |
无新增权限 |
接口测试 |
Postman |
§6 |
仅 list |
POST 圈位 |
无权限失败 |
| ZCZX-GLQWGL-API-026 |
权限 |
无配置权限 |
接口测试 |
Postman |
§6 |
无 config |
PUT /setting |
无权限失败 |
| ZCZX-GLQWGL-API-027 |
权限 |
无删除权限 |
接口测试 |
Postman |
§6 |
无 remove |
DELETE |
无权限失败 |
| ZCZX-GLQWGL-API-028 |
响应 |
失败可读 |
接口测试 |
Postman |
§8 |
已登录 |
触发备注超长、天数非法 |
msg 可区分场景 |
三、界面测试用例（UI）
测试工具：Playwright + Chromium（channel: 'chrome' 使用本机 Google Chrome）。
| 用例编号 |
测试模块 |
测试项 |
测试类型 |
测试工具 |
测试目的 |
前置条件 |
测试步骤 |
预期结果 |
| ZCZX-GLQWGL-UI-001 |
列表 |
默认展示 |
UI 测试 |
Playwright+Chrome |
§5.2.3 |
已登录；有 P1～P3 |
进入「隔离圈位管理」 |
含圈位编号、备注、操作；有「设置隔离天数」 |
| ZCZX-GLQWGL-UI-002 |
列表 |
编号模糊筛选 |
UI 测试 |
Playwright+Chrome |
§2.6 |
有 P1 01 |
编号填 1→搜索 |
列表含 P1 |
| ZCZX-GLQWGL-UI-003 |
列表 |
无结果 |
UI 测试 |
Playwright+Chrome |
§2.6 |
已登录 |
输入不存在编号→搜索 |
空列表或空状态 |
| ZCZX-GLQWGL-UI-004 |
列表 |
重置 |
UI 测试 |
Playwright+Chrome |
§5.2 |
已筛选 |
搜索→重置 |
条件清空；列表恢复 |
| ZCZX-GLQWGL-UI-005 |
新增圈位 |
有备注保存 |
UI 测试 |
Playwright+Chrome |
§5.1 |
有 add 权限 |
新增→填备注→确定 |
成功提示；列表新行有 2 位编号 |
| ZCZX-GLQWGL-UI-006 |
新增圈位 |
无备注保存 |
UI 测试 |
Playwright+Chrome |
§5.1 |
已登录 |
新增→备注留空→确定 |
成功；备注列为空或「—」 |
| ZCZX-GLQWGL-UI-007 |
新增圈位 |
备注超长 |
UI 测试 |
Playwright+Chrome |
§5.1.3 |
新增 |
输入超 50 字或保存 |
无法输入或校验失败 |
| ZCZX-GLQWGL-UI-008 |
新增圈位 |
编号只读 |
UI 测试 |
Playwright+Chrome |
§2.2 |
打开新增 |
查看圈位编号控件 |
禁用/占位「保存后自动生成」 |
| ZCZX-GLQWGL-UI-009 |
新增圈位 |
取消 |
UI 测试 |
Playwright+Chrome |
§5.1.2 |
新增 |
填备注→取消 |
弹窗关闭；无新行 |
| ZCZX-GLQWGL-UI-010 |
详情 |
只读展示 |
UI 测试 |
Playwright+Chrome |
§5.4 |
有 P1 |
点击查看 |
编号、备注只读；含审计信息 |
| ZCZX-GLQWGL-UI-011 |
编辑 |
改备注 |
UI 测试 |
Playwright+Chrome |
§5.3 |
有 P3 |
编辑→改备注→确定 |
列表备注已更新；编号不变 |
| ZCZX-GLQWGL-UI-012 |
编辑 |
编号不可改 |
UI 测试 |
Playwright+Chrome |
§5.3 |
编辑 P1 |
查看编号控件 |
只读 |
| ZCZX-GLQWGL-UI-013 |
删除 |
确认删除 |
UI 测试 |
Playwright+Chrome |
§5.5 |
无关联行 |
删除→确认 |
行消失 |
| ZCZX-GLQWGL-UI-014 |
删除 |
取消删除 |
UI 测试 |
Playwright+Chrome |
§5.5 |
任意行 |
删除→取消 |
行仍在 |
| ZCZX-GLQWGL-UI-015 |
配置 |
首次设置天数 |
UI 测试 |
Playwright+Chrome |
§5.6 |
无配置；有 config |
设置隔离天数→填 7→确定 |
成功提示；再次打开回显 7 |
| ZCZX-GLQWGL-UI-016 |
配置 |
覆盖更新天数 |
UI 测试 |
Playwright+Chrome |
§5.6 |
已配置 7 天 |
改为 14→确定 |
再次打开为 14 |
| ZCZX-GLQWGL-UI-017 |
配置 |
天数必填/非法 |
UI 测试 |
Playwright+Chrome |
§5.6.5 |
打开配置弹窗 |
留空或填 0→确定 |
前端校验失败 |
| ZCZX-GLQWGL-UI-018 |
配置 |
取消 |
UI 测试 |
Playwright+Chrome |
§5.6.4 |
已配置 |
改天数→取消 |
不保存；再打开仍为原值 |
| ZCZX-GLQWGL-UI-019 |
端到端 |
全流程 |
UI 集成 |
Playwright+Chrome |
§4 |
权限齐备 |
设天数→新增→模糊查→看→改→删 |
无报错 |
| ZCZX-GLQWGL-UI-020 |
权限 |
只读角色 |
UI 测试 |
Playwright+Chrome |
§6 |
仅 list/query |
进入模块 |
无新增/编辑/删除/设置隔离天数 |
| ZCZX-GLQWGL-UI-021 |
详情 |
从详情编辑 |
UI 测试 |
Playwright+Chrome |
§5.4 |
查看 P1 |
点「编辑」 |
进入编辑弹窗；编号只读 |
Playwright 与谷歌浏览器（实施提示）
- 安装：
npm i -D @playwright/test；npx playwright install chrome。
- 配置：
use: { channel: 'chrome', locale: 'zh-CN', baseURL: 'http://localhost:80' }；storageState 复用登录态。
- 路由：
page.goto('/tradeMarket/isolationPen')（以菜单 component 为准）。
- 模糊搜索：
page.getByLabel('圈位编号').fill('1') 后 page.getByRole('button', { name: '搜索' }).click()。
- 设置隔离天数：
page.getByRole('button', { name: '设置隔离天数' }).click() → page.getByLabel('默认隔离天数').fill('7') → 确定。
覆盖对照
| 类别 |
单元 UT |
接口 API |
界面 UI |
| 正常流程 |
UT-009、013～014 |
API-005～006、009、011、017～019、023 |
UI-005～006、010～012、015～016、019 |
| 异常流程 |
UT-003～008 |
API-007、010、013、015～016、020～022 |
UI-007、013～014、017 |
| 业务约束 |
UT-001～004、010 |
API-002～004、008、012、021 |
UI-002～004、008、012 |
| 编号 01～99 |
UT-001～003 |
API-005、008、012 |
UI-008、012 |
| 模糊筛选 |
UT-015 |
API-002～003 |
UI-002～003 |
| 逻辑删除 |
UT-011 |
API-004、014～016 |
UI-013 |
| 默认隔离天数 |
UT-005～008、013～014 |
API-017～022 |
UI-015～018 |
| 权限/鉴权 |
— |
API-024～027 |
UI-020 |
功能需求追溯（自查）
| 需求章节 |
要点 |
主要对应用例 |
| §5.1 新增圈位 |
备注、编号自动 |
UT-004、009；API-005～008；UI-005～009 |
| §5.2 列表 |
编号模糊、分页 |
UT-015～016；API-001～004；UI-001～004 |
| §5.3 修改 |
仅备注、编号不可改 |
UT-010；API-011～013；UI-011～012 |
| §5.4 详情 |
只读 |
API-009～010；UI-010、021 |
| §5.5 删除 |
逻辑删、关联 |
UT-011～012；API-014～016；UI-013～014 |
| §5.6 设置隔离天数 |
全局单份配置 |
UT-005～008、013～014；API-017～022；UI-015～018 |
| §2.2 编号 |
2 位自动 |
UT-001～003；API-005；UI-008 |
| §6 权限 |
含 config |
API-024～027；UI-020 |
修订记录
| 版本 |
说明 |
| 1.0 |
初版：单元 16、接口 28、UI 21；覆盖圈位 CRUD、模糊筛选、全局隔离天数、权限；Playwright+Chrome；前缀 ZCZX-GLQWGL |
