# 牧场管理 — 测试用例

> 依据：`牧场管理功能需求.md`、`牧场管理技术方案.md`  
> **接口 Base Path**：`/dataModel/pasture`；鉴权与若依一致（Cookie / Token）。

**通用前置**：具备本模块菜单与按钮权限的账号已登录；开发环境 `third-party.farming.mode=stub` 可使用 classpath 样例数据。**牧场类型**：`1` 个体、`2` 企业。

**界面（UI）测试**：**Playwright** + **Chromium**。

---

## 一、单元测试用例

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试目的 | 预期结果 |
| --- | --- | --- | --- | --- | --- |
| ZCZX-MCGL-UT-001 | 同步规则 | farmType 解析 | 单元测试 | `1`/`2` 映射性质 | 解析正确；非数字返回 null |
| ZCZX-MCGL-UT-002 | 同步 Tx | 新增落库 | 单元测试 | 无 external_id 记录 | insert；`del_flag=0` |
| ZCZX-MCGL-UT-003 | 同步 Tx | 更新落库 | 单元测试 | 已有 external_id | update；保留 createTime |
| ZCZX-MCGL-UT-004 | 同步 Tx | 缺名称失败 | 单元测试 | farmName 空 | 计入 failMessages |
| ZCZX-MCGL-UT-005 | 同步服务 | 空列表 | 单元测试 | stub 空数组 | insert/update=0 |
| ZCZX-MCGL-UT-006 | 同步服务 | 并发拒绝 | 单元测试 | 重复点击 | `正在同步，请稍候` |
| ZCZX-MCGL-UT-007 | Service | 列表空安全 | 单元测试 | Mapper 返回 null | 空 List |
| ZCZX-MCGL-UT-008 | Mapper | 排序与删除过滤 | 单元测试 | XML 检查 | `del_flag=0`；`create_time desc` |

---

## 二、接口测试用例

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- |
| ZCZX-MCGL-API-001 | 列表 | 默认分页 | 接口测试 | `GET /list` | `rows`≤20 |
| ZCZX-MCGL-API-002 | 列表 | 关键字 | 接口测试 | `keyword=示范` | 名称模糊命中 |
| ZCZX-MCGL-API-003 | 列表 | 类型-个体 | 接口测试 | `farmType=1` | 均为个体 |
| ZCZX-MCGL-API-004 | 详情 | 全字段 | 接口测试 | `GET /{id}` | 含 introduction、county 等 |
| ZCZX-MCGL-API-005 | 同步 | stub 成功 | 接口测试 | `POST /sync` | `insertCount`+`updateCount`≥0 |
| ZCZX-MCGL-API-006 | 同步 | 进行中 | 接口测试 | 并发第二次 POST | `msg` 含正在同步 |
| ZCZX-MCGL-API-007 | 权限 | 无 sync 权限 | 接口测试 | 无权限账号 POST | 403 |

---

## 三、界面测试用例

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- |
| ZCZX-MCGL-UI-001 | 列表 | 默认加载 | UI | 进入菜单 | 表格或空态文案 |
| ZCZX-MCGL-UI-002 | 筛选 | 名称+性质 | UI | 输入关键字选性质搜索 | 列表刷新 |
| ZCZX-MCGL-UI-003 | 同步 | 按钮与结果 | UI | 点击同步 | 成功提示；列表刷新 |
| ZCZX-MCGL-UI-004 | 详情 | 查看弹窗 | UI | 点击查看 | 展示草稿全部字段 |
| ZCZX-MCGL-UI-005 | 权限 | 无同步按钮 | UI | 无 sync 权限账号 | 同步按钮不可见 |

---

## 四、修订说明

| 版本 | 说明 |
| --- | --- |
| 1.0 | 覆盖本地 CRUD、照片、区划校验 |
| 2.0 | 改为第三方同步；移除新增/修改/删除用例；增补同步相关用例 |