牦牛资产档案

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/domain/vo/BreedingIndustryMonthlyTrendPointVo.java

@@ -1,10 +1,31 @@
 package com.ruoyi.web.modules.industryservice.domain.vo;
 
+/**
+ * 存栏变动月度趋势点（与大屏 {@code monthlyTrend[]} 字段一致）。
+ */
 public class BreedingIndustryMonthlyTrendPointVo
 {
+    /** 所属年份（自然年） */
+    private int statYear;
+
+    /** 所属月份 1～12 */
     private int month;
 
-    private int inventoryCount;
+    /** 公牛存栏（头） */
+    private int bullCount;
+
+    /** 母牛存栏（头） */
+    private int cowCount;
+
+    public int getStatYear()
+    {
+        return statYear;
+    }
+
+    public void setStatYear(int statYear)
+    {
+        this.statYear = statYear;
+    }
 
     public int getMonth()
     {
@@ -16,13 +37,23 @@ public class BreedingIndustryMonthlyTrendPointVo
         this.month = month;
     }
 
-    public int getInventoryCount()
+    public int getBullCount()
+    {
+        return bullCount;
+    }
+
+    public void setBullCount(int bullCount)
+    {
+        this.bullCount = bullCount;
+    }
+
+    public int getCowCount()
     {
-        return inventoryCount;
+        return cowCount;
     }
 
-    public void setInventoryCount(int inventoryCount)
+    public void setCowCount(int cowCount)
     {
-        this.inventoryCount = inventoryCount;
+        this.cowCount = cowCount;
     }
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/service/impl/BreedingIndustryDashboardServiceImpl.java

@@ -3,10 +3,10 @@ package com.ruoyi.web.modules.industryservice.service.impl;
 import java.math.BigDecimal;
 import java.math.RoundingMode;
 import java.time.LocalDate;
+import java.time.YearMonth;
 import java.time.ZoneId;
 import java.time.format.DateTimeFormatter;
 import java.util.ArrayList;
-import java.util.Collections;
 import java.util.Date;
 import java.util.HashMap;
 import java.util.List;
@@ -14,7 +14,6 @@ import java.util.Map;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
 import com.ruoyi.common.exception.ServiceException;
-import com.ruoyi.web.modules.industryservice.domain.dto.BreedingIndustryYakSnapshot;
 import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryAgeBandVo;
 import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryDashboardVo;
 import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryDegradationStatVo;
@@ -24,10 +23,15 @@ import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryOverviewV
 import com.ruoyi.web.modules.industryservice.mapper.BreedingIndustryStatsMapper;
 import com.ruoyi.web.modules.industryservice.service.IBreedingIndustryDashboardService;
 import com.ruoyi.web.modules.industryservice.support.BreedingIndustryCalculator;
+import com.ruoyi.web.modules.industryservice.support.BreedingIndustryDashboardSupport;
 import com.ruoyi.web.modules.industryservice.support.BreedingIndustryPastureScope;
 import com.ruoyi.web.modules.industryservice.support.BreedingIndustryRules;
 import com.ruoyi.web.modules.industryservice.support.GrasslandRules;
+import com.ruoyi.web.modules.screen.domain.dto.HomeScreenHerdCowAgeSumDto;
+import com.ruoyi.web.modules.screen.domain.dto.HomeScreenHerdGenderSumDto;
+import com.ruoyi.web.modules.screen.domain.dto.HomeScreenStatPeriodDto;
 import com.ruoyi.web.modules.screen.mapper.HomeScreenStatsMapper;
+import com.ruoyi.web.modules.screen.support.HomeScreenSupport;
 
 @Service
 public class BreedingIndustryDashboardServiceImpl implements IBreedingIndustryDashboardService
@@ -60,72 +64,55 @@ public class BreedingIndustryDashboardServiceImpl implements IBreedingIndustryDa
 
             BreedingIndustryOverviewVo overview = new BreedingIndustryOverviewVo();
             fillGrasslandOverview(overview);
+            fillOverviewFromHerdReports(overview);
             dashboard.setOverview(overview);
 
-            int currentCalendarYear = statDate.getYear();
-            // 产业总览三项：填报合计填入既有字段（与大屏首页一致）；原快照口径见下方暂保留调用
-            overview.setInventoryTotal(
-                    homeScreenStatsMapper.sumHerdInventoryYakTotalByStatYear(currentCalendarYear - 1));
-            overview.setAnnualOutbound(
-                    homeScreenStatsMapper.sumOutboundReportYakCountByStatYear(currentCalendarYear));
-            overview.setPastureCount(
-                    homeScreenStatsMapper.sumOutboundReportFarmerHouseholdCountByStatYear(currentCalendarYear));
+            HomeScreenStatPeriodDto latestHerd = homeScreenStatsMapper.selectLatestHerdInventoryStatPeriod();
+            YearMonth anchor = HomeScreenSupport.currentYearMonth();
+            int startYm = HomeScreenSupport.yearMonthKey(anchor.minusMonths(11));
+            int endYm = HomeScreenSupport.yearMonthKey(anchor);
 
             BreedingIndustryInventoryChangeVo inventoryChange = new BreedingIndustryInventoryChangeVo();
-            List<BreedingIndustryAgeBandVo> ageStructure = buildEmptyAgeStructure();
-            if (allowedPastureIds.isEmpty())
+            List<BreedingIndustryAgeBandVo> ageStructure;
+            if (latestHerd == null)
             {
-                overview.setWarningYakCount(0);
                 inventoryChange.setBullCount(0);
                 inventoryChange.setCowCount(0);
                 inventoryChange.setUnknownGenderCount(0);
-                inventoryChange.setMonthlyTrend(Collections.emptyList());
+                ageStructure = BreedingIndustryDashboardSupport.toAgeStructure(
+                        HomeScreenSupport.buildCowAgeStructureFromHerdReport(null));
+            }
+            else
+            {
+                HomeScreenHerdGenderSumDto genderSum = homeScreenStatsMapper.sumHerdInventoryGenderByStatYearMonth(
+                        latestHerd.getStatYear(), latestHerd.getStatMonth());
+                inventoryChange.setBullCount(
+                        genderSum != null && genderSum.getBullTotal() != null ? genderSum.getBullTotal() : 0);
+                inventoryChange.setCowCount(
+                        genderSum != null && genderSum.getCowTotal() != null ? genderSum.getCowTotal() : 0);
+                inventoryChange.setUnknownGenderCount(0);
+                HomeScreenHerdCowAgeSumDto cowAge = homeScreenStatsMapper.sumHerdInventoryCowAgeByStatYearMonth(
+                        latestHerd.getStatYear(), latestHerd.getStatMonth());
+                ageStructure = BreedingIndustryDashboardSupport.toAgeStructure(
+                        HomeScreenSupport.buildCowAgeStructureFromHerdReport(cowAge));
+            }
+            inventoryChange.setMonthlyTrend(BreedingIndustryDashboardSupport.toMonthlyTrend(
+                    HomeScreenSupport.buildRolling12MonthBullCowTrend(
+                            homeScreenStatsMapper.selectHerdInventoryBullCowByYearMonthRange(startYm, endYm),
+                            anchor)));
+
+            if (allowedPastureIds.isEmpty())
+            {
+                overview.setWarningYakCount(0);
             }
             else
             {
                 Date yearStart = toDate(statDate.withDayOfYear(1));
                 Date statDateEnd = toDateEndOfDay(statDate);
-
-                // 原牧场/存栏/出栏口径（暂保留调用）
-                breedingIndustryStatsMapper.countPastureInScope(allowedPastureIds);
-                int legacyInventoryTotal = breedingIndustryStatsMapper.countInventory(allowedPastureIds);
-                breedingIndustryStatsMapper.countAnnualOutbound(allowedPastureIds, yearStart, statDateEnd);
-
                 overview.setWarningYakCount(
                         breedingIndustryStatsMapper.countWarningYak(allowedPastureIds, yearStart, statDateEnd));
-
-                List<BreedingIndustryYakSnapshot> snapshots =
-                        breedingIndustryStatsMapper.selectYakSnapshotsInScope(allowedPastureIds);
-                if (snapshots == null)
-                {
-                    snapshots = Collections.emptyList();
-                }
-                int bull = 0;
-                int cow = 0;
-                for (BreedingIndustryYakSnapshot snapshot : snapshots)
-                {
-                    if (!BreedingIndustryCalculator.countsAsCurrentInventory(snapshot))
-                    {
-                        continue;
-                    }
-                    String gender = BreedingIndustryCalculator.normalizeGender(snapshot.getGender());
-                    if (BreedingIndustryRules.GENDER_BULL.equals(gender))
-                    {
-                        bull++;
-                    }
-                    else if (BreedingIndustryRules.GENDER_COW.equals(gender))
-                    {
-                        cow++;
-                    }
-                }
-                inventoryChange.setBullCount(bull);
-                inventoryChange.setCowCount(cow);
-                inventoryChange.setUnknownGenderCount(Math.max(0, legacyInventoryTotal - bull - cow));
-                inventoryChange.setMonthlyTrend(BreedingIndustryCalculator.buildMonthlyTrend(snapshots, statDate));
-
-                Map<String, Integer> bandCounts = BreedingIndustryCalculator.countAgeBands(snapshots, statDate);
-                ageStructure = BreedingIndustryCalculator.buildAgeStructure(bandCounts, legacyInventoryTotal);
             }
+
             dashboard.setInventoryChange(inventoryChange);
             dashboard.setAgeStructure(ageStructure);
             dashboard.setGrassland(buildGrasslandVo(overview.getGrasslandCount()));
@@ -137,6 +124,45 @@ public class BreedingIndustryDashboardServiceImpl implements IBreedingIndustryDa
         }
     }
 
+    private void fillOverviewFromHerdReports(BreedingIndustryOverviewVo overview)
+    {
+        HomeScreenStatPeriodDto latestHerd = homeScreenStatsMapper.selectLatestHerdInventoryStatPeriod();
+        HomeScreenStatPeriodDto latestOutbound = homeScreenStatsMapper.selectLatestOutboundReportStatPeriod();
+        overview.setInventoryTotal(sumHerdYakAtPeriod(latestHerd));
+        overview.setAnnualOutbound(sumOutboundYakAtPeriod(latestOutbound));
+        overview.setPastureCount(sumFarmerHouseholdAtPeriod(latestOutbound));
+    }
+
+    private int sumHerdYakAtPeriod(HomeScreenStatPeriodDto period)
+    {
+        if (period == null || period.getStatYear() == null || period.getStatMonth() == null)
+        {
+            return 0;
+        }
+        return homeScreenStatsMapper.sumHerdInventoryYakTotalByStatYearMonth(
+                period.getStatYear(), period.getStatMonth());
+    }
+
+    private int sumOutboundYakAtPeriod(HomeScreenStatPeriodDto period)
+    {
+        if (period == null || period.getStatYear() == null || period.getStatMonth() == null)
+        {
+            return 0;
+        }
+        return homeScreenStatsMapper.sumOutboundReportYakCountByStatYearMonth(
+                period.getStatYear(), period.getStatMonth());
+    }
+
+    private int sumFarmerHouseholdAtPeriod(HomeScreenStatPeriodDto period)
+    {
+        if (period == null || period.getStatYear() == null || period.getStatMonth() == null)
+        {
+            return 0;
+        }
+        return homeScreenStatsMapper.sumOutboundReportFarmerHouseholdCountByStatYearMonth(
+                period.getStatYear(), period.getStatMonth());
+    }
+
     private void fillGrasslandOverview(BreedingIndustryOverviewVo overview)
     {
         int grasslandCount = breedingIndustryStatsMapper.countGrassland();
@@ -180,11 +206,6 @@ public class BreedingIndustryDashboardServiceImpl implements IBreedingIndustryDa
         return result;
     }
 
-    private static List<BreedingIndustryAgeBandVo> buildEmptyAgeStructure()
-    {
-        return BreedingIndustryCalculator.buildAgeStructure(Collections.emptyMap(), 0);
-    }
-
     private static Date toDate(LocalDate localDate)
     {
         return Date.from(localDate.atStartOfDay(ZoneId.of(BreedingIndustryRules.ZONE_SHANGHAI)).toInstant());

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/support/BreedingIndustryCalculator.java

@@ -12,7 +12,6 @@ import java.util.List;
 import java.util.Map;
 import com.ruoyi.web.modules.industryservice.domain.dto.BreedingIndustryYakSnapshot;
 import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryAgeBandVo;
-import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryMonthlyTrendPointVo;
 
 /**
  * 养殖产业看板纯计算（月龄分档、月末存栏、性别、占比）。
@@ -121,30 +120,6 @@ public final class BreedingIndustryCalculator
                 .setScale(BreedingIndustryRules.RATIO_SCALE, RoundingMode.HALF_UP);
     }
 
-    public static List<BreedingIndustryMonthlyTrendPointVo> buildMonthlyTrend(
-            List<BreedingIndustryYakSnapshot> assets, LocalDate statDate)
-    {
-        List<BreedingIndustryMonthlyTrendPointVo> points = new ArrayList<>();
-        int currentMonth = statDate.getMonthValue();
-        for (int month = 1; month <= currentMonth; month++)
-        {
-            LocalDate monthEnd = resolveMonthEnd(statDate.getYear(), month, statDate);
-            int count = 0;
-            for (BreedingIndustryYakSnapshot asset : assets)
-            {
-                if (countsAtMonthEnd(asset, monthEnd))
-                {
-                    count++;
-                }
-            }
-            BreedingIndustryMonthlyTrendPointVo point = new BreedingIndustryMonthlyTrendPointVo();
-            point.setMonth(month);
-            point.setInventoryCount(count);
-            points.add(point);
-        }
-        return points;
-    }
-
     public static Map<String, Integer> countAgeBands(List<BreedingIndustryYakSnapshot> assets, LocalDate statDate)
     {
         Map<String, Integer> counts = new HashMap<>();

baqing-admin/src/main/java/com/ruoyi/web/modules/industryservice/support/BreedingIndustryDashboardSupport.java

@@ -0,0 +1,57 @@
+package com.ruoyi.web.modules.industryservice.support;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryAgeBandVo;
+import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryMonthlyTrendPointVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenAgeBandVo;
+import com.ruoyi.web.modules.screen.domain.vo.HomeScreenInventoryMonthVo;
+
+/**
+ * 养殖产业看板与填报表 / 大屏口径之间的 VO 转换。
+ */
+public final class BreedingIndustryDashboardSupport
+{
+    private BreedingIndustryDashboardSupport()
+    {
+    }
+
+    public static List<BreedingIndustryMonthlyTrendPointVo> toMonthlyTrend(List<HomeScreenInventoryMonthVo> from)
+    {
+        if (from == null || from.isEmpty())
+        {
+            return Collections.emptyList();
+        }
+        List<BreedingIndustryMonthlyTrendPointVo> list = new ArrayList<>(from.size());
+        for (HomeScreenInventoryMonthVo src : from)
+        {
+            BreedingIndustryMonthlyTrendPointVo point = new BreedingIndustryMonthlyTrendPointVo();
+            point.setStatYear(src.getStatYear());
+            point.setMonth(src.getMonth());
+            point.setBullCount(src.getBullCount());
+            point.setCowCount(src.getCowCount());
+            list.add(point);
+        }
+        return list;
+    }
+
+    public static List<BreedingIndustryAgeBandVo> toAgeStructure(List<HomeScreenAgeBandVo> from)
+    {
+        if (from == null || from.isEmpty())
+        {
+            return Collections.emptyList();
+        }
+        List<BreedingIndustryAgeBandVo> list = new ArrayList<>(from.size());
+        for (HomeScreenAgeBandVo src : from)
+        {
+            BreedingIndustryAgeBandVo band = new BreedingIndustryAgeBandVo();
+            band.setBandCode(src.getBandCode());
+            band.setBandLabel(src.getBandLabel());
+            band.setCount(src.getCount());
+            band.setRatio(src.getRatio());
+            list.add(band);
+        }
+        return list;
+    }
+}

baqing-admin/src/test/java/com/ruoyi/web/modules/industryservice/controller/BreedingIndustryDashboardControllerApiTest.java

@@ -79,7 +79,7 @@ class BreedingIndustryDashboardControllerApiTest
                 .andExpect(jsonPath("$.data.statDate").value("2026-05-20"))
                 .andExpect(jsonPath("$.data.overview.inventoryTotal").value(120))
                 .andExpect(jsonPath("$.data.inventoryChange.bullCount").value(45))
-                .andExpect(jsonPath("$.data.ageStructure[0].bandCode").value("M1_6"))
+                .andExpect(jsonPath("$.data.ageStructure[0].bandCode").value("COW_U1"))
                 .andExpect(jsonPath("$.data.grassland.availableCount").value(50));
     }
 
@@ -143,15 +143,17 @@ class BreedingIndustryDashboardControllerApiTest
         BreedingIndustryInventoryChangeVo inv = new BreedingIndustryInventoryChangeVo();
         inv.setBullCount(45);
         inv.setCowCount(60);
-        inv.setUnknownGenderCount(15);
+        inv.setUnknownGenderCount(0);
         BreedingIndustryMonthlyTrendPointVo point = new BreedingIndustryMonthlyTrendPointVo();
+        point.setStatYear(2026);
         point.setMonth(5);
-        point.setInventoryCount(120);
+        point.setBullCount(40);
+        point.setCowCount(55);
         inv.setMonthlyTrend(Collections.singletonList(point));
         vo.setInventoryChange(inv);
         BreedingIndustryAgeBandVo band = new BreedingIndustryAgeBandVo();
-        band.setBandCode("M1_6");
-        band.setBandLabel("1-6月龄");
+        band.setBandCode("COW_U1");
+        band.setBandLabel("1岁以下");
         band.setCount(30);
         band.setRatio(new BigDecimal("25.0"));
         vo.setAgeStructure(Collections.singletonList(band));

baqing-admin/src/test/java/com/ruoyi/web/modules/industryservice/service/impl/BreedingIndustryDashboardServiceImplTest.java

@@ -2,15 +2,13 @@ package com.ruoyi.web.modules.industryservice.service.impl;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.ArgumentMatchers.any;
-import static org.mockito.ArgumentMatchers.anyList;
+import static org.mockito.ArgumentMatchers.anyInt;
+import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.lenient;
 import static org.mockito.Mockito.when;
 
 import java.math.BigDecimal;
-import java.time.Year;
-import java.util.Arrays;
 import java.util.Collections;
 import org.junit.jupiter.api.DisplayName;
 import org.junit.jupiter.api.Test;
@@ -19,11 +17,14 @@ import org.mockito.InjectMocks;
 import org.mockito.Mock;
 import org.mockito.junit.jupiter.MockitoExtension;
 import com.ruoyi.common.exception.ServiceException;
-import com.ruoyi.web.modules.industryservice.BreedingIndustryTestSamples;
 import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryDashboardVo;
 import com.ruoyi.web.modules.industryservice.mapper.BreedingIndustryStatsMapper;
 import com.ruoyi.web.modules.industryservice.support.BreedingIndustryPastureScope;
 import com.ruoyi.web.modules.industryservice.support.BreedingIndustryRules;
+import com.ruoyi.web.modules.screen.domain.dto.HomeScreenHerdCowAgeSumDto;
+import com.ruoyi.web.modules.screen.domain.dto.HomeScreenHerdGenderSumDto;
+import com.ruoyi.web.modules.screen.domain.dto.HomeScreenStatPeriodDto;
+import com.ruoyi.web.modules.screen.domain.dto.HomeScreenYearMonthBullCowDto;
 import com.ruoyi.web.modules.screen.mapper.HomeScreenStatsMapper;
 
 @ExtendWith(MockitoExtension.class)
@@ -43,65 +44,81 @@ class BreedingIndustryDashboardServiceImplTest
     private BreedingIndustryDashboardServiceImpl service;
 
     @Test
-    @DisplayName("ZCZX-YZCYSJ-UT-002 可见牧场为空")
+    @DisplayName("ZCZX-YZCYSJ-UT-002 可见牧场为空仍返回填报趋势")
     void ut002_emptyScope()
     {
-        int currentYear = Year.now().getValue();
         stubGrassland();
-        stubReportOverviewSums(currentYear, 100, 50, 20);
+        stubNoHerdReport();
         when(breedingIndustryPastureScope.resolveAllowedPastureIds()).thenReturn(Collections.emptyList());
         BreedingIndustryDashboardVo vo = service.loadDashboard(false);
-        assertEquals(100, vo.getOverview().getInventoryTotal());
-        assertEquals(50, vo.getOverview().getAnnualOutbound());
-        assertEquals(20, vo.getOverview().getPastureCount());
-        assertEquals(3, vo.getOverview().getGrasslandCount());
-        assertEquals(0, vo.getInventoryChange().getMonthlyTrend().size());
+        assertEquals(0, vo.getOverview().getInventoryTotal());
+        assertEquals(0, vo.getInventoryChange().getBullCount());
+        assertEquals(0, vo.getInventoryChange().getCowCount());
+        assertEquals(0, vo.getInventoryChange().getUnknownGenderCount());
+        assertEquals(12, vo.getInventoryChange().getMonthlyTrend().size());
+        assertEquals(4, vo.getAgeStructure().size());
     }
 
     @Test
-    @DisplayName("ZCZX-YZCYSJ-UT-028 产业总览三项与大屏填报口径一致")
-    void ut028_overviewFromReportTables()
+    @DisplayName("ZCZX-YZCYSJ-UT-028 产业总览与存栏取自最近填报年月")
+    void ut028_overviewFromLatestReport()
     {
-        int currentYear = Year.now().getValue();
         stubGrassland();
-        stubReportOverviewSums(currentYear, 50000, 3200, 8988);
+        HomeScreenStatPeriodDto herd = period(2025, 12);
+        HomeScreenStatPeriodDto outbound = period(2026, 5);
+        when(homeScreenStatsMapper.selectLatestHerdInventoryStatPeriod()).thenReturn(herd);
+        when(homeScreenStatsMapper.selectLatestOutboundReportStatPeriod()).thenReturn(outbound);
+        when(homeScreenStatsMapper.sumHerdInventoryYakTotalByStatYearMonth(2025, 12)).thenReturn(50000);
+        when(homeScreenStatsMapper.sumOutboundReportYakCountByStatYearMonth(2026, 5)).thenReturn(3200);
+        when(homeScreenStatsMapper.sumOutboundReportFarmerHouseholdCountByStatYearMonth(2026, 5)).thenReturn(8988);
+        stubHerdInventoryBlock(herd, 100, 200);
         when(breedingIndustryPastureScope.resolveAllowedPastureIds())
-                .thenReturn(Collections.singletonList(BreedingIndustryTestSamples.PASTURE_P1));
-        when(breedingIndustryStatsMapper.countPastureInScope(anyList())).thenReturn(12);
-        when(breedingIndustryStatsMapper.countInventory(anyList())).thenReturn(3);
-        when(breedingIndustryStatsMapper.countAnnualOutbound(anyList(), any(), any())).thenReturn(8);
-        when(breedingIndustryStatsMapper.countWarningYak(anyList(), any(), any())).thenReturn(0);
-        when(breedingIndustryStatsMapper.selectYakSnapshotsInScope(anyList()))
-                .thenReturn(Collections.singletonList(BreedingIndustryTestSamples.normalBull()));
+                .thenReturn(Collections.singletonList(1L));
+        when(breedingIndustryStatsMapper.countWarningYak(any(), any(), any())).thenReturn(0);
 
         BreedingIndustryDashboardVo vo = service.loadDashboard(false);
 
         assertEquals(50000, vo.getOverview().getInventoryTotal());
         assertEquals(3200, vo.getOverview().getAnnualOutbound());
         assertEquals(8988, vo.getOverview().getPastureCount());
+        assertEquals(100, vo.getInventoryChange().getBullCount());
+        assertEquals(200, vo.getInventoryChange().getCowCount());
+        assertEquals(0, vo.getInventoryChange().getUnknownGenderCount());
+        assertEquals(12, vo.getInventoryChange().getMonthlyTrend().size());
+        assertEquals(4, vo.getAgeStructure().size());
     }
 
     @Test
-    @DisplayName("ZCZX-YZCYSJ-UT-009 公母未标=原存栏时点总量")
-    void ut009_genderSum()
+    @DisplayName("ZCZX-YZCYSJ-UT-009 公母牛取自填报无未标注")
+    void ut009_genderFromReport()
     {
-        int currentYear = Year.now().getValue();
         stubGrassland();
-        stubReportOverviewSums(currentYear, 0, 0, 0);
+        HomeScreenStatPeriodDto herd = period(2026, 7);
+        when(homeScreenStatsMapper.selectLatestHerdInventoryStatPeriod()).thenReturn(herd);
+        when(homeScreenStatsMapper.selectLatestOutboundReportStatPeriod()).thenReturn(null);
+        when(homeScreenStatsMapper.sumHerdInventoryYakTotalByStatYearMonth(2026, 7)).thenReturn(350);
+        HomeScreenHerdGenderSumDto gender = new HomeScreenHerdGenderSumDto();
+        gender.setBullTotal(120);
+        gender.setCowTotal(230);
+        gender.setYakTotal(350);
+        when(homeScreenStatsMapper.sumHerdInventoryGenderByStatYearMonth(2026, 7)).thenReturn(gender);
+        HomeScreenHerdCowAgeSumDto age = new HomeScreenHerdCowAgeSumDto();
+        age.setCowUnder1Count(10);
+        age.setCow13Count(20);
+        age.setCow312Count(30);
+        age.setCowOver12Count(40);
+        when(homeScreenStatsMapper.sumHerdInventoryCowAgeByStatYearMonth(2026, 7)).thenReturn(age);
+        when(homeScreenStatsMapper.selectHerdInventoryBullCowByYearMonthRange(anyInt(), anyInt()))
+                .thenReturn(Collections.emptyList());
         when(breedingIndustryPastureScope.resolveAllowedPastureIds())
-                .thenReturn(Collections.singletonList(BreedingIndustryTestSamples.PASTURE_P1));
-        when(breedingIndustryStatsMapper.countPastureInScope(anyList())).thenReturn(1);
-        when(breedingIndustryStatsMapper.countInventory(anyList())).thenReturn(3);
-        when(breedingIndustryStatsMapper.countAnnualOutbound(anyList(), any(), any())).thenReturn(0);
-        when(breedingIndustryStatsMapper.countWarningYak(anyList(), any(), any())).thenReturn(0);
-        when(breedingIndustryStatsMapper.selectYakSnapshotsInScope(anyList())).thenReturn(Arrays.asList(
-                BreedingIndustryTestSamples.normalBull(),
-                BreedingIndustryTestSamples.normalCow(),
-                BreedingIndustryTestSamples.unknownGender()));
+                .thenReturn(Collections.singletonList(1L));
+        when(breedingIndustryStatsMapper.countWarningYak(any(), any(), any())).thenReturn(0);
+
         BreedingIndustryDashboardVo vo = service.loadDashboard(false);
-        assertEquals(1, vo.getInventoryChange().getBullCount());
-        assertEquals(1, vo.getInventoryChange().getCowCount());
-        assertEquals(1, vo.getInventoryChange().getUnknownGenderCount());
+
+        assertEquals(120, vo.getInventoryChange().getBullCount());
+        assertEquals(230, vo.getInventoryChange().getCowCount());
+        assertEquals(0, vo.getInventoryChange().getUnknownGenderCount());
     }
 
     @Test
@@ -114,6 +131,42 @@ class BreedingIndustryDashboardServiceImplTest
         assertEquals(BreedingIndustryRules.MSG_LOAD_FAILED, ex.getMessage());
     }
 
+    private static HomeScreenStatPeriodDto period(int year, int month)
+    {
+        HomeScreenStatPeriodDto dto = new HomeScreenStatPeriodDto();
+        dto.setStatYear(year);
+        dto.setStatMonth(month);
+        return dto;
+    }
+
+    private void stubNoHerdReport()
+    {
+        when(homeScreenStatsMapper.selectLatestHerdInventoryStatPeriod()).thenReturn(null);
+        when(homeScreenStatsMapper.selectLatestOutboundReportStatPeriod()).thenReturn(null);
+        when(homeScreenStatsMapper.selectHerdInventoryBullCowByYearMonthRange(anyInt(), anyInt()))
+                .thenReturn(Collections.emptyList());
+    }
+
+    private void stubHerdInventoryBlock(HomeScreenStatPeriodDto herd, int bull, int cow)
+    {
+        HomeScreenHerdGenderSumDto gender = new HomeScreenHerdGenderSumDto();
+        gender.setBullTotal(bull);
+        gender.setCowTotal(cow);
+        gender.setYakTotal(bull + cow);
+        when(homeScreenStatsMapper.sumHerdInventoryGenderByStatYearMonth(
+                eq(herd.getStatYear()), eq(herd.getStatMonth()))).thenReturn(gender);
+        HomeScreenHerdCowAgeSumDto age = new HomeScreenHerdCowAgeSumDto();
+        when(homeScreenStatsMapper.sumHerdInventoryCowAgeByStatYearMonth(
+                eq(herd.getStatYear()), eq(herd.getStatMonth()))).thenReturn(age);
+        HomeScreenYearMonthBullCowDto row = new HomeScreenYearMonthBullCowDto();
+        row.setStatYear(herd.getStatYear());
+        row.setStatMonth(herd.getStatMonth());
+        row.setBullCount(bull);
+        row.setCowCount(cow);
+        when(homeScreenStatsMapper.selectHerdInventoryBullCowByYearMonthRange(anyInt(), anyInt()))
+                .thenReturn(Collections.singletonList(row));
+    }
+
     private void stubGrassland()
     {
         when(breedingIndustryStatsMapper.countGrassland()).thenReturn(3);
@@ -122,14 +175,4 @@ class BreedingIndustryDashboardServiceImplTest
         when(breedingIndustryStatsMapper.countInUseGrassland(any())).thenReturn(1);
         when(breedingIndustryStatsMapper.selectDegradationGroupCounts()).thenReturn(Collections.emptyList());
     }
-
-    private void stubReportOverviewSums(int currentYear, int inventory, int outbound, int farmerHousehold)
-    {
-        lenient().when(homeScreenStatsMapper.sumHerdInventoryYakTotalByStatYear(eq(currentYear - 1)))
-                .thenReturn(inventory);
-        lenient().when(homeScreenStatsMapper.sumOutboundReportYakCountByStatYear(eq(currentYear)))
-                .thenReturn(outbound);
-        lenient().when(homeScreenStatsMapper.sumOutboundReportFarmerHouseholdCountByStatYear(eq(currentYear)))
-                .thenReturn(farmerHousehold);
-    }
 }

baqing-admin/src/test/java/com/ruoyi/web/modules/industryservice/support/BreedingIndustryCalculatorTest.java

@@ -13,7 +13,6 @@ import org.junit.jupiter.api.DisplayName;
 import org.junit.jupiter.api.Test;
 import com.ruoyi.web.modules.industryservice.BreedingIndustryTestSamples;
 import com.ruoyi.web.modules.industryservice.domain.dto.BreedingIndustryYakSnapshot;
-import com.ruoyi.web.modules.industryservice.domain.vo.BreedingIndustryMonthlyTrendPointVo;
 
 @DisplayName("BreedingIndustryCalculator")
 class BreedingIndustryCalculatorTest
@@ -74,37 +73,6 @@ class BreedingIndustryCalculatorTest
                 BreedingIndustryTestSamples.deadWithoutChangeDate(), any));
     }
 
-    @Test
-    @DisplayName("ZCZX-YZCYSJ-UT-015 当前月=统计日")
-    void ut015_currentMonthTrend()
-    {
-        List<BreedingIndustryYakSnapshot> assets = Arrays.asList(
-                BreedingIndustryTestSamples.normalBull(),
-                BreedingIndustryTestSamples.normalCow());
-        List<BreedingIndustryMonthlyTrendPointVo> trend =
-                BreedingIndustryCalculator.buildMonthlyTrend(assets, STAT_DATE);
-        int may = trend.get(trend.size() - 1).getInventoryCount();
-        int inventory = 0;
-        for (BreedingIndustryYakSnapshot asset : assets)
-        {
-            if (BreedingIndustryCalculator.countsAsCurrentInventory(asset))
-            {
-                inventory++;
-            }
-        }
-        assertEquals(inventory, may);
-    }
-
-    @Test
-    @DisplayName("ZCZX-YZCYSJ-UT-022 不生成未来月")
-    void ut022_noFutureMonths()
-    {
-        List<BreedingIndustryMonthlyTrendPointVo> trend = BreedingIndustryCalculator.buildMonthlyTrend(
-                Collections.singletonList(BreedingIndustryTestSamples.normalBull()), STAT_DATE);
-        assertEquals(5, trend.size());
-        assertEquals(5, trend.get(4).getMonth());
-    }
-
     @Test
     @DisplayName("ZCZX-YZCYSJ-UT-004 pasture_id 空")
     void ut004_noPasture()

doc/产业数据模型及服务/养殖产业数据/养殖产业数据功能需求-草稿.md

@@ -1,9 +1,11 @@
 做一个养殖产业数据模块：
 
 1. 养殖产业数据包括：产业总览、牦牛存栏变动、牦牛年龄结构、草场类型占比。
-2. 产业总览包括：牦牛存栏总量（头）、牦牛年出栏量（头）、预警牦牛数量（头）、牧场数量（个）、草场数量（个）、草场面积（亩）；
-3. 牦牛存栏变动：包括公牛数量（头）、母牛数量（头）两个维度，按月统计牦牛存栏数量的变动趋势。
-4. 牦牛年龄结构：统计1-6月龄、7-12月龄、12月龄以上3个阶段的占比。
+2. 产业总览包括：牦牛存栏总量（头）、牦牛年出栏量（头）、预警牦牛数量（头）、农牧户（户）、草场数量（个）、草场面积（亩）；存栏/出栏/农牧户取填报表**最近年月**全县合计。
+3. 牦牛存栏变动：公牛、母牛两维度（最近填报年月）；趋势为滚动最近 **12** 自然月双折线，横轴仅月、悬停显年月；**不展示**未标注性别。
+4. 牦牛年龄结构：母牛四档（1岁以下、1～3岁、3～12岁、12岁以上），与大屏一致。
 5. 草场类型占比：1、统计可用、使用中的草场数量；2、通过未退化、轻度、中度、重度、极重度等维度统计草场的数量和占比。
 6. 异常返回：统一格式 code、msg、data。
 7. 技术栈：RuoYi v3.9.2-springboot2 分支 + MySQL-5.7.39。
+
+> 正式需求见同目录 `养殖产业数据功能需求.md`（v1.2+）。

doc/产业数据模型及服务/养殖产业数据/养殖产业数据功能需求.md

@@ -118,6 +118,20 @@
 
 **状态变更日期为空**且当前为非正常状态：该个体在**所有历史月末**均**不计入**存栏趋势。
 
+> **看板说明（v1.2）**：**§5.3 存栏变动**、**§5.4 年龄结构**及总览存栏/出栏/农牧户三项已改由 **§2.11 存栏出栏填报** 统计，**不再**使用本节档案月末还原。本节保留供档案类指标（如预警关联档案）参考。
+
+### 2.11 存栏出栏填报（看板主口径）
+
+与大屏首页一致，数据来自乡镇填报表：
+
+| 指标/图表 | 数据源 | 规则 |
+| --- | --- | --- |
+| 总览存栏 | `biz_yak_herd_inventory.yak_total` | 全县合计；**最近填报年月**（`stat_year`+`stat_month` 最大） |
+| 总览出栏、农牧户 | `biz_yak_outbound_report` | 同上最近填报年月；字段 `yak_outbound_count`、`farmer_household_count` |
+| 公/母牛数量 | `biz_yak_herd_inventory` | 最近填报年月全县 `bull_total`、`cow_total` |
+| 存栏趋势 | `biz_yak_herd_inventory` | 距当前 **12** 个自然月；按月全县公/母合计；缺月 **0** |
+| 年龄结构 | `biz_yak_herd_inventory` | 最近填报年月母牛四龄档合计 |
+
 ---
 
 ## 3. 功能范围
@@ -128,7 +142,7 @@
 | --- | --- |
 | 产业总览 | 六项指标卡片展示，见 **§5.2** |
 | 牦牛存栏变动 | 当前公、母牛数量 + 按月存栏趋势图，见 **§5.3** |
-| 牦牛年龄结构 | 三档月龄占比图，见 **§5.4** |
+| 牦牛年龄结构 | 母牛四档年龄占比图，见 **§5.4** |
 | 草场类型占比 | 可用/使用中数量 + 退化等级数量与占比，见 **§5.5** |
 | 刷新 | 重新拉取并计算全页指标，见 **§5.1** |
 
@@ -210,10 +224,10 @@ flowchart LR
 
 | 序号 | 指标名称 | 单位 | 统计口径 |
 | --- | --- | --- | --- |
-| 1 | 牦牛存栏总量 | 头 | `biz_yak_herd_inventory.yak_total` 全县乡镇合计；统计年 = **当前自然年 − 1**；接口字段 **`inventoryTotal`**（与大屏一致） |
-| 2 | 牦牛年出栏量 | 头 | `biz_yak_outbound_report.yak_outbound_count` 全县乡镇合计；统计年 = **当前自然年**；接口字段 **`annualOutbound`** |
-| 3 | 预警牦牛数量 | 头 | **§2.5**（仍为档案时点口径） |
-| 4 | 农牧户 | 户 | `biz_yak_outbound_report.farmer_household_count` 全县乡镇合计；统计年 = **当前自然年**；接口字段沿用 **`pastureCount`**（与大屏一致） |
+| 1 | 牦牛存栏总量 | 头 | `biz_yak_herd_inventory.yak_total` 全县乡镇合计；**最近填报年月**；接口字段 **`inventoryTotal`** |
+| 2 | 牦牛年出栏量 | 头 | `biz_yak_outbound_report.yak_outbound_count` 全县乡镇合计；**最近填报年月**；接口字段 **`annualOutbound`** |
+| 3 | 预警牦牛数量 | 头 | **§2.5**（档案时点口径） |
+| 4 | 农牧户 | 户 | `biz_yak_outbound_report.farmer_household_count` 全县乡镇合计；**最近填报年月**；接口字段 **`pastureCount`** |
 | 5 | 草场数量 | 个 | **§2.6** |
 | 6 | 草场面积 | 亩 | **§2.6** |
 
@@ -227,45 +241,34 @@ flowchart LR
 
 #### 5.3.1 当前性别结构（数字）
 
-在趋势图上方或侧栏展示两个指标（与原型一致）：
+在趋势图上方展示两个指标（与原型一致）：
 
 | 指标 | 单位 | 口径 |
 | --- | --- | --- |
-| 公牛数量 | 头 | 当前存栏中性别为「公」的头数 |
-| 母牛数量 | 头 | 当前存栏中性别为「母」的头数 |
+| 公牛数量 | 头 | `biz_yak_herd_inventory.bull_total` 全县乡镇合计；取**最近填报年月**（`stat_year` + `stat_month` 最大） |
+| 母牛数量 | 头 | `biz_yak_herd_inventory.cow_total` 全县乡镇合计；同上 |
 
-**数量关系：** 公牛数量 + 母牛数量 + 未标注性别数量 = **§2.3** 当前存栏时点总量（原档案口径，**不等同于** **§5.2** 第 1 项填报合计）。当未标注性别数量 > 0 时，在公、母牛数量旁展示 **「未标注性别：N 头」**（N 为整数）。
+**不展示**「未标注性别」；与大屏首页存栏变动 header 口径一致。
 
 #### 5.3.2 存栏趋势（折线图）
 
 | 项 | 要求 |
 | --- | --- |
-| 图表类型 | 折线图 |
-| 横轴 | 当前自然年 1 月～12 月（标签：1月…12月） |
+| 图表类型 | 折线图（**公牛**、**母牛**两系列） |
+| 数据范围 | 距当前时间**最近 12 个自然月**（与大屏「牦牛存栏变动」一致） |
+| 横轴 | 12 个刻度，**仅显示月份**；悬停展示 **YYYY年M月** |
 | 纵轴 | 存栏数量，单位 **头** |
-| 序列 | **存栏总量**一条折线 |
-| 各月数值 | 按 **§2.10** 计算；仅绘制 **1 月～当前月** 有定义的月份点，**未来月份不绘制** |
-| 当前月 | 以 **统计日** 作为时点代入 **§2.10**（代替月末日） |
-| 图例 | 「存栏数量」（或与原型一致） |
-
-**与总览联动：** 当前月折线点与 **§2.10** 月末还原存栏一致；**§5.2** 第 1 项已改为全县填报合计，**不要求**与折线当前月点数值相同。
+| 接口字段 | `monthlyTrend[]` 含 `statYear`、`month`、`bullCount`、`cowCount`；缺月补 **0** |
 
 ### 5.4 牦牛年龄结构
 
 | 项 | 要求 |
 | --- | --- |
 | 图表类型 | 饼图（或环形图，与原型一致） |
-| 统计对象 | **§2.3** 当前存栏个体 |
-| 分档 | 三档，互斥且穷尽（月龄按 **§2.3**）： |
-
-| 档位 | 月龄区间 |
-| --- | --- |
-| 1-6月龄 | 0 ≤ 月龄 ≤ 6 |
-| 7-12月龄 | 7 ≤ 月龄 ≤ 12（**含**整 12 月龄） |
-| 12月龄以上 | 月龄 ≥ 13 |
-
-| 展示 | 每档展示**占比（%）**；图例或标签含档位名称与百分比；各档占比之和为 **100%**（四舍五入导致 ±1% 须在界面容忍） |
-| 数量为 0 | 该档占比 0%，饼图仍保留图例项 |
+| 统计对象 | 存栏填报**最近年月**全县母牛分龄合计 |
+| 分档 | 四档（与大屏一致）：**1岁以下**、**1～3岁**、**3～12岁**、**12岁以上** |
+| 编码 | `COW_U1` / `COW_1_3` / `COW_3_12` / `COW_O12` |
+| 展示 | 每档展示**头数**与**占比（%）**；各档占比之和为 **100%**（四舍五入 ±1% 可接受） |
 
 ### 5.5 草场类型占比
 
@@ -296,7 +299,9 @@ flowchart LR
 | --- | --- |
 | 牧场管理 | 提供牧场数量；经营状态、逻辑删除规则影响是否计入 |
 | 草场管理 | 提供草场数量、面积、退化等级、利用类型、禁牧日期；驱动可用/使用中及退化占比 |
-| 牦牛资产档案管理 | 提供存栏、性别、月龄、出栏量；资产状态与变更日期为核心字段 |
+| 牦牛资产档案管理 | 预警等仍关联档案；存栏变动/年龄已改填报表 **§2.11** |
+| 牦牛存栏数据填报 | 驱动总览存栏、公母数量、趋势、年龄结构 |
+| 牦牛出栏数据填报 | 驱动总览出栏、农牧户 |
 | 牦牛疾病预警 | 提供预警牦牛数量；周期与去重规则见 **§2.5**、该模块 **§5.6** |
 | 草畜平衡计算 | 本期看板**不展示**平衡指数；若后续纳入须修订本文档 |
 
@@ -349,13 +354,13 @@ flowchart LR
 | --- | --- |
 | 缺页面结构、刷新与加载 | **§5.1**、**§4.2** |
 | 指标无统计口径 | **§2** 分节定义；**§5.2～§5.5** 引用 |
-| 存栏趋势「按月」未说明横轴与序列 | **§5.3.2**、**§2.10** 月末还原与仅画至当前月 |
-| 年龄分档边界 | **§5.4**（12 月龄归入 7～12 档） |
+| 存栏趋势「按月」未说明横轴与序列 | **§5.3.2**、**§2.11** 滚动 12 月；横轴仅月、悬停显年月 |
+| 年龄分档边界 | **§5.4** 母牛四档（与大屏一致） |
 | 草场可用/使用中含义模糊 | **§2.7** 与草场管理字段挂钩 |
 | 退化占比分母 | **§2.8** 有效草场总条数 |
 | 技术栈、code/msg/data | 已移除 |
 | 未写数据来源 | **§4.1**、**§6** |
-| 预警/出栏/性别等待定口径 | **§2.4～§2.5**、**§2.9**、**§5.3.1** 已固化为唯一约定 |
+| 预警/出栏/性别等待定口径 | **§2.4～§2.5**、**§2.11**、**§5.3.1** 已固化为填报表 + 预警档案口径 |
 
 ---
 
@@ -363,11 +368,17 @@ flowchart LR
 
 | 能力 | 章节 |
 | --- | --- |
-| 产业总览六项 | §5.2、§2.3～§2.6 |
-| 公母牛数量 + 月趋势 | §5.3 |
-| 年龄三档占比 | §5.4 |
+| 产业总览六项 | §5.2、§2.3～§2.6、§2.11 |
+| 公母牛数量 + 月趋势 | §5.3、§2.11 |
+| 年龄四档占比 | §5.4 |
 | 草场可用/使用中 + 退化占比 | §5.5、§2.7、§2.8 |
 | 只读看板 | §3、§5.1 |
-| 模块依赖 | §4.1、§6 |
-| 数据权限 | §2.9 |
-| 月趋势还原 | §2.10 |
+
+---
+
+## 11. 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| 1.2 | 2026-07-04 | 存栏变动/年龄/总览三项改填报表；滚动 12 月；母牛四档；与大屏对齐 |
+| 1.1 | （既有） | 总览存栏/出栏/农牧户改填报合计 |

doc/产业数据模型及服务/养殖产业数据/养殖产业数据技术方案.md

@@ -21,8 +21,8 @@
 | --- | --- |
 | 看板加载/刷新 | 一次请求返回四块数据；`statDate` 取服务器当前日期 |
 | 数据权限 | Service 注入用户可见 `pastureId` 列表；牦牛、预警按 **§2.2** 过滤；草场全县台账不按牧场过滤 |
-| 月末存栏趋势 | 应用层按 1～当前月循环，每月按 **§2.2 月末存栏判定** 及需求 **§2.10** 计数（**非** `asset_status=1` 简单过滤） |
-| 公/母牛 | 仅统计**当前存栏**（`asset_status=1`），与趋势图口径分离 |
+| 月末存栏趋势（档案） | 历史能力保留于 `BreedingIndustryCalculator`；**看板趋势已改填报表**，见 **§2.11** |
+| 存栏变动/年龄/趋势 | 复用 `HomeScreenStatsMapper` + `HomeScreenSupport` 滚动 12 月逻辑，与大屏一致 |
 | 性能 | 数据量大时启用 **§2.3** 可选快照表 + 短 TTL 缓存；本期可先实时聚合；月末 12 点目标 **≤3s**（1 万级档案，评审可调） |
 
 **依赖模块（只读）**
@@ -33,6 +33,8 @@
 | `biz_grassland` | 草场管理 |
 | `biz_yak_asset` | 牦牛资产档案 |
 | `biz_yak_disease_warning` | 牦牛疾病预警 |
+| `biz_yak_herd_inventory` | 牦牛存栏数据填报（存栏变动、年龄结构、总览存栏） |
+| `biz_yak_outbound_report` | 牦牛出栏数据填报（总览出栏、农牧户） |
 
 ---
 
@@ -218,10 +220,10 @@ return success(dashboardService.loadDashboard(allowed, forceRefresh));
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `inventoryTotal` | int | 牦牛存栏总量（头）；`biz_yak_herd_inventory` 全县合计，年份 = 当前自然年 **− 1**（与大屏 `inventoryTotal` 一致） |
-| `annualOutbound` | int | 牦牛年出栏量（头）；`biz_yak_outbound_report` 全县 `yak_outbound_count` 合计，年份 = 当前自然年 |
+| `inventoryTotal` | int | 牦牛存栏总量（头）；`biz_yak_herd_inventory` **最近填报年月**全县 `yak_total` 合计 |
+| `annualOutbound` | int | 牦牛年出栏量（头）；`biz_yak_outbound_report` **最近填报年月**全县 `yak_outbound_count` 合计 |
 | `warningYakCount` | int | 预警牦牛数量（头）；**§2.5** 档案口径 |
-| `pastureCount` | int | 农牧户（户）；`biz_yak_outbound_report` 全县 `farmer_household_count` 合计，年份 = 当前自然年（与大屏 `pastureCount` 一致） |
+| `pastureCount` | int | 农牧户（户）；`biz_yak_outbound_report` **最近填报年月**全县 `farmer_household_count` 合计 |
 | `grasslandCount` | int | 草场数量（个） |
 | `grasslandAreaMu` | decimal | 草场面积（亩） |
 
@@ -229,28 +231,30 @@ return success(dashboardService.loadDashboard(allowed, forceRefresh));
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `bullCount` | int | 公牛数量（头） |
-| `cowCount` | int | 母牛数量（头） |
-| `unknownGenderCount` | int | 未标注性别（头）；为 0 时前端可不展示 |
-| `monthlyTrend` | array | 按月存栏，仅含 1～当前月 |
+| `bullCount` | int | 公牛数量（头）；最近填报年月全县 `bull_total` 合计 |
+| `cowCount` | int | 母牛数量（头）；最近填报年月全县 `cow_total` 合计 |
+| `unknownGenderCount` | int | 固定 **0**（不展示未标注性别） |
+| `monthlyTrend` | array | 滚动最近 **12** 自然月；固定 **12** 条 |
 
 `monthlyTrend[]` 元素：
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `month` | int | 1～12 |
-| `inventoryCount` | int | 该月还原存栏总量（头） |
+| `statYear` | int | 所属自然年 |
+| `month` | int | 所属月份 1～12 |
+| `bullCount` | int | 该月全县公牛合计；无数据为 **0** |
+| `cowCount` | int | 该月全县母牛合计；无数据为 **0** |
 
 #### 3.1.5 `ageStructure[]`
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `bandCode` | string | `M1_6` / `M7_12` / `M13_PLUS` |
-| `bandLabel` | string | 展示名：`1-6月龄` 等 |
+| `bandCode` | string | `COW_U1` / `COW_1_3` / `COW_3_12` / `COW_O12` |
+| `bandLabel` | string | `1岁以下` / `1～3岁` / `3～12岁` / `12岁以上` |
 | `count` | int | 头数 |
-| `ratio` | decimal | 占比 0～1 或前端转 %（约定返回 **0～100** 数值，保留 1 位小数，如 `37.5` 表示 37.5%） |
+| `ratio` | decimal | 占比 0～100 数值，保留 1 位小数 |
 
-三档固定返回（count 为 0 也返回）。
+四档固定返回（count 为 0 也返回）；与大屏年龄结构一致。
 
 #### 3.1.6 `grassland`
 
@@ -291,14 +295,14 @@ return success(dashboardService.loadDashboard(allowed, forceRefresh));
     "inventoryChange": {
       "bullCount": 45,
       "cowCount": 60,
-      "unknownGenderCount": 15,
+      "unknownGenderCount": 0,
       "monthlyTrend": [
-        { "month": 1, "inventoryCount": 110 },
-        { "month": 5, "inventoryCount": 120 }
+        { "statYear": 2025, "month": 8, "bullCount": 40, "cowCount": 55 },
+        { "statYear": 2026, "month": 5, "bullCount": 45, "cowCount": 60 }
       ]
     },
     "ageStructure": [
-      { "bandCode": "M1_6", "bandLabel": "1-6月龄", "count": 30, "ratio": 25.0 }
+      { "bandCode": "COW_U1", "bandLabel": "1岁以下", "count": 30, "ratio": 25.0 }
     ],
     "grassland": {
       "availableCount": 50,
@@ -328,9 +332,9 @@ return success(dashboardService.loadDashboard(allowed, forceRefresh));
 | --- | --- |
 | **月龄** | `COALESCE(age_months, TIMESTAMPDIFF(MONTH, birth_date, statDate))`，`birth_date` 空则 0 |
 | **性别** | 入库值 `trim` 后精确匹配 `公`/`母`；第三方若写「公牛」「母牛」等，Service 层归一后再统计 |
-| **公母 vs 趋势** | `bullCount`/`cowCount`/`unknownGenderCount`/`ageStructure` 用 **§2.3** 原档案时点口径；`monthlyTrend` 用 **§2.10** 月末判定 |
-| **总览填报三项** | `overview.inventoryTotal` / `annualOutbound` / `pastureCount` 复用大屏 `HomeScreenStatsMapper` 填报合计 SQL；原 `countInventory` / `countAnnualOutbound` / `countPastureInScope` 在 Service 内暂保留调用 |
-| **一致性** | `monthlyTrend` 当前月点与 **§2.3** 时点存栏一致；**不要求**与 `overview.inventoryTotal`（填报合计）相同 |
+| **存栏变动/年龄/趋势** | `HomeScreenStatsMapper` + `HomeScreenSupport.buildRolling12MonthBullCowTrend` / `buildCowAgeStructureFromHerdReport`；`BreedingIndustryDashboardSupport` 做 VO 转换 |
+| **总览填报三项** | `overview.inventoryTotal` / `annualOutbound` / `pastureCount` 取各表**最近填报年月**全县合计 |
+| **预警** | 仍用 `biz_yak_asset` + `biz_yak_disease_warning`，按 **§2.9** 可见牧场过滤 |
 | **比率** | `ratio = count * 100.0 / NULLIF(total, 0)`，分母为 0 时 ratio=0 |
 | **月末性能** | 优先 1 条 SQL + `CASE WHEN` 按月末分组，或 Java 循环 12 次；超过 3s 启用 **§2.3** 缓存 |
 | **日志** | 看板接口可 `@Log(title="养殖产业数据", businessType=OTHER)` 或仅记录慢查询 |
@@ -365,10 +369,18 @@ VALUES ('养殖产业数据', {parentId}, 10, 'breedingIndustry', 'livestockIndu
 | 功能需求 | 技术落点 |
 | --- | --- |
 | §5.2 产业总览 | `overview` + **§2.2** SQL |
-| §5.3 存栏变动 | `inventoryChange` + **§2.2** 月末判定 |
-| §5.4 年龄结构 | `ageStructure` |
+| §5.3 存栏变动 | `inventoryChange` + 填报表滚动 12 月（与大屏一致） |
+| §5.4 年龄结构 | `ageStructure` 母牛四档（填报最近年月） |
 | §5.5 草场占比 | `grassland` |
 | §5.1 刷新 | **3.1** `forceRefresh` |
-| §2.9 数据权限 | **§2.6** `BreedingIndustryPastureScope` |
-| §2.10 月末趋势 | **§2.2** 月末判定 + `monthlyTrend` |
+| §2.9 数据权限 | **§2.6** `BreedingIndustryPastureScope`（仅预警等档案类指标） |
 | §2.5 预警 | **§2.2** warning SQL |
+
+---
+
+## 7. 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| 1.2 | 2026-07-04 | 存栏变动/年龄/趋势改 `biz_yak_herd_inventory` 填报表；滚动 12 月；与大屏字段对齐 |
+| 1.1 | （既有） | 总览三项改填报合计 |

doc/产业数据模型及服务/养殖产业数据/养殖产业数据测试用例.md

@@ -3,7 +3,7 @@
 > 依据：`养殖产业数据功能需求.md`、`养殖产业数据技术方案.md`、`养殖产业数据前端技术方案.md`  
 > **接口 Base Path**：`/dataModel/breedingIndustry`（含网关/context-path 时须补齐前缀）。鉴权：若依 Cookie / `Authorization` Token。
 
-**通用前置**：已执行 `sql/biz_pasture.sql`、`sql/biz_grassland.sql`、`sql/biz_yak_asset.sql`、`sql/biz_yak_disease_warning.sql`；测试账号具备 `dataModel:breedingIndustry:query` 及菜单「养殖产业数据」。
+**通用前置**：已执行 `sql/biz_pasture.sql`、`sql/biz_grassland.sql`、`sql/biz_yak_asset.sql`、`sql/biz_yak_disease_warning.sql`、`sql/biz_yak_herd_inventory.sql`、`sql/biz_yak_outbound_report.sql`；测试账号具备 `dataModel:breedingIndustry:query` 及菜单「养殖产业数据」。
 
 **UI 工具**：**Playwright** + **Chromium**，`channel: 'chrome'`（本机 **Google Chrome**）。组件路径：`livestockIndustry/breedingIndustry/index`。
 
@@ -30,7 +30,10 @@
 | **W-out** | `alert_time` 为上年或统计日次日 |
 | **G** | 草场 `del_flag=0`；退化 1～5、禁牧/轮牧/全年各造 1 条 |
 
-**联调统计日**：固定 **2026-05-20**（`monthlyTrend` 含 1～5 月共 5 点；不含 6～12 月）。
+| **HERD-L** | `biz_yak_herd_inventory` 最近填报年月全县 bull/cow/yak 合计 |
+| **HERD-M** | 某历史月填报记录，用于滚动 12 月趋势 |
+
+**联调统计日**：固定 **2026-05-20**（`monthlyTrend` 含 **12** 点：2025-06～2026-05；每项含 `statYear`、`month`、`bullCount`、`cowCount`）。
 
 ---
 
@@ -40,7 +43,7 @@
 | --- | --- |
 | **正常流程** | 菜单进入自动加载、刷新全页、四块指标与图表展示（§4.2、§5.1～§5.5） |
 | **异常流程** | 未登录、无权限、聚合失败、空库、接口不存在维护能力（§3、§7.2、技术§3.1.8） |
-| **业务约束** | §2.1～§2.10 口径；§2.9 权限三态；§3 本期不实现项（无 CRUD/筛选/导出） |
+| **业务约束** | §2.5～§2.11 口径；§2.9 权限三态；§3 本期不实现项（无 CRUD/筛选/导出） |
 
 ---
 
@@ -60,17 +63,17 @@
 | ZCZX-YZCYSJ-UT-010 | 预警 | 周期下界 1/1 0:00 | 单元测试 | JUnit5 | §2.5 | `alert_time=当年1/1 00:00:00` | 统计 | 计入 |
 | ZCZX-YZCYSJ-UT-011 | 预警 | 周期外排除 | 单元测试 | JUnit5 | §2.5 | W-out | 统计 | 0 |
 | ZCZX-YZCYSJ-UT-012 | 预警 | 须关联纳入档案 | 单元测试 | JUnit5 | §2.9 | 预警牛仅 P2、范围 P1 | `countWarning` | 0 |
-| ZCZX-YZCYSJ-UT-013 | 性别 | 公+母+未标=原时点总量 | 单元测试 | JUnit5 | §5.3.1 | Y-N 公母 + Y-U | 分项求和 | 等于原 `countInventory` 口径，**不等同** `overview.inventoryTotal` |
-| ZCZX-YZCYSJ-UT-028 | 产业总览 | 填报三项与大屏一致 | 单元测试 | JUnit5 | §5.2 | Mock 填报合计 | `loadDashboard` | `inventoryTotal`/`annualOutbound`/`pastureCount` 与 `HomeScreenStatsMapper` 合计一致 |
-| ZCZX-YZCYSJ-UT-014 | 性别 | trim 后匹配 | 单元测试 | JUnit5 | 技术§4 | `gender=' 母 '` | `normalizeGender` | 计母牛 |
-| ZCZX-YZCYSJ-UT-015 | 月龄 | birth_date 回退 | 单元测试 | JUnit5 | §2.3 | `age_months` 空、有生日 | `resolveAgeMonths(statDate)` | 与 `TIMESTAMPDIFF` 一致；无生日为 0 |
-| ZCZX-YZCYSJ-UT-016 | 年龄分档 | 边界 0/6/7/12/13 | 单元测试 | JUnit5 | §5.4 | 各月龄一头 | `bandOf` | M1_6、M7_12（含12）、M13_PLUS |
-| ZCZX-YZCYSJ-UT-017 | 年龄分档 | 占比与零分母 | 单元测试 | JUnit5 | §5.4 | 存栏 0 | `calcRatio` | 三档 count=0、ratio=0 仍返回 |
-| ZCZX-YZCYSJ-UT-018 | 月末趋势 | 变更日晚于月末仍计入 | 单元测试 | JUnit5 | §2.10 | Y-H，M=2 月末 | `countAtMonthEnd(2)` | 计入 |
-| ZCZX-YZCYSJ-UT-019 | 月末趋势 | 变更日≤月末排除 | 单元测试 | JUnit5 | §2.10 | Y-L，M=2 月末 | `countAtMonthEnd(2)` | 不计 |
-| ZCZX-YZCYSJ-UT-020 | 月末趋势 | 非正常且变更日空 | 单元测试 | JUnit5 | §2.10 | status=2、date 空 | 各月 | 恒 0 |
-| ZCZX-YZCYSJ-UT-021 | 月末趋势 | 当前月用统计日 | 单元测试 | JUnit5 | §2.10、技术§4 | statDate=5-20 | 5 月点 vs `countInventory` | 相等 |
-| ZCZX-YZCYSJ-UT-022 | 月末趋势 | 不生成未来月 | 单元测试 | JUnit5 | §2.2、§5.3.2 | 5 月环境 | `buildMonthlyTrend` | 仅 month 1～5 |
+| ZCZX-YZCYSJ-UT-013 | 存栏变动 | 公母来自最近填报 | 单元测试 | JUnit5 | §5.3.1、§2.11 | HERD-L | `loadDashboard` | `bullCount`/`cowCount` 与 HERD-L 全县合计一致；`unknownGenderCount=0` |
+| ZCZX-YZCYSJ-UT-028 | 产业总览 | 填报三项最近年月 | 单元测试 | JUnit5 | §5.2、§2.11 | Mock 填报合计 | `loadDashboard` | `inventoryTotal`/`annualOutbound`/`pastureCount` 与 `HomeScreenStatsMapper` 最近年月合计一致 |
+| ZCZX-YZCYSJ-UT-014 | 性别 | trim 后匹配 | 单元测试 | JUnit5 | 技术§4 | `gender=' 母 '` | `normalizeGender` | 计母牛（档案类，预警用） |
+| ZCZX-YZCYSJ-UT-015 | 年龄结构 | 四档编码 | 单元测试 | JUnit5 | §5.4 | Mock 母牛四龄填报 | `toAgeStructure` | `bandCode` 为 COW_U1/COW_1_3/COW_3_12/COW_O12 |
+| ZCZX-YZCYSJ-UT-016 | 年龄分档 | 占比与零分母 | 单元测试 | JUnit5 | §5.4 | 母牛合计 0 | `buildCowAgeStructureFromHerdReport` | 四档 count=0、ratio=0 仍返回 |
+| ZCZX-YZCYSJ-UT-017 | 年龄分档 | 占比之和 | 单元测试 | JUnit5 | §5.4 | 有母牛数据 | sum(ratio) | 99.9～100.1 |
+| ZCZX-YZCYSJ-UT-018 | 存栏趋势 | 滚动 12 月长度 | 单元测试 | JUnit5 | §5.3.2、§2.11 | 5 月环境 | `buildRolling12MonthBullCowTrend` | 固定 **12** 条；锚点含 statYear+month |
+| ZCZX-YZCYSJ-UT-019 | 存栏趋势 | 缺月补零 | 单元测试 | JUnit5 | §2.11 | 仅 HERD-M 有数 | 趋势某月 | `bullCount`/`cowCount` 无填报为 **0** |
+| ZCZX-YZCYSJ-UT-020 | 存栏趋势 | 最近月与 header 一致 | 单元测试 | JUnit5 | §5.3.1 | HERD-L | 趋势最后一点 vs header | 公/母分别相等 |
+| ZCZX-YZCYSJ-UT-021 | 存栏趋势 | 锚点当前月 | 单元测试 | JUnit5 | §2.11 | statDate=5-20 | 最后一点 month | 等于 **5**，statYear=**2026** |
+| ZCZX-YZCYSJ-UT-022 | 存栏趋势 | 不依赖档案月末 | 单元测试 | JUnit5 | §2.11 | 档案与填报不一致 | 趋势 | 以填报表为准 |
 | ZCZX-YZCYSJ-UT-023 | 牧场 | 原口径暂保留 | 单元测试 | JUnit5 | §2.6 | P-停、注销 | `countPastureInScope` 仍调用 | 结果**不**写入 `pastureCount` |
 | ZCZX-YZCYSJ-UT-024 | 草场 | 面积空不参与求和 | 单元测试 | JUnit5 | §2.6 | 一条 `area_mu` null | `sumArea` | 不计该条 |
 | ZCZX-YZCYSJ-UT-025 | 草场 | 可用=未退化+轻度 | 单元测试 | JUnit5 | §2.7 | 退化 1、2、3 各 1 | `availableCount` | 2 |
@@ -88,10 +91,10 @@
 | ZCZX-YZCYSJ-API-001 | 看板 | 首次加载全量结构 | 接口测试 | Postman/curl | §5.1 正常流程 | UA 登录；造数完整 | `GET /dataModel/breedingIndustry/dashboard` | `code=200`；`data` 含 `statDate`、`statYear`、`overview`、`inventoryChange`、`ageStructure`、`grassland` |
 | ZCZX-YZCYSJ-API-002 | 看板 | 统计日与自然年 | 接口测试 | Postman | §2.2 | 已登录 | 同上 | `statDate`=`yyyy-MM-dd` 服务器当日；`statYear` 为公历年 |
 | ZCZX-YZCYSJ-API-003 | 产业总览 | 六项指标非负 | 接口测试 | Postman | §5.2 | 已知样本 | 读 `overview` 六字段 | 与 UT-004～012、023～024 手工值一致；`grasslandAreaMu`≥0 |
-| ZCZX-YZCYSJ-API-004 | 存栏变动 | 公母未标关系 | 接口测试 | Postman | §5.3.1 | 含 Y-U | `bullCount+cowCount+unknownGenderCount` | 等于原档案时点存栏，**不要求**等于 `overview.inventoryTotal` |
-| ZCZX-YZCYSJ-API-005 | 存栏变动 | 月趋势仅至当前月 | 接口测试 | Postman | §5.3.2 | 统计日 5 月 | `monthlyTrend` | 长度=5；`month`∈{1..5}；无 6～12 |
-| ZCZX-YZCYSJ-API-006 | 存栏变动 | 当前月=总览存栏 | 接口测试 | Postman | §5.3.2、技术§4 | 已登录 | 比 `monthlyTrend` 最后项与 `inventoryTotal` | 相等 |
-| ZCZX-YZCYSJ-API-007 | 年龄结构 | 固定三档 | 接口测试 | Postman | §5.4 | 已登录 | `ageStructure` | 长度=3；`bandCode` 为 M1_6/M7_12/M13_PLUS；count=0 也返回 |
+| ZCZX-YZCYSJ-API-004 | 存栏变动 | 公母与未标注 | 接口测试 | Postman | §5.3.1 | HERD-L | 读 `inventoryChange` | `unknownGenderCount=0`；公/母与 HERD-L 一致 |
+| ZCZX-YZCYSJ-API-005 | 存栏变动 | 滚动 12 月趋势 | 接口测试 | Postman | §5.3.2 | 统计日 5 月 | `monthlyTrend` | 长度=**12**；含 `statYear`/`month`/`bullCount`/`cowCount`；末项 2026-05 |
+| ZCZX-YZCYSJ-API-006 | 存栏变动 | 最近月与 header | 接口测试 | Postman | §5.3.1、§2.11 | HERD-L | 比 `monthlyTrend` 最后一项与 header | 公/母分别相等 |
+| ZCZX-YZCYSJ-API-007 | 年龄结构 | 固定四档 | 接口测试 | Postman | §5.4 | 已登录 | `ageStructure` | 长度=**4**；`bandCode` 为 COW_U1/COW_1_3/COW_3_12/COW_O12；count=0 也返回 |
 | ZCZX-YZCYSJ-API-008 | 年龄结构 | 占比之和容忍 | 接口测试 | Postman | §5.4 | 存栏>0 | sum(ratio) | 99.9～100.1（四舍五入容忍） |
 | ZCZX-YZCYSJ-API-009 | 草场占比 | 可用/使用中 | 接口测试 | Postman | §5.5.1 | 已登录 | `grassland.availableCount/inUseCount` | 与 UT-025～026 一致 |
 | ZCZX-YZCYSJ-API-010 | 草场占比 | 退化五档与合计 | 接口测试 | Postman | §5.5.2 | 已登录 | `degradationStats` | 长度=5；sum(count)=`grasslandCount` |
@@ -104,7 +107,7 @@
 | ZCZX-YZCYSJ-API-017 | 鉴权 | 未登录 | 接口测试 | curl | §7.2 异常 | 无 Token | `GET /dashboard` | 401 或统一未登录 |
 | ZCZX-YZCYSJ-API-018 | 权限 | 无 query 权限 | 接口测试 | Postman | §7.1 | 角色无 `breedingIndustry:query` | `GET /dashboard` | 403 或 `msg` 无权限 |
 | ZCZX-YZCYSJ-API-019 | 异常 | 聚合失败 | 接口测试 | Postman/Mock | §3.1.8 | Mock Mapper 抛错 | `GET /dashboard` | 失败；`data` 空；`msg` 含「加载失败」类文案 |
-| ZCZX-YZCYSJ-API-020 | 异常 | 空库零值 | 接口测试 | Postman | §5.1 空态 | 新库无业务数据 | `GET /dashboard` | `code=200`；数值 0；`ageStructure` 长 3、`degradationStats` 长 5 |
+| ZCZX-YZCYSJ-API-020 | 异常 | 空库零值 | 接口测试 | Postman | §5.1 空态 | 新库无业务数据 | `GET /dashboard` | `code=200`；数值 0；`ageStructure` 长 **4**、`degradationStats` 长 5 |
 | ZCZX-YZCYSJ-API-021 | 范围 | 无维护/同步接口 | 接口测试 | Postman | §3 本期不实现 | 已登录 | `POST/PUT/DELETE /dataModel/breedingIndustry/**` | 404/405 或无权限 |
 | ZCZX-YZCYSJ-API-022 | 范围 | 无筛选参数 | 接口测试 | Postman | §3、§8 | 已登录 | 传 `pastureId`/`year` 等非法 Query | 忽略或 400；口径仍按 §2 默认 |
 | ZCZX-YZCYSJ-API-023 | 出栏 | 无变更日出栏 | 接口测试 | Postman | §2.4 | 仅 Y-O0 | `annualOutbound` | 0 |
@@ -120,12 +123,11 @@
 | --- | --- | --- | --- | --- | --- | --- | --- | --- |
 | ZCZX-YZCYSJ-UI-001 | 正常流程 | 菜单进入自动加载 | UI | Playwright+Chrome | §4.2、§5.1 | UA 有菜单；后端正常 | 登录→点击「养殖产业数据」 | 出现四块标题；`v-loading` 结束后六项卡片有数；无报错弹窗 |
 | ZCZX-YZCYSJ-UI-002 | 产业总览 | 六项单位与只读 | UI | Playwright+Chrome | §5.2 | 有数据 | 检查首屏卡片 | 名称含存栏/出栏/预警/农牧户/草场/面积；单位头/户/个/亩；卡片不可点击跳转 |
-| ZCZX-YZCYSJ-UI-003 | 存栏变动 | 公母与未标注文案 | UI | Playwright+Chrome | §5.3.1 | `unknownGenderCount>0` | 查看存栏区文案 | 显示公牛、母牛数量；显示「未标注性别：N 头」 |
-| ZCZX-YZCYSJ-UI-004 | 存栏变动 | 未标注为 0 隐藏 | UI | Playwright+Chrome | §5.3.1、前端§4 | 造数全公母 | 打开页 | 不展示「未标注性别」文案 |
-| ZCZX-YZCYSJ-UI-005 | 存栏变动 | 折线止于当前月 | UI | Playwright+Chrome | §5.3.2 | 5 月环境 | 检查 ECharts 折线 X 轴与数据点 | 1～5 月有值；6～12 月无数据点/折线不延伸 |
-| ZCZX-YZCYSJ-UI-006 | 存栏变动 | 当前月与总览联动 | UI | Playwright+Chrome | §5.3.2 | 有数据 | 比对折线最后一点与「牦牛存栏总量」卡片 | 数值一致 |
-| ZCZX-YZCYSJ-UI-007 | 年龄结构 | 三档饼图与占比 | UI | Playwright+Chrome | §5.4 | 有数据 | 查看年龄结构图例/标签 | 含 1-6、7-12、12月龄以上（或等价文案）；显示 % |
-| ZCZX-YZCYSJ-UI-008 | 草场占比 | 可用/使用中与退化 | UI | Playwright+Chrome | §5.5 | 有 G | 查看草场区 | 展示可用、使用中个数；退化列表/图五档；列表占比与图一致 |
+| ZCZX-YZCYSJ-UI-003 | 存栏变动 | 公母文案 | UI | Playwright+Chrome | §5.3.1 | 有 HERD-L | 查看存栏区文案 | 显示公牛、母牛数量；**无**「未标注性别」 |
+| ZCZX-YZCYSJ-UI-004 | 存栏变动 | 双折线 12 月 | UI | Playwright+Chrome | §5.3.2、前端§4 | 5 月环境 | 检查 ECharts 折线 | **12** 个刻度；横轴仅「N月」；悬停显「YYYY年N月」 |
+| ZCZX-YZCYSJ-UI-005 | 存栏变动 | 最近月与 header | UI | Playwright+Chrome | §5.3.1 | 有 HERD-L | 比对折线最后一点与上方公/母数 | 分别一致 |
+| ZCZX-YZCYSJ-UI-006 | 年龄结构 | 四档饼图与占比 | UI | Playwright+Chrome | §5.4 | 有数据 | 查看年龄结构图例/标签 | 含 1岁以下、1～3岁、3～12岁、12岁以上；显示 % |
+| ZCZX-YZCYSJ-UI-007 | 草场占比 | 可用/使用中与退化 | UI | Playwright+Chrome | §5.5 | 有 G | 查看草场区 | 展示可用、使用中个数；退化列表/图五档；列表占比与图一致 |
 | ZCZX-YZCYSJ-UI-009 | 刷新 | 成功更新全页 | UI | Playwright+Chrome | §5.1 | 已打开页 | 点击「刷新」 | 按钮 loading/disabled；完成后四块数据更新；可选轻提示「数据已更新」 |
 | ZCZX-YZCYSJ-UI-010 | 刷新 | 防重复点击 | UI | Playwright+Chrome | §5.1、前端§4 | 已打开页 | 刷新未完成时连点 2 次 | 仅 1 次有效请求或第二次按钮不可用 |
 | ZCZX-YZCYSJ-UI-011 | 异常 | 加载失败提示 | UI | Playwright+Chrome | §5.1、§7.2 | Mock `/dashboard` 返回 500 | 进入或点刷新 | 提示「加载失败，请稍后重试」类；页面不展示上一用户/会话缓存假数据 |
@@ -133,7 +135,7 @@
 | ZCZX-YZCYSJ-UI-013 | 权限 | 无菜单不可进 | UI | Playwright+Chrome | §7.1 | 无 `breedingIndustry:query` | 直接访问 `#/livestockIndustry/breedingIndustry/index` | 403/无权限页/重定向；不见四块看板 |
 | ZCZX-YZCYSJ-UI-014 | 范围 | 无维护按钮 | UI | Playwright+Chrome | §3、§5.1 | UA 有 query | 扫描工具栏与页面 | 无新增/编辑/删除/同步/导出；仅有刷新（及返回） |
 | ZCZX-YZCYSJ-UI-015 | 布局 | 纵向四块可滚动 | UI | Playwright+Chrome | §5.1 | 小屏或缩窗口 | 滚动页面 | 四块标题均可达；统计日/年可选展示 |
-| ZCZX-YZCYSJ-UI-016 | 权限 | UB 数据隔离展示 | UI | Playwright+Chrome | §2.9 | UB 登录；P1、P2 均有牛 | 打开看板记存栏总量；换 UA 对比 | UB 与 UA 存栏总量不同且符合各自牧场范围 |
+| ZCZX-YZCYSJ-UI-016 | 权限 | UB 预警隔离 | UI | Playwright+Chrome | §2.9 | UB 登录；P1、P2 均有预警 | 打开看板记 `warningYakCount`；换 UA 对比 | UB 与 UA 预警数不同；填报类指标（存栏/出栏/农牧户）全县一致 |
 
 ---
 
@@ -142,20 +144,21 @@
 | 功能需求 | 单元 | 接口 | 界面 |
 | --- | --- | --- | --- |
 | §2.1 只读看板 | — | API-021 | UI-014 |
-| §2.2 统计日/趋势月份 | UT-021～022 | API-002、005 | UI-005 |
-| §2.3 存栏认定 | UT-004～006 | API-003、026 | UI-006 |
+| §2.2 统计日/趋势月份 | UT-018～022 | API-002、005 | UI-004 |
+| §2.3 存栏认定（档案） | UT-004～006 | API-003、026 | — |
+| §2.11 填报存栏趋势 | UT-013、018～022 | API-004～006 | UI-003～005 |
 | §2.4 年出栏 | UT-007～008 | API-023 | API-003 |
 | §2.5 预警 | UT-009～012 | API-024～025 | API-003 |
 | §2.6 牧场草场总览 | UT-023～024 | API-003、010 | UI-002、008 |
 | §2.7 可用/使用中 | UT-025～026 | API-009 | UI-008 |
 | §2.8 退化占比 | UT-027 | API-010 | UI-008 |
 | §2.9 数据权限 | UT-001～003 | API-013～016 | UI-016 |
-| §2.10 月末趋势 | UT-018～022 | API-005～006 | UI-005～006 |
+| §2.10 月末趋势（档案） | — | — | — |
 | §5.1 加载/刷新/空态 | UT-028～029 | API-001、011～012、019～020 | UI-001、009～012 |
-| §5.2 产业总览 | UT-023～024 | API-003 | UI-002 |
-| §5.3 存栏变动 | UT-013～014、018～022 | API-004～006 | UI-003～006 |
-| §5.4 年龄结构 | UT-015～017 | API-007～008 | UI-007 |
-| §5.5 草场占比 | UT-025～027 | API-009～010 | UI-008 |
+| §5.2 产业总览 | UT-028 | API-003 | UI-002 |
+| §5.3 存栏变动 | UT-013、018～022 | API-004～006 | UI-003～005 |
+| §5.4 年龄结构 | UT-015～017 | API-007～008 | UI-006 |
+| §5.5 草场占比 | UT-025～027 | API-009～010 | UI-007 |
 | §7 权限提示 | — | API-017～018 | UI-013 |
 | §3 本期不实现 | — | API-021～022 | UI-014 |
 
@@ -171,6 +174,6 @@ use: { channel: 'chrome', locale: 'zh-CN', baseURL: process.env.RUOYI_BASE_URL }
 1. `beforeEach`：UI 用例先 `page.goto('/login')` 登录 UA/UB/U0/ADMIN。  
 2. 菜单路径以环境为准：`page.getByText('养殖产业数据').click()` 或路由 `#/livestockIndustry/breedingIndustry/index`。  
 3. 接口 Mock：UI-011 可用 `page.route('**/dataModel/breedingIndustry/dashboard', route => route.fulfill({ status: 500 }))`。  
-4. 图表断言：对 ECharts 容器 `.breeding-trend-chart` 等（以实现 `data-testid` 为准）检查 DOM 或拦截 XHR 校验 `monthlyTrend` 长度。
+4. 图表断言：对 ECharts 容器检查 DOM 或拦截 XHR 校验 `monthlyTrend` 长度 **=12**。
 
-**用例统计**：单元 **29**、接口 **26**、界面 **16**，合计 **71** 条。
+**用例统计**：单元 **29**、接口 **26**、界面 **15**，合计 **70** 条。