# 草畜平衡计算 — 测试用例

> 依据：`草畜平衡计算功能需求.md`、`草蓄平衡计算技术方案.md`  
> **接口 Base Path（示例）**：`/dataModel/grassLivestockBalance`；草场主数据 `/dataModel/grassland`。鉴权与若依一致（Cookie / Token）。

**通用前置（无特殊说明）**：已登录且具备 `dataModel:grassLivestockBalance:query`；草场下拉另需 `dataModel:grassland:list`、`dataModel:grassland:query`。库中存在有效草场（`biz_grassland`，`del_flag=0`），示例：**示范草场** `id=1`，面积 `100` 亩、亩产草量 `350` kg/亩、利用率 `0.65`。

**标准测算样本（用于核对公式）**：`areaMu=100`，`grassYieldPerMu=350`，`utilizationRate=0.65` → 可利用饲草量 `22750` kg；`sheepUnitAnnualForageKg=160` → 理论载畜量 `142.19` SU（保留 2 位）；`breedingHeadCount=100`，`sheepUnitConvertCoeff=4` → 实际载畜量 `400` SU；平衡指数约 `2.81`；超载率约 `181.41%`；等级 **严重超载（4）**。

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

---

## 一、单元测试用例

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ZCZX-CXPH-UT-001 | 公式计算 | 可利用饲草量 | 单元测试 | JUnit5 | 公式 1 | 无 | `calc(100,350,0.65)` | `22750.00` kg |
| ZCZX-CXPH-UT-002 | 公式计算 | 理论/实际载畜量 | 单元测试 | JUnit5 | 公式 2、3 | 样本入参 | 理论、实际 SU | `142.19`、`400.00` SU（2 位小数） |
| ZCZX-CXPH-UT-003 | 公式计算 | 指数与超载率 | 单元测试 | JUnit5 | 公式 4、5 | 样本入参 | 指数、超载率 | 指数约 `2.81`；超载率约 `181.41%` |
| ZCZX-CXPH-UT-004 | 公式计算 | 需草量/缺口/适宜头数 | 单元测试 | JUnit5 | 公式 7～10 | 样本入参 | 全年需草、缺口、适宜放牧 | 需草 `64000`；缺口 `41250`；适宜头约 `35.55` |
| ZCZX-CXPH-UT-005 | 公式计算 | 实际超载数量 | 单元测试 | JUnit5 | 公式 11 | 养殖 100、适宜约 35.55 | `actualOverloadHeads` | `64`（100−适宜，未超载为 0） |
| ZCZX-CXPH-UT-006 | 等级判定 | 四档边界 | 单元测试 | JUnit5 | §2.5、§3.2 | 无 | R=0、0.10、0.15、0.20、0.50、0.51 | 未超载/基本平衡/超载/严重超载与边界一致 |
| ZCZX-CXPH-UT-007 | 等级判定 | 指数=1 | 单元测试 | JUnit5 | 未超载 | 构造实际=理论 | `resolveLevel` | R=0%；等级 **未超载** |
| ZCZX-CXPH-UT-008 | 参数校验 | 面积与利用率 | 单元测试 | JUnit5 | §5.1 | 无 | `areaMu` 0/-1；`utilizationRate` -0.1/1.1 | 均失败 |
| ZCZX-CXPH-UT-009 | 参数校验 | 羊单位参数 | 单元测试 | JUnit5 | >0 | 无 | 年需草量、折算系数为 0 或负 | 失败 |
| ZCZX-CXPH-UT-010 | 参数校验 | 养殖数量 | 单元测试 | JUnit5 | ≥0 整数 | 无 | -1、1.5、0 | -1/小数失败；0 通过 |
| ZCZX-CXPH-UT-011 | 参数校验 | 草场 id | 单元测试 | JUnit5 | 有效草场 | Mock 草场 null/已删 | `validateForCalculate` | 失败 |
| ZCZX-CXPH-UT-012 | 边界 | 存栏为 0 | 单元测试 | JUnit5 | §5.5 | 样本产草参数；头数 0 | 计算 | 实际载畜量 0；超载率 -100%；等级未超载；超载头数 0 |
| ZCZX-CXPH-UT-013 | 边界 | 理论载畜量为 0 | 单元测试 | JUnit5 | §3.4 | 亩产草量 0；头数>0 | 计算 | `warning` 含无饲草供给；等级严重超载或指数 null |
| ZCZX-CXPH-UT-014 | 边界 | 理论为 0 且存栏 0 | 单元测试 | JUnit5 | §3.4 | 亩产草量 0；头数 0 | 计算 | 指数 0；等级未超载 |
| ZCZX-CXPH-UT-015 | 展示舍入 | 2 位小数 | 单元测试 | JUnit5 | §5.4 | 产生多位小数结果 | `scale2` | 四舍五入 2 位 |

---

## 二、接口测试用例

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ZCZX-CXPH-API-001 | 计算 | 标准样本成功 | 接口测试 | Postman | 正常流程 | 已登录；有效 `grasslandId` | `POST .../calculate` Body 标准样本 | `code=200`；11 项结果与 **UT-001～005** 一致；`balanceLevel=4` |
| ZCZX-CXPH-API-002 | 计算 | 未超载样本 | 接口测试 | Postman | 等级 1 | 已登录 | 降低养殖数量使指数≤1 | `balanceLevel=1`；`balanceLevelName=未超载` |
| ZCZX-CXPH-API-003 | 计算 | 基本平衡样本 | 接口测试 | Postman | 等级 2 | 已登录 | 构造 0<R≤15% | `balanceLevel=2` |
| ZCZX-CXPH-API-004 | 计算 | 超载样本 | 接口测试 | Postman | 等级 3 | 已登录 | 构造 15%<R≤50% | `balanceLevel=3` |
| ZCZX-CXPH-API-005 | 计算 | 调整参数与台账不一致 | 接口测试 | Postman | 允许覆盖 | 已登录 | Body 中 `areaMu` 与台账不同 | 成功；按 Body 计算非台账值 |
| ZCZX-CXPH-API-006 | 计算 | 缺草场 id | 接口测试 | Postman | 必填 | 已登录 | 缺 `grasslandId` | 失败；`msg` 可区分 |
| ZCZX-CXPH-API-007 | 计算 | 面积≤0 | 接口测试 | Postman | §5.1 | 已登录 | `areaMu=0` | 失败 |
| ZCZX-CXPH-API-008 | 计算 | 利用率越界 | 接口测试 | Postman | 0～1 | 已登录 | `utilizationRate=1.2` | 失败 |
| ZCZX-CXPH-API-009 | 计算 | 羊单位年需草量≤0 | 接口测试 | Postman | §5.5 | 已登录 | `sheepUnitAnnualForageKg=0` | 失败 |
| ZCZX-CXPH-API-010 | 计算 | 折算系数≤0 | 接口测试 | Postman | §5.5 | 已登录 | `sheepUnitConvertCoeff=0` | 失败 |
| ZCZX-CXPH-API-011 | 计算 | 无效草场 id | 接口测试 | Postman | 主数据 | 已登录 | 不存在或已删 `grasslandId` | 失败 |
| ZCZX-CXPH-API-012 | 计算 | 存栏为 0 | 接口测试 | Postman | 边界 | 已登录 | `breedingHeadCount=0` | 成功；`actualOverloadHeads=0` |
| ZCZX-CXPH-API-013 | 计算 | 亩产草量为 0 | 接口测试 | Postman | 边界 | 已登录 | `grassYieldPerMu=0`、头数>0 | 成功；含 `warning` 或等级 4 |
| ZCZX-CXPH-API-014 | 默认值 | GET defaults | 接口测试 | Postman | §3.2 | 已配置 sys_config | `GET .../defaults` | `code=200`；含年需草量、折算系数默认值 |
| ZCZX-CXPH-API-015 | 主数据 | 草场列表复用 | 接口测试 | Postman | §3.3 | 草场 list 权限 | `GET .../grassland/list` | 返回有效草场供下拉 |
| ZCZX-CXPH-API-016 | 主数据 | 草场详情带出 | 接口测试 | Postman | §3.4 | 草场 query 权限 | `GET .../grassland/{id}` | 含 `areaMu`、`grassYieldPerMu`、`utilizationRate` |
| ZCZX-CXPH-API-017 | 鉴权 | 未登录 | 接口测试 | curl | 安全 | 无 Token | `POST .../calculate` | 401 或统一未登录 |
| ZCZX-CXPH-API-018 | 权限 | 无 query 权限 | 接口测试 | Postman | §6 | 无本模块权限 | `POST .../calculate` | 无权限失败 |
| ZCZX-CXPH-API-019 | 范围 | 无保存接口 | 接口测试 | Postman | 本期无 | 已登录 | `GET/PUT/DELETE` 测算记录类路径 | 404/405 或无路由 |
| ZCZX-CXPH-API-020 | 响应 | 失败可读 | 接口测试 | Postman | §7 | 已登录 | 触发面积、利用率、羊单位非法 | `code`、`msg` 可区分 |

---

## 三、界面测试用例（UI）

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

| 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ZCZX-CXPH-UI-001 | 页面 | 布局与公式区 | UI 测试 | Playwright+Chrome | §5.7 | 已登录 | 进入「草畜平衡计算」 | 见基础参数、计算结果、公式说明（若有） |
| ZCZX-CXPH-UI-002 | 草场 | 下拉选择带出 | UI 测试 | Playwright+Chrome | §5.2 | 有草场数据 | 选择「示范草场」 | 面积、亩产草量、利用率自动填入 |
| ZCZX-CXPH-UI-003 | 草场 | 切换清空结果 | UI 测试 | Playwright+Chrome | §5.2 | 已算出结果 | 换选另一草场 | 参数更新；原结果区清空或「—」 |
| ZCZX-CXPH-UI-004 | 计算 | 标准样本成功 | UI 测试 | Playwright+Chrome | §5.3 | 已选草场 | 补全羊单位参数与养殖数量→点「计算」 | 11 项结果展示；等级 **严重超载**（样本） |
| ZCZX-CXPH-UI-005 | 计算 | 结果只读 | UI 测试 | Playwright+Chrome | §5.4 | 已计算 | 尝试编辑结果区 | 不可编辑 |
| ZCZX-CXPH-UI-006 | 计算 | 未计算前占位 | UI 测试 | Playwright+Chrome | §5.4 | 刚进页面 | 查看结果区 | 空或「—」 |
| ZCZX-CXPH-UI-007 | 校验 | 未选草场 | UI 测试 | Playwright+Chrome | §5.1 | 已登录 | 不选草场直接计算 | 提示必选；结果不更新 |
| ZCZX-CXPH-UI-008 | 校验 | 面积非法 | UI 测试 | Playwright+Chrome | §5.1 | 已登录 | 面积填 0→计算 | 校验失败提示 |
| ZCZX-CXPH-UI-009 | 校验 | 利用率越界 | UI 测试 | Playwright+Chrome | §5.1 | 界面为 % | 填 120%→计算 | 失败或自动限制在 0～100% |
| ZCZX-CXPH-UI-010 | 校验 | 羊单位≤0 | UI 测试 | Playwright+Chrome | §5.5 | 已登录 | 年需草量 0→计算 | 校验失败 |
| ZCZX-CXPH-UI-011 | 计算 | 存栏为 0 | UI 测试 | Playwright+Chrome | §5.5 | 已登录 | 养殖数量 0→计算 | 实际载畜量 0；等级未超载 |
| ZCZX-CXPH-UI-012 | 清空 | 重置表单 | UI 测试 | Playwright+Chrome | §5.6 | 已填参并计算 | 点「清空」 | 输入与结果全部清空 |
| ZCZX-CXPH-UI-013 | 计算 | 修改参数再算 | UI 测试 | Playwright+Chrome | §4 | 已计算一次 | 改养殖数量→再计算 | 结果随新参数变化 |
| ZCZX-CXPH-UI-014 | 范围 | 无保存/历史 | UI 测试 | Playwright+Chrome | §3 | 已登录 | 浏览页面按钮 | 无保存、导出、历史列表 |
| ZCZX-CXPH-UI-015 | 权限 | 无菜单 | UI 测试 | Playwright+Chrome | §6 | 无本模块角色 | 登录后找菜单 | 无「草畜平衡计算」入口 |
| ZCZX-CXPH-UI-016 | 端到端 | 选草场-计算-清空 | UI 集成 | Playwright+Chrome | §4 | 权限齐备 | 选草场→计算→清空 | 全流程无报错 |

---

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

- 安装：`npm i -D @playwright/test`；`npx playwright install chromium`；本机 Chrome：`npx playwright install chrome`。  
- `playwright.config.ts`：`use: { channel: 'chrome', headless: false, locale: 'zh-CN', baseURL: 'http://localhost:80' }`；`storageState` 复用登录态。  
- 路由：`page.goto('/dataModel/grassLivestockBalance')`（以菜单 `component` 为准）。  
- 草场：`page.locator('.el-select').filter({ hasText: '草场名称' }).click()` 后选择选项。  
- 计算：`page.getByRole('button', { name: '计算' })`；断言结果区含「可利用饲草量」「草畜平衡等级」。  
- 清空：`page.getByRole('button', { name: '清空' })`。

---

## 覆盖对照

| 类别 | 单元 UT | 接口 API | 界面 UI |
| --- | --- | --- | --- |
| 正常流程 | UT-001～007 | API-001～005、012、014～016 | UI-002、004、013、016 |
| 异常流程 | UT-008～011 | API-006～011、017～018 | UI-007～010 |
| 业务约束/公式 | UT-001～007、015 | API-001～004 | UI-004、005 |
| 边界 | UT-012～014 | API-012、013 | UI-011 |
| 草场联动 | UT-011 | API-015～016 | UI-002、003 |
| 清空/无落库 | — | API-019 | UI-012、014 |
| 权限 | — | API-017～018 | UI-015 |

---

## 功能需求追溯（自查）

| 需求章节 | 要点 | 主要对应用例 |
| --- | --- | --- |
| §5.1 参数校验 | 必填、范围 | UT-008～011；API-006～010；UI-007～010 |
| §5.2 草场联动 | 带出、切换清结果 | API-015～016；UI-002、003 |
| §5.3 公式 | 11 项指标 | UT-001～005；API-001；UI-004 |
| §2.5 等级 | 四档 | UT-006～007；API-002～004 |
| §5.5 边界 | 0 存栏、0 产草 | UT-012～014；API-012、013；UI-011 |
| §5.6 清空 | 前端重置 | UI-012 |
| §3 范围外 | 无保存 | API-019；UI-014 |

---

## 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 初版：单元 15、接口 20、UI 16；对齐功能/技术方案；Playwright+Chrome；编号前缀 **ZCZX-CXPH** |