Strona główna Odkrywaj Pomoc
Zarejestruj się Zaloguj się
lbyzx123
/
huimv-baqing
Obserwuj 1
Polub 0
Forkuj 0
Files Problemy 0 Oczekujące zmiany 0 Commity 278 Wydania 0 Wiki

西藏巴青项目

Drzewo: f76ddbca1f
Gałęzie Tagi
huimv-baqing
/
doc
/
交易市场平台
/
入场隔离登记
/
入场隔离登记测试用例.md

入场隔离登记测试用例.md 17KB
Historia Czysty

入场隔离登记 — 测试用例

依据：入场隔离登记功能需求.md、入场隔离登记技术方案.md
接口 Base Path：/tradeMarket/entryIsolation；鉴权与若依一致（Cookie / Token）。

通用前置（无特殊说明）：具备本模块权限的账号已登录（tradeMarket:entryIsolation:list|query|add|edit|remove）。关联主数据宜预置：

类型 样本 要点
供应商 biz_supplier S1 id=1 扎西牧民合作社 del_flag=0
圈位 biz_isolation_pen P1 01、P2 02 del_flag=0
全局隔离天数 7 天 biz_isolation_setting.default_days=7（无则前端兜底 3）

合法新增 Body 示例（2 头、分 2 圈）：

{
  "entryTime": "2026-05-20 10:00:00",
  "supplierId": 1,
  "certNo": "QZ20260520001",
  "quantity": 2,
  "earTagList": ["E001", "E002"],
  "isolationDays": 7,
  "penAllocList": [
    { "penId": 1, "earTagList": ["E001"] },
    { "penId": 2, "earTagList": ["E002"] }
  ]
}

界面（UI）测试：Playwright + Chromium（channel: 'chrome' 使用本机 Google Chrome）。

一、单元测试用例

用例编号 测试模块 测试项 测试类型 测试工具 测试目的 前置条件 测试步骤 预期结果
ZCZX-RCGLDJ-UT-001 耳标解析 英文逗号拆分 单元测试 JUnit5 §2.5 无 EarTagCodec.parse("A,B,C") ["A","B","C"]
ZCZX-RCGLDJ-UT-002 耳标解析 中文逗号 单元测试 JUnit5 §2.3 无 parse("A，B") 2 段
ZCZX-RCGLDJ-UT-003 耳标解析 trim 与空段 单元测试 JUnit5 §2.3 无 parse(" A , , B ") ["A","B"]
ZCZX-RCGLDJ-UT-004 耳标解析 去重拒绝 单元测试 JUnit5 §2.3 无 parse("E1,E1") 抛异常或返回需校验失败
ZCZX-RCGLDJ-UT-005 耳标解析 单段超长 单元测试 JUnit5 §2.5 无 33 字符耳标 校验失败
ZCZX-RCGLDJ-UT-006 解除日期 自然日相加 单元测试 JUnit5 §2.5 无 calc("2026-05-20 10:00:00",7) 2026-05-27
ZCZX-RCGLDJ-UT-007 解除日期 跨月 单元测试 JUnit5 §2.5 无 entry=2026-05-28，days=5 2026-06-02
ZCZX-RCGLDJ-UT-008 一致性 R1 数量=耳标数 单元测试 JUnit5 §2.6 无 quantity=3，耳标 2 个 失败
ZCZX-RCGLDJ-UT-009 一致性 R2 分圈数量之和 单元测试 JUnit5 §2.6 总量 2 分圈 1+2 失败
ZCZX-RCGLDJ-UT-010 一致性 R3 耳标遗漏 单元测试 JUnit5 §2.6 主表 E1,E2 分圈仅 E1 失败
ZCZX-RCGLDJ-UT-011 一致性 R4 跨圈重复耳标 单元测试 JUnit5 §2.6 主表 E1,E2 两圈均含 E1 失败
ZCZX-RCGLDJ-UT-012 一致性 R5 本圈数量 单元测试 JUnit5 §2.6 无 圈行 quantity=2，耳标 1 个 失败
ZCZX-RCGLDJ-UT-013 一致性 合法全量 单元测试 JUnit5 §2.6 合法 Body validate(saveDto) 通过
ZCZX-RCGLDJ-UT-014 一致性 分圈为空 单元测试 JUnit5 §5.1 无 penAllocList=[] 失败
ZCZX-RCGLDJ-UT-015 一致性 同登记重复圈位 单元测试 JUnit5 §5.1.3 无 两条 penId=1 失败
ZCZX-RCGLDJ-UT-016 外键 供应商已删 单元测试 JUnit5+Mockito §2.8 del_flag=2 validate 失败
ZCZX-RCGLDJ-UT-017 外键 圈位已删 单元测试 JUnit5+Mockito §2.8 圈位已删 validate 失败
ZCZX-RCGLDJ-UT-018 字段校验 检疫证号长度 单元测试 JUnit5 §5.1 无 空、51 字、50 字 空/51 失败；50 通过
ZCZX-RCGLDJ-UT-019 字段校验 隔离天数范围 单元测试 JUnit5 §5.1 无 0、1、3650、3651 0/3651 失败；1/3650 通过
ZCZX-RCGLDJ-UT-020 文件校验 检疫证后缀 单元测试 JUnit5 §2.7 无 .exe、.pdf、.PDF exe 失败；pdf 通过
ZCZX-RCGLDJ-UT-021 Service 新增主从落库 单元测试 JUnit5+Mockito §3.3 Mock Mapper insert 合法样本 主表 del_flag=0；子表 2 行；expected_release_date 已算
ZCZX-RCGLDJ-UT-022 Service 修改覆盖分圈 单元测试 JUnit5+Mockito §3.3 已有 2 条子表 update 新 penAllocList 旧子表删净；新子表插入
ZCZX-RCGLDJ-UT-023 Service 逻辑删除 单元测试 JUnit5+Mockito §3.4 Mock remove(id) 主表 del_flag=2
ZCZX-RCGLDJ-UT-024 Service 删除有关联 单元测试 JUnit5+Mockito §2.9 hasReference=true remove 抛 ServiceException

二、接口测试用例

用例编号 测试模块 测试项 测试类型 测试工具 测试目的 前置条件 测试步骤 预期结果
ZCZX-RCGLDJ-API-001 列表 默认分页排序 接口测试 Postman §3.1 有登记数据 GET /list code=200；≤20 条；entryTime 倒序
ZCZX-RCGLDJ-API-002 列表 进场日期区间 接口测试 Postman §5.2.1 已知进场日 entryDateStart/End 含该日 命中；区间外不出现
ZCZX-RCGLDJ-API-003 列表 检疫证号模糊 接口测试 Postman §5.2.1 证号 QZ2026 certNo=QZ2026 含片段行
ZCZX-RCGLDJ-API-004 列表 供应商精确 接口测试 Postman §5.2.1 S1、S2 各有登记 supplierId=S1 仅 S1 记录
ZCZX-RCGLDJ-API-005 列表 组合筛选 接口测试 Postman 多条件 已登录 日期+证号+供应商 同时满足才命中
ZCZX-RCGLDJ-API-006 列表 不含已删除 接口测试 Postman 逻辑删除 某 id 已删 GET /list 无该 id
ZCZX-RCGLDJ-API-007 新增 合法全量 接口测试 Postman §5.1 S1、P1/P2 POST 合法 Body code=200；expectedReleaseDate=2026-05-27
ZCZX-RCGLDJ-API-008 新增 含检疫证文件 接口测试 Postman §2.7 已 /common/upload pdf Body 带 certFileUrl/Path 成功；详情可下载
ZCZX-RCGLDJ-API-009 新增 缺供应商 接口测试 Postman 异常 已登录 无 supplierId 失败
ZCZX-RCGLDJ-API-010 新增 缺检疫证号 接口测试 Postman 异常 已登录 空 certNo 失败
ZCZX-RCGLDJ-API-011 新增 R1 数量≠耳标数 接口测试 Postman §2.6 R1 已登录 quantity=2，耳标 1 个 失败；msg 含数量/耳标
ZCZX-RCGLDJ-API-012 新增 R2 分圈数量之和 接口测试 Postman §2.6 R2 总量 2 分圈 2+1 失败
ZCZX-RCGLDJ-API-013 新增 R3 未分圈耳标 接口测试 Postman §2.6 R3 主表 E1,E2 分圈仅 E1 失败
ZCZX-RCGLDJ-API-014 新增 R4 耳标跨圈重复 接口测试 Postman §2.6 R4 主表 E1,E2 两圈均 E1 失败
ZCZX-RCGLDJ-API-015 新增 重复圈位 接口测试 Postman §5.1.3 已登录 两条相同 penId 失败
ZCZX-RCGLDJ-API-016 新增 无效供应商 接口测试 Postman §2.8 已删供应商 id POST 失败
ZCZX-RCGLDJ-API-017 新增 无效圈位 接口测试 Postman §2.8 已删 penId POST 失败
ZCZX-RCGLDJ-API-018 新增 检疫证后缀非法 接口测试 Postman §2.7 已登录 certFilePath 为 .exe 失败
ZCZX-RCGLDJ-API-019 新增 隔离天数非法 接口测试 Postman §5.1 已登录 isolationDays=0/3651 失败
ZCZX-RCGLDJ-API-020 新增 主表耳标重复 接口测试 Postman §2.3 已登录 earTagList=["E1","E1"] 失败
ZCZX-RCGLDJ-API-021 新增 分圈耳标超集 接口测试 Postman §5.1.3 主表 E1 分圈含 E9 失败
ZCZX-RCGLDJ-API-022 详情 有效 id 接口测试 Postman §5.4 有登记 E1 GET /{id} 含 supplierName、earTagList、penAllocList
ZCZX-RCGLDJ-API-023 详情 无效/已删 id 接口测试 Postman 异常 已登录 不存在或已删 失败或 data 空
ZCZX-RCGLDJ-API-024 修改 改证号与分圈 接口测试 Postman §5.3 有 E1 PUT 改 certNo、重排分圈 成功；子表全量覆盖
ZCZX-RCGLDJ-API-025 修改 进场时间联动日期 接口测试 Postman §2.5 有 E1 PUT entryTime+isolationDays expectedReleaseDate 重算
ZCZX-RCGLDJ-API-026 修改 违反 R1 接口测试 Postman §2.6 有 E1 PUT 数量与耳标不一致 失败
ZCZX-RCGLDJ-API-027 修改 不存在 id 接口测试 Postman 异常 已登录 伪造 id PUT 失败
ZCZX-RCGLDJ-API-028 删除 单条逻辑删 接口测试 Postman §5.5 无关联新行 DELETE /{id} 成功；列表不可见
ZCZX-RCGLDJ-API-029 删除 有关联拒绝 接口测试 Postman §2.9 hasReference=true DELETE 失败；提示关联
ZCZX-RCGLDJ-API-030 删除 重复删除 接口测试 Postman 幂等 已删 id 再次 DELETE 失败或不存在
ZCZX-RCGLDJ-API-031 端到端 CRUD 串联 接口测试 Postman §4 已登录 POST→list→GET→PUT→DELETE 每步 code=200
ZCZX-RCGLDJ-API-032 鉴权 未登录 接口测试 curl 安全 无 Token GET /list 401 或统一未登录
ZCZX-RCGLDJ-API-033 权限 无新增权限 接口测试 Postman §6 仅 list POST 无权限失败
ZCZX-RCGLDJ-API-034 权限 无删除权限 接口测试 Postman §6 无 remove DELETE 无权限失败
ZCZX-RCGLDJ-API-035 响应 失败可读 接口测试 Postman §8 已登录 触发 R1、重复圈位 msg 可区分场景

三、界面测试用例（UI）

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

用例编号 测试模块 测试项 测试类型 测试工具 测试目的 前置条件 测试步骤 预期结果
ZCZX-RCGLDJ-UI-001 列表 默认展示 UI 测试 Playwright+Chrome §5.2.3 已登录；有数据 进入「入场隔离登记」 含进场时间、供应商、检疫证号、数量、圈位分配、隔离天数、解除日期、操作
ZCZX-RCGLDJ-UI-002 列表 进场日期筛选 UI 测试 Playwright+Chrome §5.2.1 已知日期登记 选日期范围→搜索 仅范围内记录
ZCZX-RCGLDJ-UI-003 列表 检疫证号模糊 UI 测试 Playwright+Chrome §5.2.1 有证号含 QZ 填片段→搜索 命中对应行
ZCZX-RCGLDJ-UI-004 列表 供应商筛选 UI 测试 Playwright+Chrome §5.2.1 多供应商数据 下拉选 S1→搜索 仅 S1
ZCZX-RCGLDJ-UI-005 列表 重置 UI 测试 Playwright+Chrome §5.2 已筛选 搜索→重置 条件清空；列表恢复
ZCZX-RCGLDJ-UI-006 列表 圈位分配表 UI 测试 Playwright+Chrome §5.2.3 有分圈数据 点击「圈位分配表」 弹窗展示圈位编号、数量、耳标
ZCZX-RCGLDJ-UI-007 新增 进场时间默认 UI 测试 Playwright+Chrome §5.1 有 add 权限 打开新增弹窗 进场时间≈当前时刻
ZCZX-RCGLDJ-UI-008 新增 供应商模糊选 UI 测试 Playwright+Chrome §2.8 有 S1 供应商输入关键字→选 S1 选中后展示名称
ZCZX-RCGLDJ-UI-009 新增 隔离天数默认 UI 测试 Playwright+Chrome §2.5 全局 7 天 打开新增 隔离天数默认 7
ZCZX-RCGLDJ-UI-010 新增 预计解除日期联动 UI 测试 Playwright+Chrome §2.5 新增弹窗 改进场日期或隔离天数 解除日期自动更新
ZCZX-RCGLDJ-UI-011 新增 上传检疫证合法 UI 测试 Playwright+Chrome §2.7 有 pdf≤30MB 上传 pdf 成功；可预览/删除
ZCZX-RCGLDJ-UI-012 新增 上传格式/大小非法 UI 测试 Playwright+Chrome §2.7 有 exe 或超大文件 选择上传 提示格式或 10/30MB 限制
ZCZX-RCGLDJ-UI-013 新增 添加分圈成功 UI 测试 Playwright+Chrome §5.1.3 主表耳标 E1,E2 添加分圈→P1 选 E1→P2 选 E2→确定 表格 2 行；数量各 1
ZCZX-RCGLDJ-UI-014 新增 分圈耳标不可重复选 UI 测试 Playwright+Chrome §5.1.3 R4 已分圈 E1 再添加分圈 下拉无 E1 或选后校验失败
ZCZX-RCGLDJ-UI-015 新增 同圈位不可重复 UI 测试 Playwright+Chrome §5.1.3 已占 P1 再添加 P1 提示圈位已添加
ZCZX-RCGLDJ-UI-016 新增 保存合法全流程 UI 测试 Playwright+Chrome §4.2 权限齐备 填主表+分圈→确定 成功提示；列表新行数据正确
ZCZX-RCGLDJ-UI-017 新增 R1 前端校验 UI 测试 Playwright+Chrome §2.6 新增 数量 2、耳标 1 个→保存 校验失败；不提交
ZCZX-RCGLDJ-UI-018 新增 未分圈保存 UI 测试 Playwright+Chrome §5.1 新增 填主表无分圈→保存 提示须添加分圈
ZCZX-RCGLDJ-UI-019 新增 取消 UI 测试 Playwright+Chrome §5.1.4 新增 填数据→取消 弹窗关；无新行
ZCZX-RCGLDJ-UI-020 查看 只读含分圈 UI 测试 Playwright+Chrome §5.4 有登记 点击查看 主表只读；分圈表只读；有检疫证链接
ZCZX-RCGLDJ-UI-021 编辑 改分圈保存 UI 测试 Playwright+Chrome §5.3 有登记 编辑→删一行分圈→重分圈→确定 列表/详情已更新
ZCZX-RCGLDJ-UI-022 编辑 分圈行删除 UI 测试 Playwright+Chrome §5.1.2 编辑 分圈表点删除 行移除
ZCZX-RCGLDJ-UI-023 删除 确认删除 UI 测试 Playwright+Chrome §5.5 无关联行 删除→确认 行消失
ZCZX-RCGLDJ-UI-024 删除 取消删除 UI 测试 Playwright+Chrome §5.5 任意行 删除→取消 行仍在
ZCZX-RCGLDJ-UI-025 端到端 全流程 UI 集成 Playwright+Chrome §4 权限齐备 新增→筛选→圈位表→查看→编辑→删除 无报错；数据一致
ZCZX-RCGLDJ-UI-026 权限 只读角色 UI 测试 Playwright+Chrome §6 仅 list/query 进入模块 无新增/编辑/删除按钮
ZCZX-RCGLDJ-UI-027 查看 从详情进编辑 UI 测试 Playwright+Chrome §5.4 查看弹窗 点「编辑」 进入编辑弹窗；数据回显

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

  • 安装：npm i -D @playwright/test；npx playwright install chrome。
  • 配置：use: { channel: 'chrome', locale: 'zh-CN', baseURL: 'http://localhost:80' }；storageState 复用登录态。
  • 路由：page.goto('/tradeMarket/entryIsolation')（以菜单 component 为准）。
  • 新增：page.getByRole('button', { name: '新增' }).click() → 填进场时间、选供应商、检疫证号、数量、耳标 → getByRole('button', { name: '添加分圈' }) 完成分圈 → 确定。
  • 分圈子窗：page.getByLabel('圈位编号').click() 选圈位 → 耳标多选 → 确定。
  • 列表筛选：page.getByLabel('进场日期') 用 daterange；getByRole('button', { name: '搜索' }).click()。

覆盖对照

类别 单元 UT 接口 API 界面 UI
正常流程 UT-013、021～022 API-007～008、022、024～025、031 UI-006～011、013、016、020～021、025
异常流程 UT-004、008～012、014～017、024 API-009～010、011～021、023、026～030 UI-012、017～018、023～024
业务约束 R1～R5 UT-008～015 API-011～015、020～021、026 UI-013～018
解除日期计算 UT-006～007 API-007、025 UI-009～010
耳标解析 UT-001～005 API-020 UI-013～014
关联主数据 UT-016～017 API-016～017 UI-008
检疫证文件 UT-020 API-008、018 UI-011～012
列表筛选 — API-002～005 UI-002～005
逻辑删除 UT-023 API-006、028～030 UI-023
权限/鉴权 — API-032～034 UI-026

功能需求追溯（自查）

需求章节 要点 主要对应用例
§5.1 新增 主表+分圈、校验 UT-008～015、021；API-007～021；UI-007～019
§5.2 列表 日期/证号/供应商 API-002～005；UI-002～006
§5.3 修改 全量可改、重算日期 UT-022；API-024～026；UI-021～022
§5.4 查看 只读、圈位分配表 API-022；UI-006、020、027
§5.5 删除 逻辑删、关联 UT-023～024；API-028～030；UI-023～024
§2.6 一致性 R1～R5 UT-008～015；API-011～015；UI-013～018
§2.5 解除日期 自动计算 UT-006～007；API-007、025；UI-010
§2.7 检疫证 后缀/大小 UT-020；API-008、018；UI-011～012
§2.8 关联 供应商/圈位 UT-016～017；API-016～017；UI-008
§6 权限 按钮级 API-032～034；UI-026

修订记录

版本 说明
1.0 初版：单元 24、接口 35、UI 27；覆盖 R1～R5、主从表 CRUD、筛选、检疫证、Playwright+Chrome；前缀 ZCZX-RCGLDJ