大屏首页

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/controller/HomeScreenController.java

@@ -19,6 +19,7 @@ import com.ruoyi.web.modules.screen.domain.vo.HomeScreenLivestockOwnershipHouseh
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenPerCapitaIncomeListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenStandardListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakHerdInventoryListItemVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakInventoryOutboundListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakOutboundReportListItemVo;
 import com.ruoyi.web.modules.screen.service.IHomeScreenService;
 
@@ -227,4 +228,24 @@ public class HomeScreenController extends BaseController
                 homeScreenService.listLivestockOwnershipHouseholds(statYear, statMonth, townDeptId, villageDeptId);
         return getDataTable(list);
     }
+
+    /**
+     * 牦牛存出栏情况明细（分页）；按年、月倒序。
+     * <p>按 {@code (stat_year, stat_month, village_dept_id)} 关联
+     * {@code biz_yak_herd_inventory} 与 {@code biz_yak_outbound_report}；
+     * 返回年份、月份、乡镇、村、牦牛总存栏数、牦牛总出栏数。
+     * 所属年/月未传则不过滤，支持跨多年全量翻页。</p>
+     */
+    @GetMapping("/yakInventoryOutbounds")
+    public TableDataInfo yakInventoryOutbounds(
+            @RequestParam(value = "statYear", required = false) Integer statYear,
+            @RequestParam(value = "statMonth", required = false) Integer statMonth,
+            @RequestParam(value = "townDeptId", required = false) Long townDeptId,
+            @RequestParam(value = "villageDeptId", required = false) Long villageDeptId)
+    {
+        startPage();
+        List<HomeScreenYakInventoryOutboundListItemVo> list =
+                homeScreenService.listYakInventoryOutbounds(statYear, statMonth, townDeptId, villageDeptId);
+        return getDataTable(list);
+    }
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/mapper/HomeScreenStatsMapper.java

@@ -23,6 +23,7 @@ import com.ruoyi.web.modules.screen.domain.dto.HomeScreenStatPeriodDto;
 import com.ruoyi.web.modules.screen.domain.dto.HomeScreenSubsidyTypeSumDto;
 import com.ruoyi.web.modules.screen.domain.dto.HomeScreenTrainingMonthDto;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakInventoryOutboundListItemVo;
 
 /**
  * 大屏首页聚合查询。
@@ -224,4 +225,14 @@ public interface HomeScreenStatsMapper
     /** 指定年份区间可支配收入（含起止年） */
     List<HomeScreenDisposableIncomeYearDto> selectDisposableIncomeByYearRange(
             @Param("startYear") int startYear, @Param("endYear") int endYear);
+
+    /**
+     * 牦牛存出栏情况明细：按 {@code (stat_year, stat_month, village_dept_id)} 关联存栏/出栏填报；
+     * 按年、月倒序。缺一侧时存栏或出栏计为 0。
+     */
+    List<HomeScreenYakInventoryOutboundListItemVo> selectYakInventoryOutboundList(
+            @Param("statYear") Integer statYear,
+            @Param("statMonth") Integer statMonth,
+            @Param("townDeptId") Long townDeptId,
+            @Param("villageDeptId") Long villageDeptId);
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/service/IHomeScreenService.java

@@ -12,6 +12,7 @@ import com.ruoyi.web.modules.screen.domain.vo.HomeScreenPerCapitaIncomeListItemV
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenStandardListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakHerdInventoryListItemVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakInventoryOutboundListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakOutboundReportListItemVo;
 
 /**
@@ -107,4 +108,12 @@ public interface IHomeScreenService
      */
     List<HomeScreenLivestockOwnershipHouseholdListItemVo> listLivestockOwnershipHouseholds(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId);
+
+    /**
+     * 牦牛存出栏情况明细（分页；按年、月倒序）。
+     * 按 {@code (stat_year, stat_month, village_dept_id)} 关联存栏/出栏填报表。
+     * 年月未传不过滤，支持跨多年全量翻页。
+     */
+    List<HomeScreenYakInventoryOutboundListItemVo> listYakInventoryOutbounds(
+            Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId);
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/service/impl/HomeScreenServiceImpl.java

@@ -48,6 +48,7 @@ import com.ruoyi.web.modules.screen.domain.vo.HomeScreenStandardListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakHerdInventoryListItemVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakInventoryOutboundListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakOutboundReportListItemVo;
 import com.ruoyi.web.modules.screen.mapper.HomeScreenStandardMapper;
 import com.ruoyi.web.modules.screen.mapper.HomeScreenStatsMapper;
@@ -533,6 +534,15 @@ public class HomeScreenServiceImpl implements IHomeScreenService
         return HomeScreenSupport.buildLivestockOwnershipHouseholdListItems(rows);
     }
 
+    @Override
+    public List<HomeScreenYakInventoryOutboundListItemVo> listYakInventoryOutbounds(
+            Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
+    {
+        // 年月不默认：未传则跨年全量翻页；传入则按条件过滤
+        return homeScreenStatsMapper.selectYakInventoryOutboundList(
+                statYear, statMonth, townDeptId, villageDeptId);
+    }
+
     private static Date toDate(LocalDate localDate)
     {
         return Date.from(localDate.atStartOfDay(ZoneId.of(BreedingIndustryRules.ZONE_SHANGHAI)).toInstant());

baqing-admin/src/main/resources/mapper/screen/HomeScreenStatsMapper.xml

@@ -549,4 +549,84 @@
           and stat_year <= #{endYear}
         order by stat_year
     </select>
+
+    <!-- 牦牛存出栏情况明细：唯一键关联；支持跨年全量翻页（年月可选不过滤） -->
+    <sql id="yakInventoryOutboundHerdFilter">
+        <if test="statYear != null">
+            and h.stat_year = #{statYear}
+        </if>
+        <if test="statMonth != null">
+            and h.stat_month = #{statMonth}
+        </if>
+        <if test="townDeptId != null">
+            and h.town_dept_id = #{townDeptId}
+        </if>
+        <if test="villageDeptId != null">
+            and h.village_dept_id = #{villageDeptId}
+        </if>
+    </sql>
+
+    <!--
+      以存栏为主表 LEFT JOIN 出栏，再用 UNION ALL 补「仅出栏」行；
+      去掉 DISTINCT/UNION 去重与 sys_dept 排序，ORDER BY 对齐 uk(stat_year,stat_month,village_dept_id) 便于索引序扫描。
+    -->
+    <select id="selectYakInventoryOutboundList"
+            resultType="com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakInventoryOutboundListItemVo">
+        select t.stat_year as statYear,
+               t.stat_month as statMonth,
+               t.town_dept_id as townDeptId,
+               t.town_name as townName,
+               t.village_dept_id as villageDeptId,
+               t.village_name as villageName,
+               t.yak_total as yakTotal,
+               t.yak_outbound_count as yakOutboundCount
+        from (
+            select h.stat_year,
+                   h.stat_month,
+                   h.town_dept_id,
+                   h.town_name,
+                   h.village_dept_id,
+                   h.village_name,
+                   h.yak_total,
+                   coalesce(o.yak_outbound_count, 0) as yak_outbound_count
+            from biz_yak_herd_inventory h
+            left join biz_yak_outbound_report o
+                on o.stat_year = h.stat_year
+               and o.stat_month = h.stat_month
+               and o.village_dept_id = h.village_dept_id
+            <where>
+                <include refid="yakInventoryOutboundHerdFilter"/>
+            </where>
+            union all
+            select o.stat_year,
+                   o.stat_month,
+                   o.town_dept_id,
+                   o.town_name,
+                   o.village_dept_id,
+                   o.village_name,
+                   0 as yak_total,
+                   o.yak_outbound_count
+            from biz_yak_outbound_report o
+            where not exists (
+                select 1
+                from biz_yak_herd_inventory h
+                where h.stat_year = o.stat_year
+                  and h.stat_month = o.stat_month
+                  and h.village_dept_id = o.village_dept_id
+            )
+            <if test="statYear != null">
+                and o.stat_year = #{statYear}
+            </if>
+            <if test="statMonth != null">
+                and o.stat_month = #{statMonth}
+            </if>
+            <if test="townDeptId != null">
+                and o.town_dept_id = #{townDeptId}
+            </if>
+            <if test="villageDeptId != null">
+                and o.village_dept_id = #{villageDeptId}
+            </if>
+        ) t
+        order by t.stat_year desc, t.stat_month desc, t.town_dept_id asc, t.village_dept_id asc
+    </select>
 </mapper>

baqing-admin/src/test/java/com/ruoyi/web/modules/screen/controller/HomeScreenControllerApiTest.java

@@ -45,6 +45,7 @@ import com.ruoyi.web.modules.screen.domain.vo.HomeScreenLargeLivestockFarmerList
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenLivestockOwnershipHouseholdListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenPerCapitaIncomeListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakHerdInventoryListItemVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakInventoryOutboundListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakOutboundReportListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenSubsidyVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTrainingTrendVo;
@@ -381,6 +382,33 @@ class HomeScreenControllerApiTest
                 .andExpect(jsonPath("$.rows[0].withoutLivestockHouseholdCount").value(5));
     }
 
+    @Test
+    @DisplayName("DP-SY-API-048 GET yakInventoryOutbounds 牦牛存出栏情况明细")
+    void api048_yakInventoryOutbounds() throws Exception
+    {
+        HomeScreenYakInventoryOutboundListItemVo item = new HomeScreenYakInventoryOutboundListItemVo();
+        item.setStatYear(2026);
+        item.setStatMonth(6);
+        item.setTownName("巴青镇");
+        item.setVillageName("某村");
+        item.setYakTotal(1200);
+        item.setYakOutboundCount(80);
+        when(homeScreenService.listYakInventoryOutbounds(eq(2026), eq(6), eq(101L), eq(201L)))
+                .thenReturn(Collections.singletonList(item));
+        mockMvc.perform(get("/bigScreen/home/yakInventoryOutbounds")
+                        .param("statYear", "2026")
+                        .param("statMonth", "6")
+                        .param("townDeptId", "101")
+                        .param("villageDeptId", "201")
+                        .param("pageNum", "1")
+                        .param("pageSize", "10"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.code").value(200))
+                .andExpect(jsonPath("$.rows[0].yakTotal").value(1200))
+                .andExpect(jsonPath("$.rows[0].yakOutboundCount").value(80))
+                .andExpect(jsonPath("$.rows[0].townName").value("巴青镇"));
+    }
+
     private static com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo sampleTownMap()
     {
         com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo marker =

baqing-admin/src/test/java/com/ruoyi/web/modules/screen/mapper/HomeScreenStatsMapperXmlTest.java

@@ -64,6 +64,7 @@ class HomeScreenStatsMapperXmlTest
         assertTrue(xml.contains("selectOutboundReportYakCountByYearMonthRange"));
         assertTrue(xml.contains("selectOutboundReportYakCountByMonth"));
         assertTrue(xml.contains("selectTownMapMarkers"));
+        assertTrue(xml.contains("selectYakInventoryOutboundList"));
         assertTrue(xml.contains("herdStatMonth"));
         assertTrue(xml.contains("outboundStatMonth"));
         assertTrue(xml.contains("status not in (2, 3)"));

baqing-admin/src/test/java/com/ruoyi/web/modules/screen/service/impl/HomeScreenServiceImplTest.java

@@ -52,6 +52,7 @@ import com.ruoyi.web.modules.screen.domain.vo.HomeScreenLargeLivestockFarmerList
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenLivestockOwnershipHouseholdListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenPerCapitaIncomeListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakHerdInventoryListItemVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakInventoryOutboundListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenYakOutboundReportListItemVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapMarkerVo;
 import com.ruoyi.web.modules.screen.domain.vo.HomeScreenTownMapVo;
@@ -531,6 +532,36 @@ class HomeScreenServiceImplTest
         assertEquals(0, service.listLivestockOwnershipHouseholds(null, null, null, null).size());
     }
 
+    @Test
+    @DisplayName("DP-SY-UT-039 牦牛存出栏情况明细按条件过滤并返回存栏出栏")
+    void ut039_yakInventoryOutbounds()
+    {
+        HomeScreenYakInventoryOutboundListItemVo row = new HomeScreenYakInventoryOutboundListItemVo();
+        row.setStatYear(2026);
+        row.setStatMonth(6);
+        row.setTownName("巴青镇");
+        row.setVillageName("某村");
+        row.setYakTotal(1200);
+        row.setYakOutboundCount(80);
+        when(homeScreenStatsMapper.selectYakInventoryOutboundList(eq(2026), eq(6), eq(101L), eq(201L)))
+                .thenReturn(Collections.singletonList(row));
+        List<HomeScreenYakInventoryOutboundListItemVo> list =
+                service.listYakInventoryOutbounds(2026, 6, 101L, 201L);
+        assertEquals(1, list.size());
+        assertEquals(1200, list.get(0).getYakTotal().intValue());
+        assertEquals(80, list.get(0).getYakOutboundCount().intValue());
+    }
+
+    @Test
+    @DisplayName("DP-SY-UT-039b 牦牛存出栏情况明细未传年月不过滤（跨年全量）")
+    void ut039b_yakInventoryOutboundsNoDefaultYearMonth()
+    {
+        when(homeScreenStatsMapper.selectYakInventoryOutboundList(
+                eq(null), eq(null), eq(null), eq(null)))
+                .thenReturn(Collections.emptyList());
+        assertEquals(0, service.listYakInventoryOutbounds(null, null, null, null).size());
+    }
+
     @Test
     @DisplayName("DP-SY-UT-027 产业总览存栏出栏取所选年最大填报月")
     void ut027_overviewFromReportTables()

doc/大屏/首页/大屏首页功能需求.md

@@ -98,6 +98,7 @@
 | **牦牛出栏数据明细** | 独立接口分页查询 `biz_yak_outbound_report`（牲畜出栏/自食情况明细）；条件同农牧户明细；按**年、月倒序**；返回全部业务列表字段 |
 | **牦牛存栏数据明细** | 独立接口分页查询 `biz_yak_herd_inventory`（畜群存栏/牦牛存栏结构明细）；条件同农牧户明细；按**年、月倒序**；返回全部业务列表字段 |
 | **有无畜户数据明细** | 独立接口分页查询 `biz_livestock_ownership_household`；条件同农牧户明细；按**年、月倒序**；返回全部业务列表字段 |
+| **牦牛存出栏情况明细** | 独立接口分页；按 `(stat_year, stat_month, village_dept_id)` 关联 `biz_yak_herd_inventory` 与 `biz_yak_outbound_report`；年/月/乡镇/村均可选（**未传年月不过滤，支持跨多年全量翻页**）；按**年、月倒序**；返回年、月、乡镇、村、牦牛总存栏数、牦牛总出栏数 |
 | **草畜失衡预警明细** | 独立接口分页查询 `biz_grass_livestock_imbalance_warning`；条件：年/月/乡镇/村；按**预警时间倒序**；返回年、月、乡镇、村、主体名称、主体类型、核定载畜量、年底存栏、是否草畜平衡 |
 | **出栏统计** | 所选年 **Y** 的 1～12 月；各月全县村级 `yak_outbound_count` 合计；纯柱状图无趋势线；接口字段 **`outboundMonthly`** |
 | **地图标注** | 所选年 **Y** 内存栏/出栏表各自**最大填报月**，按乡镇汇总各村 `yak_total` / `yak_outbound_count`；**随 Y 切换** |
@@ -499,6 +500,8 @@ flowchart TB
 
 | 版本 | 日期 | 说明 |
 | --- | --- | --- |
+| 1.14 | 2026-07-23 | 牦牛存出栏明细：年月未传不过滤（跨年全量翻页）；SQL 改为存栏主表+UNION ALL 补仅出栏 |
+| 1.13 | 2026-07-23 | 新增牦牛存出栏情况明细分页接口（关联存栏/出栏填报表） |
 | 1.12 | 2026-07-23 | 明确草场面积数据明细复用农牧户明细接口，不另开接口 |
 | 1.11 | 2026-07-23 | 新增牦牛出栏/存栏、有无畜户明细分页接口 |
 | 1.10 | 2026-07-23 | 新增合作社/家庭牧场/养殖大户明细分页接口 |

doc/大屏/首页/大屏首页技术方案.md

@@ -210,6 +210,7 @@
 | 3.10 | 牦牛出栏数据明细 | GET | `/bigScreen/home/yakOutboundReports` | 同上 |
 | 3.11 | 牦牛存栏数据明细 | GET | `/bigScreen/home/yakHerdInventories` | 同上 |
 | 3.12 | 有无畜户数据明细 | GET | `/bigScreen/home/livestockOwnershipHouseholds` | 同上 |
+| 3.13 | 牦牛存出栏情况明细 | GET | `/bigScreen/home/yakInventoryOutbounds` | 同上 |
 
 前端：切换 `statYear` → **3.1** + **3.2**（`pageNum=1`）+ **3.3**；仅翻页 / 切 Tab → **3.2**；进入首页 → **3.1** + **3.2** + **3.3**。
 
@@ -550,6 +551,34 @@
 
 查询条件与 3.7～3.9 相同：年/月默认当前年月，乡镇/村可选；按年、月倒序；全县口径清空 dataScope。
 
+### 3.13 牦牛存出栏情况明细
+
+#### Query
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `statYear` | int | N | 所属年份；**未传不过滤（支持跨多年全量翻页）** |
+| `statMonth` | int | N | 所属月份；**未传不过滤** |
+| `townDeptId` | long | N | 所属乡镇 |
+| `villageDeptId` | long | N | 所属村 |
+| `pageNum` / `pageSize` | int | N | 分页（PageHelper） |
+
+关联：`biz_yak_herd_inventory` 为主表 `LEFT JOIN` `biz_yak_outbound_report`（唯一键 `(stat_year, stat_month, village_dept_id)`），`UNION ALL` 补仅出栏侧有数据的行；缺一侧时对应计数为 0。
+
+排序：`stat_year DESC, stat_month DESC, town_dept_id ASC, village_dept_id ASC`（对齐唯一键，利于索引序）。
+
+性能说明：条件下推至基表；关联走 `uk_year_month_village`；跨年全量时仍建议控制 `pageSize`，超深 offset 会随页码增大变慢。
+
+#### 响应 `rows[]`
+
+| 字段 | 说明 |
+| --- | --- |
+| `statYear` / `statMonth` | 年份、月份 |
+| `townDeptId` / `townName` | 乡镇 |
+| `villageDeptId` / `villageName` | 村 |
+| `yakTotal` | 牦牛总存栏数（头） |
+| `yakOutboundCount` | 牦牛总出栏数（头） |
+
 ---
 
 ## 4. 前端实现要点
@@ -593,6 +622,8 @@ SQL 示例：`sql/big_screen_home_perm.sql`（挂载「大屏」父菜单下）
 
 | 版本 | 日期 | 说明 |
 | --- | --- | --- |
+| 1.15 | 2026-07-23 | `/yakInventoryOutbounds`：年月未传不过滤；SQL 改为存栏主表 LEFT JOIN + UNION ALL 补仅出栏 |
+| 1.14 | 2026-07-23 | 新增牦牛存出栏情况明细分页接口 `/yakInventoryOutbounds` |
 | 1.13 | 2026-07-23 | 明确草场面积数据明细复用 `/farmerHouseholds`，不另开接口 |
 | 1.12 | 2026-07-23 | 新增牦牛出栏/存栏、有无畜户明细分页接口 |
 | 1.11 | 2026-07-23 | 新增合作社/家庭牧场/养殖大户明细分页接口 |

doc/大屏/首页/大屏首页测试用例.md

@@ -91,6 +91,7 @@
 | DP-SY-UT-036 | 牦牛出栏明细 | 条件过滤与默认年月 | 单元测试 | JUnit5 | §2.5 | Mock `biz_yak_outbound_report` | `listYakOutboundReports(...)` | 字段完整；未传年月默认当前年月 |
 | DP-SY-UT-037 | 牦牛存栏明细 | 条件过滤与默认年月 | 单元测试 | JUnit5 | §2.5 | Mock `biz_yak_herd_inventory` | `listYakHerdInventories(...)` | 字段完整；未传年月默认当前年月 |
 | DP-SY-UT-038 | 有无畜户明细 | 条件过滤与默认年月 | 单元测试 | JUnit5 | §2.5 | Mock `biz_livestock_ownership_household` | `listLivestockOwnershipHouseholds(...)` | 字段完整；未传年月默认当前年月 |
+| DP-SY-UT-039 | 存出栏情况明细 | 关联与跨年全量 | 单元测试 | JUnit5 | §2.5 | Mock `selectYakInventoryOutboundList` | `listYakInventoryOutbounds(...)` | 返回存栏/出栏；未传年月不过滤（传 null） |
 
 ---
 
@@ -144,6 +145,7 @@
 | DP-SY-API-045 | 牦牛出栏明细 | 分页与字段 | 接口测试 | Postman/curl | §2.5 | 填报表有样本 | `GET .../yakOutboundReports?statYear=2026&statMonth=7` | `code` 成功；含出栏/自食等业务字段 |
 | DP-SY-API-046 | 牦牛存栏明细 | 分页与字段 | 接口测试 | Postman/curl | §2.5 | 填报表有样本 | `GET .../yakHerdInventories?statYear=2026&statMonth=8` | `code` 成功；含 `yakTotal` 等业务字段 |
 | DP-SY-API-047 | 有无畜户明细 | 分页与字段 | 接口测试 | Postman/curl | §2.5 | 填报表有样本 | `GET .../livestockOwnershipHouseholds?statYear=2026&statMonth=9` | `code` 成功；含有畜/无畜户数字段 |
+| DP-SY-API-048 | 存出栏情况明细 | 分页与关联字段 | 接口测试 | Postman/curl | §2.5 | 存栏/出栏有样本 | `GET .../yakInventoryOutbounds?statYear=2026&statMonth=6` | `code` 成功；`rows[]` 含年/月/乡镇/村/`yakTotal`/`yakOutboundCount`；按时间倒序 |
 
 ---
 
@@ -260,6 +262,8 @@ await page.route('**/bigScreen/home/dashboard**', route =>
 
 | 版本 | 说明 |
 | --- | --- |
+| 1.5 | 存出栏明细：年月未传不过滤，支持跨年全量翻页（UT-039） |
+| 1.4 | 新增牦牛存出栏情况明细接口（UT-039、API-048） |
 | 1.3 | 明确草场面积明细复用农牧户明细接口（API-041） |
 | 1.2 | 年龄结构改为两档；用例 UT-008～009、API-006、UI-007 同步 |
 | 1.1 | 对齐 v1.1 需求/技术方案：滚动 12 月、`statYear`+`month`、填报表样本、UI 横轴/Tooltip、四档年龄、地图最近填报年月 |