大屏首页

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/domain/vo/HomeScreenDashboardVo.java

@@ -36,7 +36,7 @@ public class HomeScreenDashboardVo
     private List<HomeScreenNamedCountItemVo> cooperativeBusinessModel;
     /** 农牧户分类 */
     private List<HomeScreenNamedCountItemVo> farmerHouseholdClassification;
-    /** 人均收入：距当前最近 5 年趋势（农村可支配收入 / 脱贫人均纯收入） */
+    /** 人均收入：以库中最大所属年为终点的最近 5 年趋势（农村可支配收入 / 脱贫人均纯收入） */
     private List<HomeScreenPerCapitaIncomeYearVo> perCapitaIncomeTrend;
     /** 草场可用/在用及退化等级分布 */
     private HomeScreenGrasslandVo grassland;

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

@@ -227,6 +227,9 @@ public interface HomeScreenStatsMapper
     List<HomeScreenDisposableIncomeYearDto> selectDisposableIncomeByYearRange(
             @Param("startYear") int startYear, @Param("endYear") int endYear);
 
+    /** 可支配收入填报最大所属年份；无数据返回 null */
+    Integer selectLatestDisposableIncomeStatYear();
+
     /**
      * 牦牛存出栏情况明细：按 {@code (stat_year, stat_month, village_dept_id)} 关联存栏/出栏填报；
      * 按年、月倒序。缺一侧时存栏或出栏计为 0。

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

@@ -254,12 +254,19 @@ public class HomeScreenServiceImpl implements IHomeScreenService
                     homeScreenStatsMapper.countFarmerHouseholdClassByStatYearMonth(
                             yearFarmerHousehold.getStatYear(), yearFarmerHousehold.getStatMonth())));
         }
-        // 人均收入：距当前最近 5 年（与所选年无关）
-        int incomeEndYear = HomeScreenSupport.currentYearMonth().getYear();
-        int incomeStartYear = incomeEndYear - 4;
-        vo.setPerCapitaIncomeTrend(HomeScreenSupport.buildPerCapitaIncomeTrend(
-                homeScreenStatsMapper.selectDisposableIncomeByYearRange(incomeStartYear, incomeEndYear),
-                incomeEndYear));
+        // 人均收入：以库中最大所属年为终点，向前共 5 年（与所选年无关）
+        Integer incomeEndYear = homeScreenStatsMapper.selectLatestDisposableIncomeStatYear();
+        if (incomeEndYear == null)
+        {
+            vo.setPerCapitaIncomeTrend(Collections.emptyList());
+        }
+        else
+        {
+            int incomeStartYear = incomeEndYear - 4;
+            vo.setPerCapitaIncomeTrend(HomeScreenSupport.buildPerCapitaIncomeTrend(
+                    homeScreenStatsMapper.selectDisposableIncomeByYearRange(incomeStartYear, incomeEndYear),
+                    incomeEndYear));
+        }
 
         YearMonth anchor = HomeScreenSupport.currentYearMonth();
         int startYm = HomeScreenSupport.yearMonthKey(anchor.minusMonths(11));

baqing-admin/src/main/java/com/ruoyi/web/modules/screen/support/HomeScreenSupport.java

@@ -777,6 +777,7 @@ public final class HomeScreenSupport
 
     /**
      * 人均收入最近 5 年趋势（含 endYear 往前共 5 年）；缺年补 0；单位元。
+     * {@code endYear} 应为库中可支配收入最大所属年。
      */
     public static List<HomeScreenPerCapitaIncomeYearVo> buildPerCapitaIncomeTrend(
             List<HomeScreenDisposableIncomeYearDto> rows, int endYear)

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

@@ -550,6 +550,11 @@
         order by stat_year
     </select>
 
+    <select id="selectLatestDisposableIncomeStatYear" resultType="java.lang.Integer">
+        select max(stat_year)
+        from biz_disposable_income
+    </select>
+
     <!-- 牦牛存出栏情况明细：唯一键关联；支持跨年全量翻页（年月可选不过滤） -->
     <sql id="yakInventoryOutboundHerdFilter">
         <if test="statYear != null">

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

@@ -36,6 +36,7 @@ class HomeScreenStatsMapperXmlTest
         assertTrue(xml.contains("countCooperativeBusinessModelByStatYearMonth"));
         assertTrue(xml.contains("countFarmerHouseholdClassByStatYearMonth"));
         assertTrue(xml.contains("selectDisposableIncomeByYearRange"));
+        assertTrue(xml.contains("selectLatestDisposableIncomeStatYear"));
         assertTrue(xml.contains("biz_disposable_income"));
         assertTrue(xml.contains("rural_disposable_income"));
         assertTrue(xml.contains("business_model"));

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

@@ -829,13 +829,14 @@ class HomeScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("DP-SY-UT-037 人均收入取距当前最近5年")
+    @DisplayName("DP-SY-UT-037 人均收入取库中最大所属年向前共5年")
     void ut037_perCapitaIncomeTrend()
     {
         stubGrasslandAndReport();
         stubOtherBlocks();
-        int endYear = java.time.YearMonth.now(java.time.ZoneId.of("Asia/Shanghai")).getYear();
+        int endYear = 2024;
         int startYear = endYear - 4;
+        when(homeScreenStatsMapper.selectLatestDisposableIncomeStatYear()).thenReturn(endYear);
         HomeScreenDisposableIncomeYearDto row = new HomeScreenDisposableIncomeYearDto();
         row.setStatYear(endYear);
         row.setRuralDisposableIncome(new BigDecimal("10000"));
@@ -843,14 +844,28 @@ class HomeScreenServiceImplTest
         when(homeScreenStatsMapper.selectDisposableIncomeByYearRange(startYear, endYear))
                 .thenReturn(Collections.singletonList(row));
 
-        HomeScreenDashboardVo vo = service.loadDashboard(String.valueOf(endYear));
+        HomeScreenDashboardVo vo = service.loadDashboard("2026");
 
         assertEquals(5, vo.getPerCapitaIncomeTrend().size());
         assertEquals(endYear, vo.getPerCapitaIncomeTrend().get(4).getStatYear());
+        assertEquals(startYear, vo.getPerCapitaIncomeTrend().get(0).getStatYear());
         assertEquals(0, new BigDecimal("10000.00").compareTo(
                 vo.getPerCapitaIncomeTrend().get(4).getRuralDisposableIncome()));
     }
 
+    @Test
+    @DisplayName("DP-SY-UT-037b 人均收入库中无数据则趋势为空")
+    void ut037b_perCapitaIncomeTrendEmpty()
+    {
+        stubGrasslandAndReport();
+        stubOtherBlocks();
+        when(homeScreenStatsMapper.selectLatestDisposableIncomeStatYear()).thenReturn(null);
+
+        HomeScreenDashboardVo vo = service.loadDashboard("2026");
+
+        assertEquals(0, vo.getPerCapitaIncomeTrend().size());
+    }
+
     @Test
     @DisplayName("DP-SY-UT-028 产业总览农牧户取所选年最大填报月")
     void ut028_farmerHouseholdFromReportTable()
@@ -938,6 +953,7 @@ class HomeScreenServiceImplTest
                 .thenReturn(Collections.emptyList());
         lenient().when(homeScreenStatsMapper.selectDisposableIncomeByYearRange(any(Integer.class), any(Integer.class)))
                 .thenReturn(Collections.emptyList());
+        lenient().when(homeScreenStatsMapper.selectLatestDisposableIncomeStatYear()).thenReturn(null);
         lenient().when(homeScreenStatsMapper.selectHerdInventoryBullCowByYearMonthRange(any(Integer.class), any(Integer.class)))
                 .thenReturn(Collections.emptyList());
         lenient().when(homeScreenStatsMapper.selectOutboundReportYakCountByYearMonthRange(any(Integer.class), any(Integer.class)))

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

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

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

@@ -663,6 +663,7 @@ SQL 示例：`sql/big_screen_home_perm.sql`（挂载「大屏」父菜单下）
 
 | 版本 | 日期 | 说明 |
 | --- | --- | --- |
+| 1.20 | 2026-07-24 | 人均收入 `perCapitaIncomeTrend`：以库中最大所属年为终点向前 5 年 |
 | 1.19 | 2026-07-24 | 出栏 `outboundMonthly`：按填报最大月 N 输出 1～N |
 | 1.18 | 2026-07-23 | 公母牛 `monthlyTrend`：按填报最大月 N 输出 1～N |
 | 1.17 | 2026-07-23 | 新增大屏 `/townOptions`、`/villageTree`（全县口径） |