huimv-baqing/doc/养殖标准体系/药物禁配标准/药物禁配标准管理测试用例.md

药物禁配标准管理 — 测试用例

依据：药物禁配标准管理功能需求.md、药物禁配标准管理技术方案.md
接口 Base Path：/breedingStandards/diseaseTreatment/drugIncompatibility；若含 context-path 或网关前缀须补齐。鉴权与若依一致（Cookie / Token）。
权限标识（建议）：drugIncompatibility:standard:list|query|add|edit|remove|syncKb|removeKb（无 publish / offline）。

通用前置（无特殊说明）：具备本模块菜单与按钮权限的账号已登录；测试环境可访问知识库或已按技术方案启用占位（如 LOCAL-{id}）。主药名称：必填，1～20 字符（计数口径与项目全局一致）；允许重复。配伍药物：至少 1 条；每条名称 1～20 字符；trim 后互不相同且均不等于主药；顺序与保存一致。配伍结果：选填，≤50 字符。知识库同步状态：0 未同步 / 1 已同步；本模块不设发布/下架。列表默认 keyword 仅匹配主药名（不匹配配伍名，除非需求已扩展并验收）。

知识库说明：后端当前可为占位实现（同步即成功写 LOCAL-{id}）。含「知识库调用失败」的用例在占位阶段可标为 待 HTTP 对接后执行；或通过对 Service 编排层 Mock 失败路径单独补测。

界面（UI）测试：借助 Playwright 启动 Chromium（与 Google Chrome 同源内核）；可配置 channel: 'chrome' 调用本机已安装的谷歌浏览器，模拟点击、输入与断言。前端菜单路由以实际若依页面为准（未上线页面时步骤中菜单名写为占位，落地后替换）。

---

一、单元测试用例

用例编号	测试模块	测试项	测试类型	测试工具	测试目的	前置条件	测试步骤	预期结果
JP-BZ-UT-001	枚举/持久化	kb_sync_status 合法值	单元测试	JUnit5	仅两种稳态	无	校验/映射仅允许 0、1；拒绝 2、-1 等	非法值拒绝；0/1 合法
JP-BZ-UT-002	状态守卫	编辑前置	单元测试	JUnit5	需求 4.3、操作矩阵	无	canEdit(kb=0) true；canEdit(kb=1) false	已同步不可改
JP-BZ-UT-003	状态守卫	删除前置	单元测试	JUnit5	需求 4.4	无	canDelete(kb=0) true；canDelete(kb=1) false	已同步须先移出
JP-BZ-UT-004	状态守卫	同步知识库前置	单元测试	JUnit5	需求 4.5、矩阵	无	canSyncKb(kb=0) true；canSyncKb(kb=1) false	仅未同步可同步
JP-BZ-UT-005	状态守卫	移出知识库前置	单元测试	JUnit5	需求 4.6、矩阵	无	canRemoveKb(kb=1) true；canRemoveKb(kb=0) false	仅已同步可移出
JP-BZ-UT-006	参数校验	主药名称长度	单元测试	JUnit5	需求 4.1	无	空串、21 字、validateMainDrugName；合法 1～20 字	空/超长失败；合法通过
JP-BZ-UT-007	参数校验	配伍结果长度	单元测试	JUnit5	需求 4.1	无	null、全空白、50 字、51 字	null/空白/50 通过；51 失败
JP-BZ-UT-008	参数校验	配伍列表至少一条	单元测试	JUnit5	需求 2.3、4.1	companions=[]	validateCompanions	抛错（至少一条）
JP-BZ-UT-009	参数校验	配伍名同条重复	单元测试	JUnit5	需求 2.3	两条配伍 trim 后同名	validateCompanions	抛错（不能重复）
JP-BZ-UT-010	参数校验	配伍名与主药相同	单元测试	JUnit5	需求 2.3	配伍名与主药 trim 后相同	validateCompanions	抛错（不能与主药相同）
JP-BZ-UT-011	参数校验	trimFieldsForSave	单元测试	JUnit5	需求 2.3 名称口径	主药/配伍含首尾空格；配伍结果为空白串	trimFieldsForSave 后再校验	主药、配伍 trim 正确；空配伍结果变 null
JP-BZ-UT-012	Service	新增落库与子表	单元测试	JUnit5+Mockito	需求 4.1	Mock 主表 insert 回填 id；Mock 子表 insert	insertBizDrugIncompatibilityStandard(合法体)	kb_sync_status=0；子表 insert 被调用
JP-BZ-UT-013	Service	修改—已同步拒绝	单元测试	JUnit5+Mockito	需求 2.2、4.3	库中 kb=1	updateBizDrugIncompatibilityStandard	业务失败；不写主表 update
JP-BZ-UT-014	Service	修改—未同步替换子表	单元测试	JUnit5+Mockito	技术方案一致性	kb=0；Mock update/delete/insert	update 成功路径	先 deleteByStandardId 再批量 insert；kb 不被客户端篡改
JP-BZ-UT-015	Service	修改—主键为空	单元测试	JUnit5+Mockito	异常流程	id=null	update	抛错（主键不能为空）
JP-BZ-UT-016	Service	同步成功（占位）	单元测试	JUnit5+Mockito	需求 4.5	kb=0；Mock update	syncKb(id)	kb=1；kb_doc_id 含 LOCAL-{id} 或非空
JP-BZ-UT-017	Service	同步—已同步拒绝	单元测试	JUnit5+Mockito	需求 4.5 互斥	kb=1	syncKb	抛错；不更新为成功态
JP-BZ-UT-018	Service	移出成功	单元测试	JUnit5+Mockito	需求 4.6	kb=1；Mock update	removeKb(id)	kb=0；kb_doc_id 清空
JP-BZ-UT-019	Service	移出—未同步拒绝	单元测试	JUnit5+Mockito	矩阵互斥	kb=0	removeKb	抛错
JP-BZ-UT-020	Service	删除—已同步拒绝	单元测试	JUnit5+Mockito	需求 4.4	kb=1	deleteBizDrugIncompatibilityStandardByIds	抛错；不执行主表 delete
JP-BZ-UT-021	Service	删除—批量含已同步整单失败	单元测试	JUnit5+Mockito	需求 4.4 批量	ids 含未同步+已同步	delete...ByIds	抛错；主表 delete 不调用
JP-BZ-UT-022	Service	删除—未同步成功	单元测试	JUnit5+Mockito	需求 4.4	全部 kb=0	delete...ByIds	主表 delete 调用（子表级联由库保证）
JP-BZ-UT-023	Service	详情带子表顺序	单元测试	JUnit5+Mockito	需求 4.7	Mock 主表+多行子表	selectBizDrugIncompatibilityStandardById	companions 条数与顺序与 Mapper 一致
JP-BZ-UT-024	Mapper/XML（可选）	列表 keyword 仅主药	单元测试	MyBatis 集成或手工 SQL	需求 4.2、技术方案 3.1	造数：主药不含「甲」、配伍名含「甲」	list 带 keyword=甲	该条不命中（默认仅主药模糊）

---

二、接口测试用例

用例编号	测试模块	测试项	测试类型	测试工具	测试目的	前置条件	测试步骤	预期结果
JP-BZ-API-001	列表	默认分页与排序	接口测试	Postman/curl/MockMvc	需求 4.2	已登录；有多条	GET /drugIncompatibility/standard/list?pageNum=1&pageSize=10	rows/total 正常；默认创建时间新在前（与技术方案一致）
JP-BZ-API-002	列表	主药名称模糊	接口测试	Postman	需求 4.2	已登录	keyword= 仅命中 main_drug_name 子串	返回含预期行
JP-BZ-API-003	列表	关键字不匹配「仅配伍含词」	接口测试	Postman	需求 4.2、1.2	主药不含「测」、配伍名含「测」	keyword=测	不出现该行
JP-BZ-API-004	列表	展示同步状态与配伍条数	接口测试	Postman	需求 4.2	已登录；有 0/1 状态数据	GET .../list	行内含 kbSyncStatus、companionCount（字段名与前端一致即可）
JP-BZ-API-005	新增	合法提交（含多配伍）	接口测试	Postman/MockMvc	正常主流程 4.1	已登录；add 权限	POST /drugIncompatibility/standard Body：mainDrugName、compatResult 可空、companions≥1	code 成功；库中 kb_sync_status=0；子表条数一致
JP-BZ-API-006	新增	主药非法	接口测试	Postman	需求 4.1	已登录	主药空或 21 字或缺主药	失败；无新主表行
JP-BZ-API-006a	新增	主药名称可重复	接口测试	Postman	需求 4.1	已存在 mainDrugName=主药A	POST 再提交同名（配伍不同）	成功；两条主药名相同记录并存
JP-BZ-API-007	新增	配伍条数/重复/同主药	接口测试	Postman	需求 2.3、4.1	已登录	companions 空数组；或两配伍同名；或配伍=主药	失败；可读 msg
JP-BZ-API-008	新增	配伍结果超长	接口测试	Postman	需求 4.1	已登录	compatResult 长度 51	失败
JP-BZ-API-009	详情	有效 id	接口测试	Postman	需求 4.7	已登录	GET /drugIncompatibility/standard/{id}	含主药、有序 companions、配伍结果、同步状态
JP-BZ-API-010	详情	无效 id	接口测试	Postman	异常	已登录	不存在 id	404 或业务失败；与项目约定一致
JP-BZ-API-011	修改	未同步成功	接口测试	Postman	需求 4.3	已登录；目标 kb=0	PUT /drugIncompatibility/standard Body 含 id、主药/配伍/结果	成功；仍为 kb=0；详情与提交一致
JP-BZ-API-012	修改	已同步拒绝	接口测试	Postman	需求 4.3、矩阵	已登录；目标 kb=1	PUT ... 改任意业务字段	失败；数据不变
JP-BZ-API-013	删除	未同步成功	接口测试	Postman	需求 4.4	已登录；kb=0	DELETE /drugIncompatibility/standard/{id}	成功；记录消失（GET 无或失败）
JP-BZ-API-014	删除	已同步拒绝	接口测试	Postman	需求 4.4	已登录；kb=1	DELETE ...	失败；提示先移出
JP-BZ-API-015	删除	批量 ids	接口测试	Postman	技术方案 3.5	已登录；多条 kb=0	DELETE .../1,2,3	全部删除成功（与若依逗号分隔惯例一致）
JP-BZ-API-016	删除	批量含已同步整单失败	接口测试	Postman	需求 4.4 批量	ids 含未同步+已同步	DELETE .../id1,id2	失败；均未删或符合先校验实现；msg 可读
JP-BZ-API-017	同步知识库	未同步成功	接口测试	Postman	需求 4.5	已登录；kb=0	POST /drugIncompatibility/standard/syncKb/{id}	kb=1；kb_doc_id 非空
JP-BZ-API-018	同步知识库	已同步重复调用	接口测试	Postman	矩阵、4.5 互斥	已登录；kb=1	POST .../syncKb/{id}	失败；仍为已同步
JP-BZ-API-019	同步知识库	失败不翻转	接口测试	Postman+Mock 对端	需求 4.5	待 KB 对接：对端失败	POST .../syncKb/{id}	仍为未同步；msg 可读可重试（占位阶段可跳过）
JP-BZ-API-020	移出知识库	已同步成功	接口测试	Postman	需求 4.6	已登录；kb=1	POST /drugIncompatibility/standard/removeKb/{id}	kb=0；kb_doc_id 空
JP-BZ-API-021	移出知识库	未同步调用	接口测试	Postman	矩阵	已登录；kb=0	POST .../removeKb/{id}	失败
JP-BZ-API-022	移出知识库	失败保持已同步	接口测试	Postman	需求 4.6	待 KB 对接：对端失败	POST .../removeKb/{id}	仍为已同步（占位阶段可跳过）
JP-BZ-API-023	关键路径	移出→改→再同步	接口测试	Postman	需求 3.3	一条 kb=1	removeKb→PUT→syncKb	最终 kb=1；业务与最后一次 PUT 一致
JP-BZ-API-024	鉴权	未登录	接口测试	curl	安全	无 Token/Cookie	GET .../list	401 或重定向登录
JP-BZ-API-025	权限	无对应按钮权限	接口测试	Postman	需求 第 7 章	仅 list 无 add	POST /drugIncompatibility/standard	无权限失败
JP-BZ-API-026	错误提示	校验与业务失败可读	接口测试	Postman	需求 第 6 章	已登录	触发校验失败、已同步删除等	msg 区分输入不合法与状态不允许

---

三、界面测试用例（UI）

测试工具：Playwright + Chromium（channel: 'chrome' 时使用本机 Google Chrome）。步骤与脚本映射：page.goto、locator.fill、locator.click、expect；删除/同步/移出等二次确认：page.once('dialog') 或页面内「确定」按钮。

用例编号	测试模块	测试项	测试类型	测试工具	测试目的	前置条件	测试步骤	预期结果
JP-BZ-UI-001	列表	默认分页与排序	UI 测试	Playwright+Chrome/Chromium	需求 4.2	已登录；数据>默认页大小	进入药物禁配标准列表（路由占位）	每页条数与项目一致；创建时间新在前
JP-BZ-UI-002	列表	主药关键字	UI 测试	Playwright+Chrome/Chromium	主药模糊	存在主药含关键词记录	输入关键字→查询	表格含该行
JP-BZ-UI-003	列表	关键字不匹配「仅配伍含词」	UI 测试	Playwright+Chrome/Chromium	与 4.2 默认维度	造数：主药不含「测」、配伍含「测」	关键字「测」→查询	不出现该行
JP-BZ-UI-004	列表	同步状态与配伍条数/摘要	UI 测试	Playwright+Chrome/Chromium	需求 4.2	多条数据	查看列表列	可见未同步/已同步；可见配伍条数或等价摘要（若 UI 实现）
JP-BZ-UI-005	列表	操作矩阵	UI 测试	Playwright+Chrome/Chromium	需求 第 5 章	未同步、已同步各一条	逐行查看按钮	未同步：查/改/删/同步，无移出；已同步：查/移出，无改/删/同步
JP-BZ-UI-006	新增	完整合法主流程	UI 集成	Playwright+Chrome/Chromium	需求 4.1、3.2	有新增权限	新增→主药+至少一条配伍+可选配伍结果→提交	成功提示；列表新行未同步
JP-BZ-UI-007	新增	配伍行增减与边界	UI 测试	Playwright+Chrome/Chromium	需求 2.3、4.1	打开新增	用 +/- 增减行；试删至 0 条；两配伍同名；配伍=主药；配伍结果超长	对应校验失败；不能 0 条保存
JP-BZ-UI-008	详情	字段与同步状态	UI 测试	Playwright+Chrome/Chromium	需求 4.7	已有一条	点详情/查看	展示主药、有序配伍列表、配伍结果、同步状态
JP-BZ-UI-009	详情	已同步只读	UI 测试	Playwright+Chrome/Chromium	需求 4.7	已同步记录	打开详情	无保存式编辑或编辑入口不可用
JP-BZ-UI-010	详情	未同步可进编辑	UI 测试	Playwright+Chrome/Chromium	需求 4.7	未同步记录	详情或列表进编辑	可改并保存；列表/详情刷新后所见即所得
JP-BZ-UI-011	修改	未同步保存成功	UI 集成	Playwright+Chrome/Chromium	需求 4.3	未同步样本	改主药或配伍顺序/内容→保存	成功；仍为未同步
JP-BZ-UI-012	修改	已同步不可改	UI 测试	Playwright+Chrome/Chromium	需求 4.3、矩阵	已同步样本	尝试编辑	无编辑或保存被拒绝
JP-BZ-UI-013	知识库	同步成功	UI 集成	Playwright+Chrome/Chromium	需求 4.5	未同步记录	点「同步知识库」→确认（若有）	状态变已同步
JP-BZ-UI-014	知识库	已同步无「同步」入口	UI 测试	Playwright+Chrome/Chromium	矩阵	已同步行	查看操作区	「同步」隐藏或禁用
JP-BZ-UI-015	知识库	同步失败提示与可重试	UI 测试	Playwright+Chrome/Chromium	需求 4.5、第 6 章	未同步；KB 失败环境或 Mock	点同步	明确失败文案；未同步；可再试（占位阶段可跳过）
JP-BZ-UI-016	知识库	移出成功	UI 集成	Playwright+Chrome/Chromium	需求 4.6	已同步记录	点「移出知识库」→确认	变未同步；可再编辑
JP-BZ-UI-017	知识库	未同步无「移出」	UI 测试	Playwright+Chrome/Chromium	矩阵	未同步行	查看操作区	「移出」隐藏或禁用
JP-BZ-UI-018	知识库	移出失败提示	UI 测试	Playwright+Chrome/Chromium	需求 4.6	已同步；KB 移出失败（对接后）	点移出	仍为已同步；可读错误（占位阶段可跳过）
JP-BZ-UI-019	删除	未同步删除	UI 测试	Playwright+Chrome/Chromium	需求 4.4	未同步记录	删除→二次确认确定	记录从列表消失
JP-BZ-UI-020	删除	已同步不可删	UI 测试	Playwright+Chrome/Chromium	需求 4.4	已同步记录	尝试删除	无删除或失败并提示先移出
JP-BZ-UI-021	删除	取消确认不删	UI 测试	Playwright+Chrome/Chromium	需求 4.4 交互	未同步	删除→取消	记录仍在
JP-BZ-UI-022	批量删除	含已同步整单失败	UI 测试	Playwright+Chrome/Chromium	需求 4.4	前端若支持多选删除	勾选未同步+已同步→删除	整单失败提示；数据未被部分误删
JP-BZ-UI-023	端到端	状态机全链路	UI 集成	Playwright+Chrome/Chromium	需求 3.2、3.3	可新建	新增(未同步)→同步(已同步)→详情只读→移出(未同步)→编辑保存→再同步(已同步)→移出→删除	每步与矩阵一致；最终删除成功
JP-BZ-UI-024	权限	只读/无写权限账号	UI 测试	Playwright+Chrome/Chromium	需求 第 7 章	无 add/edit 等	登录进入模块	无新增/编辑/删除或按钮不可见；若有 list 可查
JP-BZ-UI-025	回归	无发布/下架入口	UI 测试	Playwright+Chrome/Chromium	需求 第 1 章 边界	任意状态	扫页面按钮与路由	无「发布」「下架」类操作

---

四、用例与需求/设计追溯（摘要）

需求章节	单元测试	接口测试	UI 测试
4.1 新增与字段规则	UT-006～011、012	API-005～008	UI-006、UI-007
4.2 列表	UT-024	API-001～004	UI-001～004
4.3 修改	UT-002、013～015	API-011、012	UI-011、012
4.4 删除与幂等通知	UT-003、020～022	API-013～016	UI-019～022
4.5 同步	UT-004、016、017	API-017～019	UI-013～015
4.6 移出	UT-005、018、019	API-020～022	UI-016～018
4.7 详情	UT-023	API-009、010	UI-008～010
第 5 章 操作矩阵	UT-002～005、017、019	API-012、014、018、021	UI-005、012、014、017、020
第 6 章 错误提示	UT-006～010	API-026	UI-007、015
3.3 关键路径	—	API-023	UI-023
2.3 配伍约束	UT-008～011	API-007	UI-007

---

五、Playwright 脚本提示（可选落地）

// 示例：使用本机 Chrome（需已安装）；无则去掉 channel 使用内置 Chromium
import { test, expect } from '@playwright/test';

test.use({ channel: 'chrome', headless: true });

test('JP-BZ-UI-023 摘要：新增→同步→移出→改→再同步→移出→删', async ({ page }) => {
  await page.goto(process.env.BASE_URL + '/#/login');
  await page.getByPlaceholder('用户名').fill(process.env.USER!);
  await page.getByPlaceholder('密码').fill(process.env.PASS!);
  await page.getByRole('button', { name: /登录/ }).click();
  // 进入「药物禁配标准」菜单（文案与路由以实际为准）
  await page.getByText('药物禁配', { exact: false }).click();
  // 新增：填写主药、配伍行（+ 添加行）、配伍结果；提交
  // 列表：同步知识库 → 详情断言已同步 → 移出 → 编辑保存 → 再同步 → 移出 → 删除
  // await expect(page.getByRole('row', { name: /未同步|已同步/ })).toBeVisible();
});

说明：具体菜单路径、表单 label、配伍行「+/-」按钮、同步/移出确认框选择器以若依前端实现为准；建议将 BASE_URL、登录信息与 Page Object 抽离，便于 CI 与多环境复用。