大屏 — 首页统计 — 功能需求
1. 文档说明
| 项 |
说明 |
| 模块名称 |
大屏首页统计 |
| 使用场景 |
领导参观、指挥调度、对外展示等大屏端只读看板（首页/总览页） |
| 目标 |
按统计年份集中展示养殖产业、流通交易、线下服务预约、惠农补贴、养殖标准、农技与实战培训等核心指标，形成县域牧业综合态势一屏总览 |
| 数据来源 |
养殖产业数据相关台账（牦牛资产、牧场、草场、疾病预警等）、交易市场平台（供应商、承销商、交易市场）、牧业疫病诊疗服务（服务预约）、产业政策（补贴发放记录）、养殖标准体系（各子类标准）、牧业养殖科技服务（视频课程）、科技平台与服务（实战业务培训）；大屏不录入、不修改、不删除业务数据 |
| 修订依据 |
同目录 大屏首页功能需求-草稿.md、Snipaste_2026-05-25_20-14-49.jpg、Snipaste_2026-05-25_20-15-28.jpg；指标口径与《养殖产业数据功能需求》《补贴发放记录功能需求》《实战业务培训功能需求》《畜牧医疗资源管理功能需求》《畜牧科技资源管理功能需求》《养殖标准管理功能需求》及关联子标准模块对齐 |
| 关联维护 |
台账补录、发布、下架、预约、补贴登记、标准维护须在对应业务后台完成；大屏刷新后展示最新结果 |
本文档仅描述功能需求、业务规则与展示逻辑，不涉及数据库结构、接口路径、请求体字段及技术实现选型。
2. 术语与口径
2.1 统计年份
- 大屏顶部（或全局筛选区）提供统计年份选择，格式为自然年 YYYY（如
2026）。
- 进入大屏时默认选中当前自然年。
- 变更统计年份后，本页全部统计区块须同步按新年份重新计算与展示，不得出现区块之间年份不一致。
2.2 统计日与历史年末时点
记用户打开或刷新大屏时的系统日期为统计日。
| 场景 |
时点约定 |
| 统计年份 Y = 当前自然年 |
「时点类」指标以统计日为基准（与《养殖产业数据功能需求》§2.2 一致） |
| 统计年份 Y 为历史年 |
「时点类」指标以 Y 年 12 月 31 日 为还原时点（月末存栏还原规则见 §2.5） |
2.3 统计月份（按月图表）
- 凡「按月统计」的图表，横轴固定为 1 月～12 月 共 12 个刻度。
- 缺月规则： 该月在 Y 年 内无任何纳入统计的业务记录时，当月指标按 0 参与展示；不省略该月刻度、不断线留空、不用相邻月插值。
- 当前年未到来月份： 当 Y 为当前年时，晚于统计日 的月份在趋势图/柱状图中按 0 展示（与缺月规则统一，保证横轴恒为 12 月）。
2.4 指标类型与年份关系（总览）
| 指标类型 |
代表指标 |
与统计年份 Y 的关系 |
| 年内累计 |
牦牛年出栏量、补贴发放金额、预约人次（年度卡片合计） |
仅汇总 Y 年 内满足纳入条件的记录 |
| 时点/还原 |
牦牛存栏总量、公母牛数、年龄结构、牧场/草场数量与面积 |
按 §2.2 时点或月末还原 |
| 主数据实时快照 |
供应商数量、承销商数量、交易市场数量 |
不随 Y 切换；始终为当前有效主数据条数（见 §2.6） |
草稿写「产业总览统计当前年份」；对主数据条数三类，正式口径收束为实时快照，避免历史年无法追溯版本导致误导；牦牛存栏、出栏等仍严格按 Y 与 §2.2 计算。
2.5 牦牛产业口径（对齐《养殖产业数据功能需求》）
以下与养殖产业看板保持一致，大屏仅只读引用，不在此重复维护台账。
| 主题 |
规则摘要 |
| 存栏 |
「牦牛资产档案」未逻辑删除且资产状态为正常的个体计入存栏；死淘、丢失、出栏不计入 |
| 性别 |
公、母按档案性别；无法映射公/母的计入存栏总量、不计入公/母分项 |
| 月龄 |
优先档案「月龄」；缺失时由出生日期与统计时点计算整月龄 |
| 年出栏量 |
Y 年 1 月 1 日 0:00 至（Y 为当前年则统计日 24:00，Y 为历史年则 Y-12-31 24:00）内，状态为出栏且状态变更日期落在上述区间内的档案，按头计 1；变更日期为空的不计入 |
| 按月存栏趋势 |
各月数值为该月月末（当前月用统计日代替月末）按 §2.3 存栏认定 还原的头数；分公牛、母牛两系列 |
| 按月出栏 |
Y 年 各自然月内，满足出栏认定且状态变更日期落在该月的头数合计 |
| 年龄结构 |
在 §2.2 时点上，按整月龄分档：1～6 月龄、7～12 月龄、12 月龄以上（含 12 月龄边界以产品全局月龄规则为准，三档互斥且覆盖全部纳入存栏个体）；展示各档头数占比 |
| 牧场 |
未逻辑删除且经营状态为正常的牧场条数 |
| 草场 |
未逻辑删除的草场条数；草场面积为有效草场面积字段之和，面积为空不计入求和 |
| 可用/使用中草场 |
同《养殖产业数据》§2.7 |
| 退化等级结构 |
对未逻辑删除的全部草场按退化等级（未退化、轻度、中度、重度、极重度）统计条数及占草场总条数的占比 |
数据权限： 牦牛、牧场纳入范围与《养殖产业数据》§2.9 一致（可见牧场范围内档案；pasture_id 为空的档案不参与牦牛类统计）；草场按授权区域全县（或授权范围）台账统计。
2.6 交易市场主数据（供应商 / 承销商 / 交易市场）
| 指标 |
规则 |
| 供应商数量 |
「供应商管理」中未逻辑删除的供应商条数 |
| 承销商数量 |
「承销商管理」中未逻辑删除的承销商条数 |
| 交易市场数量 |
「交易市场管理」中未逻辑删除且运营状态为正常的市场条数 |
三项为主数据实时快照，切换统计年份 Y 时数值不变（除非后台主数据变更后刷新大屏）。
2.7 线下服务预约口径
预约数据来源于服务预约业务（移动端提交、后台可查）；资源类型与《预约服务》/《畜牧医疗资源管理》一致：
| 展示名称 |
资源类型编码 |
含义 |
| 兽医人员 |
004001 |
兽医人员预约 |
| 专家人员 |
004005 |
专家（科技资源专家库）预约 |
| 诊疗机构 |
004003 |
诊疗机构预约 |
| 项 |
规则 |
| 统计对象 |
Y 年内预约日期（或服务发生日期，与后台预约主档「预约日期」字段一致）落在 **Y 年的预约记录条数 |
| 去重 |
一条预约记录计 1 人次（不按预约人去重，除非产品另定） |
| 无效记录 |
已逻辑删除的预约不参与 |
| 左侧年度卡片 |
分别为上述三类在 Y 年内的预约条数合计 |
| 按月堆叠柱图 |
横轴 1～12 月；系列为兽医预约、专家预约、机构预约；当月无记录则为 0 |
草稿「专家人员」对应预约资源 专家（004005），非专家团队编码 004002。
2.8 惠农补贴发放口径
对齐《补贴发放记录功能需求》：
| 项 |
规则 |
| 统计周期 |
发放日期落在统计年份 Y 年内（Y-01-01～Y-12-31，含起止日） |
| 统计对象 |
未逻辑删除的补贴发放记录 |
| 分组维度 |
补贴类型：1 农业生产、2 住房基建、3 民生保障 |
| 指标 |
各类型 补贴金额合计；展示单位建议 万元（保留 2 位小数或与全局金额展示一致） |
| 图表 |
三类并列柱状图（或条形图），无记录的类型金额为 0 |
2.9 养殖标准列表口径
大屏「养殖标准」区以分类 Tab 切换（与原型一致），Tab 与标准体系对应关系如下：
| Tab 展示名 |
标准体系范围（示例） |
列表数据来源 |
| 养殖管理 |
繁育作业等养殖管理类标准 |
对应「养殖标准体系」下各子模块中标准类型归属该类的记录 |
| 牦牛饲喂 |
饲喂类标准 |
饲喂标准管理 |
| 设备实施 |
设备实施作业类标准 |
设备实施作业标准管理 |
| 疾病诊疗 |
疫病诊疗类标准 |
疫病诊疗标准管理 |
| 生长出栏 |
生长与出栏类标准 |
生长与出栏标准管理 |
纳入列表的记录须同时满足：
- 创建时间的日期部分落在统计年份 Y 年内（与草稿「当前年份创建」一致）；
- 未逻辑删除；
- 上架状态为已发布（对外有效的标准方可在展示场景出现；未发布、仅草稿不展示）。
展示与交互：
- 分页列表；默认按创建时间倒序（或按标准名称，与产品定稿一致）；
- 行内至少展示：标准名称及查阅所需摘要字段（如类型、创建日期等，以原型为准）；
- 行内「详情」为展开或浮层展示正文/附件说明，不设大屏独立详情页、不跳转后台维护菜单（与《大屏共同富裕统计》列表约定一致）。
2.10 农技课堂口径
| 指标 |
规则 |
| 课程视频 |
Y 年内已发布的「视频课程」资源（resource_type = 004008）条数；未发布、已逻辑删除不计入 |
| 实战培训 |
Y 年内已发布的实战业务培训场次（主档条数）；未发布、已逻辑删除不计入 |
| 培训内容合计 |
课程视频数 + 实战培训场次数（中心「培训内容」数字） |
| 发布时间界定 |
以各模块发布成功时间落在 Y 年为准；若仅有创建时间无发布时间，以产品与技术方案约定字段为准 |
2.11 实战培训报名趋势口径
对齐《实战业务培训功能需求》：
| 维度 |
规则 |
| 活动数（个/月） |
Y 年各月内，培训时间落在该月的、已发布且未删除的实战培训条数 |
| 报名人数（人/月） |
对上述落在该月的培训，将其实际报名人数（enroll_status=已报名 的统计值，与主档 actual_enrolled_count 一致）求和 |
| 图表形式 |
双系列曲线/面积图（活动数、报名人数）；横轴 12 月；缺月为 0 |
| 无已发布培训 |
当年无培训时走 §7.1 空态，不用 0 冒充有培训业务 |
2.12 比率与单位
| 项 |
约定 |
| 头数 |
牦牛存栏、出栏、年龄结构 |
| 个数 |
牧场、草场、供应商、承销商、交易市场、培训场次 |
| 亩 |
草场面积 |
| 人 |
预约人次、报名人数 |
| 万元 |
补贴金额（若界面用元须全文统一） |
| 占比 |
年龄结构、草场退化占比，建议 % 保留 1 位小数或整数 % |
3. 功能范围与边界
3.1 范围内
- 统计年份筛选与整页刷新；
- 产业总览八项指标卡片；
- 牦牛存栏变动（当前公/母牛数量 + 按月存栏趋势）；
- 牦牛年龄结构（三档月龄占比）；
- 牦牛出栏统计（按月柱状图）；
- 草场类型占比（可用/使用中 + 退化等级数量与占比）；
- 线下服务预约（三类年度合计 + 按月堆叠柱图）；
- 惠农补贴发放（三类金额柱状图）；
- 养殖标准（分类 Tab + 分页列表，行内查阅）；
- 农技课堂（课程视频、实战培训、培训内容合计）；
- 实战培训报名（按月活动数与报名人数双曲线）；
- 地图标注（全县乡镇牦牛存栏/出栏头数，供首页地图展示）；
- 无数据、加载中、加载失败等状态展示。
3.2 范围外
- 各业务模块台账的增删改、发布下架、预约受理、补贴登记、标准维护；
- 导出、打印；地图下钻后台菜单（若后续增加外链须单独评审）；
- 按牧场、区域、自定义日期段筛选（见 §8）；
- 气象、疫病风险专页、共同富裕专页等其他大屏子页（各自独立需求）；
- 大屏端权限与网关策略（由部署约定，本文档不展开）。
4. 业务流程概览
flowchart TD
A[打开大屏首页] --> B[默认当前统计年份 Y]
B --> C[加载各区块统计数据]
C --> D[渲染总览/图表/列表]
J[用户切换统计年份] --> C
K[后台维护业务数据后] --> L[刷新或重新进入大屏]
L --> C
典型使用顺序：
- 用户进入大屏首页，系统按当前年加载并展示各区块。
- 用户切换统计年份 → 全页统一 Loading → 各区块按 Y 重算（主数据三类快照除外）。
- 运营人员在后台维护牦牛档案、草场、预约、补贴、标准、培训等数据后，大屏通过重新进入、手动刷新或约定自动轮播周期更新（不要求秒级实时同步）。
4.1 数据汇聚关系
flowchart TB
subgraph industry [产业与草场]
Y[牦牛资产/牧场/草场]
end
subgraph trade [流通交易]
S[供应商/承销商/交易市场]
end
subgraph service [服务与政策]
A1[服务预约]
P[补贴发放]
end
subgraph knowledge [标准与培训]
ST[养殖标准体系]
C[视频课程]
T[实战业务培训]
end
subgraph screen [大屏首页]
H[首页各区块]
end
Y --> H
S --> H
A1 --> H
P --> H
ST --> H
C --> H
T --> H
5. 页面结构与区块需求
布局以原型 Snipaste_2026-05-25_20-14-49.jpg、Snipaste_2026-05-25_20-15-28.jpg 为准。
5.1 全局：统计年份
| 项 |
规则 |
| 统计年份 |
见 §2.1；变更后整页重载 |
| 标题 |
各区块标题与原型一致 |
| 只读 |
大屏无维护类按钮；可有刷新 |
5.2 区块一：产业总览
以指标卡片横向排列（与原型一致，共 8 项）：
| 序号 |
指标名称 |
单位 |
统计口径 |
| 1 |
牦牛存栏总量 |
头 |
§2.5 时点存栏 |
| 2 |
牦牛年出栏量 |
头 |
§2.5 年内出栏 |
| 3 |
牧场数量 |
个 |
§2.5 |
| 4 |
草场数量 |
个 |
§2.5 |
| 5 |
草场面积 |
亩 |
§2.5 |
| 6 |
供应商数量 |
个 |
§2.6 实时快照 |
| 7 |
承销商数量 |
个 |
§2.6 实时快照 |
| 8 |
交易市场数量 |
个 |
§2.6 实时快照 |
草稿未列「预警牦牛数量」；首页总览以草稿八项为准，疾病预警指标留在「养殖产业数据」专看板。
无数据： 某项无可汇总数据时展示 0 或 —（时点类建议 0；若全县无草场台账可展示 0）。
5.3 区块二：牦牛存栏变动
| 项 |
规则 |
| 图表类型 |
折线图（或面积图，以原型为准） |
| 数据系列 |
公牛数量、母牛数量（头） |
| 横轴 |
§2.3 1～12 月 |
| 辅助展示 |
可在图例区或标题旁展示 §2.2 时点的公、母牛当前数量（与趋势图一致口径） |
| 交互 |
至少支持悬停查看「月份 + 公牛数 + 母牛数」 |
5.4 区块三：牦牛年龄结构
| 项 |
规则 |
| 图表类型 |
饼图/环形图（以原型为准） |
| 分档 |
1～6 月龄、7～12 月龄、12 月龄以上 |
| 展示内容 |
各档头数及占比（%） |
| 无存栏 |
§2.5 时点存栏为 0 时 §7.1 空态 |
5.5 区块四：牦牛出栏统计
| 项 |
规则 |
| 图表类型 |
柱状图 |
| 指标 |
Y 年各月出栏头数 |
| 横轴 |
§2.3 1～12 月 |
| 交互 |
悬停展示月份与出栏头数 |
5.6 区块五：草场类型占比
| 项 |
规则 |
| 上部卡片 |
可用草场数、使用中草场数（§2.5） |
| 下部图表 |
退化等级（未退化、轻度、中度、重度、极重度）的条数与占比；表格或环形图（以原型为准） |
| 说明 |
「可用」「使用中」含义不同，不宜简单相加为总量；文案须区分 |
5.7 区块六：线下服务预约
| 项 |
规则 |
| 左侧 |
三类年度预约合计卡片：兽医人员、专家人员、诊疗机构（§2.7） |
| 右侧 |
堆叠柱状图：横轴 12 月；系列为兽医/专家/机构预约人次 |
| 图例 |
与三类名称一致，颜色区分 |
5.8 区块七：惠农补贴发放
| 项 |
规则 |
| 图表类型 |
柱状图（以原型为准） |
| 横轴 |
农业生产、住房基建、民生保障 |
| 纵轴 |
补贴金额合计（万元） |
| 口径 |
§2.8 |
5.9 区块八：养殖标准
| 项 |
规则 |
| 布局 |
左侧 5 个分类 Tab（§2.9）；右侧分页列表 |
| 列表字段 |
至少含标准名称；行内「详情」展开查阅，不跳转后台 |
| 分页 |
支持翻页；切换 Tab 时从第 1 页重新加载 |
| 无数据 |
该分类在 Y 年无已发布标准时列表空态 |
5.10 区块九：农技课堂
| 项 |
规则 |
| 展示项 |
课程视频数量、实战培训场次、中心 培训内容合计（§2.10） |
| 展示形式 |
环形或指标盘（以原型为准） |
| 无数据 |
两项均为 0 时走空态或展示 0（与 §7.1 协调） |
5.11 区块十：实战培训报名
| 项 |
规则 |
| 图表类型 |
双系列曲线/面积图（以原型为准） |
| 系列 |
活动数（个）、报名人数（人） |
| 横轴 |
§2.3 1～12 月 |
| 口径 |
§2.11 |
5.12 区块十一：地图标注
| 项 |
规则 |
| 展示位置 |
首页地图各乡镇标注（以原型为准） |
| 乡镇范围 |
sys_dept 中 parent_id=100 且 order_num>12 的有效乡镇 |
| 标注字段 |
所属乡镇 dept_id、乡镇名称、牦牛存栏数（头）、牦牛出栏数（头） |
| 存栏口径 |
biz_yak_herd_inventory.yak_total；统计年 = 当前自然年 − 1 |
| 出栏口径 |
biz_yak_outbound_report.yak_outbound_count；统计年 = 当前自然年 |
| 无填报 |
对应乡镇该年未填报时展示 0 |
| 与看板年份 |
不随页面「统计年份 Y」切换；始终按服务器当前自然年取上一年存栏、当年出栏 |
6. 图表与列表通用规则
| 项 |
规则 |
| 单位 |
界面须标注单位（头、个、亩、人、万元、% 等） |
| 跨年 |
仅使用 §2 约定的 Y 纳入规则 |
| 列表与统计一致 |
养殖标准列表仅展示 §2.9 纳入记录 |
| 只读 |
无编辑、删除、发布、预约、登记类操作 |
7. 异常、空态与刷新
7.1 业务数据空态
| 场景 |
展示要求 |
| Y 年无出栏记录 |
出栏柱状图空态；年出栏量卡片可为 0 |
| Y 年时点无存栏 |
年龄结构、存栏趋势空态；存栏总量为 0 |
| Y 年无预约 |
预约区空态；三类年度卡片为 0 |
| Y 年无补贴发放 |
补贴图空态或三类型均为 0 |
| 某标准分类无已发布标准 |
该 Tab 列表空态 |
| Y 年无视频课程且无实战培训 |
农技课堂空态 |
| Y 年无已发布实战培训 |
实战培训报名趋势空态 |
| 某乡镇无存栏/出栏填报 |
地图标注该乡镇对应头数为 0 |
7.2 加载与失败
| 场景 |
展示要求 |
| 切换年份加载中 |
整页或分区块 Loading，避免显示上一年残留数据 |
| 业务数据加载失败 |
明确失败提示，支持重试 |
| 部分区块失败 |
失败区块单独提示；已成功区块可保留（若产品要求整页失败则统一提示） |
7.3 数据刷新
- 大屏为只读；后台维护后，须通过重新进入、手动刷新或轮播周期自动刷新更新（周期建议 1～5 分钟，由实施配置）。
- 不要求与后台变更秒级同步。
8. 验收要点（功能）
| 编号 |
场景 |
通过标准 |
| SY-01 |
默认年份 |
进入首页默认当前年，各区块口径一致 |
| SY-02 |
切换年份 |
切换 Y 后各区块同步更新，无旧年残留 |
| SY-03 |
产业总览 |
八项指标与手工按 §2.5、§2.6 核算一致（主数据三项不随 Y 变） |
| SY-04 |
存栏趋势 |
折线 12 月；缺月/未来月为 0；公/母系列区分 |
| SY-05 |
年龄结构 |
三档占比之和为 100%（有存栏时） |
| SY-06 |
出栏按月 |
与 Y 年各月出栏手工核算一致 |
| SY-07 |
草场占比 |
可用/使用中及五档退化与《养殖产业数据》一致 |
| SY-08 |
预约统计 |
三类年度合计与按月堆叠与 §2.7 一致 |
| SY-09 |
补贴金额 |
三类金额为 Y 年发放日记录金额合计 |
| SY-10 |
养殖标准 |
仅 Y 年创建且已发布；分页；行内详情无跳转 |
| SY-11 |
农技课堂 |
视频数、培训场次与 §2.10 一致 |
| SY-12 |
培训报名趋势 |
活动数、报名人数按月与 §2.11 一致 |
| SY-13 |
后台补录后刷新 |
补录后刷新大屏可见新数据 |
| SY-14 |
只读 |
页面无业务维护按钮 |
9. 修订记录
| 版本 |
日期 |
说明 |
| 1.0 |
2026-05-25 |
由草稿优化：补全流程、边界、十区块需求；对齐养殖产业/预约/补贴/标准/培训口径；不涉及库表与接口；保留草稿不修改 |
10. 相对草稿的优化说明
| 草稿问题 |
处理方式 |
| 仅条目罗列 |
增加 §3、§4、§7、§8 与 mermaid 流程 |
| 「当前年份」对主数据含糊 |
§2.4、§2.6 区分年内累计、时点还原、实时快照 |
| 未写出栏按月、缺月规则 |
§2.3、§2.5、§5.5 |
| 养殖标准仅一句 |
§2.9、§5.9 补 Tab、纳入条件、行内详情 |
| 专家人员未对应编码 |
§2.7 明确 004005 |
| 技术栈、统一响应格式 |
属技术方案，不写入本文档 |
| 草稿未列预警牦牛 |
首页总览按草稿八项；预警留在养殖产业专看板 |
