121 lines
3.5 KiB
Markdown
121 lines
3.5 KiB
Markdown
|
# 宁夏智慧养殖监管平台
|
|||
|
|
|
|||
|
|
## 项目概述
|
|||
|
|
|
|||
|
|
宁夏智慧养殖监管平台是一个现代化的农场管理系统，提供实时监控、数据分析和多终端访问功能。
|
|||
|
|
|
|||
|
|
## 目录结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
nxxmdata/
|
|||
|
|
├── backend/ # 后端服务 (Node.js + Express + Sequelize)
|
|||
|
|
│ ├── config/ # 配置文件
|
|||
|
|
│ ├── controllers/ # 业务逻辑控制器
|
|||
|
|
│ ├── models/ # 数据模型
|
|||
|
|
│ ├── routes/ # API路由
|
|||
|
|
│ ├── middleware/ # 中间件
|
|||
|
|
│ ├── utils/ # 工具类
|
|||
|
|
│ ├── migrations/ # 数据库迁移
|
|||
|
|
│ ├── seeds/ # 种子数据
|
|||
|
|
│ └── server.js # 服务器入口
|
|||
|
|
├── admin-system/ # 管理后台 (Vue.js 3.x)
|
|||
|
|
│ └── frontend/ # 前端项目
|
|||
|
|
├── website/ # 官网 (Vue.js 3.x)
|
|||
|
|
│ └── data-screen/ # 数据大屏展示
|
|||
|
|
├── mini_program/ # 微信小程序矩阵
|
|||
|
|
│ └── farm-monitor-dashboard/ # 监控仪表盘小程序
|
|||
|
|
├── scripts/ # 执行脚本目录
|
|||
|
|
│ ├── init-db.js # 数据库初始化
|
|||
|
|
│ ├── migration-manager.js # 迁移管理
|
|||
|
|
│ ├── seed-manager.js # 种子数据管理
|
|||
|
|
│ ├── test-connection.js # 连接测试
|
|||
|
|
│ └── test-map-api.js # 地图API测试
|
|||
|
|
├── docs/ # 文档目录
|
|||
|
|
│ ├── baidu-map-license.md # 百度地图许可
|
|||
|
|
│ └── performance-monitoring.md # 性能监控文档
|
|||
|
|
├── test/ # 测试文件目录
|
|||
|
|
│ └── performance-monitor-test.js # 性能监控测试
|
|||
|
|
├── examples/ # 示例代码
|
|||
|
|
└── 配置文件
|
|||
|
|
├── arch.md # 架构文档
|
|||
|
|
├── design.md # 详细设计
|
|||
|
|
├── dev-plan.md # 开发计划
|
|||
|
|
├── task.md # 任务列表
|
|||
|
|
├── schema.sql # 数据库架构
|
|||
|
|
└── create_tables.sql # 建表脚本
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
### 后端技术栈
|
|||
|
|
- **运行环境**: Node.js 18.0+
|
|||
|
|
- **Web框架**: Express.js 4.18+
|
|||
|
|
- **ORM框架**: Sequelize 6.30+
|
|||
|
|
- **数据库**: MySQL (mysql2 3.0+)
|
|||
|
|
- **认证**: JWT (jsonwebtoken 9.0+)
|
|||
|
|
- **密码加密**: bcrypt 5.1+
|
|||
|
|
- **API文档**: Swagger (swagger-jsdoc + swagger-ui-express)
|
|||
|
|
- **日志管理**: Winston 3.17+
|
|||
|
|
- **开发工具**: nodemon 3.0+
|
|||
|
|
- **跨域处理**: CORS 2.8+
|
|||
|
|
- **数据验证**: express-validator 7.2+
|
|||
|
|
- **环境变量**: dotenv 16.0+
|
|||
|
|
- **HTTP客户端**: Axios 1.4+
|
|||
|
|
- **服务器端口**: 5350
|
|||
|
|
|
|||
|
|
### 前端技术栈
|
|||
|
|
- **管理后台**: Vue.js 3.4+ + Ant Design Vue 4.0+
|
|||
|
|
- **官网**: Vue.js 3.4+ + ECharts 5.4+
|
|||
|
|
- **微信小程序**: React + TypeScript + Tailwind CSS
|
|||
|
|
- **构建工具**: Vite 5.0+
|
|||
|
|
- **状态管理**: Pinia 2.0+
|
|||
|
|
- **路由管理**: Vue Router 4.0+
|
|||
|
|
|
|||
|
|
## 核心功能
|
|||
|
|
|
|||
|
|
- ✅ 实时设备监控
|
|||
|
|
- ✅ 动物健康管理
|
|||
|
|
- ✅ 地图可视化展示
|
|||
|
|
- ✅ 数据分析报表
|
|||
|
|
- ✅ 多角色权限系统
|
|||
|
|
- ✅ 订单管理功能
|
|||
|
|
- ✅ 预警管理系统
|
|||
|
|
- ✅ 性能监控分析
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
### 后端启动
|
|||
|
|
```bash
|
|||
|
|
cd backend
|
|||
|
|
npm install
|
|||
|
|
npm run dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 管理后台启动
|
|||
|
|
```bash
|
|||
|
|
cd admin-system/frontend
|
|||
|
|
npm install
|
|||
|
|
npm run dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 官网启动
|
|||
|
|
```bash
|
|||
|
|
cd website/data-screen
|
|||
|
|
npm install
|
|||
|
|
npm run dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 开发规范
|
|||
|
|
|
|||
|
|
1. 遵循模块化开发原则
|
|||
|
|
2. 代码注释规范清晰
|
|||
|
|
3. API接口文档完整
|
|||
|
|
4. 数据库迁移脚本可重复执行
|
|||
|
|
5. 测试用例覆盖核心功能
|
|||
|
|
|
|||
|
|
## 部署说明
|
|||
|
|
|
|||
|
|
生产环境建议使用Docker容器化部署，具体部署流程参考各模块的部署文档。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
*最后更新: 2025年8月*
|