西藏巴青项目

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

1. 文档说明

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

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

2. 术语与口径

2.1 统计年份

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

2.2 统计月份（图表横轴）

凡「按月统计」的图表，横轴固定为 1 月～12 月 共 12 个刻度。
缺月规则： 某月无对应「共同富裕成果」台账记录时，该指标在该月按 0 参与展示（柱状高度为 0、折线落点为 0）；不省略该月刻度、不断线留空、不用相邻月插值。

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

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

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

2.4 年度总览区汇总口径

「共富成果」总览卡片对选定年份内各月台账汇总规则如下（须在界面或帮助说明中标注，避免与「单月值」混淆）：

指标类型	年度总览展示口径
集体经济收入、带动就业人数、新增就业岗位、环境治理项目数、新增绿化面积、文化传承人数、民族融合项目数、民族团结活动数、区域公共品牌数	对 1～12 月逐月取值（缺月按 0），再求全年加总
数字平台使用率、品牌产品溢价率	对 1～12 月逐月取值（缺月按 0），再求 12 个月算术平均值（分母固定为 12）

全年无任何成果台账记录时，总览区与各图表走 §7.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～12 月；标签格式全站统一（如 `1月`…`12月`）
纵轴	标注单位或通过图例说明
单点数据	仅 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 全部展示字段）
共同富裕成果年度报告（管理端）	业务口径与年度报告一致；大屏为大屏专用布局，指标与汇总规则应对齐，避免同一指标两套口径

9. 验收要点（功能）

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

10. 修订记录

版本	日期	说明
1.0	2026-05-25	由草稿优化：补全流程、口径、十区块需求；对齐成果/项目/年度报告；明确列表行内详情；不涉及库表与接口

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，与原型第二张图一致

大屏共同富裕功能需求.md 16KB История Исходник