Files
nxxmdata/README.md
2025-09-01 02:51:34 +08:00

3.6 KiB
Raw Blame History

宁夏智慧养殖监管平台

项目概述

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

目录结构

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+

核心功能

  • 实时设备监控
  • 动物健康管理
  • 地图可视化展示
  • 数据分析报表
  • 多角色权限系统
  • 订单管理功能
  • 预警管理系统
  • 性能监控分析

快速开始

后端启动

cd backend
npm install
npm run dev

管理后台启动

cd admin-system/frontend
npm install
npm run dev

官网启动

cd website/data-screen
npm install
npm run dev

开发规范

  1. 遵循模块化开发原则
  2. 代码注释规范清晰
  3. API接口文档完整
  4. 数据库迁移脚本可重复执行
  5. 测试用例覆盖核心功能

部署说明

生产环境建议使用Docker容器化部署具体部署流程参考各模块的部署文档。


最后更新: 2025年8月