西藏巴青项目

畜牧监控 — 测试用例

依据：畜牧监控功能需求.md（v1.3）、畜牧监控技术方案.md（v1.3）
接口 Base Path：/videoSurveillance/livestockMonitor；鉴权与若依一致（Cookie / Token）。

样本	类型	名称	状态	用途
P1	养殖主体 `owner_type=1`	巴青牧场	`biz_pasture` 正常、`del_flag=0`	关联监控 C1
P2	养殖主体	停业牧场	`biz_status=2`	不可选/保存失败
M1	交易市场 `owner_type=2`	巴青县交易市场	`operate_status=1`	关联监控 C2
M2	交易市场	注销市场	`operate_status=3`	不可选/保存失败

biz_livestock_monitor（del_flag=0）：

样本	监控名称	monitor_id	所属主体	圈舍	视频来源	要点
C1	圈舍监控1	50001	P1	1号圈舍	wvp	列表/改删/实时预览主样本
C2	东门监控	50002	M1	东门	ys7	交易市场主体
C3	圈舍监控1	50003	P1	2号圈舍	wvp	与 C1 同名（唯一性不校验）

合法新增 Body 示例：monitorId=50099，monitorName=测试监控，videoSource=wvp，ownerType=1，ownerId={P1.id}，enclosureName=1号栏，installLocation=1号栏。

第三方 stub：thirdparty/stub-cameras.json（同步）；stub-camera-play-urls.json（/playUrl 实时预览）；配置 third-party.farming.mode=stub。

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

一、单元测试用例

用例编号	测试模块	测试项	测试类型	测试工具	测试目的	前置条件	测试步骤	预期结果
ZCZX-XMJK-UT-001	参数校验	监控名称	单元测试	JUnit5	§3.9	无	空、纯空白、11 字、10 字 trim	空/空白/超长失败；合法通过
ZCZX-XMJK-UT-002	参数校验	安装位置	单元测试	JUnit5	§3.9	无	空、11 字、10 字	可选；超长失败；合法通过
ZCZX-XMJK-UT-003	参数校验	视频来源	单元测试	JUnit5	§3.9	无	空、非法值、wvp/ys7/url	非法失败；合法通过
ZCZX-XMJK-UT-004	参数校验	摄像头 ID	单元测试	JUnit5	§3.9	无	空、33 字、合法	空/超长失败；通过
ZCZX-XMJK-UT-005	参数校验	主体类型	单元测试	JUnit5	§2.2	无	`ownerType=0/3`；`1/2`	非法失败；1/2 进入后续校验
ZCZX-XMJK-UT-006	主体校验	养殖主体正常	单元测试	JUnit5+Mockito	§2.3	Mock P1 存在且正常	`validateOwner(1,P1.id)`	通过；可解析 `ownerName`
ZCZX-XMJK-UT-007	主体校验	牧场停业	单元测试	JUnit5+Mockito	需求 §2.2	Mock P2	`validateOwner(1,P2.id)`	失败；主体不存在或已停用
ZCZX-XMJK-UT-008	主体校验	市场正常	单元测试	JUnit5+Mockito	§2.3	Mock M1	`validateOwner(2,M1.id)`	通过
ZCZX-XMJK-UT-009	主体校验	市场注销	单元测试	JUnit5+Mockito	§2.3	Mock M2	`validateOwner(2,M2.id)`	失败
ZCZX-XMJK-UT-010	唯一性	名称可重复	单元测试	JUnit5+Mockito	需求	库已有 C1	再 `validateRowForSave` 同名	通过
ZCZX-XMJK-UT-011	Service	新增冗余主体名	单元测试	JUnit5+Mockito	§2.3	Mock 主数据	`insert` 合法行	`owner_name` 与主数据名称一致
ZCZX-XMJK-UT-012	Service	逻辑删除	单元测试	JUnit5+Mockito	§3.5	Mock Mapper	`remove(id)`	`del_flag=2`
ZCZX-XMJK-UT-013	Service	已删不可改	单元测试	JUnit5+Mockito	需求 §5.3	`del_flag=2`	`update`	失败
ZCZX-XMJK-UT-014	ownerOptions	仅正常主体	单元测试	JUnit5+Mockito	§3.6	库含 P1/P2/M1/M2	`listOwnerOptions(null)`	仅含 P1、M1
ZCZX-XMJK-UT-015	ownerOptions	关键字模糊	单元测试	JUnit5+Mockito	§3.6	有 P1「巴青」	`keyword=巴青`	含 P1
ZCZX-XMJK-UT-016	Mapper	名称模糊 SQL	单元测试	JUnit5	§3.9	审阅 XML	`monitor_name LIKE CONCAT`
ZCZX-XMJK-UT-017	Mapper	主体精确 SQL	单元测试	JUnit5	§3.9	审阅 XML	`owner_type` AND `owner_id` 成对
ZCZX-XMJK-UT-018	Mapper	列表范围	单元测试	JUnit5	§3.9	审阅 XML	`del_flag='0'`；含 `monitor_id`；无 `video_url`
ZCZX-XMJK-UT-019	第三方同步	空列表	单元测试	JUnit5+Mockito	§3.7	stub 空	`syncFromThirdParty`	insert/update=0
ZCZX-XMJK-UT-020	第三方同步	新增与更新	单元测试	JUnit5+Mockito	§3.7	2 条摄像头	`sync`	insert=1, update=1
ZCZX-XMJK-UT-021	第三方同步	并发拒绝	单元测试	JUnit5+Mockito	§3.7	同步进行中	再次 `sync`	「正在同步，请稍候」
ZCZX-XMJK-UT-022	第三方同步	单条落库失败	单元测试	JUnit5+Mockito	§3.7	persist 抛错	`sync`	failCount+1
ZCZX-XMJK-UT-023	播放地址	按 monitorId 成功	单元测试	JUnit5+Mockito	§3.8	C1 存在；Mock play-url	`getPlayUrlByMonitorId('50001')`	返回 `videoUrl`
ZCZX-XMJK-UT-024	播放地址	点位不存在	单元测试	JUnit5+Mockito	§3.8	无记录	`getPlayUrlByMonitorId('99999')`	失败
ZCZX-XMJK-UT-025	播放地址	已删不可预览	单元测试	JUnit5+Mockito	§3.8	`del_flag=2`	`getPlayUrlByMonitorId`	失败

二、接口测试用例

用例编号	测试模块	测试项	测试类型	测试工具	测试目的	前置条件	测试步骤	预期结果
ZCZX-XMJK-API-001	列表	默认分页排序	接口测试	Postman	§3.1	有 C1～C3	`GET /list`	`code=200`；含 `ownerTypeName`；时间倒序
ZCZX-XMJK-API-002	列表	名称模糊	接口测试	Postman	§5.1	有 C1	`monitorName=圈舍`	含 C1、C3
ZCZX-XMJK-API-003	列表	主体精确	接口测试	Postman	§5.1	有 C2	`ownerType=2&ownerId={M1.id}`	仅含 C2
ZCZX-XMJK-API-004	列表	组合筛选	接口测试	Postman	§5.1	有 C1	`monitorName=圈舍`+P1 主体参数	含 C1、C3
ZCZX-XMJK-API-005	列表	不含已删除	接口测试	Postman	§5.5	某 id 已删	`GET /list`	无该 id
ZCZX-XMJK-API-006	列表	含监控字段	接口测试	Postman	§3.1	有 C1	`GET /list`	行含 `monitorId`、`videoSource`；无 `videoUrl`
ZCZX-XMJK-API-007	ownerOptions	全量选项	接口测试	Postman	§3.6	有 P1/M1	`GET /ownerOptions`	`code=200`；项含 `ownerType/ownerId/ownerName`
ZCZX-XMJK-API-008	ownerOptions	关键字	接口测试	Postman	§3.6	有 P1	`keyword=巴青`	含 P1
ZCZX-XMJK-API-009	新增	养殖主体监控	接口测试	Postman	§5.2	已登录	`POST` 合法 Body 绑 P1	`code=200`；`ownerName` 与 P1 一致
ZCZX-XMJK-API-010	新增	交易市场监控	接口测试	Postman	§5.2	已登录	`POST` `ownerType=2`+M1	成功
ZCZX-XMJK-API-011	新增	同名允许	接口测试	Postman	需求	已有 C1	`POST` 与 C1 同名	`code=200`（第二条）
ZCZX-XMJK-API-012	新增	缺监控名称	接口测试	Postman	§5.2	已登录	缺 `monitorName`	失败
ZCZX-XMJK-API-013	新增	名称超长	接口测试	Postman	§5.2	已登录	`monitorName` 11 字	失败
ZCZX-XMJK-API-014	新增	视频来源非法	接口测试	Postman	§3.9	已登录	`videoSource=invalid`	失败
ZCZX-XMJK-API-015	新增	停业牧场主体	接口测试	Postman	§2.2	已登录	`ownerType=1`+P2.id	失败
ZCZX-XMJK-API-016	新增	注销市场主体	接口测试	Postman	§2.2	已登录	`ownerType=2`+M2.id	失败
ZCZX-XMJK-API-017	详情	有效 id	接口测试	Postman	§3.2	有 C1	`GET /{id}`	含 `monitorId`、主体类型名称；无 `videoUrl`
ZCZX-XMJK-API-018	详情	已删/不存在	接口测试	Postman	§8	已登录	已删或 999999	失败；记录不存在或已删除
ZCZX-XMJK-API-019	修改	改圈舍	接口测试	Postman	§3.4	有 C1	`PUT` 改 `enclosureName`	成功
ZCZX-XMJK-API-020	修改	更换主体	接口测试	Postman	§5.3	有 C1	`PUT` 改绑 M1（type=2）	成功；`ownerName` 更新为市场名
ZCZX-XMJK-API-021	修改	已删记录	接口测试	Postman	§5.3	C1 已删	`PUT`	失败
ZCZX-XMJK-API-022	删除	单条逻辑删	接口测试	Postman	§5.5	新建行无依赖	`DELETE /{id}`	成功；`list` 不可见
ZCZX-XMJK-API-023	删除	批量删除	接口测试	Postman	§3.5	两条新行	`DELETE /id1,id2`	均不可见
ZCZX-XMJK-API-024	删除	重复删除	接口测试	Postman	幂等	已删 id	再次 `DELETE`	失败或 0 条
ZCZX-XMJK-API-025	端到端	CRUD 串联	接口测试	Postman	§4	已登录	`POST`→`list`→`GET`→`PUT`→`DELETE`	关键步 `code=200`
ZCZX-XMJK-API-026	鉴权	未登录	接口测试	curl	安全	无 Token	`GET /list`	401 或统一未登录
ZCZX-XMJK-API-027	权限	无新增	接口测试	Postman	§6	仅 list	`POST`	无权限失败
ZCZX-XMJK-API-028	权限	无删除	接口测试	Postman	§6	无 remove	`DELETE`	无权限失败
ZCZX-XMJK-API-029	同步	stub 全量同步	接口测试	Postman	§3.7	`mode=stub`	`POST /sync`	`insertCount`+`updateCount`≥0；不写 `video_url`
ZCZX-XMJK-API-030	同步	并发拒绝	接口测试	Postman	§3.7	同步进行中	再次 `POST /sync`	失败；正在同步
ZCZX-XMJK-API-031	同步	无 sync 权限	接口测试	Postman	§4	无 sync	`POST /sync`	无权限失败
ZCZX-XMJK-API-032	playUrl	stub 成功	接口测试	Postman	§3.8	C1；`mode=stub`	`GET /playUrl?monitorId=50001`	`videoUrl` 非空
ZCZX-XMJK-API-033	playUrl	无 monitorId	接口测试	Postman	§3.8	已登录	缺参数	失败
ZCZX-XMJK-API-034	playUrl	未登记摄像头	接口测试	Postman	§3.8	已登录	`monitorId=99999`	监控点位不存在
ZCZX-XMJK-API-035	playUrl	无 query 权限	接口测试	Postman	§4	无 query	`GET /playUrl`	无权限失败
ZCZX-XMJK-API-036	响应	失败可读	接口测试	Postman	§8	已登录	触发缺名称、非法 videoSource	`msg` 可区分场景

三、界面测试用例（UI）

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

用例编号	测试模块	测试项	测试类型	测试工具	测试目的	前置条件	测试步骤	预期结果
ZCZX-XMJK-UI-001	列表	默认展示	UI 测试	Playwright+Chrome	§5.1、原型	已登录；有 C1	进入「畜牧监控」	列：监控名称、所属主体、安装位置、操作
ZCZX-XMJK-UI-002	列表	名称模糊搜索	UI 测试	Playwright+Chrome	§5.1	有 C1	监控名称填「圈舍」→搜索	含 C1、C3
ZCZX-XMJK-UI-003	列表	主体筛选	UI 测试	Playwright+Chrome	§5.1	有 C2	所属主体选 M1→搜索	仅 C2
ZCZX-XMJK-UI-004	列表	重置	UI 测试	Playwright+Chrome	§5.1	已筛选	搜索→重置	条件清空；列表恢复
ZCZX-XMJK-UI-005	列表	未点搜索不筛	UI 测试	Playwright+Chrome	平台惯例	有数据	仅改名称不点搜索	列表不变
ZCZX-XMJK-UI-006	同步	stub 同步	UI 测试	Playwright+Chrome	§3.3	有 sync	点击同步	成功提示；列表出现 stub 数据
ZCZX-XMJK-UI-007	新增	主体下拉模糊	UI 测试	Playwright+Chrome	§2.2	有 P1	所属主体输入「巴青」	可选 P1；显示类型标签
ZCZX-XMJK-UI-008	新增	缺必填校验	UI 测试	Playwright+Chrome	§5.2	新增弹窗	空名称或未选 videoSource→确定	校验失败；弹窗不关闭
ZCZX-XMJK-UI-009	新增	名称超 10 字	UI 测试	Playwright+Chrome	§5.2	新增	名称输入超 10 字	`maxlength` 或保存失败
ZCZX-XMJK-UI-010	新增	取消	UI 测试	Playwright+Chrome	§5.2	新增	填一半→取消	无新行
ZCZX-XMJK-UI-011	查看	详情只读	UI 测试	Playwright+Chrome	§5.4	有 C1	点击查看	只读；含主体类型、`monitorId`
ZCZX-XMJK-UI-012	编辑	修改字段	UI 测试	Playwright+Chrome	§5.3	有 C1	编辑→改安装位置→保存	列表/详情已更新
ZCZX-XMJK-UI-013	编辑	更换主体	UI 测试	Playwright+Chrome	§5.3	有 C1	编辑→改选 M1→保存	所属主体显示为 M1
ZCZX-XMJK-UI-014	删除	确认删除	UI 测试	Playwright+Chrome	§5.5	无依赖新行	删除→确认	行消失
ZCZX-XMJK-UI-015	删除	取消删除	UI 测试	Playwright+Chrome	§5.5	任意行	删除→取消	行仍在
ZCZX-XMJK-UI-016	实时监控	stub 播放	UI 测试	Playwright+Chrome	§5.6	有 C1；stub	点击查看实时监控	弹窗打开；LivePlayer 有地址
ZCZX-XMJK-UI-017	实时监控	无 monitorId	UI 测试	Playwright+Chrome	§5.6	行缺 monitorId	点击查看实时监控	提示缺少摄像头 ID
ZCZX-XMJK-UI-018	权限	只读角色	UI 测试	Playwright+Chrome	§6	仅 list/query	进入模块	无新增/编辑/删除/同步按钮
ZCZX-XMJK-UI-019	端到端	全流程	UI 集成	Playwright+Chrome	§4	权限齐备	同步→搜索→实时预览→编辑→删	无报错
ZCZX-XMJK-UI-020	主体	停业不可选	UI 测试	Playwright+Chrome	§2.2	有 P2 停业	新增→主体下拉搜 P2	无选项或不可选

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

安装：npm i -D @playwright/test；npx playwright install chrome。
配置：use: { channel: 'chrome', locale: 'zh-CN', baseURL: 'http://localhost:80' }；storageState 复用登录态。
路由：page.goto('/videoSurveillance/livestockMonitor')（以菜单 component 为准）。
筛选：page.getByPlaceholder('请输入监控名称').fill('圈舍')；所属主体用 el-select + 远程搜索。
同步：page.getByRole('button', { name: '同步' }).click()；expect(page.getByText('同步完成')).toBeVisible()。
新增：page.getByRole('button', { name: '新增' }).click()；填 monitorId、名称、视频来源等；确定。
实时监控：page.getByRole('button', { name: '查看实时监控' }).first().click()；expect(page.locator('.live-player-wrap')).toBeVisible()。

覆盖对照

类别	单元 UT	接口 API	界面 UI
正常 CRUD	UT-011	API-009～010、017、019～020、025	UI-011～013、019
列表筛选	UT-016～018	API-001～004	UI-002～005
主体约束	UT-006～009、014～015	API-007～008、015～016	UI-007、020
字段校验	UT-001～005	API-012～014	UI-008～009
唯一性不校验	UT-010	API-011	—
逻辑删除	UT-012～013	API-005、022～024	UI-014～015
第三方同步	UT-019～022	API-029～031	UI-006
实时播放	UT-023～025	API-032～035	UI-016～017
鉴权权限	—	API-026～028、031、035	UI-018
ownerOptions	UT-014～015	API-007～008	UI-007
监控字段	UT-003～004	API-006	UI-001

修订记录

版本	说明
1.0	初稿：对齐功能需求 v1.1、技术方案 v1.0；UT/API/UI；Playwright+Chrome
1.1	对齐 v1.2 实现：新字段、移除 IP；增加第三方同步 UT/API/UI 用例
1.2	对齐 v1.3：移除 `video_url` 与同步阶段二；新增 `/playUrl` UT/API/UI；实时预览 LivePlayer

畜牧监控测试用例.md 16KB Historie Surový