# 大屏可视化系统需求文档

## 1. 系统概述

大屏可视化系统是锡林郭勒盟智慧养殖产业平台的重要组成部分，主要用于展示锡林郭勒盟地区智慧养殖产业的整体数据、实时监控信息和分析结果。通过直观的图表和数据可视化方式，为管理者提供全面的产业洞察，支持决策制定。

## 2. 功能需求

### 2.1 产业概览模块
- **整体产业规模展示**：展示牛只总数、牧场数量等关键指标（数据来源：`/api/v1/dashboard/overview`，数据库表：`industry_overview`）
- **产值和增长率关键指标**：展示年度产值、增长率趋势图（数据刷新频率：每5秒一次，数据来源：`/api/v1/dashboard/growth`）
- **数据可视化图表**：通过 DataV 组件展示品种分布、区域分布等（支持动态缩放和拖拽）
- **实时数据更新机制**：通过 WebSocket 实现数据实时更新（`ws://<host>/api/v1/dashboard/realtime`）
- **数据钻取功能**：支持点击图表查看详细数据（弹窗展示，含数据导出按钮）
- **多维度数据筛选**：支持按时间、区域、品种等维度筛选（交互：下拉选择器 + 确认按钮）
- **首页地图展示**：在首页集成锡林郭勒盟区域地图，展示各区域牛只分布、牧场位置、产业热点等信息（交互：点击区域查看详细数据）

### 2.2 养殖监控模块
- **各牧场养殖情况展示**：通过 DataV 地图组件展示各牧场位置和规模（数据来源：`/api/v1/dashboard/farms`，数据库表：`farm_locations`）
- **环境数据实时监控**：展示温湿度、氨气浓度等传感器数据（刷新频率：每3秒一次，数据来源：`/api/v1/dashboard/environment`）
- **异常情况告警**：展示环境异常、健康异常等告警信息（交互：点击告警跳转到详情页）
- **历史数据趋势分析**：展示环境数据历史趋势图（支持时间范围选择：1天/7天/30天）
- **牛只健康状态监控**：展示健康、亚健康、患病牛只数量统计（数据来源：`/api/v1/dashboard/health`）
- **饲养记录统计**：展示饲料消耗、投喂量趋势（交互：悬停显示具体数值）

### 2.3 金融服务模块
- **贷款统计展示**：展示贷款申请数、放款总额、还款情况（数据来源：`/api/v1/dashboard/loans`，数据库表：`loan_records`）
- **保险统计展示**：展示投保数量、保费总额、理赔情况（数据来源：`/api/v1/dashboard/insurance`）
- **风险数据展示**：展示高风险贷款、理赔率高的牧场等（交互：点击跳转到风险管理页）
- **金融服务趋势分析**：展示贷款和保险业务增长趋势（支持按季度/年度切换）

### 2.4 交易统计模块
- **牛只交易量统计**：展示日交易量、月交易量、年度交易量（数据来源：`/api/v1/dashboard/transactions`，数据库表：`transaction_logs`）
- **价格趋势和区域分布**：展示价格热力图、区域价格对比（交互：点击区域高亮显示）
- **交易类型分析**：分析活牛交易、牛肉制品销售等（数据来源：`/api/v1/dashboard/transaction-types`）
- **交易排行榜**：展示热门牧场、活跃交易员等（交互：点击名称查看详情）

### 2.5 运输跟踪模块
- **牛只运输实时状态**：展示运输路线、当前位置、预计到达时间（数据来源：`/api/v1/dashboard/transport`，数据库表：`transport_logs`）
- **运输车辆监控**：展示车辆状态、司机信息等（交互：点击车辆查看实时视频）
- **运输异常告警**：展示延误、偏离路线等异常情况（数据来源：`/api/v1/dashboard/transport-alerts`）
- **运输效率分析**：展示运输时间、成本等统计（支持导出为Excel）

### 2.6 风险预警模块
- **风险事件展示**：展示疫病风险、市场风险、自然灾害风险等（数据来源：`/api/v1/dashboard/risks`）
- **预警信息推送**：分类展示不同级别预警（交互：点击预警订阅通知）
- **风险趋势分析**：展示各类风险的历史趋势和预测（支持自定义时间范围）
- **风险地图**：按区域展示风险分布（交互：点击区域查看详情）

### 2.7 生态指标模块
- **环保数据展示**：展示碳排放、水资源使用、饲料消耗等（数据来源：`/api/v1/dashboard/eco`）
- **可持续发展指标**：展示草畜平衡、生态效益等（交互：悬停显示计算方式）
- **环保趋势分析**：展示环保指标的历史变化趋势（支持同比/环比对比）
- **生态效益评估**：展示经济效益与生态效益的平衡分析（数据来源：`/api/v1/dashboard/eco-balance`）

### 2.8 政府监管模块
- **监管数据总览**：展示防疫完成率、补贴发放情况等（数据来源：`/api/v1/dashboard/gov`）
- **合规性检查结果**：展示合规牧场比例、违规事件统计等（交互：点击违规事件查看整改记录）
- **政策执行效果分析**：展示政策实施后的数据变化（支持多政策对比）
- **监管报告生成**：展示自动生成的监管报告可视化（支持PDF导出）

## 3. 非功能需求

### 3.1 性能需求
- **响应时间**：页面加载 ≤1秒，数据查询 ≤2秒
- **数据更新延迟**：实时数据 ≤3秒（WebSocket推送）
- **并发支持**：同时展示10个图表（DataV优化渲染）
- **大数据量**：支持10万条数据流畅渲染（虚拟滚动）

### 3.2 兼容性需求
- **屏幕比例**：适配16:9、4:3等常见比例
- **分辨率**：支持1080p至8K
- **浏览器**：Chrome、Firefox、Safari、Edge最新版

### 3.3 安全需求
- **传输加密**：HTTPS + WSS（WebSocket Secure）
- **日志审计**：操作日志保留6个月
- **防护措施**：防SQL注入、XSS攻击

### 3.4 可用性需求
- **可用性**：99.9% SLA
- **错误提示**：中英文双语错误信息
- **异常处理**：自动重试3次 + 降级展示
- **全屏模式**：一键切换全屏/窗口模式

### 3.5 可维护性需求
- **架构**：微服务设计（模块解耦）
- **监控**：集成Prometheus + Grafana
- **日志**：结构化日志（ELK收集）

## 4. 术语表
- **数据钻取**：通过点击图表查看详细数据的交互方式
- **虚拟滚动**：动态加载大数据量的优化技术
- **SLA**：服务等级协议（可用性指标）