huimv-baqing/doc/视频监控系统/对接畜牧监控/畜牧监控测试用例.md

畜牧监控 — 测试用例

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

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

样本	类型	名称	状态	用途
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