docs: 更新项目文档和数据库设计,添加官网相关功能

This commit is contained in:
ylweng
2025-08-20 03:01:14 +08:00
parent 47c67ff704
commit fdc58aa3a2
58 changed files with 37635 additions and 28437 deletions

View File

@@ -12,7 +12,7 @@ xlxumu - 锡林郭勒盟地区养殖产业平台
- 构建完整的畜牧业数字化管理生态系统
- 实现养殖过程可视化、监管实时化、交易透明化
- 提升产业链协同效率
- 促进锡林郭勒盟安格斯牛品牌建设
- 促进锡林郭勒盟智慧养殖品牌建设
## 2. 非功能需求

View File

@@ -0,0 +1,78 @@
# 官网需求文档
## 1. 系统概述
官网是锡林郭勒盟地区智慧养殖产业平台的对外展示窗口,主要用于宣传平台功能、展示产业动态、发布新闻资讯以及提供用户访问入口。通过官网,用户可以了解平台的核心价值和服务内容。
## 2. 功能需求
### 2.1 首页展示
- **平台介绍展示**:在英雄区域展示平台的核心功能和价值主张
- **核心功能模块展示**:以卡片形式展示六大核心功能模块(数字化养殖管理、活体抵押贷款、养殖保险监管、政府监管平台、线上活牛交易、优质牛肉商城)
- **数据可视化展示**:以图表形式展示部分公开的产业数据(牲畜存栏量统计、牧草产量与价格趋势)
- **行业动态展示**:展示最新的产业新闻和市场动态
- **联系信息展示**:提供平台联系方式和地址信息
### 2.2 导航功能
- **顶部导航栏**:提供首页、平台功能、数据看板、行业动态、关于我们等页面导航
- **锚点导航**:支持页面内锚点跳转
- **响应式导航**:移动端自适应折叠导航菜单
### 2.3 数据可视化
- **牲畜存栏量统计图表**:以柱状图展示不同牲畜的存栏量数据
- **牧草产量与价格趋势图表**:以折线图展示牧草产量与价格的变化趋势
- **图表交互功能**:支持图表的响应式显示和交互操作
### 2.4 新闻资讯
- **新闻列表展示**:按时间顺序展示平台相关新闻和行业资讯
- **新闻分类标签**:通过标签区分不同类型的新闻(政策解读、市场动态、技术前沿)
- **新闻详情查看**:用户可以点击查看新闻详细内容
- **查看更多功能**:提供查看更多新闻的入口
### 2.5 用户交互
- **平滑滚动**:页面内导航支持平滑滚动效果
- **悬停效果**:功能卡片等元素支持悬停动画效果
- **响应式设计**:适配不同屏幕尺寸的设备
### 2.6 页脚信息
- **平台介绍**:简要介绍平台定位和目标
- **快速链接**:提供主要页面的快速访问链接
- **联系方式**:展示联系地址、电话和邮箱等信息
- **社交媒体链接**提供微信、微博、YouTube等社交媒体链接
- **法律信息**:提供隐私政策和使用条款链接
## 3. 非功能需求
### 3.1 性能需求
- 页面加载时间不超过3秒
- 支持1000+并发用户访问
- 图片和静态资源需要优化加载
### 3.2 兼容性需求
- 兼容所有主流浏览器Chrome、Firefox、Safari、Edge
- 支持移动端浏览和响应式显示
- 适配不同分辨率屏幕
### 3.3 安全需求
- 防止XSS攻击和SQL注入
- 敏感信息传输加密
- 定期安全漏洞扫描
### 3.4 可用性需求
- 界面简洁美观,符合草原文化特色
- 导航清晰,用户可以快速找到所需信息
- 提供友好的错误提示信息
## 4. 用户角色
### 4.1 普通访客
- 可以浏览官网所有公开内容
- 可以查看新闻资讯
- 可以了解平台功能介绍
- 可以查看公开的统计数据
### 4.2 管理员
- 可以发布和管理新闻资讯
- 可以更新平台介绍内容
- 可以管理合作伙伴信息
- 可以更新数据可视化内容

View File

@@ -2,157 +2,92 @@
## 1. 系统概述
大屏可视化系统是锡林郭勒盟安格斯牛养殖产业平台的重要组成部分,主要用于展示锡林郭勒盟地区安格斯牛养殖产业的整体数据、实时监控信息和分析结果。通过直观的图表和数据可视化方式,为管理者提供全面的产业洞察,支持决策制定。
大屏可视化系统是锡林郭勒盟智慧养殖产业平台的重要组成部分,主要用于展示锡林郭勒盟地区智慧养殖产业的整体数据、实时监控信息和分析结果。通过直观的图表和数据可视化方式,为管理者提供全面的产业洞察,支持决策制定。
## 2. 功能需求
### 2.1 产业概览模块
- **整体产业规模展示**:展示牛只总数、牧场数量等关键指标
- **产值和增长率关键指标**:展示年度产值、增长率趋势图
- **数据可视化图表**:通过饼图展示品种分布、柱状图展示区域分布
- **实时数据更新机制**通过WebSocket实现数据实时更新
- **数据钻取功能**:支持点击图表查看详细数据
- **多维度数据展示**:支持按时间、区域、品种等维度筛选
- **整体产业规模展示**:展示牛只总数、牧场数量等关键指标(数据来源:`/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. 非功能需求
### 3.1 政府监管人员
- 可以查看所有模块的数据和图表
- 可以导出数据报告
- 可以配置部分展示参数
### 3.1 性能需求
- **响应时间**:页面加载 ≤1秒数据查询 ≤2秒
- **数据更新延迟**:实时数据 ≤3秒WebSocket推送
- **并发支持**同时展示10个图表DataV优化渲染
- **大数据量**支持10万条数据流畅渲染虚拟滚动
### 3.2 系统管理员
- 拥有所有功能权限
- 可以配置系统参数
- 可以管理用户权限
### 3.2 兼容性需求
- **屏幕比例**适配16:9、4:3等常见比例
- **分辨率**支持1080p至8K
- **浏览器**Chrome、Firefox、Safari、Edge最新版
## 4. 非功能需求
### 3.3 安全需求
- **传输加密**HTTPS + WSSWebSocket Secure
- **日志审计**操作日志保留6个月
- **防护措施**防SQL注入、XSS攻击
### 4.1 性能需求
- 系统响应时间小于2秒
- 数据更新延迟不超过5秒
- 支持同时展示多个数据图表
- 大数据量渲染优化,确保流畅显示
### 3.4 可用性需求
- **可用性**99.9% SLA
- **错误提示**:中英文双语错误信息
- **异常处理**自动重试3次 + 降级展示
- **全屏模式**:一键切换全屏/窗口模式
### 4.2 兼容性需求
- 支持多种大屏比例(16:9, 4:3等)
- 适配不同分辨率的大屏设备
- 支持主流浏览器Chrome、Firefox、Safari、Edge
### 3.5 可维护性需求
- **架构**:微服务设计(模块解耦)
- **监控**集成Prometheus + Grafana
- **日志**结构化日志ELK收集
### 4.3 安全需求
- 用户身份认证和权限控制
- 数据传输加密HTTPS
- 操作日志记录和审计
- 防止SQL注入和XSS攻击
### 4.4 可用性需求
- 系统全年可用性达到99.9%
- 提供友好的错误提示信息
- 实现异常处理和恢复机制
- 支持全屏显示模式
### 4.5 可维护性需求
- 微服务架构设计,降低模块间耦合
- 完善的日志记录和监控
- 支持配置文件与代码分离
- 提供完善的API文档
## 5. 技术要求
### 5.1 前端技术栈
- **框架**Vue.js 3
- **可视化库**ECharts
- **构建工具**Vite
- **状态管理**Pinia
- **响应式设计**:支持多种大屏比例
### 5.2 实时数据
- **数据推送**WebSocket实时数据推送
- **数据更新**:支持实时、定时和手动刷新
### 5.3 设计规范
- **主题风格**:深色科技风格背景
- **色彩搭配**:草原绿色系为主,科技蓝为辅
- **字体规范**:清晰易读的字体设计
- **布局结构**:合理的数据展示区域分布
## 6. 数据接口需求
### 6.1 养殖管理相关接口
- 牛只档案数据接口(获取牛只总数、品种分布等)
- 环境监测数据接口(获取实时环境数据)
- 饲养记录数据接口(获取饲料消耗、投喂量等数据)
### 6.2 金融服务相关接口
- 贷款申请数据接口(获取贷款申请数、放款总额等)
- 保险保单数据接口(获取投保数量、保费总额等)
- 理赔数据接口(获取理赔情况)
### 6.3 交易相关接口
- 活牛交易数据接口(获取交易量、价格等数据)
- 商城订单数据接口(获取销售数据、热门商品等)
### 6.4 政府监管相关接口
- 防疫数据接口(获取防疫完成率等数据)
- 补贴发放数据接口(获取补贴发放情况)
### 6.5 数据分析相关接口
- 预警信息接口(获取各类风险预警信息)
- 分析报告接口(获取各类分析报告数据)
## 7. 部署要求
### 7.1 部署环境
- 支持Docker容器化部署
- 支持云平台部署
- 支持本地服务器部署
### 7.2 监控需求
- 实现系统运行状态监控
- 提供性能监控指标
- 支持异常告警功能
- 日志收集和分析
## 4. 术语表
- **数据钻取**:通过点击图表查看详细数据的交互方式
- **虚拟滚动**:动态加载大数据量的优化技术
- **SLA**:服务等级协议(可用性指标)