# 有无畜户数据填报 — 功能需求

## 1. 文档说明

| 项 | 说明 |
| --- | --- |
| 模块名称 | 有无畜户数据填报 |
| 粒度 | 村 × 年月 |
| 模板 | `livestock_ownership_household_import_template.xlsx` |

---

## 2. 字段范围

| 分组 | 字段 | 单位 |
| --- | --- | --- |
| 基本信息 | 所属年份、所属月份、所属乡镇、所属村（村居） | — |
| 有畜户 | 户数、人数、有劳力、牲畜数 | 户 / 人 / 人 / 头只 |
| 无畜户 | 户数、人数、有劳力 | 户 / 人 / 人 |

搜索：年、月、乡镇、村。列表展示上述业务字段。

---

## 3. 业务规则

1. CRUD + Excel 导入导出；模板表头为第 1～4 行（含双行表头）。
2. 同一年度每月最新数据为**更新**（upsert），非增幅累加。
3. 导入/导出年月由系统对话框选择，与填报年月一致。
4. 导出填表人 = 当前登录用户名称。
5. 后台新增默认本年本月。
6. 唯一键：`(stat_year, stat_month, village_dept_id)`。

---

## 4. 权限与菜单

- 权限：`dataModel:livestockOwnershipHousehold:list|query|add|edit|remove|import|export`
- 组件：`dataModel/livestockOwnershipHousehold/index`

---

## 5. 相关文档

- [有无畜户数据填报技术方案.md](./有无畜户数据填报技术方案.md)
- [有无畜户数据填报前端技术方案.md](./有无畜户数据填报前端技术方案.md)
- [有无畜户数据填报测试用例.md](./有无畜户数据填报测试用例.md)

## 6. 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 初版：对齐牦牛出栏骨架，村×年月填报 |
| 1.1 | 补充前端技术方案链接 |
