# 宁夏智慧养殖监管平台

## 项目概述

宁夏智慧养殖监管平台是一个现代化的农场管理系统，提供实时监控、数据分析和多终端访问功能。

## 目录结构

```
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      # 详细设计
    ├── PRD.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月*