# 宁夏智慧养殖监管平台
**现代化的智慧养殖监管平台，集成IoT设备监控、动物健康管理、数据可视化分析等功能**
[功能特性](#功能特性) • [快速开始](#快速开始) • [项目架构](#项目架构) • [文档](#文档) • [贡献指南](#贡献指南)
## 📋 项目概述
宁夏智慧养殖监管平台是一个现代化的农场管理系统，旨在通过数字化手段提升养殖业的管理效率和监管水平。系统采用前后端分离架构，支持多端访问，为养殖场管理者、监管部门和相关机构提供全方位的智慧养殖解决方案。
### 🎯 核心价值
- **智能监控**：实时监控养殖环境和设备状态
- **数据驱动**：基于大数据分析的决策支持
- **全程追溯**：完整的养殖过程记录和追溯
- **多端协同**：支持Web端、小程序等多平台访问
- **安全可靠**：企业级安全防护和数据保护
## ✨ 功能特性
### 🏭 核心业务模块
- **🏢 养殖场管理**：养殖场信息、圈舍管理、电子围栏
- **🐄 动物健康管理**：牲畜档案、健康监测、批次管理
- **📱 IoT设备监控**：传感器数据、设备状态、实时告警
- **📊 数据可视化**：统计分析、图表展示、决策支持
- **👥 用户权限管理**：多角色权限、操作审计、安全控制
- **🛒 产品订单管理**：产品销售、订单处理、库存管理
- **⚠️ 预警管理**：智能告警、异常处理、风险预防
### 🌐 多端支持
- **管理后台**：基于Vue 3的现代化管理界面
- **数据大屏**：实时数据展示和监控大屏
- **官方网站**：产品展示和信息发布
- **小程序矩阵**：
- 银行端小程序：金融服务支持
- 政府端小程序：监管和政策发布
- 保险端小程序：保险服务管理
### 🛠️ 技术特性
- **现代化技术栈**：Vue 3 + Node.js + MySQL
- **响应式设计**：适配多种设备和屏幕尺寸
- **实时通信**：WebSocket支持实时数据推送
- **地图集成**：百度地图API地理信息展示
- **性能监控**：完整的系统性能监控体系
- **API文档**：Swagger自动生成API文档
## 🚀 快速开始
### 环境要求
- **Node.js**: 16.20.2+
- **MySQL**: 8.0+
- **npm**: 8.0.0+
### 安装步骤
1. **克隆项目**
```bash
git clone
cd nxxmdata
```
2. **安装依赖**
```bash
# 安装后端依赖
cd backend
npm install
# 安装前端依赖
cd ../admin-system
npm install
# 安装数据大屏依赖
cd ../datav
npm install
```
3. **配置环境**
```bash
# 复制环境配置文件
cp backend/.env.example backend/.env
cp admin-system/.env.example admin-system/.env
# 编辑配置文件，设置数据库连接等信息
```
4. **初始化数据库**
```bash
cd backend
npm run init-db
```
5. **启动服务**
```bash
# 启动后端服务 (端口: 5000)
cd backend
npm run dev
# 启动管理后台 (端口: 5173)
cd admin-system
npm run dev
# 启动数据大屏 (端口: 5174)
cd datav
npm run dev
```
### 访问地址
- **管理后台**: http://localhost:5173
- **数据大屏**: http://localhost:5174
- **API文档**: http://localhost:5000/api-docs
- **官方网站**: 直接打开 `website/index.html`
## 🏗️ 项目架构
```
nxxmdata/
├── 📁 backend/ # 后端API服务
│ ├── config/ # 配置文件
│ ├── controllers/ # 控制器
│ ├── models/ # 数据模型
│ ├── routes/ # 路由定义
│ ├── middleware/ # 中间件
│ └── utils/ # 工具类
├── 📁 admin-system/ # 管理后台前端
│ ├── src/ # 源代码
│ ├── components/ # 组件库
│ └── views/ # 页面视图
├── 📁 datav/ # 数据可视化大屏
├── 📁 website/ # 官方网站
├── 📁 bank_mini_program/ # 银行端小程序
├── 📁 government-mini-program/ # 政府端小程序
├── 📁 insurance_mini_program/ # 保险端小程序
├── 📁 docs/ # 项目文档
└── 📁 scripts/ # 脚本工具
```
### 技术栈
**后端技术栈**
- Node.js 16.20.2 + Express.js
- Sequelize ORM + MySQL 8.0
- JWT认证 + bcryptjs加密
- Swagger API文档
- Winston日志系统
**前端技术栈**
- Vue 3.4.15 + Vite
- Ant Design Vue 4.0
- ECharts 5.4 数据可视化
- Pinia 状态管理
- Axios HTTP客户端
## 📚 文档
### 核心文档
- [📋 产品需求文档](docs/config/PRD.md) - 详细的业务需求和功能规格
- [🏗️ 系统架构文档](docs/config/arch.md) - 技术架构和系统设计
- [🔧 开发指南](docs/DEVELOPMENT.md) - 开发环境搭建和开发规范
- [🚀 部署指南](docs/DEPLOYMENT.md) - 生产环境部署说明
- [📖 API文档](docs/API.md) - 接口设计和使用说明
### 专项文档
- [🏦 银行端小程序文档](docs/银行端小程序产品需求文档.md)
- [🏛️ 政府端小程序文档](docs/政府端产品需求文档.md)
- [🛡️ 保险端小程序文档](docs/保险端产品需求文档.md)
- [🔒 安全说明](docs/SECURITY.md)
- [❓ 故障排除](docs/TROUBLESHOOTING.md)
## 🤝 贡献指南
我们欢迎所有形式的贡献！请阅读 [贡献指南](docs/CONTRIBUTING.md) 了解如何参与项目开发。
### 开发流程
1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request
### 代码规范
- 遵循 ESLint 配置
- 使用语义化提交信息
- 编写单元测试
- 更新相关文档
## 📄 许可证
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
## 📞 联系我们
- **项目维护者**: NXXM Development Team
- **技术支持**: [创建Issue](../../issues)
- **文档反馈**: [文档仓库](docs/)
## 🙏 致谢
感谢所有为项目做出贡献的开发者和用户！
---
**⭐ 如果这个项目对你有帮助，请给我们一个星标！**
Made with ❤️ by NXXM Development Team