# 畜牧产品产量登记 — 功能需求

## 1. 文档说明

| 项 | 说明 |
| --- | --- |
| 模块名称 | 畜牧产品产量登记 |
| 目标 | 按**村 × 所属年月**登记肉产量、奶产量；导入按唯一键 upsert；导出含合计行 |
| 关联系统 | 业务后台；`sys_dept`（乡镇、村） |
| 修订依据 | 交接表 `畜牧产品产量登记.xlsx`；运行模板 `livestock_product_output_import_template.xlsx` |

---

## 2. 填报粒度

- 一条记录：某一自然年、某一自然月、某一行政村的肉/奶产量快照。
- 保存时由所选村反推所属乡镇。
- 唯一键：所属年份 + 所属月份 + 所属村。
- 导入：存在则更新、不存在则插入（非增幅累加，也不按年月先删后插）。

---

## 3. 功能范围

| 能力 | 说明 |
| --- | --- |
| 分页列表 | 筛选：年、月、乡镇、村；列：年、月、乡镇、村、肉产量、奶产量 |
| 新增 / 修改 | 只选村；新增默认本年本月；肉/奶产量（万吨） |
| 详情 | 全部字段；乡镇只读 |
| 删除 | 物理删除 |
| Excel 导入 | 表头 1～3 行；导入文件无合计行；另选年月 |
| Excel 导出 | 另选年月；可选乡镇；**末行合计**；填表人=登录用户 |

---

## 4. 权限

`dataModel:livestockProductOutput:list|query|add|edit|remove|import|export`

---

## 5. 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 首版：村级产量登记；CRUD + upsert 导入 + 带合计导出 |
