大屏 — 共同富裕统计 — 功能需求
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 后，纳入大屏「项目分类」「项目列表」的项目须同时满足：
- 发布状态为已发布（未发布、已下架的不展示）；
- 实施周期与年份 Y 存在交集：实施开始日期 ≤ Y-12-31，且实施结束日期 ≥ Y-01-01。
同一项目只计一次；类型以项目当前登记的类型为准。
3. 功能范围与边界
3.1 范围内
- 统计年份筛选与整页刷新；
- 共富成果年度总览（指标卡片）；
- 集体经济收入、就业带动、环境治理、绿化建设、文化传承、民族团结 等按月图表；
- 数字赋能（区域公共品牌数、品牌产品溢价率、数字平台使用率）展示；
- 共富项目分类占比（饼图）；
- 共富项目列表（分页，列表项含完整展示所需信息，不设单独「详情页」或二次跳转详情流程）；
- 无数据、加载中、加载失败等状态展示。
3.2 范围外
- 成果台账、共富项目的增删改、发布下架；
- 导出、打印、权限配置（若需仅在大屏端控制访问，由部署与网关策略约定，本文档不展开）；
- 下钻到后台业务菜单（若产品后续增加「去维护」外链，须单独评审）。
4. 业务流程概览
flowchart TD
A[打开大屏共同富裕页] --> B[默认当前统计年份]
B --> C[加载成果台账与已发布项目]
C --> D{该年是否有成果记录}
D -->|成果与项目均无| E[整页或分区块空态]
D -->|至少一类有数据| F[计算年度汇总与按月序列]
F --> G[渲染总览与图表]
F --> H[统计项目分类占比]
F --> I[分页展示项目列表]
J[用户切换统计年份] --> C
K[后台维护数据后] --> L[大屏刷新或重新进入]
L --> C
典型使用顺序：
- 用户进入大屏，系统按当前年加载并展示。
- 用户切换统计年份 → 全页统一 Loading → 各区块按新年份重算。
- 运营人员在后台补录某月成果或发布项目后，大屏通过刷新、重新进入或约定自动轮播周期获取最新数据（不要求秒级实时推送）。
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.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 |
下架项目 |
已下架项目不再出现在分类与列表 |
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～最大月；与管理端年度报告口径一致 |
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，与原型第二张图一致 |
