huimv-baqing/doc/产业数据模型及服务/牦牛出栏数据填报/牦牛出栏数据填报功能需求.md

牦牛出栏数据填报 — 功能需求

1. 文档说明

项	说明
模块名称	牦牛出栏数据填报
目标	按村 × 所属年月填报、导入、维护农牧户牲畜出栏及自食情况；每月导入一次当月快照
关联系统	业务后台；sys_dept（乡镇、村）
修订依据	交接表 牦牛出栏数据填报.xlsx；运行模板 yak_outbound_report_import_template.xlsx

---

2. 术语与统计口径

2.1 填报粒度

• 一条记录：某一自然年、某一自然月、某一行政村的出栏及自食汇总。
  
• 保存时由所选村反推所属乡镇。
  
• 唯一键：所属年份 + 所属月份 + 所属村。
  
• 同月重复导入为该年月全量覆盖（先删后插）。

2.2～2.4 年月 / 乡镇 / 村

与存栏模块一致：年份向前 6 年、月份 1～12 不可未来月；乡镇为 sys_dept 二级合法节点；村为三级叶子；表单只选村。

2.5 指标

录入：农牧户户数/人数；牦牛、黄牛/奶牛/犏牛、绵羊、山羊、马骡、驴出栏；自食牛/绵羊/山羊。

导出计算（不入库）：出栏合计 = 六类出栏之和；自食合计 = 三类自食之和。

自食大于对应出栏时允许保存，导入可返回警告。

---

3～5. 功能要点

能力	说明
列表	筛年/月/乡镇/村；列含乡镇、村、户数、人数、牦牛出栏、自食牛
新增/修改	年、月、村必填；乡镇反推；唯一「年+月+村」
导入	选填报年月；解析乡镇+村；失败则不写库；成功则全量覆盖
导出	导出该月已填报村行；合计合并序号+乡镇+村；自户数起按列求和；填表时间为导出当日年月

Excel 列：序号、乡镇、村、户数、人数、六类出栏、出栏合计、三类自食、自食合计。

---

6. 权限

dataModel:yakOutboundReport:list|query|add|edit|remove|import|export

---

10. 修订记录

版本	说明
1.0～1.x	乡镇粒度、按年月、upsert 等历史版本
2.0	按村填报；列含村；导入全量覆盖；导出合计按列求和；对齐交接模板