# 草畜失衡预警 — 功能需求

## 1. 文档说明

| 项 | 说明 |
| --- | --- |
| 模块名称 | 草畜失衡预警 |
| 目标 | 独立存储并查询由填报触发的草畜失衡预警，**不与牦牛疾病预警混表** |
| 关联模块 | 家庭牧场 / 农牧户 / 养殖大户数据填报 |

---

## 2. 触发规则

核定年末草畜平衡载畜量 **&lt;** 年底牲畜存栏（绵羊单位）时写入；恢复平衡或删除源填报记录时清除。

| 来源 | data_source | source_key |
| --- | --- | --- |
| 家庭牧场 | `family_ranch` | `FR-{id}` |
| 农牧户 | `farmer_household` | `FH-{id}` |
| 养殖大户 | `large_livestock_farmer` | `LLF-{id}` |

---

## 3. 功能范围

| 能力 | 说明 |
| --- | --- |
| 分页列表 | 筛选：预警日期、数据来源、主体名称；列含年月、乡镇村、主体、载畜量、存栏、预警信息 |
| 详情 | 只读 |
| 写入 | 由填报模块后端自动 upsert/删除，无手工新增 |

---

## 4. 权限与菜单

- 权限：`dataModel:grassLivestockImbalanceWarning:list|query`
- 组件：`dataModel/grassLivestockImbalanceWarning/index`

---

## 5. 相关文档

- [草畜失衡预警技术方案.md](./草畜失衡预警技术方案.md)
- [草畜失衡预警前端技术方案.md](./草畜失衡预警前端技术方案.md)
- [草畜失衡预警测试用例.md](./草畜失衡预警测试用例.md)

---

## 6. 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 从 `biz_yak_disease_warning`（type=6）拆出独立表 |
| 1.1 | 补齐技术方案、测试用例 |
