共同富裕

baqing-admin/src/main/java/com/ruoyi/web/modules/prosperity/support/AchievementReportAggregator.java

@@ -13,7 +13,11 @@ import com.ruoyi.web.modules.prosperity.domain.vo.AchievementAnnualSummaryVo;
 import com.ruoyi.web.modules.prosperity.domain.vo.AchievementMonthlyVo;
 
 /**
- * 年度报告数据组装与汇总计算（纯逻辑，便于单测）。
+ * 年度报告 / 大屏共同富裕成果组装（口径一致）：
+ * <ul>
+ *   <li>按月序列：所选年 1～库中最大统计月，缺月补 0</li>
+ *   <li>总览：最大统计月的单月指标</li>
+ * </ul>
  */
 public final class AchievementReportAggregator
 {
@@ -41,42 +45,65 @@ public final class AchievementReportAggregator
         }
     }
 
+    /**
+     * 所选年内台账的最大统计月；无有效行返回 0。
+     */
+    public static int resolveMaxMonth(int statYear, List<BizCommonProsperityAchievement> rows)
+    {
+        int maxMonth = 0;
+        if (rows == null)
+        {
+            return 0;
+        }
+        String yearPrefix = String.valueOf(statYear) + "-";
+        for (BizCommonProsperityAchievement row : rows)
+        {
+            if (row == null || StringUtils.isEmpty(row.getStatPeriod())
+                    || !row.getStatPeriod().startsWith(yearPrefix))
+            {
+                continue;
+            }
+            int month = parseMonthFromStatPeriod(row.getStatPeriod());
+            if (month >= 1 && month <= 12 && month > maxMonth)
+            {
+                maxMonth = month;
+            }
+        }
+        return maxMonth;
+    }
+
     public static AchievementAnnualReportVo buildReport(int statYear, List<BizCommonProsperityAchievement> rows)
     {
         AchievementAnnualReportVo report = new AchievementAnnualReportVo();
         report.setStatYear(statYear);
-        boolean hasData = rows != null && !rows.isEmpty();
+        boolean hasData = rows != null && !rows.isEmpty() && resolveMaxMonth(statYear, rows) > 0;
         report.setHasData(hasData);
         List<AchievementMonthlyVo> monthly = buildMonthly(statYear, rows);
         report.setMonthly(monthly);
-        report.setSummary(hasData ? calcSummary(monthly) : null);
+        report.setSummary(hasData ? calcSummaryFromMaxMonth(statYear, rows) : null);
         return report;
     }
 
+    /**
+     * 所选年 1～库中最大月；无数据返回空列表。
+     */
     public static List<AchievementMonthlyVo> buildMonthly(int statYear, List<BizCommonProsperityAchievement> rows)
     {
-        Map<Integer, BizCommonProsperityAchievement> byMonth = new HashMap<>();
-        if (rows != null)
+        Map<Integer, BizCommonProsperityAchievement> byMonth = indexByMonth(statYear, rows);
+        int maxMonth = 0;
+        for (Integer m : byMonth.keySet())
         {
-            for (BizCommonProsperityAchievement row : rows)
+            if (m != null && m > maxMonth)
             {
-                if (row == null || StringUtils.isEmpty(row.getStatPeriod()))
-                {
-                    continue;
-                }
-                if (!row.getStatPeriod().startsWith(String.valueOf(statYear) + "-"))
-                {
-                    continue;
-                }
-                int month = parseMonthFromStatPeriod(row.getStatPeriod());
-                if (month >= 1 && month <= 12)
-                {
-                    byMonth.put(month, row);
-                }
+                maxMonth = m;
             }
         }
-        List<AchievementMonthlyVo> monthly = new ArrayList<>(MONTHS_IN_YEAR);
-        for (int m = 1; m <= MONTHS_IN_YEAR; m++)
+        if (maxMonth <= 0)
+        {
+            return new ArrayList<>();
+        }
+        List<AchievementMonthlyVo> monthly = new ArrayList<>(maxMonth);
+        for (int m = 1; m <= maxMonth; m++)
         {
             BizCommonProsperityAchievement src = byMonth.get(m);
             if (src != null)
@@ -141,52 +168,142 @@ public final class AchievementReportAggregator
         return monthly;
     }
 
-    public static AchievementAnnualSummaryVo calcSummary(List<AchievementMonthlyVo> monthly)
+    /**
+     * 取所选年内台账最大统计月的单月指标；无有效台账返回 {@code null}。
+     */
+    public static AchievementAnnualSummaryVo calcSummaryFromMaxMonth(
+            int statYear, List<BizCommonProsperityAchievement> rows)
     {
+        BizCommonProsperityAchievement latest = findMaxMonthRow(statYear, rows);
+        if (latest == null)
+        {
+            return null;
+        }
         AchievementAnnualSummaryVo summary = new AchievementAnnualSummaryVo();
-        BigDecimal incomeSum = BigDecimal.ZERO;
-        int employmentSum = 0;
-        int jobsSum = 0;
-        int envSum = 0;
-        BigDecimal greenSum = BigDecimal.ZERO;
-        int heritageSum = 0;
-        int integrationSum = 0;
-        int unitySum = 0;
-        BigDecimal digitalSum = BigDecimal.ZERO;
-        int brandCountSum = 0;
-        BigDecimal premiumSum = BigDecimal.ZERO;
-
-        for (AchievementMonthlyVo item : monthly)
-        {
-            incomeSum = incomeSum.add(nvl(item.getCollectiveEconomyIncome()));
-            employmentSum += nvlInt(item.getEmploymentDrivenCount());
-            jobsSum += nvlInt(item.getNewJobPositions());
-            envSum += nvlInt(item.getEnvProjectCount());
-            greenSum = greenSum.add(nvl(item.getNewGreenArea()));
-            heritageSum += nvlInt(item.getCulturalHeritageCount());
-            integrationSum += nvlInt(item.getEthnicIntegrationProjectCount());
-            unitySum += nvlInt(item.getEthnicUnityActivityCount());
-            digitalSum = digitalSum.add(nvl(item.getDigitalPlatformUsageRate()));
-            brandCountSum += nvlInt(item.getRegionalPublicBrandCount());
-            premiumSum = premiumSum.add(nvl(item.getBrandPremiumRate()));
-        }
-
-        summary.setCollectiveEconomyIncome(incomeSum.setScale(2, RoundingMode.HALF_UP));
-        summary.setEmploymentDrivenCount(employmentSum);
-        summary.setNewJobPositions(jobsSum);
-        summary.setEnvProjectCount(envSum);
-        summary.setNewGreenArea(greenSum.setScale(2, RoundingMode.HALF_UP));
-        summary.setCulturalHeritageCount(heritageSum);
-        summary.setEthnicIntegrationProjectCount(integrationSum);
-        summary.setEthnicUnityActivityCount(unitySum);
+        summary.setCollectiveEconomyIncome(nvl(latest.getCollectiveEconomyIncome()).setScale(2, RoundingMode.HALF_UP));
+        summary.setEmploymentDrivenCount(nvlInt(latest.getEmploymentDrivenCount()));
+        summary.setNewJobPositions(nvlInt(latest.getNewJobPositions()));
+        summary.setEnvProjectCount(nvlInt(latest.getEnvProjectCount()));
+        summary.setNewGreenArea(nvl(latest.getNewGreenArea()).setScale(2, RoundingMode.HALF_UP));
+        summary.setCulturalHeritageCount(nvlInt(latest.getCulturalHeritageCount()));
+        summary.setEthnicIntegrationProjectCount(nvlInt(latest.getEthnicIntegrationProjectCount()));
+        summary.setEthnicUnityActivityCount(nvlInt(latest.getEthnicUnityActivityCount()));
         summary.setDigitalPlatformUsageRate(
-                digitalSum.divide(BigDecimal.valueOf(MONTHS_IN_YEAR), RATE_SCALE, RoundingMode.HALF_UP));
-        summary.setRegionalPublicBrandCount(brandCountSum);
-        summary.setBrandPremiumRate(
-                premiumSum.divide(BigDecimal.valueOf(MONTHS_IN_YEAR), RATE_SCALE, RoundingMode.HALF_UP));
+                nvl(latest.getDigitalPlatformUsageRate()).setScale(RATE_SCALE, RoundingMode.HALF_UP));
+        summary.setRegionalPublicBrandCount(nvlInt(latest.getRegionalPublicBrandCount()));
+        summary.setBrandPremiumRate(nvl(latest.getBrandPremiumRate()).setScale(RATE_SCALE, RoundingMode.HALF_UP));
         return summary;
     }
 
+    /**
+     * @deprecated 使用 {@link #calcSummaryFromMaxMonth(int, List)}
+     */
+    @Deprecated
+    public static AchievementAnnualSummaryVo calcSummaryFromMaxMonth(List<BizCommonProsperityAchievement> rows)
+    {
+        if (rows == null || rows.isEmpty())
+        {
+            return null;
+        }
+        for (BizCommonProsperityAchievement row : rows)
+        {
+            if (row != null && StringUtils.isNotEmpty(row.getStatPeriod()) && row.getStatPeriod().length() >= 4)
+            {
+                try
+                {
+                    int year = Integer.parseInt(row.getStatPeriod().substring(0, 4));
+                    return calcSummaryFromMaxMonth(year, rows);
+                }
+                catch (NumberFormatException ignored)
+                {
+                    // try next
+                }
+            }
+        }
+        return null;
+    }
+
+    /**
+     * 在所选年台账行中取最大统计月的一条。
+     */
+    public static BizCommonProsperityAchievement findMaxMonthRow(
+            int statYear, List<BizCommonProsperityAchievement> rows)
+    {
+        BizCommonProsperityAchievement latest = null;
+        int maxMonth = -1;
+        if (rows == null)
+        {
+            return null;
+        }
+        String yearPrefix = String.valueOf(statYear) + "-";
+        for (BizCommonProsperityAchievement row : rows)
+        {
+            if (row == null || StringUtils.isEmpty(row.getStatPeriod())
+                    || !row.getStatPeriod().startsWith(yearPrefix))
+            {
+                continue;
+            }
+            int month = parseMonthFromStatPeriod(row.getStatPeriod());
+            if (month >= 1 && month <= 12 && month >= maxMonth)
+            {
+                maxMonth = month;
+                latest = row;
+            }
+        }
+        return latest;
+    }
+
+    /** @deprecated 使用 {@link #findMaxMonthRow(int, List)} */
+    @Deprecated
+    public static BizCommonProsperityAchievement findMaxMonthRow(List<BizCommonProsperityAchievement> rows)
+    {
+        if (rows == null || rows.isEmpty())
+        {
+            return null;
+        }
+        for (BizCommonProsperityAchievement row : rows)
+        {
+            if (row != null && StringUtils.isNotEmpty(row.getStatPeriod()) && row.getStatPeriod().length() >= 4)
+            {
+                try
+                {
+                    int year = Integer.parseInt(row.getStatPeriod().substring(0, 4));
+                    return findMaxMonthRow(year, rows);
+                }
+                catch (NumberFormatException ignored)
+                {
+                    // try next
+                }
+            }
+        }
+        return null;
+    }
+
+    private static Map<Integer, BizCommonProsperityAchievement> indexByMonth(
+            int statYear, List<BizCommonProsperityAchievement> rows)
+    {
+        Map<Integer, BizCommonProsperityAchievement> byMonth = new HashMap<>();
+        if (rows == null)
+        {
+            return byMonth;
+        }
+        String yearPrefix = String.valueOf(statYear) + "-";
+        for (BizCommonProsperityAchievement row : rows)
+        {
+            if (row == null || StringUtils.isEmpty(row.getStatPeriod())
+                    || !row.getStatPeriod().startsWith(yearPrefix))
+            {
+                continue;
+            }
+            int month = parseMonthFromStatPeriod(row.getStatPeriod());
+            if (month >= 1 && month <= 12)
+            {
+                byMonth.put(month, row);
+            }
+        }
+        return byMonth;
+    }
+
     private static AchievementMonthlyVo fromEntity(int month, BizCommonProsperityAchievement src)
     {
         AchievementMonthlyVo vo = new AchievementMonthlyVo();

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

@@ -5,7 +5,6 @@ import java.util.Collections;
 import java.util.List;
 import java.util.Map;
 import java.util.stream.Collectors;
-import java.time.YearMonth;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
 import com.ruoyi.web.modules.prosperity.domain.BizCommonProsperityAchievement;
@@ -14,27 +13,22 @@ import com.ruoyi.web.modules.prosperity.domain.BizCommonProsperityProjectOpImage
 import com.ruoyi.web.modules.prosperity.mapper.BizCommonProsperityAchievementMapper;
 import com.ruoyi.web.modules.prosperity.mapper.BizCommonProsperityProjectMapper;
 import com.ruoyi.web.modules.prosperity.mapper.BizCommonProsperityProjectOpImageMapper;
-import com.ruoyi.web.modules.prosperity.service.IAchievementReportService;
 import com.ruoyi.web.modules.prosperity.support.AchievementReportAggregator;
 import com.ruoyi.web.modules.prosperity.support.AchievementReportValidation;
-import com.ruoyi.web.modules.prosperity.domain.vo.AchievementAnnualReportVo;
 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;
 
 /**
  * 大屏共同富裕统计服务实现。
  * <p>
- * 看板复用 {@link IAchievementReportService} 年度成果；项目列表仅含已发布且实施周期与统计年有交集的记录。
+ * 成果口径与管理端年度报告一致：总览为所选年<strong>最大统计月</strong>单月值；
+ * 按月图表为该年 1～最大月（缺月补 0）；项目列表仅含已发布且实施周期与统计年有交集的记录。
  */
 @Service
 public class CommonProsperityScreenServiceImpl implements ICommonProsperityScreenService
 {
-    @Autowired
-    private IAchievementReportService achievementReportService;
-
     @Autowired
     private BizCommonProsperityAchievementMapper achievementMapper;
 
@@ -48,14 +42,10 @@ public class CommonProsperityScreenServiceImpl implements ICommonProsperityScree
     public CommonProsperityScreenDashboardVo loadDashboard(String statYear)
     {
         int year = AchievementReportValidation.parseStatYear(statYear);
-        YearMonth rollingAnchor = HomeScreenSupport.currentYearMonth();
         CommonProsperityScreenDashboardVo vo = new CommonProsperityScreenDashboardVo();
         vo.setStatYear(year);
-        AchievementAnnualReportVo achievement = achievementReportService.getAnnualReport(String.valueOf(year));
-        List<BizCommonProsperityAchievement> rollingRows = safeAchievementsBetween(
-                rollingAnchor.minusMonths(11), rollingAnchor);
-        achievement.setMonthly(AchievementReportAggregator.buildRollingMonthly(rollingAnchor, rollingRows));
-        vo.setAchievement(achievement);
+        List<BizCommonProsperityAchievement> rows = safeAchievementsByYear(year);
+        vo.setAchievement(AchievementReportAggregator.buildReport(year, rows));
         List<BizCommonProsperityProject> projects = safePublishedForScreen(year);
         vo.setHasProjectData(!projects.isEmpty());
         vo.setProjectTypeStats(CommonProsperityScreenSupport.buildProjectTypeStats(projects));
@@ -87,11 +77,9 @@ public class CommonProsperityScreenServiceImpl implements ICommonProsperityScree
         return list != null ? list : new ArrayList<>();
     }
 
-    private List<BizCommonProsperityAchievement> safeAchievementsBetween(YearMonth start, YearMonth end)
+    private List<BizCommonProsperityAchievement> safeAchievementsByYear(int statYear)
     {
-        List<BizCommonProsperityAchievement> list = achievementMapper.selectByStatPeriodBetween(
-                HomeScreenSupport.formatStatPeriod(start),
-                HomeScreenSupport.formatStatPeriod(end));
+        List<BizCommonProsperityAchievement> list = achievementMapper.selectByStatYear(String.valueOf(statYear));
         return list != null ? list : new ArrayList<>();
     }
 }

baqing-admin/src/test/java/com/ruoyi/web/modules/prosperity/controller/BizCommonProsperityAchievementReportControllerApiTest.java

@@ -95,7 +95,7 @@ class BizCommonProsperityAchievementReportControllerApiTest
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.code").value(200))
                 .andExpect(jsonPath("$.data.hasData").value(true))
-                .andExpect(jsonPath("$.data.monthly.length()").value(12))
+                .andExpect(jsonPath("$.data.monthly.length()").value(5))
                 .andExpect(jsonPath("$.data.summary.collectiveEconomyIncome").exists());
     }
 

baqing-admin/src/test/java/com/ruoyi/web/modules/prosperity/support/AchievementReportAggregatorTest.java

@@ -17,22 +17,22 @@ import com.ruoyi.web.modules.prosperity.domain.vo.AchievementAnnualSummaryVo;
 import com.ruoyi.web.modules.prosperity.domain.vo.AchievementMonthlyVo;
 
 /**
- * GTFY-NB-UT-003～014
+ * GTFY-NB-UT-003～014；口径：1～最大月 + 最大月总览
  */
 @DisplayName("AchievementReportAggregator")
 class AchievementReportAggregatorTest
 {
 
     @Test
-    @DisplayName("GTFY-NB-UT-003 仅3月有数据缺月补零")
+    @DisplayName("GTFY-NB-UT-003 仅3月有数据：序列为1～3，缺月补零")
     void ut003_partialMonth()
     {
         List<AchievementMonthlyVo> monthly = AchievementReportAggregator.buildMonthly(2026,
                 Collections.singletonList(row("2026-03", "10", 30)));
-        assertEquals(12, monthly.size());
+        assertEquals(3, monthly.size());
         assertEquals(0, monthly.get(0).getEmploymentDrivenCount().intValue());
         assertEquals(30, monthly.get(2).getEmploymentDrivenCount().intValue());
-        assertNull(monthly.get(0).getStatPeriod());
+        assertEquals("2026-01", monthly.get(0).getStatPeriod());
         assertEquals("2026-03", monthly.get(2).getStatPeriod());
     }
 
@@ -51,40 +51,41 @@ class AchievementReportAggregatorTest
     }
 
     @Test
-    @DisplayName("GTFY-NB-UT-005 加总类 SUM")
-    void ut005_sumMetrics()
+    @DisplayName("GTFY-NB-UT-005 总览取最大月单月值")
+    void ut005_summaryMaxMonth()
     {
-        List<AchievementMonthlyVo> monthly = AchievementReportAggregator.buildMonthly(2026,
+        AchievementAnnualReportVo report = AchievementReportAggregator.buildReport(2026,
                 Collections.singletonList(row("2026-03", "10", 30)));
-        AchievementAnnualSummaryVo summary = AchievementReportAggregator.calcSummary(monthly);
+        AchievementAnnualSummaryVo summary = report.getSummary();
         assertEquals(new BigDecimal("10.00"), summary.getCollectiveEconomyIncome());
         assertEquals(30, summary.getEmploymentDrivenCount().intValue());
     }
 
     @Test
-    @DisplayName("GTFY-NB-UT-006 比率类月均")
-    void ut006_rateAverage()
+    @DisplayName("GTFY-NB-UT-006 比率取最大月原值")
+    void ut006_rateFromMaxMonth()
     {
         BizCommonProsperityAchievement r = row("2026-01", "0", 0);
         r.setDigitalPlatformUsageRate(new BigDecimal("0.6"));
         r.setBrandPremiumRate(BigDecimal.ZERO);
-        List<AchievementMonthlyVo> monthly = AchievementReportAggregator.buildMonthly(2026,
-                Collections.singletonList(r));
-        AchievementAnnualSummaryVo summary = AchievementReportAggregator.calcSummary(monthly);
-        assertEquals(new BigDecimal("0.0500"), summary.getDigitalPlatformUsageRate());
+        AchievementAnnualSummaryVo summary = AchievementReportAggregator.buildReport(2026,
+                Collections.singletonList(r)).getSummary();
+        assertEquals(new BigDecimal("0.6000"), summary.getDigitalPlatformUsageRate());
     }
 
     @Test
-    @DisplayName("GTFY-NB-UT-007 多月比率")
-    void ut007_multiMonthRate()
+    @DisplayName("GTFY-NB-UT-007 多月时总览取最大月")
+    void ut007_multiMonthMax()
     {
-        BizCommonProsperityAchievement m3 = row("2026-03", "0", 0);
+        BizCommonProsperityAchievement m3 = row("2026-03", "10", 10);
         m3.setDigitalPlatformUsageRate(new BigDecimal("0.6"));
-        BizCommonProsperityAchievement m6 = row("2026-06", "0", 0);
-        m6.setDigitalPlatformUsageRate(new BigDecimal("0.6"));
-        List<AchievementMonthlyVo> monthly = AchievementReportAggregator.buildMonthly(2026, Arrays.asList(m3, m6));
-        AchievementAnnualSummaryVo summary = AchievementReportAggregator.calcSummary(monthly);
-        assertEquals(new BigDecimal("0.1000"), summary.getDigitalPlatformUsageRate());
+        BizCommonProsperityAchievement m6 = row("2026-06", "88", 50);
+        m6.setDigitalPlatformUsageRate(new BigDecimal("0.75"));
+        AchievementAnnualReportVo report =
+                AchievementReportAggregator.buildReport(2026, Arrays.asList(m3, m6));
+        assertEquals(6, report.getMonthly().size());
+        assertEquals(new BigDecimal("88.00"), report.getSummary().getCollectiveEconomyIncome());
+        assertEquals(new BigDecimal("0.7500"), report.getSummary().getDigitalPlatformUsageRate());
     }
 
     @Test
@@ -94,7 +95,7 @@ class AchievementReportAggregatorTest
         AchievementAnnualReportVo report = AchievementReportAggregator.buildReport(2026, Collections.emptyList());
         assertFalse(report.getHasData());
         assertNull(report.getSummary());
-        assertEquals(12, report.getMonthly().size());
+        assertEquals(0, report.getMonthly().size());
     }
 
     @Test
@@ -105,6 +106,7 @@ class AchievementReportAggregatorTest
                 Collections.singletonList(row("2026-05", "1", 1)));
         assertTrue(report.getHasData());
         assertTrue(report.getSummary() != null);
+        assertEquals(5, report.getMonthly().size());
     }
 
     @Test
@@ -114,8 +116,8 @@ class AchievementReportAggregatorTest
         List<AchievementMonthlyVo> monthly = AchievementReportAggregator.buildMonthly(2026, Arrays.asList(
                 row("2025-12", "99", 99),
                 row("2026-01", "1", 1)));
+        assertEquals(1, monthly.size());
         assertEquals(new BigDecimal("1"), monthly.get(0).getCollectiveEconomyIncome());
-        assertEquals(0, monthly.get(11).getEmploymentDrivenCount().intValue());
     }
 
     @Test
@@ -123,30 +125,32 @@ class AchievementReportAggregatorTest
     void ut011_parseMonth()
     {
         assertEquals(9, AchievementReportAggregator.parseMonthFromStatPeriod("2026-09"));
+        assertEquals(8, AchievementReportAggregator.resolveMaxMonth(2026,
+                Collections.singletonList(row("2026-08", "1", 1))));
     }
 
     @Test
-    @DisplayName("GTFY-NB-UT-012 monthly 月份顺序")
+    @DisplayName("GTFY-NB-UT-012 monthly 月份顺序至最大月")
     void ut012_monthOrder()
     {
         List<AchievementMonthlyVo> monthly = AchievementReportAggregator.buildMonthly(2026, Arrays.asList(
-                row("2026-12", "12", 12),
+                row("2026-08", "8", 8),
                 row("2026-03", "3", 3),
                 row("2026-01", "1", 1)));
-        for (int i = 0; i < 12; i++)
+        assertEquals(8, monthly.size());
+        for (int i = 0; i < monthly.size(); i++)
         {
             assertEquals(i + 1, monthly.get(i).getMonth().intValue());
         }
     }
 
     @Test
-    @DisplayName("GTFY-NB-UT-014 单月收入为0仍参与汇总")
+    @DisplayName("GTFY-NB-UT-014 最大月收入为0仍展示")
     void ut014_zeroIncome()
     {
         BizCommonProsperityAchievement r = row("2026-01", "0", 5);
-        List<AchievementMonthlyVo> monthly = AchievementReportAggregator.buildMonthly(2026,
-                Collections.singletonList(r));
-        AchievementAnnualSummaryVo summary = AchievementReportAggregator.calcSummary(monthly);
+        AchievementAnnualSummaryVo summary = AchievementReportAggregator.buildReport(2026,
+                Collections.singletonList(r)).getSummary();
         assertEquals(new BigDecimal("0.00"), summary.getCollectiveEconomyIncome());
         assertEquals(5, summary.getEmploymentDrivenCount().intValue());
     }

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

@@ -10,6 +10,7 @@ import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.when;
 
+import java.math.BigDecimal;
 import java.util.Arrays;
 import java.util.Collections;
 import org.junit.jupiter.api.DisplayName;
@@ -18,13 +19,11 @@ import org.junit.jupiter.api.extension.ExtendWith;
 import org.mockito.InjectMocks;
 import org.mockito.Mock;
 import org.mockito.junit.jupiter.MockitoExtension;
+import com.ruoyi.web.modules.prosperity.domain.BizCommonProsperityAchievement;
 import com.ruoyi.web.modules.prosperity.domain.BizCommonProsperityProject;
-import com.ruoyi.web.modules.prosperity.domain.vo.AchievementAnnualReportVo;
 import com.ruoyi.web.modules.prosperity.mapper.BizCommonProsperityAchievementMapper;
 import com.ruoyi.web.modules.prosperity.mapper.BizCommonProsperityProjectMapper;
 import com.ruoyi.web.modules.prosperity.mapper.BizCommonProsperityProjectOpImageMapper;
-import com.ruoyi.web.modules.prosperity.service.IAchievementReportService;
-import com.ruoyi.web.modules.prosperity.support.AchievementReportAggregator;
 import com.ruoyi.web.modules.screen.domain.vo.CommonProsperityScreenDashboardVo;
 
 /**
@@ -35,9 +34,6 @@ import com.ruoyi.web.modules.screen.domain.vo.CommonProsperityScreenDashboardVo;
 class CommonProsperityScreenServiceImplTest
 {
 
-    @Mock
-    private IAchievementReportService achievementReportService;
-
     @Mock
     private BizCommonProsperityAchievementMapper achievementMapper;
 
@@ -54,8 +50,7 @@ class CommonProsperityScreenServiceImplTest
     @DisplayName("DP-GTFY-UT-014 仅项目无成果")
     void ut014_projectsOnly()
     {
-        AchievementAnnualReportVo report = AchievementReportAggregator.buildReport(2026, Collections.emptyList());
-        when(achievementReportService.getAnnualReport("2026")).thenReturn(report);
+        when(achievementMapper.selectByStatYear("2026")).thenReturn(Collections.emptyList());
         BizCommonProsperityProject p = new BizCommonProsperityProject();
         p.setId(1L);
         p.setProjectType(1);
@@ -75,9 +70,8 @@ class CommonProsperityScreenServiceImplTest
     @DisplayName("DP-GTFY-UT-015 仅成果无项目")
     void ut015_achievementOnly()
     {
-        AchievementAnnualReportVo report = AchievementReportAggregator.buildReport(2026,
-                Collections.singletonList(sampleAchievementRow()));
-        when(achievementReportService.getAnnualReport("2026")).thenReturn(report);
+        when(achievementMapper.selectByStatYear("2026"))
+                .thenReturn(Collections.singletonList(sampleAchievementRow()));
         when(projectMapper.selectPublishedForScreen(2026)).thenReturn(Collections.emptyList());
         when(achievementMapper.selectDistinctStatYears()).thenReturn(Collections.singletonList("2026"));
         when(projectMapper.selectDistinctStatYearsFromPublished()).thenReturn(Collections.emptyList());
@@ -89,20 +83,47 @@ class CommonProsperityScreenServiceImplTest
     }
 
     @Test
-    @DisplayName("复用年度报告服务")
-    void reusesAchievementReport()
+    @DisplayName("按所选年查询成果台账")
+    void loadsAchievementsByStatYear()
     {
-        when(achievementReportService.getAnnualReport("2026"))
-                .thenReturn(AchievementReportAggregator.buildReport(2026, Collections.emptyList()));
+        when(achievementMapper.selectByStatYear("2026")).thenReturn(Collections.emptyList());
         when(projectMapper.selectPublishedForScreen(2026)).thenReturn(Collections.emptyList());
         when(achievementMapper.selectDistinctStatYears()).thenReturn(Collections.emptyList());
         when(projectMapper.selectDistinctStatYearsFromPublished()).thenReturn(Collections.emptyList());
 
         service.loadDashboard("2026");
-        verify(achievementReportService).getAnnualReport("2026");
+        verify(achievementMapper).selectByStatYear("2026");
         verify(projectMapper).selectPublishedForScreen(eq(2026));
     }
 
+    @Test
+    @DisplayName("总览取所选年最大填报月，按月序列为该年 1～最大月")
+    void summaryUsesMaxMonthOfSelectedYear()
+    {
+        BizCommonProsperityAchievement mar = sampleAchievementRowForYear(2025, 3);
+        mar.setCollectiveEconomyIncome(new BigDecimal("10"));
+        BizCommonProsperityAchievement aug = sampleAchievementRowForYear(2025, 8);
+        aug.setCollectiveEconomyIncome(new BigDecimal("88"));
+        aug.setEmploymentDrivenCount(50);
+        when(achievementMapper.selectByStatYear("2025")).thenReturn(Arrays.asList(mar, aug));
+        when(projectMapper.selectPublishedForScreen(2025)).thenReturn(Collections.emptyList());
+        when(achievementMapper.selectDistinctStatYears()).thenReturn(Collections.singletonList("2025"));
+        when(projectMapper.selectDistinctStatYearsFromPublished()).thenReturn(Collections.emptyList());
+
+        CommonProsperityScreenDashboardVo vo = service.loadDashboard("2025");
+        assertEquals(2025, vo.getStatYear().intValue());
+        assertTrue(vo.getAchievement().getHasData());
+        assertNotNull(vo.getAchievement().getSummary());
+        assertEquals(0, new BigDecimal("88.00").compareTo(vo.getAchievement().getSummary().getCollectiveEconomyIncome()));
+        assertEquals(50, vo.getAchievement().getSummary().getEmploymentDrivenCount().intValue());
+        assertEquals(8, vo.getAchievement().getMonthly().size());
+        assertEquals(2025, vo.getAchievement().getMonthly().get(0).getStatYear().intValue());
+        assertEquals(0, new BigDecimal("10").compareTo(
+                vo.getAchievement().getMonthly().get(2).getCollectiveEconomyIncome()));
+        assertEquals(0, new BigDecimal("88").compareTo(
+                vo.getAchievement().getMonthly().get(7).getCollectiveEconomyIncome()));
+    }
+
     @Test
     @DisplayName("列表含运营图查询")
     void listLoadsOpImages()
@@ -119,22 +140,26 @@ class CommonProsperityScreenServiceImplTest
         verify(opImageMapper).selectByProjectIds(Arrays.asList(9L));
     }
 
-    private static com.ruoyi.web.modules.prosperity.domain.BizCommonProsperityAchievement sampleAchievementRow()
+    private static BizCommonProsperityAchievement sampleAchievementRow()
+    {
+        return sampleAchievementRowForYear(2026, 3);
+    }
+
+    private static BizCommonProsperityAchievement sampleAchievementRowForYear(int year, int month)
     {
-        com.ruoyi.web.modules.prosperity.domain.BizCommonProsperityAchievement r =
-                new com.ruoyi.web.modules.prosperity.domain.BizCommonProsperityAchievement();
-        r.setStatPeriod("2026-03");
-        r.setCollectiveEconomyIncome(new java.math.BigDecimal("10"));
+        BizCommonProsperityAchievement r = new BizCommonProsperityAchievement();
+        r.setStatPeriod(String.format("%d-%02d", year, month));
+        r.setCollectiveEconomyIncome(new BigDecimal("10"));
         r.setEmploymentDrivenCount(1);
         r.setNewJobPositions(1);
         r.setEnvProjectCount(1);
-        r.setNewGreenArea(new java.math.BigDecimal("1"));
+        r.setNewGreenArea(new BigDecimal("1"));
         r.setCulturalHeritageCount(1);
         r.setEthnicIntegrationProjectCount(1);
         r.setEthnicUnityActivityCount(1);
-        r.setDigitalPlatformUsageRate(new java.math.BigDecimal("0.1"));
+        r.setDigitalPlatformUsageRate(new BigDecimal("0.1"));
         r.setRegionalPublicBrandCount(1);
-        r.setBrandPremiumRate(new java.math.BigDecimal("0.1"));
+        r.setBrandPremiumRate(new BigDecimal("0.1"));
         return r;
     }
 }

doc/共同富裕/共同富裕成果年度报告/共同富裕成果年度报告前端技术方案.md

@@ -23,7 +23,7 @@
 | **方法** | `getAchievementAnnualReport(statYear)` → `GET /commonProsperity/achievementReport` |
 | **可选** | `getAchievementReportYears()` → `GET /commonProsperity/achievementReport/years`（年份选择器可仅用 `el-date-picker type="year"`，不强制调此接口） |
 
-**响应使用**：`data.hasData`、`data.summary`（12 项年度汇总）、`data.monthly`（长度 12，缺月指标为 0）。
+**响应使用**：`data.hasData`、`data.summary`（最大月单月 12 项）、`data.monthly`（长度 = 该年最大月，缺月指标为 0）。
 
 ---
 
@@ -43,7 +43,7 @@
 | 文化传承 | 柱状 | `culturalHeritageCount` |
 | 民族团结 | 堆叠柱状 | `ethnicIntegrationProjectCount`、`ethnicUnityActivityCount` |
 
-横轴固定 **1～12 月**；`monthly` 缺月由后端补 0，前端 `seriesByField` 再兜底为 0。
+横轴为 **1～该年最大统计月**；`monthly` 缺月由后端补 0，前端按返回序列渲染。
 
 ---
 

doc/共同富裕/共同富裕成果年度报告/共同富裕成果年度报告功能需求.md

@@ -25,8 +25,9 @@
 
 ### 2.2 统计月份（图表横轴）
 
-- 图表按月展示时，横轴**固定**为 **1 月～12 月**，共 12 个刻度。
-- **缺月规则（产品定论）：** 某月**无**对应成果记录时，该月各指标在图表与参与年度汇总的序列中均按 **0** 取值（**不**断线、**不**留空、**不**跳过该月）。Tooltip 仍展示「0 + 单位」。
+- 图表按月展示时，横轴为选定年 **1 月～该年台账中最大统计月 N**，共 **N** 个刻度（与大屏共同富裕一致）。
+- **缺月规则：** 1～N 内某月**无**对应成果记录时，该月各指标按 **0** 取值（**不**断线、**不**留空、**不**跳过该月）。Tooltip 仍展示「0 + 单位」。
+- 全年无任何台账时走 **§7.2** 空态，`monthly` 为空列表。
 
 ### 2.3 共富成果指标（与台账一致）
 
@@ -48,14 +49,13 @@
 
 ### 2.4 汇总口径（年度总览）
 
-**年度总览区**（见 **§5.2**）对选定年份内各月台账数据汇总规则如下（须在界面或帮助说明中标注，避免与「单月快照」混淆）：
+**年度总览区**（见 **§5.2**）与大屏共同富裕总览口径一致：
 
 | 指标类型 | 年度展示口径 |
 | --- | --- |
-| 金额、人数、岗位数、项目数、活动数、品牌数、绿化面积 | 对 **1～12 月** 逐月取值，**缺月按 0**，再求**全年加总** |
-| 数字平台使用率、品牌产品溢价率 | 对 **1～12 月** 逐月取值，**缺月按 0**，再求 **12 个月算术平均值**（分母固定为 12） |
+| 全部 12 项指标（含比率） | 取该年台账中 **`stat_period` 最大月份** 的**单月**指标值（非全年加总、非 12 月均值） |
 
-> 与图表缺月规则一致；**全年无任何台账记录**时仍走 **§7.2** 空态，不将「全年无数据」展示为全 0 汇总。
+> **全年无任何台账记录**时仍走 **§7.2** 空态，不将「全年无数据」展示为全 0 汇总。
 
 ### 2.5 模块边界
 
@@ -137,7 +137,7 @@ flowchart TD
 | 项 | 规则 |
 | --- | --- |
 | 标题 | 各图表具备明确标题（与草稿主题一致：集体经济收入、就业带动、环境治理等） |
-| 横轴 | **月份**（1～12 月）；标签格式与原型一致（如 `1月`…`12月` 或 `2026-01`） |
+| 横轴 | **月份**（1～该年最大统计月）；标签格式与原型一致（如 `1月`…`N月`） |
 | 纵轴 | 带单位或图例说明（万元、人、个、亩、% 等） |
 | 缺月 | 该月无台账记录：柱状图、折线图、堆叠柱状图**均显示为 0**（柱高为 0、折线落点为 0）；**12 个月均须渲染**，不得省略横轴刻度 |
 | 单点数据 | 仅 1 个月有数据时，图表仍须正常渲染，不得报错 |

doc/共同富裕/共同富裕成果年度报告/共同富裕成果年度报告技术方案.md

@@ -44,14 +44,14 @@
 | **索引** | 沿用 `idx_stat_period` / `uk_stat_period`；单年最多 12 行，无额外索引要求 |
 | **可选年份列表** | `SELECT DISTINCT LEFT(stat_period, 4) AS stat_year FROM biz_common_prosperity_achievement ORDER BY stat_year DESC` |
 
-### 2.3 汇总计算（服务端，与功能需求对齐）
+### 2.3 汇总计算（服务端，与大屏共同富裕一致）
 
-| 类型 | 字段（库 snake / API 驼峰） | 年度总览算法 | 分月序列 |
-| --- | --- | --- | --- |
-| 加总 | `collective_economy_income` 等 10 项非比率指标 | 1～12 月逐月取值，**缺月=0**，再 **SUM** | 每月台账值或 **0** |
-| 月均 | `digital_platform_usage_rate`、`brand_premium_rate` | 1～12 月逐月取值，**缺月=0**，再 **SUM/12** | 每月台账值或 **0** |
+| 类型 | 字段 | 算法 |
+| --- | --- | --- |
+| 总览 `summary` | 全部 12 项指标 | 取该年台账 **最大统计月** 的单月值 |
+| 分月 `monthly` | 同上字段 | 所选年 **1～最大月 N**；区间内缺月补 **0**；无数据返回空列表 |
 
-**`hasData` 判定**：该年查询结果 `COUNT(*) > 0` 为 `true`；为 `false` 时 `summary` 可为 `null`，`monthly` 仍返回 12 个月（全 0）或空数组（与前端约定二选一，**推荐**：`monthly` 仍 12 条全 0，由前端根据 `hasData` 显示空态）。
+**`hasData` 判定**：该年存在 ≥1 条有效台账为 `true`；为 `false` 时 `summary=null`，`monthly=[]`。
 
 ---
 
@@ -188,3 +188,4 @@
 | 版本 | 说明 |
 | --- | --- |
 | 1.0 | 初稿：无新表；单接口年度报告 + 可选年份列表；缺月补 0；`hasData` 控制空态 |
+| 1.1 | 与大屏对齐：总览取最大月单月；`monthly` 为 1～最大月 |

doc/共同富裕/共同富裕成果年度报告/共同富裕成果年度报告管理测试用例.md

@@ -3,7 +3,7 @@
 > 依据：`共同富裕成果年度报告功能需求.md`、`共同富裕成果年度报告技术方案.md`  
 > **接口 Base Path（示例）**：`/commonProsperity/achievementReport`；若含 `context-path` 或网关前缀须补齐。鉴权与若依一致（Cookie / Token）。
 
-**通用前置（无特殊说明）**：具备本模块**查询**权限的账号已登录。**数据依赖**：成果台账表 `biz_common_prosperity_achievement` 已有测试数据。**缺月规则**：无台账月份指标按 **0**；**全年无记录**时 `hasData=false`，`summary=null`。**年度汇总**：加总类 **SUM(12 月，缺月=0)**；比率类 **(SUM 12 月)/12**。
+**通用前置（无特殊说明）**：具备本模块**查询**权限的账号已登录。**数据依赖**：成果台账表 `biz_common_prosperity_achievement` 已有测试数据。**缺月规则**：1～最大月内无台账月份指标按 **0**；**全年无记录**时 `hasData=false`，`summary=null`，`monthly=[]`。**总览**：取该年**最大统计月**单月值（与大屏一致）。
 
 **界面（UI）测试**：借助 **Playwright** 启动 **Chromium**（与 **Google Chrome 同源内核**）；可配置 `channel: 'chrome'` 调用本机已安装的谷歌浏览器。
 

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

@@ -21,18 +21,18 @@
 
 - 大屏顶部（或全局筛选区）提供**统计年份**选择，格式为自然年 **YYYY**（如 `2026`）。
 - 进入大屏时默认选中**当前自然年**。
-- 变更统计年份后，**总览卡片、项目分类、项目列表**等标注「与 **Y** 相关」的区块须**同步**按新年份重算；**§5.3～5.9 按月图表**为滚动最近 12 月，**不**随 **Y** 切换（见 **§2.2**）。
+- 变更统计年份后，本页**全部统计区块**（总览卡片、按月图表、数字赋能、项目分类、项目列表）须**同步**按新年份 **Y** 重算与展示，不得出现区块之间年份不一致。
 
 ### 2.2 统计月份（图表横轴）
 
-**滚动最近 12 个月**（适用于 **§5.3～5.9** 全部按月图表）
+**所选年 1～最大统计月**（适用于 **§5.3～5.9** 全部按月图表；与管理端年度报告一致）
 
-- 以服务器当前年月为锚点，取**含当月在内向前连续 12 个自然月**；**不**随页面「统计年份 **Y**」切换。
-- 接口 `achievement.monthly[]` 每条含 **`statYear`**、**`month`（1～12）**、**`statPeriod`（yyyy-MM）**；按时间升序固定 **12** 条。
-- **缺月规则：** 窗口槽位内无对应成果台账时，各指标按 **0** 展示；**不**省略刻度、**不**断线留空。
+- 横轴为选定统计年 **Y** 的 **1～N** 月，**N** 为该年台账中最大 `stat_period` 月份；切换 **Y** 后同步切换。
+- 接口 `achievement.monthly[]` 每条含 **`statYear`**、**`month`**、**`statPeriod`（yyyy-MM）**；按月份升序，长度 **N**（无数据时为空列表）。
+- **缺月规则：** 1～N 内无对应成果台账时，各指标按 **0** 展示；**不**省略刻度、**不**断线留空。
 - **前端横轴**仅展示月份（如 `8月`）；**鼠标悬停**展示 **YYYY年M月** 及数值。
 
-**年度总览**（**§2.4**）仍按选定 **Y** 全年 1～12 月台账汇总，与滚动图表窗口**独立**。
+**年度总览**（**§2.4**）取所选年台账中**最大统计月**的单月数据；按月图表为该年 1～N 月序列。
 
 ### 2.3 共富成果指标（与后台台账一致）
 
@@ -54,14 +54,14 @@
 
 ### 2.4 年度总览区汇总口径
 
-「共富成果」总览卡片对选定年份内各月台账汇总规则如下（须在界面或帮助说明中标注，避免与「单月值」混淆）：
+「共富成果」总览卡片（及数字赋能区同源字段）对选定年份 **Y** 的规则如下：
 
 | 指标类型 | 年度总览展示口径 |
 | --- | --- |
-| 集体经济收入、带动就业人数、新增就业岗位、环境治理项目数、新增绿化面积、文化传承人数、民族融合项目数、民族团结活动数、区域公共品牌数 | 对 1～12 月逐月取值（缺月按 0），再求**全年加总** |
-| 数字平台使用率、品牌产品溢价率 | 对 1～12 月逐月取值（缺月按 0），再求 **12 个月算术平均值**（分母固定为 12） |
+| 集体经济收入、带动就业人数、新增就业岗位、环境治理项目数、新增绿化面积、文化传承人数、民族融合项目数、民族团结活动数、区域公共品牌数、数字平台使用率、品牌产品溢价率 | 取该年台账中 **`stat_period` 最大月份** 的**单月**指标值（非全年加总 / 非 12 月均值） |
 
-> **全年无任何成果台账记录**时，总览区与各图表走 **§7.1** 空态，**不**将「无数据」展示为全 0 汇总。
+> **全年无任何成果台账记录**时，总览区与各图表走 **§7.1** 空态，**不**将「无数据」展示为全 0 汇总。  
+> 按月图表（**§5.3～5.9**）展示该年 1～最大月序列，缺月填 0；总览取最大月单月值。
 
 ### 2.5 共富项目类型（与后台一致）
 
@@ -147,7 +147,7 @@ flowchart TD
 
 | 项 | 规则 |
 | --- | --- |
-| 展示内容 | **§2.3** 所列指标在该年的汇总结果，口径遵循 **§2.4** |
+| 展示内容 | **§2.3** 所列指标在该年的取值，口径遵循 **§2.4**（最大填报月单月） |
 | 展示形式 | 卡片或数字大屏组件；每项含指标名称、数值、单位（比率类带 %） |
 | 布局 | 原型若仅展示部分核心指标，以产品定稿为准；**不得**改变指标含义与汇总口径 |
 | 无数据 | 该年无任何成果台账时，本区块 **§7.1** 空态，并提示前往后台维护 |
@@ -202,9 +202,9 @@ flowchart TD
 
 | 项 | 规则 |
 | --- | --- |
-| 区域公共品牌数 | 展示 **§2.4** 全年加总结果；可用中心数字 + 环形/仪表盘等组件 |
-| 品牌产品溢价率 | 展示 **§2.4** 十二个月算术平均；可按**百分比**展示（如 52%） |
-| 数字平台使用率 | 展示 **§2.4** 十二个月算术平均；可按**百分比**展示 |
+| 区域公共品牌数 | 展示 **§2.4** 所选年最大填报月单月值；可用中心数字 + 环形/仪表盘等组件 |
+| 品牌产品溢价率 | 展示 **§2.4** 所选年最大填报月单月值；可按**百分比**展示（如 52%） |
+| 数字平台使用率 | 展示 **§2.4** 所选年最大填报月单月值；可按**百分比**展示 |
 | 无成果数据 | 该年无台账时，本区块与总览一致走空态，**不**展示误导性 0% 或 0 个品牌 |
 
 ---
@@ -284,10 +284,10 @@ flowchart TD
 | 项 | 规则 |
 | --- | --- |
 | 标题 | 各图表有明确中文标题（可与原型一致） |
-| 横轴 | **滚动 12 月**；12 个刻度，**仅显示月份**；悬停显 **YYYY年M月** |
+| 横轴 | **所选年 1～最大月**；N 个刻度，**仅显示月份**；悬停显 **YYYY年M月** |
 | 纵轴 | 标注单位或通过图例说明 |
-| 单点数据 | 滚动窗口内仅 1 个月有台账时，图表仍须正常渲染 |
-| 跨年 | 滚动窗口可跨自然年；按 `statPeriod` 归属槽位 |
+| 单点数据 | 该年内仅 1 个月有台账时，图表仍须正常渲染（长度为 1） |
+| 切年 | 切换 **Y** 后横轴为新年 1～该年最大月；数据归属新年份，**不**混入其他年 |
 | 同月唯一 | 依赖后台「同一统计范围不可重复」；若后台允许多条，须约定取**最新登记**一条并修订本文档 |
 
 ---
@@ -329,7 +329,7 @@ flowchart TD
 | --- | --- |
 | 共同富裕成果 | 按统计年份读取各月指标；驱动总览、按月图表、数字赋能 |
 | 共同富裕项目 | 读取**已发布**项目；驱动分类饼图与列表（列表含 **§5.11.2** 全部展示字段） |
-| 共同富裕成果年度报告（管理端） | 业务口径与年度报告一致；大屏为**大屏专用布局**，指标与汇总规则应对齐，避免同一指标两套口径 |
+| 共同富裕成果年度报告（管理端） | 与大屏共用 `AchievementReportAggregator`：总览最大月单月；按月 1～最大月缺月补 0 |
 
 ---
 
@@ -339,9 +339,9 @@ flowchart TD
 | --- | --- | --- |
 | DP-01 | 默认年份 | 进入大屏默认当前年，总览与图表年份一致 |
 | DP-02 | 切换年份 | 切换后全页数据同属一年；无旧年残留 |
-| DP-03 | 缺月 | 滚动 12 月窗口内仅 3、8 月有台账时，其余槽位为 0；横轴仍为 12 刻度；悬停显年月 |
+| DP-03 | 缺月 | 选定年仅 3、8 月有台账时，其余月为 0；横轴仍为 12 刻度；悬停显年月 |
 | DP-04 | 全年无成果 | 总览与图表空态，非全 0 假数据 |
-| DP-05 | 比率展示 | 溢价率、使用率与后台逻辑一致（12 个月平均后按 % 展示） |
+| DP-05 | 比率展示 | 溢价率、使用率取所选年最大填报月单月值，按 % 展示 |
 | DP-06 | 就业/民族团结双系列 | 图例、Tooltip 可区分两个维度 |
 | DP-07 | 项目分类 | 仅统计已发布且与年份交集的项目；占比之和为 100%（有项目时） |
 | DP-08 | 项目列表 | 分页正常；行内可见类型、名称、简介、内容、周期、图视；无单独详情页跳转 |
@@ -356,6 +356,9 @@ flowchart TD
 | --- | --- | --- |
 | 1.0 | 2026-05-25 | 由草稿优化：补全流程、口径、十区块需求；对齐成果/项目/年度报告；明确列表行内详情；不涉及库表与接口 |
 | 1.1 | 2026-07-04 | **§5.3～5.9** 按月图表改为**滚动最近 12 月**；`monthly` 增 `statYear`；总览仍按 **Y** 汇总 |
+| 1.2 | 2026-07-24 | **总览与按月图表**统一按所选年 **Y** 的 1～12 月取数；取消滚动 12 月窗口 |
+| 1.3 | 2026-07-24 | **总览 / 数字赋能**改为所选年台账**最大统计月**的单月数据；按月图表仍为该年 1～12 月 |
+| 1.4 | 2026-07-24 | 按月图表改为所选年 **1～最大月**；与管理端年度报告口径一致 |
 
 ---
 

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

@@ -135,8 +135,8 @@
 | 字段 | 说明 |
 | --- | --- |
 | `hasData` | 即 `hasAchievementData`；全年无成果台账为 `false` |
-| `summary` | 年度总览；`hasData=false` 时为 **`null`** |
-| `monthly` | 固定 **12** 条；**滚动最近 12 自然月**；每项含 `statYear`、`month`、`statPeriod`；缺月指标为 **0** |
+| `summary` | 总览 / 数字赋能；取所选年台账**最大统计月**单月值；`hasData=false` 时为 **`null`** |
+| `monthly` | **所选年 1～最大统计月 N**，共 N 条；每项含 `statYear`、`month`、`statPeriod`；缺月指标为 **0**；无数据时为空列表 |
 
 **图表字段映射**（与功能需求 §5、年度报告一致）
 
@@ -181,8 +181,9 @@
 
 ```
 1. year = parseStatYear(statYear)
-2. achievement = achievementReportService.getAnnualReport(String.valueOf(year))；`summary`/`hasData` 仍按 **Y**
-3. achievement.monthly = AchievementReportAggregator.buildRollingMonthly(anchor, selectByStatPeriodBetween(...)) — **滚动 12 月**，**不**随 **Y**
+2. rows = achievementMapper.selectByStatYear(year)
+3. achievement = AchievementReportAggregator.buildReport(year, rows)
+   — summary = 最大月单月；monthly = 1～最大月缺月补 0；无数据 monthly=[]、summary=null
 4. projects = mapper.selectPublishedForScreen(year)
 5. projectTypeStats = groupByType(projects); hasProjectData = total > 0
 6. availableYears = union(achievementMapper.selectDistinctStatYears(), projectYears)
@@ -254,3 +255,6 @@ SQL 示例：`sql/big_screen_common_prosperity_perm.sql`（挂载「大屏」父
 | 版本 | 日期 | 说明 |
 | --- | --- | --- |
 | 1.0 | 2026-05-20 | 初稿：无新业务表；复用成果年度报告聚合；双接口（看板 + 项目分页）；对齐功能需求 v1.0 |
+| 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 口径 |

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

@@ -3,7 +3,7 @@
 > 依据：`大屏共同富裕功能需求.md`（v1.1）、`大屏共同富裕技术方案.md`  
 > **接口 Base Path**：`/bigScreen/commonProsperity`（含 `context-path`、网关前缀须补齐）。鉴权：若依 Cookie / `Authorization` Token；权限 `bigScreen:commonProsperity:query`。
 
-**成果口径（图表）**：`achievement.monthly` 为**滚动最近 12 月**；含 `statYear`+`month`；**不**随 **Y**；缺月 **0**。**总览** `summary` 仍按 **Y** 全年汇总。
+**成果口径**：`achievement.monthly` 为所选年 **Y** 的 **1～最大统计月**；缺月 **0**；无数据为空列表。**总览** `summary` 为该年台账**最大统计月**的单月值。与管理端年度报告一致。
 
 **UI 测试**：**Playwright** + **Chromium**，`playwright.config` 中 `use: { channel: 'chrome' }` 调用本机 **Google Chrome**。
 
@@ -54,7 +54,7 @@
 | 用例编号 | 测试模块 | 测试项 | 测试类型 | 测试工具 | 测试目的 | 前置条件 | 测试步骤 | 预期结果 |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- |
 | DP-GTFY-API-001 | 看板 | 满年成果+项目 | 接口测试 | Postman/curl | 正常流程 DP-01 | 已登录；2026 成果多月+已发布项目 | `GET .../dashboard?statYear=2026` | `code` 成功；`achievement.hasData=true`；`monthly.length=12`；`hasProjectData=true`；`projectTypeStats` 有数据 |
-| DP-GTFY-API-002 | 看板 | 滚动 12 月缺月补零 | 接口测试 | Postman | DP-03 | ACH-2026 仅 3、8 月 | `statYear=2026` | `monthly` 含 `statYear`、`month`；缺槽 0；**不**随 **Y** 变窗口 |
+| DP-GTFY-API-002 | 看板 | 所选年缺月补零 | 接口测试 | Postman | DP-03 | ACH-2026 仅 3、8 月 | `statYear=2026` | `monthly` 含 `statYear`、`month`；缺槽 0；切年窗口随 **Y** |
 | DP-GTFY-API-003 | 看板 | 全年无成果 | 接口测试 | Postman | DP-04 | 2026 ACH-EMPTY | `GET dashboard` | `achievement.hasData=false`；`summary=null`；`monthly` 仍 12 条全 0 |
 | DP-GTFY-API-004 | 看板 | 仅项目无成果 | 接口测试 | Postman | §7.2 | 2026 无成果；有 PRJ-PUB-B | `GET dashboard` | `achievement.hasData=false`；`hasProjectData=true`；饼图 stats 正常 |
 | DP-GTFY-API-005 | 看板 | 仅成果无项目 | 接口测试 | Postman | §7.2 | 2026 有 ACH；无符合交集项目 | `GET dashboard` | `achievement.hasData=true`；`hasProjectData=false`；`projectTypeStats` 三项 count=0 |
@@ -94,7 +94,7 @@
 | DP-GTFY-UI-004 | 空态 | 全年无成果 | UI 测试 | Playwright+Chrome | DP-04、§7.1 | 选 ACH-EMPTY 年 | 进入或切换该年 | 总览/图表/数字赋能空态文案；**不**显示全 0 汇总卡片 |
 | DP-GTFY-UI-005 | 空态 | 无项目有成果 | UI 测试 | Playwright+Chrome | §7.2 | 2026 有成果无项目 | 打开 2026 | 图表正常；饼图空态；列表「本年度暂无共富项目」 |
 | DP-GTFY-UI-006 | 总览 | 指标与单位 | UI 测试 | Playwright+Chrome | §5.2 | 2026 有成果 | 查看共富成果卡片区 | 名称/数值/单位正确（万元、人、个、亩）；比率显示 **%** |
-| DP-GTFY-UI-007 | 图表 | 集体经济横向柱滚动 12 月 | UI 测试 | Playwright+Chrome | §5.3、DP-03 | ACH-2026 缺月 | 查看该图+悬停 | 12 刻度**仅月份**；悬停显 **YYYY年M月**+万元 |
+| DP-GTFY-UI-007 | 图表 | 集体经济横向柱所选年 12 月 | UI 测试 | Playwright+Chrome | §5.3、DP-03 | ACH-2026 缺月 | 查看该图+悬停 | 12 刻度**仅月份**；悬停显 **YYYY年M月**+万元 |
 | DP-GTFY-UI-008 | 图表 | 就业双系列 | UI 测试 | Playwright+Chrome | DP-06、§5.4 | 2026 有数据 | 查看就业带动图 | 两图例/两色系；Tooltip 区分人数与岗位 |
 | DP-GTFY-UI-009 | 图表 | 环境治理/文化传承柱图 | UI 测试 | Playwright+Chrome | §5.5、§5.8 | 2026 有数据 | 查看两图 | 12 月；缺月为 0 |
 | DP-GTFY-UI-010 | 图表 | 绿化折线 | UI 测试 | Playwright+Chrome | §5.6 | 2026 有数据 | 查看绿化建设 | 12 落点；缺月 0 不断线 |
@@ -157,7 +157,7 @@ await expect(page.locator('[data-chart]')).toHaveCount(6); // 集体经济/就
 | --- | --- | --- |
 | DP-01 | 默认当前年 | UI-001；API-001 |
 | DP-02 | 切年一致 | API-028；UI-002～003 |
-| DP-03 | 滚动 12 月缺月=0 | UT-003；API-002；UI-007～011 |
+| DP-03 | 所选年缺月=0 | UT-003；API-002；UI-007～011 |
 | DP-04 | 无成果空态 | UT-004；API-003；UI-004、013 |
 | DP-05 | 比率 % | UT-005；API-006；UI-006、012 |
 | DP-06 | 双系列图 | UI-008、011 |