大屏查询

baqing-admin/src/main/java/com/ruoyi/web/modules/prosperity/mapper/BizCommonProsperityProjectMapper.java

@@ -33,8 +33,8 @@ public interface BizCommonProsperityProjectMapper
     /**
      * 大屏：共富项目分类情况明细（按实施年限聚合类型数量；年份倒序）。
      *
-     * @param statYear 所属年份（实施年限），必填
+     * @param statYear 所属年份（实施年限），可选；未传不过滤
      */
     List<CommonProsperityProjectTypeDetailVo> selectPublishedTypeDetailsByYear(
-            @Param("statYear") int statYear);
+            @Param("statYear") Integer statYear);
 }

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

@@ -73,7 +73,7 @@ public class CommonProsperityScreenController extends BaseController
      * {@code publish_status=1}，按 {@code impl_year}、{@code project_type} 聚合。
      * </p>
      *
-     * @param statYear 所属年份；未传默认当前自然年
+     * @param statYear 所属年份；未传不过滤
      */
     @GetMapping("/projectTypeDetails")
     public TableDataInfo projectTypeDetails(

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

@@ -97,7 +97,7 @@ public class HomeScreenController extends BaseController
 
     /**
      * 人均收入情况明细（分页）；按所属年份倒序。
-     * <p>查询条件：所属年份（可选，未传默认当前自然年）。数据源 {@code biz_disposable_income}。</p>
+     * <p>查询条件：所属年份（可选，未传不过滤）。数据源 {@code biz_disposable_income}。</p>
      */
     @GetMapping("/perCapitaIncomes")
     public TableDataInfo perCapitaIncomes(
@@ -110,7 +110,7 @@ public class HomeScreenController extends BaseController
 
     /**
      * 农牧户数据明细（分页）；按年、月倒序。草场面积数据明细复用本接口。
-     * <p>查询条件：所属年份（可选，默认当前年）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
+     * <p>查询条件：所属年份（可选，未传不过滤）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
      * 数据源 {@code biz_farmer_household}，返回全部业务字段（含 {@code pastureContractArea} 等）。</p>
      */
     @GetMapping("/farmerHouseholds")
@@ -128,7 +128,7 @@ public class HomeScreenController extends BaseController
 
     /**
      * 合作社发展数据明细（分页）；按年、月倒序。
-     * <p>查询条件：所属年份（可选，默认当前年）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
+     * <p>查询条件：所属年份（可选，未传不过滤）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
      * 数据源 {@code biz_cooperative_development}。</p>
      */
     @GetMapping("/cooperativeDevelopments")
@@ -146,7 +146,7 @@ public class HomeScreenController extends BaseController
 
     /**
      * 家庭牧场数据明细（分页）；按年、月倒序。
-     * <p>查询条件：所属年份（可选，默认当前年）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
+     * <p>查询条件：所属年份（可选，未传不过滤）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
      * 数据源 {@code biz_family_ranch}。</p>
      */
     @GetMapping("/familyRanches")
@@ -164,7 +164,7 @@ public class HomeScreenController extends BaseController
 
     /**
      * 养殖大户数据明细（分页）；按年、月倒序。
-     * <p>查询条件：所属年份（可选，默认当前年）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
+     * <p>查询条件：所属年份（可选，未传不过滤）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
      * 数据源 {@code biz_large_livestock_farmer}。</p>
      */
     @GetMapping("/largeLivestockFarmers")
@@ -182,7 +182,7 @@ public class HomeScreenController extends BaseController
 
     /**
      * 牦牛出栏数据明细（分页）；按年、月倒序。对应牲畜出栏/自食情况明细。
-     * <p>查询条件：所属年份（可选，默认当前年）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
+     * <p>查询条件：所属年份（可选，未传不过滤）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
      * 数据源 {@code biz_yak_outbound_report}。</p>
      */
     @GetMapping("/yakOutboundReports")
@@ -200,7 +200,7 @@ public class HomeScreenController extends BaseController
 
     /**
      * 牦牛存栏数据明细（分页）；按年、月倒序。对应畜群存栏/牦牛存栏结构明细。
-     * <p>查询条件：所属年份（可选，默认当前年）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
+     * <p>查询条件：所属年份（可选，未传不过滤）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
      * 数据源 {@code biz_yak_herd_inventory}。</p>
      */
     @GetMapping("/yakHerdInventories")
@@ -218,7 +218,7 @@ public class HomeScreenController extends BaseController
 
     /**
      * 有无畜户数据明细（分页）；按年、月倒序。
-     * <p>查询条件：所属年份（可选，默认当前年）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
+     * <p>查询条件：所属年份（可选，未传不过滤）、所属月份（可选，未传不过滤）、所属乡镇、所属村。
      * 数据源 {@code biz_livestock_ownership_household}。</p>
      */
     @GetMapping("/livestockOwnershipHouseholds")

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

@@ -53,7 +53,7 @@ public class LivestockResourceScreenController extends BaseController
      * 乡镇/村下拉可复用首页 {@code /bigScreen/home/townOptions}、{@code /villageTree}。
      * </p>
      *
-     * @param statYear      所属年份；未传默认当前自然年；按上报时间落在该年 1-1～12-31
+     * @param statYear      所属年份；未传不过滤（不按上报时间窗限制）
      * @param townDeptId    所属乡镇部门 ID，可选
      * @param villageDeptId 所属村部门 ID，可选
      */
@@ -73,8 +73,8 @@ public class LivestockResourceScreenController extends BaseController
      * 畜牧产品产量数据明细（分页）；按 {@code stat_year}、{@code stat_month} 倒序。
      * <p>数据源 {@code biz_livestock_product_output}；大屏全县口径。</p>
      *
-     * @param statYear      所属年份；未传默认当前自然年
-     * @param statMonth     所属月份；未传不过滤（该年全年，按月倒序）
+     * @param statYear      所属年份；未传不过滤
+     * @param statMonth     所属月份；未传不过滤
      * @param townDeptId    所属乡镇，可选
      * @param villageDeptId 所属村，可选
      */
@@ -95,8 +95,8 @@ public class LivestockResourceScreenController extends BaseController
      * 疫苗接种情况明细（分页）；按 {@code stat_year}、{@code stat_month} 倒序。
      * <p>数据源 {@code biz_vaccination_data}；大屏全县口径；免疫率优先用落库值。</p>
      *
-     * @param statYear      所属年份；未传默认当前自然年
-     * @param statMonth     所属月份；未传不过滤（该年全年，按月倒序）
+     * @param statYear      所属年份；未传不过滤
+     * @param statMonth     所属月份；未传不过滤
      * @param townDeptId    所属乡镇，可选
      * @param villageDeptId 所属村，可选
      */

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

@@ -31,7 +31,7 @@ public interface ICommonProsperityScreenService
     /**
      * 共富项目分类情况明细（按实施年限聚合各类型数量；分页由 Controller 启 PageHelper）。
      *
-     * @param statYear 所属年份；{@code null} 时默认当前自然年
+     * @param statYear 所属年份；{@code null} 时不过滤（跨年按实施年限倒序）
      */
     List<CommonProsperityProjectTypeDetailVo> listProjectTypeDetails(Integer statYear);
 }

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

@@ -61,7 +61,7 @@ public interface IHomeScreenService
     /**
      * 人均收入情况明细（分页由 Controller {@code startPage} 控制；按所属年份倒序）。
      *
-     * @param statYear 所属年份，可选；未传时默认当前自然年
+     * @param statYear 所属年份，可选；未传不过滤（跨年按年倒序）
      */
     List<HomeScreenPerCapitaIncomeListItemVo> listPerCapitaIncomes(Integer statYear);
 
@@ -69,8 +69,8 @@ public interface IHomeScreenService
      * 农牧户数据明细（分页由 Controller {@code startPage} 控制；按年、月倒序）。
      * 草场面积数据明细复用本方法，不另开接口。
      *
-     * @param statYear      所属年份，可选；未传默认当前自然年
-     * @param statMonth     所属月份，可选；未传不过滤月份（该年全年，按月倒序）
+     * @param statYear      所属年份，可选；未传不过滤
+     * @param statMonth     所属月份，可选；未传不过滤
      * @param townDeptId    所属乡镇，可选
      * @param villageDeptId 所属村，可选
      */

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

@@ -26,7 +26,7 @@ public interface ILivestockResourceScreenService
     /**
      * 三资具体问题上报明细（配合 Controller {@code startPage} 分页；按上报时间倒序）。
      *
-     * @param statYear      所属年份，null 则当前自然年
+     * @param statYear      所属年份，可选；未传不过滤
      * @param townDeptId    乡镇，可选
      * @param villageDeptId 村，可选
      */
@@ -36,7 +36,7 @@ public interface ILivestockResourceScreenService
     /**
      * 畜牧产品产量数据明细（配合分页；按所属年月倒序）。
      *
-     * @param statYear      所属年份，null 则当前自然年
+     * @param statYear      所属年份，可选；未传不过滤
      * @param statMonth     所属月份，null 则不过滤月份
      * @param townDeptId    乡镇，可选
      * @param villageDeptId 村，可选
@@ -47,7 +47,7 @@ public interface ILivestockResourceScreenService
     /**
      * 疫苗接种情况明细（配合分页；按所属年月倒序）。
      *
-     * @param statYear      所属年份，null 则当前自然年
+     * @param statYear      所属年份，可选；未传不过滤
      * @param statMonth     所属月份，null 则不过滤月份
      * @param townDeptId    乡镇，可选
      * @param villageDeptId 村，可选

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

@@ -20,7 +20,6 @@ import com.ruoyi.web.modules.screen.domain.vo.CommonProsperityScreenDashboardVo;
 import com.ruoyi.web.modules.screen.domain.vo.ScreenProjectListItemVo;
 import com.ruoyi.web.modules.screen.service.ICommonProsperityScreenService;
 import com.ruoyi.web.modules.screen.support.CommonProsperityScreenSupport;
-import com.ruoyi.web.modules.screen.support.HomeScreenSupport;
 
 /**
  * 大屏共同富裕统计服务实现。
@@ -91,14 +90,13 @@ public class CommonProsperityScreenServiceImpl implements ICommonProsperityScree
 
     /**
      * {@inheritDoc}
-     * <p>口径：{@code publish_status=1}，按 {@code impl_year} 聚合；未传年份默认当前自然年。</p>
+     * <p>口径：{@code publish_status=1}，按 {@code impl_year} 聚合；未传年份不过滤。</p>
      */
     @Override
     public List<CommonProsperityProjectTypeDetailVo> listProjectTypeDetails(Integer statYear)
     {
-        int year = statYear != null ? statYear : HomeScreenSupport.currentYearMonth().getYear();
         List<CommonProsperityProjectTypeDetailVo> list =
-                projectMapper.selectPublishedTypeDetailsByYear(year);
+                projectMapper.selectPublishedTypeDetailsByYear(statYear);
         return list != null ? list : new ArrayList<>();
     }
 

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

@@ -3,7 +3,6 @@ package com.ruoyi.web.modules.screen.service.impl;
 import java.math.BigDecimal;
 import java.math.RoundingMode;
 import java.time.LocalDate;
-import java.time.YearMonth;
 import java.time.ZoneId;
 import java.util.Collections;
 import java.util.Date;
@@ -371,7 +370,7 @@ public class HomeScreenServiceImpl implements IHomeScreenService
     public List<HomeScreenPerCapitaIncomeListItemVo> listPerCapitaIncomes(Integer statYear)
     {
         BizDisposableIncome query = new BizDisposableIncome();
-        query.setStatYear(statYear != null ? statYear : HomeScreenSupport.currentYearMonth().getYear());
+        query.setStatYear(statYear);
         List<BizDisposableIncome> rows = bizDisposableIncomeMapper.selectBizDisposableIncomeList(query);
         return HomeScreenSupport.buildPerCapitaIncomeListItems(rows);
     }
@@ -380,9 +379,8 @@ public class HomeScreenServiceImpl implements IHomeScreenService
     public List<HomeScreenFarmerHouseholdListItemVo> listFarmerHouseholds(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
     {
-        YearMonth now = HomeScreenSupport.currentYearMonth();
         BizFarmerHousehold query = new BizFarmerHousehold();
-        query.setStatYear(statYear != null ? statYear : now.getYear());
+        query.setStatYear(statYear);
         query.setStatMonth(statMonth);
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);
@@ -396,9 +394,8 @@ public class HomeScreenServiceImpl implements IHomeScreenService
     public List<HomeScreenCooperativeDevelopmentListItemVo> listCooperativeDevelopments(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
     {
-        YearMonth now = HomeScreenSupport.currentYearMonth();
         BizCooperativeDevelopment query = new BizCooperativeDevelopment();
-        query.setStatYear(statYear != null ? statYear : now.getYear());
+        query.setStatYear(statYear);
         query.setStatMonth(statMonth);
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);
@@ -412,9 +409,8 @@ public class HomeScreenServiceImpl implements IHomeScreenService
     public List<HomeScreenFamilyRanchListItemVo> listFamilyRanches(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
     {
-        YearMonth now = HomeScreenSupport.currentYearMonth();
         BizFamilyRanch query = new BizFamilyRanch();
-        query.setStatYear(statYear != null ? statYear : now.getYear());
+        query.setStatYear(statYear);
         query.setStatMonth(statMonth);
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);
@@ -427,9 +423,8 @@ public class HomeScreenServiceImpl implements IHomeScreenService
     public List<HomeScreenLargeLivestockFarmerListItemVo> listLargeLivestockFarmers(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
     {
-        YearMonth now = HomeScreenSupport.currentYearMonth();
         BizLargeLivestockFarmer query = new BizLargeLivestockFarmer();
-        query.setStatYear(statYear != null ? statYear : now.getYear());
+        query.setStatYear(statYear);
         query.setStatMonth(statMonth);
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);
@@ -443,9 +438,8 @@ public class HomeScreenServiceImpl implements IHomeScreenService
     public List<HomeScreenYakOutboundReportListItemVo> listYakOutboundReports(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
     {
-        YearMonth now = HomeScreenSupport.currentYearMonth();
         BizYakOutboundReport query = new BizYakOutboundReport();
-        query.setStatYear(statYear != null ? statYear : now.getYear());
+        query.setStatYear(statYear);
         query.setStatMonth(statMonth);
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);
@@ -458,9 +452,8 @@ public class HomeScreenServiceImpl implements IHomeScreenService
     public List<HomeScreenYakHerdInventoryListItemVo> listYakHerdInventories(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
     {
-        YearMonth now = HomeScreenSupport.currentYearMonth();
         BizYakHerdInventory query = new BizYakHerdInventory();
-        query.setStatYear(statYear != null ? statYear : now.getYear());
+        query.setStatYear(statYear);
         query.setStatMonth(statMonth);
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);
@@ -473,9 +466,8 @@ public class HomeScreenServiceImpl implements IHomeScreenService
     public List<HomeScreenLivestockOwnershipHouseholdListItemVo> listLivestockOwnershipHouseholds(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
     {
-        YearMonth now = HomeScreenSupport.currentYearMonth();
         BizLivestockOwnershipHousehold query = new BizLivestockOwnershipHousehold();
-        query.setStatYear(statYear != null ? statYear : now.getYear());
+        query.setStatYear(statYear);
         query.setStatMonth(statMonth);
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);

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

@@ -2,7 +2,6 @@ package com.ruoyi.web.modules.screen.service.impl;
 
 import java.time.LocalDate;
 import java.time.LocalDateTime;
-import java.time.YearMonth;
 import java.time.ZoneId;
 import java.util.Collections;
 import java.util.Date;
@@ -121,15 +120,16 @@ public class LivestockResourceScreenServiceImpl implements ILivestockResourceScr
     public List<LivestockResourceThreeAssetsProblemListItemVo> listThreeAssetsProblemReports(
             Integer statYear, Long townDeptId, Long villageDeptId)
     {
-        int year = statYear != null ? statYear : HomeScreenSupport.currentYearMonth().getYear();
-        LocalDate yearStart = LocalDate.of(year, 1, 1);
-        LocalDate yearEnd = LocalDate.of(year, 12, 31);
-
         BizThreeAssetsProblemReport query = new BizThreeAssetsProblemReport();
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);
-        query.setBeginReportTime(toDate(yearStart));
-        query.setEndReportTime(toDate(yearEnd));
+        if (statYear != null)
+        {
+            LocalDate yearStart = LocalDate.of(statYear, 1, 1);
+            LocalDate yearEnd = LocalDate.of(statYear, 12, 31);
+            query.setBeginReportTime(toDate(yearStart));
+            query.setEndReportTime(toDate(yearEnd));
+        }
         // 大屏全县口径，清空 dataScope
         query.getParams().put("dataScope", "");
         List<BizThreeAssetsProblemReport> rows =
@@ -141,9 +141,8 @@ public class LivestockResourceScreenServiceImpl implements ILivestockResourceScr
     public List<LivestockResourceProductOutputListItemVo> listProductOutputs(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
     {
-        YearMonth current = HomeScreenSupport.currentYearMonth();
         BizLivestockProductOutput query = new BizLivestockProductOutput();
-        query.setStatYear(statYear != null ? statYear : current.getYear());
+        query.setStatYear(statYear);
         query.setStatMonth(statMonth);
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);
@@ -158,9 +157,8 @@ public class LivestockResourceScreenServiceImpl implements ILivestockResourceScr
     public List<LivestockResourceVaccinationListItemVo> listVaccinationData(
             Integer statYear, Integer statMonth, Long townDeptId, Long villageDeptId)
     {
-        YearMonth current = HomeScreenSupport.currentYearMonth();
         BizVaccinationData query = new BizVaccinationData();
-        query.setStatYear(statYear != null ? statYear : current.getYear());
+        query.setStatYear(statYear);
         query.setStatMonth(statMonth);
         query.setTownDeptId(townDeptId);
         query.setVillageDeptId(villageDeptId);

baqing-admin/src/main/resources/mapper/prosperity/BizCommonProsperityProjectMapper.xml

@@ -143,7 +143,9 @@
                sum(case when p.project_type = 3 then 1 else 0 end) as otherProjectCount
         from biz_common_prosperity_project p
         where p.publish_status = 1
+          <if test="statYear != null">
           and p.impl_year = #{statYear}
+          </if>
         group by p.impl_year
         order by p.impl_year desc
     </select>

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

@@ -196,8 +196,8 @@ class CommonProsperityScreenControllerApiTest
     }
 
     @Test
-    @DisplayName("GET projectTypeDetails 缺年份传 null 由服务默认当前年")
-    void api_projectTypeDetails_defaultYear() throws Exception
+    @DisplayName("GET projectTypeDetails 缺年份传 null 由服务不过滤年份")
+    void api_projectTypeDetails_noYearFilter() throws Exception
     {
         when(commonProsperityScreenService.listProjectTypeDetails(null)).thenReturn(Collections.emptyList());
         mockMvc.perform(get("/bigScreen/commonProsperity/projectTypeDetails"))

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

@@ -27,7 +27,6 @@ import com.ruoyi.web.modules.prosperity.mapper.BizCommonProsperityProjectMapper;
 import com.ruoyi.web.modules.prosperity.mapper.BizCommonProsperityProjectOpImageMapper;
 import com.ruoyi.web.modules.screen.domain.vo.CommonProsperityProjectTypeDetailVo;
 import com.ruoyi.web.modules.screen.domain.vo.CommonProsperityScreenDashboardVo;
-import com.ruoyi.web.modules.screen.support.HomeScreenSupport;
 
 /**
  * DP-GTFY-UT-014、015
@@ -164,16 +163,15 @@ class CommonProsperityScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("分类明细：未传年份默认当前自然年")
-    void listProjectTypeDetails_defaultCurrentYear()
+    @DisplayName("分类明细：未传年份不过滤")
+    void listProjectTypeDetails_noYearFilter()
     {
-        int currentYear = HomeScreenSupport.currentYearMonth().getYear();
-        when(projectMapper.selectPublishedTypeDetailsByYear(currentYear)).thenReturn(Collections.emptyList());
+        when(projectMapper.selectPublishedTypeDetailsByYear(null)).thenReturn(Collections.emptyList());
 
         List<CommonProsperityProjectTypeDetailVo> list = service.listProjectTypeDetails(null);
         assertNotNull(list);
         assertTrue(list.isEmpty());
-        verify(projectMapper).selectPublishedTypeDetailsByYear(currentYear);
+        verify(projectMapper).selectPublishedTypeDetailsByYear(null);
     }
 
     private static BizCommonProsperityAchievement sampleAchievementRow()

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

@@ -203,14 +203,13 @@ class HomeScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("DP-SY-UT-031b 人均收入明细未传年份默认当前年")
-    void ut031b_perCapitaIncomesDefaultCurrentYear()
+    @DisplayName("DP-SY-UT-031b 人均收入明细未传年份不过滤")
+    void ut031b_perCapitaIncomesNoYearFilter()
     {
-        int currentYear = com.ruoyi.web.modules.screen.support.HomeScreenSupport.currentYearMonth().getYear();
         when(bizDisposableIncomeMapper.selectBizDisposableIncomeList(any(BizDisposableIncome.class)))
                 .thenAnswer(invocation -> {
                     BizDisposableIncome q = invocation.getArgument(0);
-                    assertEquals(currentYear, q.getStatYear().intValue());
+                    assertNull(q.getStatYear());
                     return Collections.emptyList();
                 });
 
@@ -252,14 +251,13 @@ class HomeScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("DP-SY-UT-032b 农牧户明细未传年默认当前年，未传月不过滤")
-    void ut032b_farmerHouseholdsDefaultCurrentYearNoMonth()
+    @DisplayName("DP-SY-UT-032b 农牧户明细未传年月不过滤")
+    void ut032b_farmerHouseholdsNoYearMonthFilter()
     {
-        java.time.YearMonth now = com.ruoyi.web.modules.screen.support.HomeScreenSupport.currentYearMonth();
         when(bizFarmerHouseholdMapper.selectBizFarmerHouseholdList(any(BizFarmerHousehold.class)))
                 .thenAnswer(invocation -> {
                     BizFarmerHousehold q = invocation.getArgument(0);
-                    assertEquals(now.getYear(), q.getStatYear().intValue());
+                    assertNull(q.getStatYear());
                     assertNull(q.getStatMonth());
                     return Collections.emptyList();
                 });
@@ -295,14 +293,13 @@ class HomeScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("DP-SY-UT-033b 合作社明细未传年默认当前年，未传月不过滤")
-    void ut033b_cooperativeDevelopmentsDefaultCurrentYearNoMonth()
+    @DisplayName("DP-SY-UT-033b 合作社明细未传年月不过滤")
+    void ut033b_cooperativeDevelopmentsNoYearMonthFilter()
     {
-        java.time.YearMonth now = com.ruoyi.web.modules.screen.support.HomeScreenSupport.currentYearMonth();
         when(bizCooperativeDevelopmentMapper.selectBizCooperativeDevelopmentList(any(BizCooperativeDevelopment.class)))
                 .thenAnswer(invocation -> {
                     BizCooperativeDevelopment q = invocation.getArgument(0);
-                    assertEquals(now.getYear(), q.getStatYear().intValue());
+                    assertNull(q.getStatYear());
                     assertNull(q.getStatMonth());
                     return Collections.emptyList();
                 });
@@ -333,14 +330,13 @@ class HomeScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("DP-SY-UT-034b 家庭牧场明细未传年默认当前年，未传月不过滤")
-    void ut034b_familyRanchesDefaultCurrentYearNoMonth()
+    @DisplayName("DP-SY-UT-034b 家庭牧场明细未传年月不过滤")
+    void ut034b_familyRanchesNoYearMonthFilter()
     {
-        java.time.YearMonth now = com.ruoyi.web.modules.screen.support.HomeScreenSupport.currentYearMonth();
         when(bizFamilyRanchMapper.selectBizFamilyRanchList(any(BizFamilyRanch.class)))
                 .thenAnswer(invocation -> {
                     BizFamilyRanch q = invocation.getArgument(0);
-                    assertEquals(now.getYear(), q.getStatYear().intValue());
+                    assertNull(q.getStatYear());
                     assertNull(q.getStatMonth());
                     return Collections.emptyList();
                 });
@@ -372,14 +368,13 @@ class HomeScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("DP-SY-UT-035b 养殖大户明细未传年默认当前年，未传月不过滤")
-    void ut035b_largeLivestockFarmersDefaultCurrentYearNoMonth()
+    @DisplayName("DP-SY-UT-035b 养殖大户明细未传年月不过滤")
+    void ut035b_largeLivestockFarmersNoYearMonthFilter()
     {
-        java.time.YearMonth now = com.ruoyi.web.modules.screen.support.HomeScreenSupport.currentYearMonth();
         when(bizLargeLivestockFarmerMapper.selectBizLargeLivestockFarmerList(any(BizLargeLivestockFarmer.class)))
                 .thenAnswer(invocation -> {
                     BizLargeLivestockFarmer q = invocation.getArgument(0);
-                    assertEquals(now.getYear(), q.getStatYear().intValue());
+                    assertNull(q.getStatYear());
                     assertNull(q.getStatMonth());
                     return Collections.emptyList();
                 });
@@ -412,14 +407,13 @@ class HomeScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("DP-SY-UT-036b 牦牛出栏明细未传年默认当前年，未传月不过滤")
-    void ut036b_yakOutboundReportsDefaultCurrentYearNoMonth()
+    @DisplayName("DP-SY-UT-036b 牦牛出栏明细未传年月不过滤")
+    void ut036b_yakOutboundReportsNoYearMonthFilter()
     {
-        java.time.YearMonth now = com.ruoyi.web.modules.screen.support.HomeScreenSupport.currentYearMonth();
         when(bizYakOutboundReportMapper.selectBizYakOutboundReportList(any(BizYakOutboundReport.class)))
                 .thenAnswer(invocation -> {
                     BizYakOutboundReport q = invocation.getArgument(0);
-                    assertEquals(now.getYear(), q.getStatYear().intValue());
+                    assertNull(q.getStatYear());
                     assertNull(q.getStatMonth());
                     return Collections.emptyList();
                 });
@@ -451,14 +445,13 @@ class HomeScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("DP-SY-UT-037b 牦牛存栏明细未传年默认当前年，未传月不过滤")
-    void ut037b_yakHerdInventoriesDefaultCurrentYearNoMonth()
+    @DisplayName("DP-SY-UT-037b 牦牛存栏明细未传年月不过滤")
+    void ut037b_yakHerdInventoriesNoYearMonthFilter()
     {
-        java.time.YearMonth now = com.ruoyi.web.modules.screen.support.HomeScreenSupport.currentYearMonth();
         when(bizYakHerdInventoryMapper.selectBizYakHerdInventoryList(any(BizYakHerdInventory.class)))
                 .thenAnswer(invocation -> {
                     BizYakHerdInventory q = invocation.getArgument(0);
-                    assertEquals(now.getYear(), q.getStatYear().intValue());
+                    assertNull(q.getStatYear());
                     assertNull(q.getStatMonth());
                     return Collections.emptyList();
                 });
@@ -491,15 +484,14 @@ class HomeScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("DP-SY-UT-038b 有无畜户明细未传年默认当前年，未传月不过滤")
-    void ut038b_livestockOwnershipHouseholdsDefaultCurrentYearNoMonth()
+    @DisplayName("DP-SY-UT-038b 有无畜户明细未传年月不过滤")
+    void ut038b_livestockOwnershipHouseholdsNoYearMonthFilter()
     {
-        java.time.YearMonth now = com.ruoyi.web.modules.screen.support.HomeScreenSupport.currentYearMonth();
         when(bizLivestockOwnershipHouseholdMapper.selectBizLivestockOwnershipHouseholdList(
                 any(BizLivestockOwnershipHousehold.class)))
                 .thenAnswer(invocation -> {
                     BizLivestockOwnershipHousehold q = invocation.getArgument(0);
-                    assertEquals(now.getYear(), q.getStatYear().intValue());
+                    assertNull(q.getStatYear());
                     assertNull(q.getStatMonth());
                     return Collections.emptyList();
                 });

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

@@ -2,6 +2,7 @@ package com.ruoyi.web.modules.screen.service.impl;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
 import static org.mockito.ArgumentMatchers.any;
 import static org.mockito.ArgumentMatchers.anyInt;
 import static org.mockito.ArgumentMatchers.eq;
@@ -180,7 +181,7 @@ class LivestockResourceScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("三资问题上报明细默认当前年并组装字段")
+    @DisplayName("三资问题上报明细按年过滤并组装字段")
     void listThreeAssetsProblemReports()
     {
         BizThreeAssetsProblemReport row = new BizThreeAssetsProblemReport();
@@ -190,7 +191,12 @@ class LivestockResourceScreenServiceImplTest
         row.setProblemDetail("道路硬化问题");
         row.setHandleResult("已整改");
         when(bizThreeAssetsProblemReportMapper.selectBizThreeAssetsProblemReportList(any()))
-                .thenReturn(Collections.singletonList(row));
+                .thenAnswer(invocation -> {
+                    BizThreeAssetsProblemReport q = invocation.getArgument(0);
+                    assertNotNull(q.getBeginReportTime());
+                    assertNotNull(q.getEndReportTime());
+                    return Collections.singletonList(row);
+                });
 
         java.util.List<LivestockResourceThreeAssetsProblemListItemVo> list =
                 service.listThreeAssetsProblemReports(2026, 101L, 201L);
@@ -203,6 +209,20 @@ class LivestockResourceScreenServiceImplTest
         assertEquals("已整改", list.get(0).getHandleResult());
     }
 
+    @Test
+    @DisplayName("三资问题上报明细未传年份不过滤上报时间窗")
+    void listThreeAssetsProblemReports_noYearFilter()
+    {
+        when(bizThreeAssetsProblemReportMapper.selectBizThreeAssetsProblemReportList(any()))
+                .thenAnswer(invocation -> {
+                    BizThreeAssetsProblemReport q = invocation.getArgument(0);
+                    assertNull(q.getBeginReportTime());
+                    assertNull(q.getEndReportTime());
+                    return Collections.emptyList();
+                });
+        assertEquals(0, service.listThreeAssetsProblemReports(null, null, null).size());
+    }
+
     @Test
     @DisplayName("DP-XM-UT-009 产量明细分页")
     void listProductOutputs()

doc/大屏/共同富裕/大屏共同富裕功能需求.md

@@ -246,7 +246,7 @@ flowchart TD
 
 | 项 | 规则 |
 | --- | --- |
-| 筛选 | **所属年份**（实施年限）；未选时默认**当前自然年** |
+| 筛选 | **所属年份**（实施年限）；未选时**不过滤**（跨年按实施年限倒序） |
 | 数据口径 | 已发布项目（`publish_status=1`），按所属年份聚合；与饼图纳入规则一致 |
 | 列表字段 | **所属年份**、**项目总数**、**和美乡村建设项目数**、**人居环境整治提升项目数**、**其他项目投入数**（单位：个） |
 | 排序 | 按所属年份**倒序** |
@@ -359,7 +359,7 @@ flowchart TD
 | DP-08 | 项目列表 | 分页正常；行内可见类型、名称、简介、内容、周期、图视；无单独详情页跳转 |
 | DP-09 | 后台补录后刷新 | 补录某月成果或发布项目后，大屏刷新可见新数据 |
 | DP-10 | 下架项目 | 已下架项目不再出现在分类与列表 |
-| DP-11 | 分类明细 | 明细弹窗按所属年展示总数及三类数量；默认当前年；支持分页；年份倒序 |
+| DP-11 | 分类明细 | 明细弹窗按所属年展示总数及三类数量；未选年可跨年分页；支持分页；年份倒序 |
 
 ---
 
@@ -372,6 +372,7 @@ flowchart TD
 | 1.2 | 2026-07-24 | **总览与按月图表**统一按所选年 **Y** 的 1～12 月取数；取消滚动 12 月窗口 |
 | 1.3 | 2026-07-24 | **总览 / 数字赋能**改为所选年台账**最大统计月**的单月数据；按月图表仍为该年 1～12 月 |
 | 1.4 | 2026-07-24 | 按月图表改为所选年 **1～最大月**；与管理端年度报告口径一致 |
+| 1.6 | 2026-08-18 | §5.10.1 / DP-11：分类明细未选年份不过滤 |
 | 1.5 | 2026-07-24 | 新增 **§5.10.1** 共富项目分类情况明细（下钻）；验收 DP-11 |
 
 ---

doc/大屏/共同富裕/大屏共同富裕技术方案.md

@@ -233,7 +233,7 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `statYear` | int | N | 所属年份（实施年限）；**未传默认当前自然年** |
+| `statYear` | int | N | 所属年份（实施年限）；**未传不过滤（跨年按实施年限倒序）** |
 | `pageNum` | int | N | 默认 `1` |
 | `pageSize` | int | N | 默认若依分页 |
 
@@ -286,4 +286,5 @@ SQL 示例：`sql/big_screen_common_prosperity_perm.sql`（挂载「大屏」父
 | 1.1 | 2026-07-24 | 看板 `monthly` 改回所选年 1～12 月（与 `summary` 同源），不再覆盖为滚动 12 月 |
 | 1.2 | 2026-07-24 | 看板 `summary` 改为所选年**最大统计月**单月值；`monthly` 仍为该年 1～12 月 |
 | 1.3 | 2026-07-24 | `monthly` 改为所选年 1～最大月；与管理端年度报告共用 Aggregator 口径 |
+| 1.5 | 2026-08-18 | `/projectTypeDetails`：年份未传不过滤（跨年按实施年限倒序聚合） |
 | 1.4 | 2026-07-24 | 新增共富项目分类情况明细 `GET /projectTypeDetails`（分页、按年聚合） |

doc/大屏/共同富裕/大屏共同富裕测试用例.md

@@ -82,7 +82,7 @@
 | DP-GTFY-API-027 | 权限 | 有大屏无成果写 | 接口测试 | Postman | 只读 | 仅有 query | `GET` 成功；`POST /commonProsperity/achievement` 失败 | 大屏可读；台账不可写 |
 | DP-GTFY-API-028 | 一致性 | 切年数据不串 | 接口测试 | Postman | DP-02 | 2025、2026 各不同数据 | 分别 `statYear=2025/2026` | 各年 `monthly`/项目集合互不混入 |
 | DP-GTFY-API-029 | 分类明细 | 指定年有数据 | 接口测试 | Postman | DP-11、§5.10.1 | 2026 已发布三类项目 | `GET .../projectTypeDetails?statYear=2026` | `code` 成功；`rows[0].statYear=2026`；`totalCount`=三类之和；各类型 count 正确 |
-| DP-GTFY-API-030 | 分类明细 | 缺年份默认当前年 | 接口测试 | Postman | §5.10.1 | 已登录；当前年有/无项目均可 | 不传 `statYear` | 成功；按当前自然年聚合（无数据则 `rows=[]`） |
+| DP-GTFY-API-030 | 分类明细 | 缺年份不过滤 | 接口测试 | Postman | §5.10.1 | 已登录；库中有多年项目 | 不传 `statYear` | 成功；按实施年限倒序返回多年聚合行（无数据则 `rows=[]`） |
 | DP-GTFY-API-031 | 分类明细 | 未发布不计 | 接口测试 | Postman | 业务约束 | 该年仅未发布项目 | `GET projectTypeDetails` | `rows=[]` 或无该年行 |
 | DP-GTFY-API-032 | 分类明细 | 分页参数 | 接口测试 | Postman | 分页 | 已登录 | `pageNum=1&pageSize=10` | 成功；`total`/`rows` 符合 PageHelper |
 
@@ -182,4 +182,5 @@ await expect(page.locator('[data-chart]')).toHaveCount(6); // 集体经济/就
 | 版本 | 说明 |
 | --- | --- |
 | 1.0 | 初版：单元 18、接口 28、UI 25；覆盖 DP-01～10 与正常/异常/约束；Playwright+Chrome；Base `/bigScreen/commonProsperity` |
+| 1.2 | 分类明细缺年份改为不过滤（API-030） |
 | 1.1 | 增补分类情况明细 API-029～032（DP-11）；成果口径改为最大月 / 1～最大月 |

doc/大屏/畜牧资源/大屏畜牧资源技术方案.md

@@ -436,7 +436,7 @@ XML：`mapper/screen/LivestockResourceScreenMapper.xml`。
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `statYear` | int | N | 所属年份；未传默认**当前自然年**；按 `report_time` 落在该年 1-1～12-31 |
+| `statYear` | int | N | 所属年份；**未传不过滤**；传入则按 `report_time` 落在该年 1-1～12-31 |
 | `townDeptId` | long | N | 所属乡镇 |
 | `villageDeptId` | long | N | 所属村 |
 | `pageNum` / `pageSize` | int | N | 分页 |
@@ -467,8 +467,8 @@ XML：`mapper/screen/LivestockResourceScreenMapper.xml`。
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `statYear` | int | N | 所属年份；未传默认**当前自然年** |
-| `statMonth` | int | N | 所属月份；未传不过滤（该年全年，按月倒序） |
+| `statYear` | int | N | 所属年份；**未传不过滤（支持跨多年全量翻页）** |
+| `statMonth` | int | N | 所属月份；未传不过滤 |
 | `townDeptId` | long | N | 所属乡镇 |
 | `villageDeptId` | long | N | 所属村 |
 | `pageNum` / `pageSize` | int | N | 分页 |
@@ -498,8 +498,8 @@ XML：`mapper/screen/LivestockResourceScreenMapper.xml`。
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `statYear` | int | N | 所属年份；未传默认**当前自然年** |
-| `statMonth` | int | N | 所属月份；未传不过滤（该年全年，按月倒序） |
+| `statYear` | int | N | 所属年份；**未传不过滤（支持跨多年全量翻页）** |
+| `statMonth` | int | N | 所属月份；未传不过滤 |
 | `townDeptId` | long | N | 所属乡镇 |
 | `villageDeptId` | long | N | 所属村 |
 | `pageNum` / `pageSize` | int | N | 分页 |
@@ -570,6 +570,7 @@ SQL 示例：`sql/big_screen_livestock_resource_perm.sql`（挂载「大屏」
 
 | 版本 | 日期 | 说明 |
 | --- | --- | --- |
+| 1.17 | 2026-08-18 | 明细分页年份未传一律不过滤：`/threeAssetsProblemReports`、`/productOutputs`、`/vaccinationData` |
 | 1.16 | 2026-08-18 | `/productOutputs`、`/vaccinationData`：月份未传不过滤（该年全年）；年份未传仍默认当前年 |
 | 1.15 | 2026-07-24 | 新增兽医数量明细分页接口 `/vetCounts`（按乡镇汇总） |
 | 1.13 | 2026-07-24 | 新增畜牧产品产量数据明细分页接口 `/productOutputs` |

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

@@ -89,8 +89,8 @@
 | **合作社经营模式分类** | 所选年 **Y** 内 `biz_cooperative_development` 最大填报月按 `business_model` 计数（整村/股份/联合/多种经营/公司型/其他）；饼图；单位**个**；字段 **`cooperativeBusinessModel`** |
 | **农牧户分类** | 所选年 **Y** 内 `biz_farmer_household` 最大填报月各分类标记为「是」的村级记录数（纯牧户/无畜户/绝户/超载牧户/需要封顶/需要保底）；柱状图；单位**个**；字段 **`farmerHouseholdClassification`** |
 | **人均收入** | `biz_disposable_income` 以库中**最大所属年**为终点向前共 5 年双折线：农村居民人均可支配收入、脱贫人口人均纯收入；缺年补 0；无数据则空；单位**元**；**不随所选年 Y 切换**；字段 **`perCapitaIncomeTrend`** |
-| **人均收入明细** | 独立接口分页查询 `biz_disposable_income`；条件：所属年份（可选，**默认当前年**）；按**所属年份倒序**；返回年份、农村居民人均可支配收入、增幅、增速、脱贫人口人均纯收入 |
-| **农牧户数据明细** | 独立接口分页查询 `biz_farmer_household`；条件：年（可选，**默认当前年**）、月（可选，**未传不过滤**）、乡镇、村；按**年、月倒序**；返回全部业务列表字段 |
+| **人均收入明细** | 独立接口分页查询 `biz_disposable_income`；条件：所属年份（可选，**未传不过滤**）；按**所属年份倒序**；返回年份、农村居民人均可支配收入、增幅、增速、脱贫人口人均纯收入 |
+| **农牧户数据明细** | 独立接口分页查询 `biz_farmer_household`；条件：年（可选，**未传不过滤**）、月（可选，**未传不过滤**）、乡镇、村；按**年、月倒序**；返回全部业务列表字段 |
 | **草场面积数据明细** | **复用**农牧户数据明细接口（同表同条件；面积字段含 `pasture_contract_area` 等）；**不另开**独立接口 |
 | **合作社数据明细** | 独立接口分页查询 `biz_cooperative_development`；条件同农牧户明细；按**年、月倒序**；返回全部业务列表字段 |
 | **家庭牧场数据明细** | 独立接口分页查询 `biz_family_ranch`；条件同农牧户明细；按**年、月倒序**；返回全部业务列表字段 |
@@ -503,6 +503,7 @@ flowchart TB
 
 | 版本 | 日期 | 说明 |
 | --- | --- | --- |
+| 1.22 | 2026-08-18 | 大屏明细分页：年份未传一律不过滤（跨年全量翻页）；含人均收入/农牧户/合作社/家庭牧场/养殖大户/出栏/存栏/有无畜户 |
 | 1.21 | 2026-08-18 | 大屏明细分页：月份未传一律不过滤（该年全年）；年份未传仍默认当前年。含合作社/家庭牧场/养殖大户/出栏/存栏/有无畜户 |
 | 1.19 | 2026-07-24 | 人均收入趋势改为以库中最大所属年为终点的最近 5 年 |
 | 1.18 | 2026-07-24 | 牦牛月度出栏趋势改为按填报最大月 N 输出 1～N 月（区间缺月补 0） |

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

@@ -488,7 +488,7 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `statYear` | int | N | 所属年份；**未传默认当前自然年** |
+| `statYear` | int | N | 所属年份；**未传不过滤（跨年按年倒序）** |
 | `pageNum` / `pageSize` | int | N | 分页（PageHelper） |
 
 排序：`stat_year DESC, id DESC`。
@@ -515,8 +515,8 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `statYear` | int | N | 所属年份；**未传默认当前自然年** |
-| `statMonth` | int | N | 所属月份；**未传不过滤（该年全年按月倒序）** |
+| `statYear` | int | N | 所属年份；**未传不过滤（支持跨多年全量翻页）** |
+| `statMonth` | int | N | 所属月份；**未传不过滤** |
 | `townDeptId` | long | N | 所属乡镇 |
 | `villageDeptId` | long | N | 所属村 |
 | `pageNum` / `pageSize` | int | N | 分页（PageHelper） |
@@ -537,8 +537,8 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `statYear` | int | N | 所属年份；**未传默认当前自然年** |
-| `statMonth` | int | N | 所属月份；**未传不过滤（该年全年按月倒序）** |
+| `statYear` | int | N | 所属年份；**未传不过滤（支持跨多年全量翻页）** |
+| `statMonth` | int | N | 所属月份；**未传不过滤** |
 | `townDeptId` | long | N | 所属乡镇 |
 | `villageDeptId` | long | N | 所属村 |
 | `pageNum` / `pageSize` | int | N | 分页（PageHelper） |
@@ -554,7 +554,7 @@
 | 3.11 | `/yakHerdInventories` | `biz_yak_herd_inventory` | 全部业务字段（含公母牛/奶牛/羊/保险等） |
 | 3.12 | `/livestockOwnershipHouseholds` | `biz_livestock_ownership_household` | 全部业务字段（有畜/无畜户数人数劳动力等） |
 
-查询条件与 3.6 相同：年未传默认当前年，月未传不过滤，乡镇/村可选；按年、月倒序；全县口径清空 dataScope。
+查询条件与 3.6 相同：年/月未传不过滤，乡镇/村可选；按年、月倒序；全县口径清空 dataScope。
 
 ### 3.13 牦牛存出栏情况明细
 
@@ -665,6 +665,7 @@ SQL 示例：`sql/big_screen_home_perm.sql`（挂载「大屏」父菜单下）
 
 | 版本 | 日期 | 说明 |
 | --- | --- | --- |
+| 1.25 | 2026-08-18 | 首页明细分页：年份未传一律不过滤（跨年全量翻页）；含人均收入/农牧户/合作社/家庭牧场/养殖大户/出栏/存栏/有无畜户 |
 | 1.24 | 2026-08-18 | 首页明细分页：月份未传一律不过滤；含合作社/家庭牧场/养殖大户/出栏/存栏/有无畜户（农牧户已在 1.23） |
 | 1.23 | 2026-08-18 | `/farmerHouseholds`：月份未传不过滤（该年全年按月倒序）；年份未传仍默认当前年 |
 | 1.21 | 2026-07-24 | 看板屏蔽：`subsidy`、`grassland`、`outboundMonthly`、`inventoryChange` |

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

@@ -83,14 +83,14 @@
 | DP-SY-UT-028 | 产业总览 | 农牧户合计 | 单元测试 | JUnit5 | §5.2 | Mock `biz_farmer_household` 所选年最大月 | `loadDashboard(Y)` | `pastureCount` 为该年月全县村级 `household_count` 合计 |
 | DP-SY-UT-029 | 产业总览 | 合作社等计数 | 单元测试 | JUnit5 | §5.2 | Mock 三表所选年最大月 | `loadDashboard(Y)` | `cooperativeCount`/`familyRanchCount`/`largeLivestockFarmerCount` 为该年月记录条数 |
 | DP-SY-UT-030 | 产业总览 | 有畜户/草场面积 | 单元测试 | JUnit5 | §5.2 | Mock 有无畜户与农牧户面积 | `loadDashboard(Y)` | `withLivestockHouseholdCount`/`grasslandAreaMu` 取所选年最大月合计 |
-| DP-SY-UT-031 | 人均收入明细 | 字段映射与默认年 | 单元测试 | JUnit5 | §2.5 | Mock `biz_disposable_income` | `listPerCapitaIncomes(2025)` / `null` | 字段完整；未传年默认当前年 |
-| DP-SY-UT-032 | 农牧户明细 | 条件过滤与默认年 | 单元测试 | JUnit5 | §2.5 | Mock `biz_farmer_household` | `listFarmerHouseholds(...)` / `null,null` | 字段完整；未传年默认当前年；未传月不过滤 |
-| DP-SY-UT-033 | 合作社明细 | 条件过滤与默认年 | 单元测试 | JUnit5 | §2.5 | Mock `biz_cooperative_development` | `listCooperativeDevelopments(...)` | 字段完整；未传年默认当前年；未传月不过滤 |
-| DP-SY-UT-034 | 家庭牧场明细 | 条件过滤与默认年 | 单元测试 | JUnit5 | §2.5 | Mock `biz_family_ranch` | `listFamilyRanches(...)` | 字段完整；未传年默认当前年；未传月不过滤 |
-| DP-SY-UT-035 | 养殖大户明细 | 条件过滤与默认年 | 单元测试 | JUnit5 | §2.5 | Mock `biz_large_livestock_farmer` | `listLargeLivestockFarmers(...)` | 字段完整；未传年默认当前年；未传月不过滤 |
-| 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-031 | 人均收入明细 | 字段映射与未传年 | 单元测试 | JUnit5 | §2.5 | Mock `biz_disposable_income` | `listPerCapitaIncomes(2025)` / `null` | 字段完整；未传年不过滤 |
+| DP-SY-UT-032 | 农牧户明细 | 条件过滤与未传年月 | 单元测试 | JUnit5 | §2.5 | Mock `biz_farmer_household` | `listFarmerHouseholds(...)` / `null,null` | 字段完整；未传年月不过滤 |
+| DP-SY-UT-033 | 合作社明细 | 条件过滤与未传年月 | 单元测试 | JUnit5 | §2.5 | Mock `biz_cooperative_development` | `listCooperativeDevelopments(...)` | 字段完整；未传年月不过滤 |
+| DP-SY-UT-034 | 家庭牧场明细 | 条件过滤与未传年月 | 单元测试 | JUnit5 | §2.5 | Mock `biz_family_ranch` | `listFamilyRanches(...)` | 字段完整；未传年月不过滤 |
+| DP-SY-UT-035 | 养殖大户明细 | 条件过滤与未传年月 | 单元测试 | JUnit5 | §2.5 | Mock `biz_large_livestock_farmer` | `listLargeLivestockFarmers(...)` | 字段完整；未传年月不过滤 |
+| 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） |
 | DP-SY-UT-040 | 养殖主体数量明细 | 关联计数与跨年全量 | 单元测试 | JUnit5 | §2.5 | Mock `selectBreedingEntityQuantityList` | `listBreedingEntityQuantities(...)` | 返回四类数量；未传年月不过滤 |
 | DP-SY-UT-041 | 乡镇列表 | 全县口径 | 单元测试 | JUnit5 | §2.5 | Mock `toAllOptionList` | `listTownOptions()` | 返回乡镇选项 |
@@ -268,6 +268,7 @@ await page.route('**/bigScreen/home/dashboard**', route =>
 
 | 版本 | 说明 |
 | --- | --- |
+| 1.8 | 明细分页：年份未传不过滤（UT-031～038） |
 | 1.7 | 新增大屏乡镇列表、村树接口（UT-041～042、API-050～051） |
 | 1.6 | 新增养殖主体数量明细接口（UT-040、API-049） |
 | 1.5 | 存出栏明细：年月未传不过滤，支持跨年全量翻页（UT-039） |