# 大屏 — 共同富裕统计 — 功能需求

## 1. 文档说明

| 项 | 说明 |
| --- | --- |
| 模块名称 | 大屏共同富裕统计 |
| 使用场景 | 领导参观、指挥调度、对外展示等**大屏端**只读看板 |
| 目标 | 按**统计年份**集中展示本县（或本辖区）共同富裕成效指标、分主题趋势图表及共富项目概况 |
| 数据来源 | **共同富裕成果**（按月台账）、**共同富裕项目**（已发布项目）；大屏**不录入、不修改、不删除**业务数据 |
| 修订依据 | 同目录 `大屏共同富裕功能需求-草稿.md`、`Snipaste_2026-05-25_16-04-04.jpg`、`Snipaste_2026-05-25_16-04-26.jpg`；指标口径与《共同富裕成果功能需求》《共同富裕成果年度报告功能需求》对齐 |
| 关联维护 | 数据补录、修正须在业务后台「共同富裕成果」「共同富裕项目」中完成；大屏刷新后展示最新结果 |

本文档仅描述**功能需求、业务规则与展示逻辑**，不涉及数据库结构、接口路径、请求体字段及技术实现选型。

---

## 2. 术语与口径

### 2.1 统计年份

- 大屏顶部（或全局筛选区）提供**统计年份**选择，格式为自然年 **YYYY**（如 `2026`）。
- 进入大屏时默认选中**当前自然年**。
- 变更统计年份后，本页**全部统计区块**（总览卡片、按月图表、数字赋能、项目分类、项目列表）须**同步**按新年份 **Y** 重算与展示，不得出现区块之间年份不一致。

### 2.2 统计月份（图表横轴）

**所选年 1～最大统计月**（适用于 **§5.3～5.9** 全部按月图表；与管理端年度报告一致）

- 横轴为选定统计年 **Y** 的 **1～N** 月，**N** 为该年台账中最大 `stat_period` 月份；切换 **Y** 后同步切换。
- 接口 `achievement.monthly[]` 每条含 **`statYear`**、**`month`**、**`statPeriod`（yyyy-MM）**；按月份升序，长度 **N**（无数据时为空列表）。
- **缺月规则：** 1～N 内无对应成果台账时，各指标按 **0** 展示；**不**省略刻度、**不**断线留空。
- **前端横轴**仅展示月份（如 `8月`）；**鼠标悬停**展示 **YYYY年M月** 及数值。

**年度总览**（**§2.4**）取所选年台账中**最大统计月**的单月数据；按月图表为该年 1～N 月序列。

### 2.3 共富成果指标（与后台台账一致）

大屏展示的成效指标名称、含义、单位与《共同富裕成果》台账一致，主要包括：

| 指标 | 单位 / 展示习惯 |
| --- | --- |
| 集体经济收入 | 万元 |
| 带动就业人数 | 人 |
| 新增就业岗位 | 个 |
| 环境治理项目数 | 个 |
| 新增绿化面积 | 亩 |
| 文化传承人数 | 人 |
| 民族融合项目数 | 个 |
| 民族团结活动数 | 个 |
| 数字平台使用率 | 比例（后台为 0～1；大屏可统一按**百分比**展示，如 85%） |
| 区域公共品牌数 | 个 |
| 品牌产品溢价率 | 比例（同上，可按百分比展示） |

### 2.4 年度总览区汇总口径

「共富成果」总览卡片（及数字赋能区同源字段）对选定年份 **Y** 的规则如下：

| 指标类型 | 年度总览展示口径 |
| --- | --- |
| 集体经济收入、带动就业人数、新增就业岗位、环境治理项目数、新增绿化面积、文化传承人数、民族融合项目数、民族团结活动数、区域公共品牌数、数字平台使用率、品牌产品溢价率 | 取该年台账中 **`stat_period` 最大月份** 的**单月**指标值（非全年加总 / 非 12 月均值） |

> **全年无任何成果台账记录**时，总览区与各图表走 **§7.1** 空态，**不**将「无数据」展示为全 0 汇总。  
> 按月图表（**§5.3～5.9**）展示该年 1～最大月序列，缺月填 0；总览取最大月单月值。

### 2.5 共富项目类型（与后台一致）

| 后台枚举 | 大屏展示名称（可与原型文案一致） |
| --- | --- |
| 合作共赢 | 共富项目 |
| 农文旅融合 | 农文旅项目 |
| 认养农业 | 认养项目 |

### 2.6 共富项目纳入统计年份的规则

选定统计年份 **Y** 后，纳入大屏「项目分类」「项目列表」的项目须同时满足：

1. **发布状态**为**已发布**（未发布、已下架的不展示）；
2. **实施周期**与年份 **Y** 存在交集：实施开始日期 ≤ **Y-12-31**，且实施结束日期 ≥ **Y-01-01**。

同一项目只计一次；类型以项目当前登记的类型为准。

---

## 3. 功能范围与边界

### 3.1 范围内

- 统计年份筛选与整页刷新；
- **共富成果年度总览**（指标卡片）；
- **集体经济收入**、**就业带动**、**环境治理**、**绿化建设**、**文化传承**、**民族团结** 等按月图表；
- **数字赋能**（区域公共品牌数、品牌产品溢价率、数字平台使用率）展示；
- **共富项目分类**占比（饼图）及**分类情况明细**下钻（按所属年聚合各类型数量，见 **§5.10.1**）；
- **共富项目列表**（分页，列表项含完整展示所需信息，**不设**单独「详情页」或二次跳转详情流程）；
- 无数据、加载中、加载失败等状态展示。

### 3.2 范围外

- 成果台账、共富项目的增删改、发布下架；
- 导出、打印、权限配置（若需仅在大屏端控制访问，由部署与网关策略约定，本文档不展开）；
- 下钻到后台业务菜单（若产品后续增加「去维护」外链，须单独评审）。

---

## 4. 业务流程概览

```mermaid
flowchart TD
    A[打开大屏共同富裕页] --> B[默认当前统计年份]
    B --> C[加载成果台账与已发布项目]
    C --> D{该年是否有成果记录}
    D -->|成果与项目均无| E[整页或分区块空态]
    D -->|至少一类有数据| F[计算年度汇总与按月序列]
    F --> G[渲染总览与图表]
    F --> H[统计项目分类占比]
    F --> I[分页展示项目列表]
    J[用户切换统计年份] --> C
    K[后台维护数据后] --> L[大屏刷新或重新进入]
    L --> C
```

**典型使用顺序：**

1. 用户进入大屏，系统按**当前年**加载并展示。  
2. 用户切换统计年份 → 全页统一 Loading → 各区块按新年份重算。  
3. 运营人员在后台补录某月成果或发布项目后，大屏通过**刷新、重新进入或约定自动轮播周期**获取最新数据（**不要求**秒级实时推送）。

---

## 5. 页面结构与区块需求

布局以原型为准，建议分为上下两大屏或纵向滚动两屏，逻辑顺序如下。

### 5.1 全局：统计年份

| 项 | 规则 |
| --- | --- |
| 控件 | 年份选择（可选范围宜覆盖台账已有年份及当前年前后若干年） |
| 默认值 | 当前自然年 |
| 联动 | 变更后触发**整页**数据重载；展示统一加载状态，避免旧年数据与新选年份短暂并存 |

---

### 5.2 区块一：共富成果年度总览

**对应原型：** 顶部「共富成果」指标卡片区。

| 项 | 规则 |
| --- | --- |
| 展示内容 | **§2.3** 所列指标在该年的取值，口径遵循 **§2.4**（最大填报月单月） |
| 展示形式 | 卡片或数字大屏组件；每项含指标名称、数值、单位（比率类带 %） |
| 布局 | 原型若仅展示部分核心指标，以产品定稿为准；**不得**改变指标含义与汇总口径 |
| 无数据 | 该年无任何成果台账时，本区块 **§7.1** 空态，并提示前往后台维护 |

---

### 5.3 区块二：集体经济收入对比

| 项 | 规则 |
| --- | --- |
| 图表类型 | **横向柱状图** |
| 维度 | 按月；单月值为该月台账中的「集体经济收入」（万元），**非**年内累计 |
| 缺月 | 按 **§2.2** 显示为 0 |
| 交互 | 至少支持悬停查看「月份 + 数值 + 单位」 |

---

### 5.4 区块三：就业带动

| 项 | 规则 |
| --- | --- |
| 图表类型 | **折线图**（原型为面积图时，以产品定稿为准，须能区分双系列） |
| 数据系列 | ① 带动就业人数（人）；② 新增就业岗位（个） |
| 图例 | 两系列须有明确图例与颜色区分 |
| 缺月 | 两系列均按 0 落点；12 个月均展示 |

---

### 5.5 区块四：环境治理

| 项 | 规则 |
| --- | --- |
| 图表类型 | **柱状图**（竖向） |
| 数据系列 | 单月「环境治理项目数」（个） |
| 缺月 | 按 **§2.2** |

---

### 5.6 区块五：绿化建设

| 项 | 规则 |
| --- | --- |
| 图表类型 | **折线图** |
| 数据系列 | 单月「新增绿化面积」（亩）；小数位与台账展示一致 |
| 缺月 | 按 **§2.2** |

---

### 5.7 区块六：数字赋能

**对应原型：** 「数字赋能」— 品牌价值提升、数字普及化。

| 项 | 规则 |
| --- | --- |
| 区域公共品牌数 | 展示 **§2.4** 所选年最大填报月单月值；可用中心数字 + 环形/仪表盘等组件 |
| 品牌产品溢价率 | 展示 **§2.4** 所选年最大填报月单月值；可按**百分比**展示（如 52%） |
| 数字平台使用率 | 展示 **§2.4** 所选年最大填报月单月值；可按**百分比**展示 |
| 无成果数据 | 该年无台账时，本区块与总览一致走空态，**不**展示误导性 0% 或 0 个品牌 |

---

### 5.8 区块七：文化传承

| 项 | 规则 |
| --- | --- |
| 图表类型 | **柱状图** |
| 数据系列 | 单月「文化传承人数」（人） |
| 缺月 | 按 **§2.2** |

---

### 5.9 区块八：民族团结

| 项 | 规则 |
| --- | --- |
| 图表类型 | **堆叠柱状图** |
| 数据系列 | ① 民族融合项目数（个）；② 民族团结活动数（个） |
| 堆叠含义 | 同月两值在同一柱上堆叠；悬停须**分别**展示两项数值 |
| 文案 | 与后台台账一致；草稿中「民族融合案例」视同「民族融合项目数」 |
| 缺月 | 两系列均按 0 |

---

### 5.10 区块九：共富项目分类

| 项 | 规则 |
| --- | --- |
| 图表类型 | **饼图**（原型为 3D 饼图时以视觉为准） |
| 统计对象 | 符合 **§2.6** 的已发布项目，按类型计数 |
| 展示内容 | 各类型项目**数量**及**占比**（占比 = 该类型数量 ÷ 三类合计；合计为 0 时 **§7.2**） |
| 图例 | 三类名称与 **§2.5** 对应，颜色与下方项目列表类型标签一致 |

#### 5.10.1 共富项目分类情况明细（下钻）

饼图可打开**分类情况明细**浮层 / 弹窗（只读），要求如下：

| 项 | 规则 |
| --- | --- |
| 筛选 | **所属年份**（实施年限）；未选时**不过滤**（跨年按实施年限倒序） |
| 数据口径 | 已发布项目（`publish_status=1`），按所属年份聚合；与饼图纳入规则一致 |
| 列表字段 | **所属年份**、**项目总数**、**和美乡村建设项目数**、**人居环境整治提升项目数**、**其他项目投入数**（单位：个） |
| 排序 | 按所属年份**倒序** |
| 分页 | 支持分页 |

---

### 5.11 区块十：共富项目列表

**业务要求：** 分页列出选定年份内的共富项目；**不在大屏上单独打开详情页**，列表行（或展开区）内展示查阅所需的全部信息。

#### 5.11.1 列表范围与排序

| 项 | 规则 |
| --- | --- |
| 范围 | **§2.6** 已发布且实施周期与统计年份有交集的项目 |
| 默认排序 | 建议按**发布时间**倒序（最近发布在前）；若产品改为按实施开始日期倒序，须在验收时明确 |
| 分页 | 支持分页；每页条数与翻页控件样式以大屏交互为准（建议单页 **5～10** 条，避免一屏过长） |

#### 5.11.2 列表行展示内容（即「详情」信息）

每一项目在同一列表内展示（可为固定行高 + 展开，或卡片式），至少包含：

| 信息项 | 说明 |
| --- | --- |
| 项目类型 | 展示为共富项目 / 农文旅项目 / 认养项目，样式与饼图、标签色一致 |
| 项目名称 | 完整展示或大屏约定字数截断 + 悬停全文 |
| 项目简介 | 完整或截断展示 |
| 项目内容 | 完整或截断展示；过长时滚动或展开，**不**跳转新页面 |
| 实施周期 | 实施开始日期～实施结束日期 |
| 运营图片 | 展示已上传图片（1～3 张），支持缩略图预览 |
| 运营视频 | 若有则展示封面或播放入口；无则不占位或显示「无」 |
| 封面 | 若有则展示；无则按产品约定 |

**不提供**单独「详情」按钮跳转二级页；若原型保留「详情」文案，应定义为**行内展开/浮层**查看完整内容，而非新开维护端或接口级详情页。

#### 5.11.3 列表空态

该年无符合 **§2.6** 的已发布项目时，列表区展示「本年度暂无共富项目」类提示；**不影响**成果类图表是否展示（成果有数据时图表仍正常）。

---

## 6. 图表通用规则

适用于 **§5.3～5.9** 所有按月图表：

| 项 | 规则 |
| --- | --- |
| 标题 | 各图表有明确中文标题（可与原型一致） |
| 横轴 | **所选年 1～最大月**；N 个刻度，**仅显示月份**；悬停显 **YYYY年M月** |
| 纵轴 | 标注单位或通过图例说明 |
| 单点数据 | 该年内仅 1 个月有台账时，图表仍须正常渲染（长度为 1） |
| 切年 | 切换 **Y** 后横轴为新年 1～该年最大月；数据归属新年份，**不**混入其他年 |
| 同月唯一 | 依赖后台「同一统计范围不可重复」；若后台允许多条，须约定取**最新登记**一条并修订本文档 |

---

## 7. 异常、空态与刷新

### 7.1 成果数据空态

| 场景 | 展示要求 |
| --- | --- |
| 选定年份无任何成果台账 | 总览区、按月图表、数字赋能区展示统一空态文案（如「暂无该年度共富成果数据」）；可附带简短引导「请在共同富裕成果中维护」 |
| 年内部分月份缺失 | **不**视为空态；按 **§2.2** 缺月填 0 正常出图 |

### 7.2 项目数据空态

| 场景 | 展示要求 |
| --- | --- |
| 无符合 **§2.6** 的项目 | 饼图区、列表区分别空态；饼图不展示 100% 单类假象 |
| 有项目无成果 | 项目区块正常；成果区块按 **§7.1** |

### 7.3 加载与失败

| 场景 | 展示要求 |
| --- | --- |
| 切换年份加载中 | 整页或分区块 Loading，避免显示上一年残留数据 |
| 加载失败 | 明确失败提示，支持**重试**；不得静默空白 |
| 部分区块失败 | **不宜**出现「总览成功、图表失败」长期并存；宜整页失败或分块重试 |

### 7.4 数据刷新

- 大屏为**只读**；后台维护后，须通过**重新进入页面、手动刷新、或大屏轮播周期自动刷新**更新（自动刷新周期由实施配置，建议 **1～5 分钟** 量级，避免过于频繁）。
- **不要求**与后台台账变更秒级同步。

---

## 8. 与后台模块的关系

| 后台模块 | 大屏如何使用 |
| --- | --- |
| 共同富裕成果 | 按统计年份读取各月指标；驱动总览、按月图表、数字赋能 |
| 共同富裕项目 | 读取**已发布**项目；驱动分类饼图与列表（列表含 **§5.11.2** 全部展示字段） |
| 共同富裕成果年度报告（管理端） | 与大屏共用 `AchievementReportAggregator`：总览最大月单月；按月 1～最大月缺月补 0 |

---

## 9. 验收要点（功能）

| 编号 | 场景 | 通过标准 |
| --- | --- | --- |
| DP-01 | 默认年份 | 进入大屏默认当前年，总览与图表年份一致 |
| DP-02 | 切换年份 | 切换后全页数据同属一年；无旧年残留 |
| DP-03 | 缺月 | 选定年仅 3、8 月有台账时，其余月为 0；横轴仍为 12 刻度；悬停显年月 |
| DP-04 | 全年无成果 | 总览与图表空态，非全 0 假数据 |
| DP-05 | 比率展示 | 溢价率、使用率取所选年最大填报月单月值，按 % 展示 |
| DP-06 | 就业/民族团结双系列 | 图例、Tooltip 可区分两个维度 |
| DP-07 | 项目分类 | 仅统计已发布且与年份交集的项目；占比之和为 100%（有项目时） |
| DP-08 | 项目列表 | 分页正常；行内可见类型、名称、简介、内容、周期、图视；无单独详情页跳转 |
| DP-09 | 后台补录后刷新 | 补录某月成果或发布项目后，大屏刷新可见新数据 |
| DP-10 | 下架项目 | 已下架项目不再出现在分类与列表 |
| DP-11 | 分类明细 | 明细弹窗按所属年展示总数及三类数量；未选年可跨年分页；支持分页；年份倒序 |

---

## 10. 修订记录

| 版本 | 日期 | 说明 |
| --- | --- | --- |
| 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～最大月**；与管理端年度报告口径一致 |
| 1.6 | 2026-08-18 | §5.10.1 / DP-11：分类明细未选年份不过滤 |
| 1.5 | 2026-07-24 | 新增 **§5.10.1** 共富项目分类情况明细（下钻）；验收 DP-11 |

---

## 11. 相对草稿的优化说明

| 草稿问题 | 处理方式 |
| --- | --- |
| 仅条目罗列、无流程与边界 | 增加 **§3、§4、§7、§9** |
| 指标「区域公共品牌数」重复 | 按台账保留一项，纳入 **§2.3** |
| 序号缺 6、跳号 | 在正式需求中按主题分 **§5.3～5.11** 编排 |
| 「详情不要单独接口」表述偏技术 | 转化为 **§5.11** 列表行内展示全部字段、无二级详情页 |
| 未说明年份、缺月、汇总口径 | 沿用年度报告 **§2.2、§2.4** 并写入 **§2** |
| 项目分类与列表范围不清 | 增加 **§2.5、§2.6** 及发布状态、实施周期交集规则 |
| 未覆盖数字赋能区块 | 增加 **§5.7**，与原型第二张图一致 |
