huimv-baqing/doc/牧业疫病诊疗服务/我的预约(机构)/我的预约(机构)测试用例.md

我的预约（机构）— 测试用例

依据：我的预约(机构)功能需求.md、我的预约(机构)技术方案.md
接口 Base Path：/diseaseTreatment/myAppointment/org；鉴权与若依一致（Cookie / Token）。
本期范围：登记制（列表 + 详情 + 完成接诊）；无确认/拒绝/评价接口。

通用前置（无特殊说明）：机构账号 B 已通过「畜牧医疗资源管理」为机构 O1（resource_type=3、account_assigned=1、sys_user_id=B）分配账号并绑定角色 102；具备权限 diseaseTreatment:orgMyAppointment:list|query|complete（无 confirm/reject）。biz_service_appointment 宜预置：

样本	归属	状态	要点
B0	O1，provider_type=2	已预约 5	可操作完成接诊；canComplete=true
B1	O1	已取消 3	仅查看
B2	O1	已完成 4	仅查看；无评价入口
BX	O2（另一机构）	已预约 5	账号 B 不可见/不可查详情
V0	兽医 R1，provider_type=1	待确认 0	机构列表不可见
E1	专家，provider_type=3	待确认 0	机构列表不可见
BAD（可选）	O1，provider_type=2	待确认 0	数据串单；用于异常防护用例

界面（UI）测试：Playwright + Chromium（channel: 'chrome' 使用本机 Google Chrome）；菜单示例「牧业疫病诊疗服务 → 我的预约（机构）」；组件路径 diseaseTreatment/myAppointment/org/index。

---

一、单元测试用例

用例编号	测试模块	测试项	测试类型	测试工具	测试目的	前置条件	测试步骤	预期结果
ZCZX-WDYYJG-UT-001	参数校验	预约日期范围	单元测试	JUnit5	§6.1、§9	无	OrgAppointmentValidation：startDate 晚于 endDate；相等；合法区间	前者失败，msg「结束日期不能早于开始日期」；后两者通过
ZCZX-WDYYJG-UT-002	参数校验	状态筛选合法集	单元测试	JUnit5	§4.1、技术方案 §2.2	无	status 为 3/4/5；null；0/1/2	前三与 null 通过；0/1/2 失败，msg「状态筛选无效」
ZCZX-WDYYJG-UT-003	状态展示	三态标签解析	单元测试	JUnit5	§4.1、§6.1	无	OrgAppointmentStatusResolver.resolveLabel(5/3/4)	已预约 / 已取消 / 已完成
ZCZX-WDYYJG-UT-004	状态展示	status=5 非「已确认」	单元测试	JUnit5	§3.1、技术方案 §5	无	resolveLabel(5)；对比兽医 resolveLabel(1)	机构为「已预约」；不得映射为「已确认」
ZCZX-WDYYJG-UT-005	状态规则	可完成接诊	单元测试	JUnit5	§6.5、§7	无	canCompleteOrg(3/4/5)	仅 status=5 为 true
ZCZX-WDYYJG-UT-005a	状态规则	机构无接单动作	单元测试	JUnit5	§5.2	无	审阅 Controller	无 confirm/reject 路由
ZCZX-WDYYJG-UT-016	Service	完成接诊成功	单元测试	JUnit5+Mockito	§6.5	Mock B0	complete(id)	status=4
ZCZX-WDYYJG-UT-017	Service	已取消不可完成	单元测试	JUnit5+Mockito	§6.5	Mock B1	complete	失败；已取消或不允许
ZCZX-WDYYJG-UT-018	Mapper	完成接诊 SQL	单元测试	JUnit5	技术方案 §3.2	审阅 XML	updateCompleteOrgAppointment	provider_type=2；status=5→4
ZCZX-WDYYJG-UT-006	范围解析	当前机构 providerId	单元测试	JUnit5+Mockito	§2.2、技术方案 §2.4	Mock 用户 B；库有 O1（resource_type=3）	OrgProviderResolver.resolveProviderId(B)	返回 O1.id
ZCZX-WDYYJG-UT-007	范围解析	未绑定机构	单元测试	JUnit5+Mockito	§9	用户无 resource_type=3 绑定	resolveProviderId	返回 null 或 Optional.empty
ZCZX-WDYYJG-UT-008	Service	列表数据范围	单元测试	JUnit5+Mockito	§6.1、§3.5	Mock Mapper；有 B0、BX、V0	selectList 账号 B	查询含 provider_type=2、provider_id=O1；仅 B0/B1/B2；无 BX/V0
ZCZX-WDYYJG-UT-009	Service	详情成功	单元测试	JUnit5+Mockito	§6.2	Mock B0	getById(B0.id)	返回全字段；含 timeStart/timeEnd/serviceAddress/serviceRequirement
ZCZX-WDYYJG-UT-010	Service	详情不含拒绝理由	单元测试	JUnit5+Mockito	§6.2、§5.2	Mock B0	检查 VO/Codec 或响应组装	不设置/不下发 rejectReason
ZCZX-WDYYJG-UT-011	Service	越权-他机构	单元测试	JUnit5+Mockito	§2.2	账号 B；目标 BX（O2）	getById(BX.id)	失败；msg「无权查看该预约记录」或「预约记录不存在」
ZCZX-WDYYJG-UT-012	Service	未绑定无法查详情	单元测试	JUnit5+Mockito	§9	无 O1 绑定	getById	失败；msg「未绑定机构资源，无法查询预约」
ZCZX-WDYYJG-UT-013	Service	未绑定列表为空	单元测试	JUnit5+Mockito	§9	无绑定	selectList	空列表（不抛错）或统一提示策略与实现一致
ZCZX-WDYYJG-UT-014	Service	串单异常状态	单元测试	JUnit5+Mockito	§4.3	Mock BAD（provider_type=2,status=0）	getById 或列表过滤	不展示或报错/记日志（与技术方案 §5 一致）
ZCZX-WDYYJG-UT-015	Mapper	机构列表 SQL	单元测试	JUnit5	§6.1、技术方案 §3.2	审阅 XML	selectOrgAppointmentList	provider_type=2；provider_id=；姓名 LIKE；日期区间；status=；ORDER BY appoint_date DESC, create_time DESC, id DESC

---

二、接口测试用例

用例编号	测试模块	测试项	测试类型	测试工具	测试目的	前置条件	测试步骤	预期结果
ZCZX-WDYYJG-API-001	列表	默认分页排序	接口测试	Postman	§6.1	账号 B；O1 多条样本	GET /list	code=200；rows≤20；appointDate 倒序
ZCZX-WDYYJG-API-002	列表	预约人模糊	接口测试	Postman	§6.1	B0 预约人含关键字	appointeeName=关键字片段	含 B0；不含无关人
ZCZX-WDYYJG-API-003	列表	预约日期区间	接口测试	Postman	§6.1	样本日期已知	startDate、endDate 含 B0 当天	含 B0；边界日包含
ZCZX-WDYYJG-API-004	列表	状态-已预约	接口测试	Postman	§6.1	有 B0	status=5	均为已预约；statusLabel 为「已预约」
ZCZX-WDYYJG-API-005	列表	状态-已取消/已完成	接口测试	Postman	§6.1	有 B1、B2	status=3；status=4	分别仅对应状态
ZCZX-WDYYJG-API-006	列表	日期区间非法	接口测试	Postman	§9	已登录	startDate 晚于 endDate	code≠200；msg「结束日期不能早于开始日期」
ZCZX-WDYYJG-API-007	列表	状态 0/1/2 非法	接口测试	Postman	§4.3、技术方案 §2.2	已登录	status=0、1、2 各一次	失败或 msg「状态筛选无效」
ZCZX-WDYYJG-API-008	列表	数据隔离-他机构	接口测试	Postman	§2.2	有 BX	账号 B GET /list	无 BX
ZCZX-WDYYJG-API-009	列表	数据隔离-兽医/专家	接口测试	Postman	§3.5	有 V0、E1	账号 B GET /list	无 V0、E1
ZCZX-WDYYJG-API-010	列表	未绑定机构	接口测试	Postman	§9	无 resource_type=3 绑定账号	GET /list	空列表；或 msg「未绑定机构资源，无法查询预约」
ZCZX-WDYYJG-API-011	列表	禁止传 providerId	接口测试	Postman	技术方案 §4.1	已登录	GET /list?providerId=伪造O2	仍以服务端 O1 为准；不可查 O2 数据
ZCZX-WDYYJG-API-012	列表	列表字段精简	接口测试	Postman	§6.1	有 B0	检查 rows[0] 字段	含 appointeeName/appointDate/contactPhone/status/statusLabel；可不返回或前端忽略 serviceAddress 等（以实现为准）
ZCZX-WDYYJG-API-013	详情	已预约全字段	接口测试	Postman	§6.2	有 B0	GET /{B0.id}	含 timeStart/timeEnd/serviceAddress/serviceRequirement；status=5；statusLabel=已预约
ZCZX-WDYYJG-API-014	详情	三态均可查看	接口测试	Postman	§7	有 B1、B2	分别 GET /{id}	code=200；状态与标签正确
ZCZX-WDYYJG-API-015	详情	无拒绝理由字段	接口测试	Postman	§6.2、§5.2	有 B0	GET /{id}	响应无 rejectReason；无 confirmTime/rejectTime（若实现统一 VO 则值为 null 且文档约定前端不展示）
ZCZX-WDYYJG-API-016	详情	越权-他机构	接口测试	Postman	§2.2	有 BX	账号 B GET /{BX.id}	失败；msg「无权查看」或「不存在」
ZCZX-WDYYJG-API-017	详情	不存在 id	接口测试	Postman	技术方案 §4.3	已登录	GET /999999999	失败；msg「预约记录不存在或已删除」
ZCZX-WDYYJG-API-018	详情	未绑定机构	接口测试	Postman	§9	无绑定	GET /{任意id}	失败；msg「未绑定机构资源，无法查询预约」
ZCZX-WDYYJG-API-019	本期范围	无确认接口	接口测试	Postman	§5.2	有 B0	POST /confirm/{B0.id}	404 或 405；路由不存在
ZCZX-WDYYJG-API-020	本期范围	无拒绝接口	接口测试	Postman	§5.2	有 B0	POST /reject/{B0.id}	404 或 405
ZCZX-WDYYJG-API-021	本期范围	无写方法	接口测试	Postman	§5.2	已登录	PUT/DELETE /{id}	404 或 405
ZCZX-WDYYJG-API-022	本期范围	无评价接口	接口测试	Postman	§5.2、§3.4	有 B2	GET .../reviewList/{id}	404 或未实现
ZCZX-WDYYJG-API-023	完成接诊	已预约成功	接口测试	Postman	§6.5	有 B0	POST /complete/{B0.id}	code=200；库 status=4
ZCZX-WDYYJG-API-023a	完成接诊	已取消禁止	接口测试	Postman	§6.5	有 B1	POST /complete/{B1.id}	失败
ZCZX-WDYYJG-API-023b	列表	canComplete	接口测试	Postman	§6.1	有 B0	GET /list	B0 行 canComplete=true
ZCZX-WDYYJG-API-031	权限	无 complete	接口测试	Postman	§7	无 complete	POST /complete/{id}	无权限失败
ZCZX-WDYYJG-API-032	端到端	登记+完成主流程	接口测试	Postman	§8.1	有 B0	list→complete→list	B0 变已完成
ZCZX-WDYYJG-API-024	端到端	筛选组合	接口测试	Postman	§6.1	多样本	appointeeName+日期+status=5	结果同时满足
ZCZX-WDYYJG-API-025	鉴权	未登录	接口测试	curl	安全	无 Token	GET /list	401 或未登录
ZCZX-WDYYJG-API-026	权限	无 list 权限	接口测试	Postman	§7	无 list 角色	GET /list	无权限失败
ZCZX-WDYYJG-API-027	权限	无 query 权限	接口测试	Postman	§7	仅 list	GET /{id}	无权限失败
ZCZX-WDYYJG-API-028	权限	无 confirm 误配	接口测试	Postman	§7	机构角色仅 list/query	尝试兽医路径 POST .../vet/confirm/{V0.id}	与机构模块无关；机构路径无此接口（见 API-019）
ZCZX-WDYYJG-API-029	响应	失败 msg 可读	接口测试	Postman	§9	已登录	触发日期非法、状态非法、越权	msg 与 §9/技术方案 §4.3 一致
ZCZX-WDYYJG-API-030	异常数据	串单记录	接口测试	Postman	§4.3	有 BAD（可选）	GET /list 或 GET /{BAD.id}	列表不含或详情报错；不展示待确认标签

---

三、界面测试用例（UI）

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

用例编号	测试模块	测试项	测试类型	测试工具	测试目的	前置条件	测试步骤	预期结果
ZCZX-WDYYJG-UI-001	列表	页面与精简列	UI 测试	Playwright+Chrome	§6.1	账号 B 登录；有样本	进入「我的预约（机构）」	列含预约人、预约日期、联系电话、状态、操作；无时段、地址、需求、拒绝理由列
ZCZX-WDYYJG-UI-002	列表	状态标签三态	UI 测试	Playwright+Chrome	§6.1	有 B0/B1/B2	查看各行状态	分别展示已预约/已取消/已完成；颜色可区分
ZCZX-WDYYJG-UI-003	列表	预约人筛选	UI 测试	Playwright+Chrome	§6.1	有 B0	填预约人→搜索	含匹配行
ZCZX-WDYYJG-UI-004	列表	日期与状态筛选	UI 测试	Playwright+Chrome	§6.1	有 B1	选日期区间+状态「已取消」→搜索	仅已取消行
ZCZX-WDYYJG-UI-005	列表	状态下拉仅三项	UI 测试	Playwright+Chrome	§4.1	已登录	打开状态下拉	仅已预约、已取消、已完成；无待确认/已确认/已拒绝
ZCZX-WDYYJG-UI-006	列表	日期非法提示	UI 测试	Playwright+Chrome	§9	已登录	结束日期早于开始→搜索	提示「结束日期不能早于开始日期」
ZCZX-WDYYJG-UI-007	列表	重置	UI 测试	Playwright+Chrome	§6.1	已筛选	搜索→点「重置」	条件清空；列表恢复
ZCZX-WDYYJG-UI-008	列表	默认分页	UI 测试	Playwright+Chrome	§6.1	>20 条 O1 数据	进入列表	每页 20 条；可翻页
ZCZX-WDYYJG-UI-009	操作列	已预约可完成	UI 测试	Playwright+Chrome	§7	有 B0	查看操作列	有查看、完成接诊
ZCZX-WDYYJG-UI-009a	操作列	已取消/已完成仅查看	UI 测试	Playwright+Chrome	§7	B1/B2	查看操作列	仅有「查看」；无确认/拒绝/评价
ZCZX-WDYYJG-UI-010	详情	只读弹窗全字段	UI 测试	Playwright+Chrome	§6.2	有 B0	点击查看	含预约人、日期、时段（HH:mm~HH:mm）、电话、地址、需求、状态；字段不可编辑
ZCZX-WDYYJG-UI-011	详情	无拒绝理由区	UI 测试	Playwright+Chrome	§6.2、§5.2	有 B0/B1/B2	分别打开详情	无「拒绝理由」表单项
ZCZX-WDYYJG-UI-012	详情	已完成无评价	UI 测试	Playwright+Chrome	§3.4、§5.2	有 B2	打开 B2 详情	无星级、综合评价、「查看评价」按钮
ZCZX-WDYYJG-UI-013	详情	关闭不变态	UI 测试	Playwright+Chrome	§6.2	有 B0	打开详情→点「确定」或「关闭」	弹窗关闭；列表状态仍为已预约；无成功提交类提示
ZCZX-WDYYJG-UI-014	详情	三态均可进入	UI 测试	Playwright+Chrome	§7	有 B0/B1/B2	各点查看	均可打开详情且字段完整（时段等仅在详情）
ZCZX-WDYYJG-UI-015	范围	未绑定账号	UI 测试	Playwright+Chrome	§9	无机构绑定账号	进入菜单或列表	无菜单或列表空/友好提示；页面不崩溃
ZCZX-WDYYJG-UI-016	权限	无 complete 角色	UI 测试	Playwright+Chrome	§7	仅 list/query	有 B0	无完成接诊；无确认/拒绝
ZCZX-WDYYJG-UI-017	对比	与兽医页差异	UI 测试	Playwright+Chrome	§3.3	可选	对比列表列与操作	机构列更少；无确认/拒绝；有完成接诊（已预约）
ZCZX-WDYYJG-UI-019	完成接诊	成功提示	UI 测试	Playwright+Chrome	§6.5	有 B0	完成接诊→确定	成功；状态变已完成
ZCZX-WDYYJG-UI-020	权限	无 complete 按钮	UI 测试	Playwright+Chrome	§7	无 complete	已预约行	无完成接诊
ZCZX-WDYYJG-UI-018	端到端	登记+完成流程	UI 集成	Playwright+Chrome	§8.1	权限齐备	筛选已预约→完成接诊→查已完成	状态与按钮符合 §7 矩阵

---

四、覆盖对照

类别	单元 UT	接口 API	界面 UI
正常流程（列表/详情/三态）	UT-003、008、009	API-001～005、012～015、023～024	UI-001～004、008～010、014、018
异常/校验	UT-001～002	API-006～007、017、029	UI-005～006
完成接诊（唯一写操作）	UT-005、016～018	API-023～023b、031～032	UI-009、019～020
无确认/拒绝	UT-005a	API-019～020	UI-009a
状态机（三态）	UT-003～004	API-004～005、014	UI-002、005、014
数据范围/三端隔离	UT-006～008、011	API-008～011、016	UI-015、017
列表精简/详情完整	UT-010	API-012～013	UI-001、010
无拒绝/无评价	UT-010	API-015、022	UI-011～012
串单/非法状态	UT-002、014	API-007、030	UI-005
权限/鉴权	UT-012、013	API-025～028	UI-016
与兽医差异（不做接单）	UT-005	API-019～021、028	UI-009、017

---

五、功能需求追溯

需求章节	要点	主要用例
§6.1 列表	范围、筛选、分页、精简列	API-001～012；UI-001～008
§6.2 详情	只读、时段/地址/需求、无拒绝理由	API-013～015；UI-010～011、013～014
§4.1 三态	已预约/已取消/已完成	UT-002～004；API-004～005；UI-002、005
§4.3 不应出现待确认等	串单防护	UT-014；API-007、030
§5.2 不做	确认/拒绝/评价	API-019～022；UI-009a、012
§6.5 完成接诊	已预约→已完成	UT-016～018；API-023～032；UI-009、019
§7 权限矩阵	查看+完成接诊	API-026～027、031；UI-009、016、020
§2.2、§3.5 数据隔离	仅本机构；与兽医/专家隔离	UT-008、011；API-008～009、016；UI-015、017
§8.1 主流程	查阅+完成	API-032；UI-018、019
§9 提示	文案一致	API-006、029；UI-005～006

---

六、Playwright 实施提示

• 安装：npm i -D @playwright/test；npx playwright install chrome。
  
• 配置：use: { channel: 'chrome', locale: 'zh-CN', baseURL: 'http://localhost:80' }；storageState 复用机构账号 B 登录态。
  
• 路由：page.goto('/diseaseTreatment/myAppointment/org')（以菜单 component 为准）。
  
• 定位示例：page.getByPlaceholder('请输入预约人')；page.getByRole('button', { name: '搜索' })；page.getByRole('button', { name: '查看' })；page.getByRole('button', { name: '完成接诊' })；断言 page.getByRole('button', { name: '确认接诊' }) count=0。
  
• 数据准备：「畜牧医疗资源管理」为 O1（resource_type=3）分配账号 B；向 biz_service_appointment 插入 provider_type=2、provider_id=O1.id、status∈{5,3,4} 样本；另备 O2/V0/E1 用于隔离用例。

---

七、修订记录

版本	说明
1.0	初版：单元 15、接口 30、UI 18；覆盖登记制三态只读、列表精简/详情完整、三端隔离、无确认拒绝评价、Playwright+Chrome
1.1	增补完成接诊；修正 Base Path；权限含 complete；取消「只读」表述