畜牧产品产量登记

doc/产业数据模型及服务/畜牧产品产量登记/畜牧产品产量登记功能需求.md

@@ -0,0 +1,46 @@
+# 畜牧产品产量登记 — 功能需求
+
+## 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 导入 + 带合计导出 |

doc/产业数据模型及服务/畜牧产品产量登记/畜牧产品产量登记技术方案.md

@@ -0,0 +1,40 @@
+# 畜牧产品产量登记 — 技术方案
+
+> 模板：`baqing-admin/src/main/resources/templates/livestock_product_output_import_template.xlsx`
+
+## 1. 架构
+
+Controller `/dataModel/livestockProductOutput` → Service → Mapper；Excel：`LivestockProductOutputExcelParser` / `LivestockProductOutputExcelExporter`；校验：`LivestockProductOutputValidation`。
+
+## 2. 表 `biz_livestock_product_output`
+
+唯一键 `uk_year_month_village (stat_year, stat_month, village_dept_id)`；字段含乡镇/村冗余名、`meat_output`、`milk_output`（万吨）。DDL：`sql/biz_livestock_product_output.sql`。
+
+## 3. Excel 列（0-based）
+
+| 列 | 字段 |
+| --- | --- |
+| 0 | 序号 |
+| 1 | 乡镇 |
+| 2 | 村 |
+| 3 | 肉产量（万吨） |
+| 4 | 奶产量（万吨） |
+
+数据起始：`headerRow + 1`。导入遇「合计」停止；导出写合计行并合并 0～2 列，对肉/奶求和。
+
+## 4. 导入 / 导出
+
+- 导入：任一行失败不写库 → 按唯一键 upsert。
+- 导出：可选 `townDeptId`；复制模板数据行样式到新建行；含合计行。
+
+## 5. 前端
+
+- 页面：`ruoyi-ui/src/views/dataModel/livestockProductOutput/index.vue`
+- API：`ruoyi-ui/src/api/dataModel/livestockProductOutput.js`
+- i18n：`livestockProductOutput`
+
+## 6. 修订记录
+
+| 版本 | 说明 |
+| --- | --- |
+| 1.0 | 首版对齐交接模板与合作社/出栏交互 |

doc/产业数据模型及服务/畜牧产品产量登记/畜牧产品产量登记测试用例.md

@@ -0,0 +1,15 @@
+# 畜牧产品产量登记 — 测试用例（节选）
+
+> **接口 Base Path**：`/dataModel/livestockProductOutput`  
+> **建表**：执行 `sql/biz_livestock_product_output.sql`
+
+| 编号 | 场景 | 期望 |
+| --- | --- | --- |
+| UT-001 | 解析样例 Excel | 2 行；肉/奶数值正确 |
+| UT-002 | 导出合计 | 末行「合计」；肉/奶为各行之和 |
+| API-001 | 新增 | 选村+年月+产量成功；乡镇回填 |
+| API-002 | 唯一键 | 同年同月同村再增失败 |
+| API-003 | 导入 upsert | 已有更新、新建插入；不删同月其他村 |
+| API-004 | 导出乡镇 | 传 `townDeptId` 仅该乡镇；不传全部 |
+
+样例：`baqing-admin/src/test/resources/excel/livestock_product_output_sample.xlsx`