宁夏智慧养殖监管平台 - 政府端管理后台
项目简介
本项目是宁夏智慧养殖监管平台的政府端管理后台,基于 Vue 3 + Ant Design Vue 构建,为政府监管部门提供养殖场管理、设备监控、数据分析等功能。
技术栈
- 前端框架: Vue 3.4+
- 构建工具: Vite 5.0+
- UI组件库: Ant Design Vue 4.0+
- 状态管理: Pinia 2.1+
- 路由管理: Vue Router 4.2+
- HTTP客户端: Axios 1.6+
- 图表库: ECharts 5.4+
- 样式预处理: Sass
- Node.js版本: 16.x
功能特性
核心功能
- 🔐 用户认证与权限管理
- 🏠 养殖场信息管理
- 🗺️ 地图可视化展示
- 📊 设备监控与状态管理
- 🐄 动物健康管理
- ⚠️ 预警管理系统
- 📈 数据可视化与报表
- 👥 用户管理
- ⚙️ 系统设置
技术特性
- 📱 响应式设计,支持多端适配
- 🎨 现代化UI设计,用户体验优良
- 🚀 基于Vite的快速开发体验
- 🔄 实时数据更新(WebSocket)
- 📦 组件化开发,代码复用性高
- 🛡️ 完善的权限控制系统
- 🌐 国际化支持(预留)
环境要求
- Node.js 16.x
- npm 8.0+ 或 yarn 1.22+
- 现代浏览器(Chrome 88+, Firefox 78+, Safari 14+)
快速开始
1. 克隆项目
git clone <repository-url>
cd government-admin
2. 安装依赖
# 使用npm
npm install
# 或使用yarn
yarn install
3. 配置环境变量
# 复制环境变量示例文件
cp .env.example .env
# 编辑 .env 文件,配置API地址等信息
4. 启动开发服务器
# 使用npm
npm run dev
# 或使用yarn
yarn dev
5. 构建生产版本
# 使用npm
npm run build
# 或使用yarn
yarn build
项目结构
government-admin/
├── public/ # 静态资源
├── src/
│ ├── assets/ # 资源文件
│ ├── components/ # 通用组件
│ ├── layouts/ # 布局组件
│ ├── router/ # 路由配置
│ ├── stores/ # 状态管理
│ ├── styles/ # 样式文件
│ ├── utils/ # 工具函数
│ ├── views/ # 页面组件
│ ├── App.vue # 根组件
│ └── main.js # 入口文件
├── .env.example # 环境变量示例
├── .nvmrc # Node.js版本配置
├── index.html # HTML模板
├── package.json # 项目配置
├── vite.config.js # Vite配置
└── README.md # 项目说明
开发规范
代码规范
- 使用 ESLint + Prettier 进行代码格式化
- 组件命名使用 PascalCase
- 文件命名使用 kebab-case
- 变量命名使用 camelCase
Git提交规范
feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 代码重构
test: 测试相关
chore: 构建过程或辅助工具的变动
部署说明
开发环境
npm run dev
生产环境
npm run build
npm run preview
Docker部署
# 构建镜像
docker build -t government-admin .
# 运行容器
docker run -p 5400:80 government-admin
API接口
后端API服务地址: http://localhost:5350/api
主要接口:
/auth/*- 认证相关/farms/*- 养殖场管理/devices/*- 设备监控/animals/*- 动物管理/alerts/*- 预警管理/reports/*- 报表数据/users/*- 用户管理
浏览器支持
| Chrome | Firefox | Safari | Edge |
|---|---|---|---|
| 88+ | 78+ | 14+ | 88+ |
许可证
MIT License
联系方式
- 项目维护: NXXM Development Team
- 技术支持: [技术支持邮箱]
- 问题反馈: [GitHub Issues]
更新日志
v1.0.0 (2025-01-18)
- 🎉 初始版本发布
- ✨ 完成基础框架搭建
- ✨ 实现用户认证系统
- ✨ 完成基础布局和路由配置