# 系统架构文档 ## 1. 概述 本项目是一个综合性的畜牧业数字化管理平台，主要面向锡林郭勒盟地区的养殖产业，包含官网展示、后台管理、移动端小程序、大屏可视化等多个子系统。平台集成了养殖管理、金融服务（银行监管、保险监管）、政府监管、牛只交易、牛肉商城、数据分析等功能模块，旨在通过数字化手段提升整个产业链的管理效率和透明度。 ## 2. 技术栈 ### 2.1 前端技术栈 - **官网首页**: HTML5 + CSS3 + JavaScript - **后台管理系统**: Vue.js 3 + TypeScript + Ant Design Vue + Pinia - **大屏可视化系统**: Vue.js 3 + ECharts + 自定义可视化组件 - **微信小程序矩阵**: 微信小程序原生开发 + uni-app ### 2.2 后端技术栈 - **API服务**: Node.js + Express.js + TypeScript + RESTful API - **数据库**: MySQL - **缓存系统**: Redis - **消息队列**: RabbitMQ（用于异步处理） - **文件存储**: 腾讯云对象存储 - **实时通信**: WebSocket（用于大屏数据推送和实时通知） ### 2.3 数据库配置 #### 2.3.1 测试环境 - **主机**: `192.168.0.240` (MySQL主机地址) - **端口**: `3306` (MySQL端口) - **用户名**: `root` - **密码**: `aiot$Aiot123` - **数据库**: `xlxumudata` #### 2.3.2 生产环境 - **主机**: `129.211.213.226` - **端口**: `9527`（端口号） - **用户名**: `root` - **密码**: `aiotAiot123!` - **数据库**: `xlxumudata` ### 2.4 安全架构 - **身份认证**: JWT (JSON Web Tokens) - **权限管理**: 基于角色的访问控制 (RBAC) - **数据传输**: HTTPS 加密传输 - **API防护**: 接口限流、参数校验、防SQL注入等 - **密码安全**: BCrypt加密存储 - **操作审计**: 用户操作日志记录和审计 ### 2.5 数据架构 - **实时数据采集**: IoT设备数据接入 - **数据处理**: ETL数据处理流程 - **数据存储**: 分层数据存储（操作数据、历史数据、统计数据） - **大数据分析**: 数据分析引擎 - **智能预警**: 基于规则的预警系统 - **可视化展示**: 图表化数据展示平台 ## 3. 系统架构图 ``` ┌─────────────────────────────────────────────────────────────────────────────────────────────┐ │ 用户端接入层 │ ├─────────────────┬─────────────────────────────────────────────────────────────────────────┤ │ 官网首页 │ 专业管理系统 │ │ (HTML5展示) ├─────────────────────────────────────────────────────────────────────────┤ │ │ - 养殖管理系统 (Vue.js 3 + Ant) │ │ │ - 银行监管系统 (Vue.js 3 + Ant) │ │ │ - 保险监管系统 (Vue.js 3 + Ant) │ │ │ - 政府监管平台 (Vue.js 3 + Ant) │ │ │ - 活牛交易系统 (Vue.js 3 + Ant) │ │ │ - 商城管理系统 (Vue.js 3 + Ant) │ │ │ - 大屏可视化系统 (Vue.js 3 + ECharts) │ ├─────────────────┼─────────────────────────────────────────────────────────────────────────┤ │ 微信小程序矩阵 │ │ - 牛肉商城小程序 │ │ - 养殖管理小程序 │ │ - 银行监管小程序 │ │ - 保险监管小程序 │ │ - 活牛交易小程序 │ │ - 政府监管小程序 │ │ - 数据中台小程序 │ │ - AI能力小程序 │ ├─────────────────┴─────────────────────────────────────────────────────────────────────────┤ │ API服务层 (Node.js) │ ├─────────────────────────────────────────────────────────────────────────────────────────────┤ │ 数据处理与存储层 │ ├─────────────────────────────────────────────────────────────────────────────────────────────┤ │ 关系数据库(MySQL) │ 缓存系统(Redis) │ 消息队列(RabbitMQ) │ 文件存储(腾讯云) │ ├─────────────────────────────────────────────────────────────────────────────────────────────┤ │ 数据分析与展示层 │ ├─────────────────────────────────────────────────────────────────────────────────────────────┤ │ 大数据分析引擎 │ 智能预警系统 │ 可视化平台 │ 实时数据推送 │ └─────────────────────────────────────────────────────────────────────────────────────────────┘ ``` ## 4. 前端系统架构 ### 4.1 官网首页系统 - 纯HTML5、CSS3、JavaScript实现 - 响应式设计，适配多种设备 - 突出锡林郭勒盟地域元素和蒙古族文化特色 - 绿色草原主题风格 ### 4.2 专业管理系统 #### 4.2.1 养殖管理系统 - 基于Vue.js 3 Composition API - 使用Ant Design Vue组件库 - 状态管理采用Pinia - TypeScript增强代码可维护性 ##### 功能模块 1. 牛只档案管理 2. 饲养记录管理 3. 繁殖管理 4. 环境监测数据展示 5. 健康监测管理 6. 生产计划制定和执行跟踪 #### 4.2.2 银行监管系统 - 基于Vue.js 3 Composition API - 使用Ant Design Vue组件库 - 状态管理采用Pinia - TypeScript增强代码可维护性 ##### 功能模块 1. 贷款申请和审批流程管理 2. 质押物（牛只）状态监控 3. 还款计划跟踪 4. 风险评估数据展示 5. 财务报表生成 6. 风控管理 #### 4.2.3 保险监管系统 - 基于Vue.js 3 Composition API - 使用Ant Design Vue组件库 - 状态管理采用Pinia - TypeScript增强代码可维护性 ##### 功能模块 1. 保险投保管理 2. 理赔申请和处理流程 3. 风险评估和预警 4. 保险记录查询 5. 数据统计分析 #### 4.2.4 政府监管平台 - 基于Vue.js 3 Composition API - 使用Ant Design Vue组件库 - 状态管理采用Pinia - TypeScript增强代码可维护性 ##### 功能模块 1. 产业数据总览 2. 各类监管数据汇总 3. 政策发布和通知 4. 合规性检查 5. 统计报表生成 6. 用户管理（集中式用户权限管理） 7. 系统配置管理 #### 4.2.5 活牛交易系统 - 基于Vue.js 3 Composition API - 使用Ant Design Vue组件库 - 状态管理采用Pinia - TypeScript增强代码可维护性 ##### 功能模块 1. 牛只信息发布和展示 2. 在线交易撮合 3. 合同管理 4. 支付流程管理 5. 交易记录查询 6. 商户管理 7. 行情管理 #### 4.2.6 商城管理系统 - 基于Vue.js 3 Composition API - 使用Ant Design Vue组件库 - 状态管理采用Pinia - TypeScript增强代码可维护性 ##### 功能模块 1. 商品信息管理 2. 库存管理 3. 订单处理 4. 物流跟踪 5. 售后服务管理 6. 营销管理 #### 4.2.7 大屏可视化系统 - 基于Vue.js 3 Composition API - 使用ECharts和自定义可视化组件 - 状态管理采用Pinia - TypeScript增强代码可维护性 - WebSocket实现实时数据推送 ##### 功能模块 1. 产业概览 2. 养殖监控 3. 金融服务 4. 交易统计 5. 运输跟踪 6. 风险预警 7. 生态指标 8. 政府监管 ### 4.3 微信小程序矩阵 - 使用微信小程序原生开发框架 - 跨平台支持采用uni-app - 包含8个专门的小程序应用 #### 4.3.1 牛肉商城小程序（消费者端） - 商品浏览和搜索 - 在线下单和支付 - 订单查询和跟踪 - 售后服务申请 - **认养功能**：用户可以认养特定牛只，跟踪其成长过程 #### 4.3.2 养殖管理小程序（牧民端） - 移动端牛只档案查看 - 饲养记录录入 - 健康状况上报 - 通知消息接收 - 数据统计查看 #### 4.3.3 银行监管小程序（银行端） - 移动端贷款审批 - 质押物状态查看 - 风险数据监控 - 移动办公支持 #### 4.3.4 保险监管小程序（保险端） - 移动端保险处理 - 理赔流程管理 - 风险评估查看 - 移动查勘支持 #### 4.3.5 活牛交易小程序（交易员端） - 活牛信息发布 - 在线交易撮合 - 合同查看和管理 - 交易记录查询 - 支付状态跟踪 #### 4.3.6 政府监管小程序（监管人员端） - 防疫任务执行 - 补贴申请审核 - 政策信息查看 - 监管数据上报 #### 4.3.7 数据中台小程序（数据人员端） - 数据查询和导出 - 统计报表查看 - 数据服务申请 #### 4.3.8 AI能力小程序（养殖户/兽医端） - 牛只体况评估 - 饲料配方推荐 - 智能诊断辅助 ## 5. 后端系统架构 ### 5.1 API服务层 - 基于Node.js和Express.js构建 - 使用TypeScript增强代码健壮性 - RESTful API设计风格 - JWT身份认证机制 - 微服务架构设计（按业务模块划分） ### 5.2 数据存储层 - 主数据库：MySQL关系型数据库 - 缓存系统：Redis（用于会话缓存、数据缓存） - 消息队列：RabbitMQ（用于异步任务处理） - 文件存储：腾讯云对象存储服务 - 日志存储：Elasticsearch（用于日志分析） ### 5.3 安全架构 - 基于JWT的无状态认证 - RBAC角色权限管理系统（集中式用户管理） - HTTPS加密传输 - API接口安全防护（限流、防注入等） - 数据加密存储（BCrypt等） - 操作日志审计 ### 5.4 数据分析层 - 实时数据采集系统（IoT设备数据、用户行为数据） - 大数据分析引擎 - 智能预警系统 - 数据可视化展示平台 ## 6. 项目结构 ``` . ├── frontend/ # 前端项目 │ ├── website/ # 官网首页 │ ├── farming-management/ # 养殖管理系统 │ ├── bank-supervision/ # 银行监管系统 │ ├── insurance-supervision/ # 保险监管系统 │ ├── government-platform/ # 政府监管平台 │ ├── cattle-trading/ # 活牛交易系统 │ ├── mall-management/ # 商城管理系统 │ ├── dashboard/ # 大屏可视化系统 │ └── mini-programs/ # 微信小程序矩阵 │ ├── beef-mall/ # 牛肉商城小程序 │ ├── farming-manager/ # 养殖管理小程序 │ ├── bank-supervision/ # 银行监管小程序 │ ├── insurance-supervision/ # 保险监管小程序 │ ├── cattle-trading/ # 活牛交易小程序 │ ├── gov-supervision/ # 政府监管小程序 │ ├── data-platform/ # 数据中台小程序 │ └── ai-capabilities/ # AI能力小程序 ├── backend/ # 后端项目 │ ├── api/ # API服务 │ │ ├── farming/ # 养殖管理API │ │ ├── finance/ # 金融服务API │ │ ├── government/ # 政府监管API │ │ ├── trade/ # 交易管理API │ │ ├── mall/ # 商城管理API │ │ ├── data-platform/ # 数据中台API │ │ ├── ai/ # AI能力API │ │ └── user-center/ # 用户中心API │ ├── database/ # 数据库脚本 │ ├── utils/ # 工具函数 │ └── services/ # 微服务模块 ├── docs/ # 文档 └── deployment/ # 部署相关配置 ``` ## 7. 用户权限管理架构 ### 7.1 集中式用户管理 - 所有用户信息统一在政府监管平台进行管理 - 各子系统仅负责登录验证和部分权限校验 - 实现统一的RBAC权限模型 ### 7.2 权限体系 - 基于角色的访问控制（RBAC） - 支持多角色分配 - 细粒度权限控制（菜单权限、操作权限、数据权限） - 权限继承机制 ### 7.3 用户角色 1. 超级管理员 2. 政府监管员 3. 银行信贷员 4. 保险专员 5. 交易管理员 6. 商城管理员 7. 养殖户 8. 普通用户 9. 数据分析师 10. 系统审计员 ## 8. 大屏可视化系统架构 ### 8.1 系统概述 大屏可视化系统是本项目的重要组成部分，主要用于展示锡林郭勒盟安格斯牛养殖产业的整体数据、实时监控信息和分析结果。通过直观的图表和数据可视化方式，为管理者提供全面的产业洞察。 ### 8.2 技术实现 - **前端框架**: Vue.js 3 + ECharts + 自定义可视化组件 - **可视化库**: Apache ECharts + D3.js - **响应式设计**: 支持多种大屏比例(16:9, 4:3等) - **实时数据**: WebSocket实时数据推送 - **性能优化**: 虚拟滚动、数据分页等技术 ### 8.3 功能模块 1. **产业概览**: 展示整体产业规模、产值、增长率等关键指标 2. **养殖监控**: 实时展示各牧场的养殖情况、环境数据 3. **金融服务**: 展示贷款、保险等金融服务数据 4. **交易统计**: 牛只交易量、价格趋势、区域分布等数据 5. **运输跟踪**: 牛只运输实时状态和路径展示 6. **风险预警**: 风险事件展示和预警信息推送 7. **生态指标**: 环保数据、可持续发展指标展示 8. **政府监管**: 展示政府监管相关数据和政策执行效果 ### 8.4 设计特色 - 融入锡林郭勒盟草原绿色主题 - 采用蒙古族文化元素的UI设计 - 突出安格斯牛品牌形象 - 支持多维度数据钻取和交互 ## 9. 系统集成架构 ### 9.1 外部系统集成 1. 银行系统对接 2. 政府监管平台对接 3. 第三方系统集成（LDAP/AD、OAuth2.0等） 4. 物联网设备集成（MQTT/CoAP协议） 5. 云服务集成（腾讯云COS、短信服务等） ### 9.2 数据交换机制 - RESTful API接口 - 消息队列异步处理 - 文件传输 - 数据库同步 ## 10. 性能优化策略 ### 10.1 前端优化 - 代码分割和按需加载 - 图片懒加载和压缩 - CDN加速静态资源 - 浏览器缓存策略 - 虚拟滚动处理大数据量展示 ### 10.2 后端优化 - 数据库索引优化 - API响应缓存（Redis） - 数据库连接池 - 负载均衡部署 - 异步任务处理（RabbitMQ） ## 11. 部署架构 ### 11.1 开发环境 - 本地开发服务器 - 热重载功能 - 代理配置解决跨域问题 ### 11.2 生产环境 - Nginx反向代理服务器 - 负载均衡配置 - SSL证书配置 - 日志收集和监控系统 - 容器化部署（Docker） - 自动化部署（CI/CD）