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

## 1. 文档说明

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

---

## 2. 填报粒度

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

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

---

## 3. 功能范围

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

### 列表展示列

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

### Excel 要点

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

---

## 4. 权限

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

---

## 5. 修订记录

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