huimv-baqing/doc/产业数据模型及服务/合作社发展数据填报/合作社发展数据填报功能需求.md

合作社发展数据填报 — 功能需求

1. 文档说明

项	说明
模块名称	合作社发展数据填报
目标	按村 × 合作社 × 所属年月填报、导入、维护新型经营主体（农牧民专业合作组织）发展情况；导入按唯一键 upsert
关联系统	业务后台；sys_dept（乡镇、村）
修订依据	交接表 合作社发展数据填报.xlsx；运行模板 cooperative_development_import_template.xlsx

---

2. 填报粒度

• 一条记录：某一自然年、某一自然月、某一行政村下的一家合作社快照。
• 保存时由所选村反推所属乡镇。
• 唯一键：所属年份 + 所属月份 + 所属村 + 合作社名称。
• 导入按唯一键（年+月+村+合作社名称）存在则更新、不存在则插入；不是增幅累加，也不按年月先删后插。

年月选项、乡镇/村合法性与存栏/出栏模块一致。

---

3. 功能范围

能力	说明
分页列表	筛选：年、月、乡镇、村、合作社名称；列表列见下
新增 / 修改	只选村；新增默认本年本月；牲畜入股小计=牛+羊（保存重算）
详情	全部明细；乡镇只读
删除	物理删除
Excel 导入 / 导出 / 下载模板	另选年月；表头 1～7 行；数据从第 8 行起

列表展示列

所属年份、所属月份、所属村、所属乡镇、合作社名称、法定代表人、成立时间、注册资本、截止年底总资产、总收入、亏损、牛存栏、牛出栏、操作。

Excel 要点

• 列顺序：村在前、乡镇在后（与出栏模板相反）。
• 经营范围：多选，对应空格填「1」，入库逗号分隔。
• 经营模式 / 运营情况：单选，对应空格填「1」。
• 导出填表人=登录用户名称；填表时间=导出当日年月。
• 导出仅输出已填报数据行，不含合计行。

---

4. 权限

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

---

5. 修订记录

版本	说明
1.0	首版：村级合作社快照；CRUD + 导入导出；对齐交接模板
1.1	导入改为按唯一键 upsert，取消按年月先删后插