共同富裕

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

@@ -90,7 +90,7 @@
 - **共富成果年度总览**（指标卡片）；
 - **集体经济收入**、**就业带动**、**环境治理**、**绿化建设**、**文化传承**、**民族团结** 等按月图表；
 - **数字赋能**（区域公共品牌数、品牌产品溢价率、数字平台使用率）展示；
-- **共富项目分类**占比（饼图）；
+- **共富项目分类**占比（饼图）及**分类情况明细**下钻（按所属年聚合各类型数量，见 **§5.10.1**）；
 - **共富项目列表**（分页，列表项含完整展示所需信息，**不设**单独「详情页」或二次跳转详情流程）；
 - 无数据、加载中、加载失败等状态展示。
 
@@ -240,6 +240,18 @@ flowchart TD
 | 展示内容 | 各类型项目**数量**及**占比**（占比 = 该类型数量 ÷ 三类合计；合计为 0 时 **§7.2**） |
 | 图例 | 三类名称与 **§2.5** 对应，颜色与下方项目列表类型标签一致 |
 
+#### 5.10.1 共富项目分类情况明细（下钻）
+
+饼图可打开**分类情况明细**浮层 / 弹窗（只读），要求如下：
+
+| 项 | 规则 |
+| --- | --- |
+| 筛选 | **所属年份**（实施年限）；未选时默认**当前自然年** |
+| 数据口径 | 已发布项目（`publish_status=1`），按所属年份聚合；与饼图纳入规则一致 |
+| 列表字段 | **所属年份**、**项目总数**、**和美乡村建设项目数**、**人居环境整治提升项目数**、**其他项目投入数**（单位：个） |
+| 排序 | 按所属年份**倒序** |
+| 分页 | 支持分页 |
+
 ---
 
 ### 5.11 区块十：共富项目列表
@@ -347,6 +359,7 @@ flowchart TD
 | DP-08 | 项目列表 | 分页正常；行内可见类型、名称、简介、内容、周期、图视；无单独详情页跳转 |
 | DP-09 | 后台补录后刷新 | 补录某月成果或发布项目后，大屏刷新可见新数据 |
 | DP-10 | 下架项目 | 已下架项目不再出现在分类与列表 |
+| DP-11 | 分类明细 | 明细弹窗按所属年展示总数及三类数量；默认当前年；支持分页；年份倒序 |
 
 ---
 
@@ -359,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.5 | 2026-07-24 | 新增 **§5.10.1** 共富项目分类情况明细（下钻）；验收 DP-11 |
 
 ---
 

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

@@ -272,7 +272,7 @@ SQL 示例：`sql/big_screen_common_prosperity_perm.sql`（挂载「大屏」父
 - [ ] `BizCommonProsperityProjectMapper` 大屏查询 SQL（**§2.2** 条件）
 - [ ] 复用 `IAchievementReportService` / `AchievementReportAggregator`（禁止大屏单独写一套汇总）
 - [ ] 单元测试：全年无成果（`summary=null`）、缺月补 0、项目年份交集、仅项目无成果、分类占比、分页列表含运营图
-- [ ] 接口测试：`/bigScreen/commonProsperity/dashboard`、`/projects`
+- [ ] 接口测试：`/bigScreen/commonProsperity/dashboard`、`/projects`、`/projectTypeDetails`
 - [ ] 菜单权限 SQL；依赖成果/项目表 DDL 已执行
 - [ ] 大屏前端页面（另见前端技术方案，本期可后补）
 

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

@@ -3,7 +3,7 @@
 > 依据：`大屏共同富裕功能需求.md`（v1.1）、`大屏共同富裕技术方案.md`  
 > **接口 Base Path**：`/bigScreen/commonProsperity`（含 `context-path`、网关前缀须补齐）。鉴权：若依 Cookie / `Authorization` Token；权限 `bigScreen:commonProsperity:query`。
 
-**成果口径**：`achievement.monthly` 为所选年 **Y** 的 **1～最大统计月**；缺月 **0**；无数据为空列表。**总览** `summary` 为该年台账**最大统计月**的单月值。与管理端年度报告一致。
+**成果口径**：`achievement.monthly` 为所选年 **Y** 的 **1～最大统计月**；缺月 **0**；无数据为空列表。**总览** `summary` 为该年台账**最大统计月**的单月值。与管理端年度报告一致。分类明细见 `GET /projectTypeDetails`。
 
 **UI 测试**：**Playwright** + **Chromium**，`playwright.config` 中 `use: { channel: 'chrome' }` 调用本机 **Google Chrome**。
 
@@ -81,6 +81,10 @@
 | DP-GTFY-API-026 | 权限 | 无大屏权限 | 接口测试 | Postman | 越权 | 无 `bigScreen:commonProsperity:query` | `GET dashboard`、`GET projects` | 403 或无权限 |
 | 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-031 | 分类明细 | 未发布不计 | 接口测试 | Postman | 业务约束 | 该年仅未发布项目 | `GET projectTypeDetails` | `rows=[]` 或无该年行 |
+| DP-GTFY-API-032 | 分类明细 | 分页参数 | 接口测试 | Postman | 分页 | 已登录 | `pageNum=1&pageSize=10` | 成功；`total`/`rows` 符合 PageHelper |
 
 ---
 
@@ -165,6 +169,7 @@ await expect(page.locator('[data-chart]')).toHaveCount(6); // 集体经济/就
 | DP-08 | 列表分页行内 | API-016～018；UI-016～018 |
 | DP-09 | 后台变更刷新 | API-023～024；UI-021、025 |
 | DP-10 | 下架不展示 | UT-007；API-013；UI-022 |
+| DP-11 | 分类明细下钻 | API-029～032 |
 | §2.6 | 项目交集 | UT-006、008；API-014 |
 | §3.2 | 只读 | UT-016～017；API-021～022；UI-019 |
 | §5.11 | 无详情页 | UT-017；API-021；UI-017 |
@@ -177,3 +182,4 @@ await expect(page.locator('[data-chart]')).toHaveCount(6); // 集体经济/就
 | 版本 | 说明 |
 | --- | --- |
 | 1.0 | 初版：单元 18、接口 28、UI 25；覆盖 DP-01～10 与正常/异常/约束；Playwright+Chrome；Base `/bigScreen/commonProsperity` |
+| 1.1 | 增补分类情况明细 API-029～032（DP-11）；成果口径改为最大月 / 1～最大月 |