# farm-ui

**Repository Path**: huanlis/farm-ui

## Basic Information

- **Project Name**: farm-ui
- **Description**: 农场设备管理系统是一个专为智慧农业设计的综合管理平台，用于管理和监控农场中的各类设备。系统提供直观的界面，帮助用户高效地管理设备信息、监控设备状态、配置设备模板等。
- **Primary Language**: Unknown
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-18
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 农场设备管理系统 (Farm UI)

一个基于 Vue 3 + Element Plus 的现代化农场设备管理系统前端界面，提供设备管理、数据监控、模板配置等功能。

## 项目简介

农场设备管理系统是一个专为智慧农业设计的综合管理平台，用于管理和监控农场中的各类设备。系统提供直观的界面，帮助用户高效地管理设备信息、监控设备状态、配置设备模板等。

## 主要功能

- 🏠 **仪表盘** - 展示系统概览信息，包括设备总数、在线设备、设备类型等统计数据
- 📱 **设备管理** - 管理农场设备的基本信息、状态和位置
- 🏷️ **设备类型管理** - 定义和管理不同类型的设备模板
- 📊 **数据类型管理** - 管理设备采集的数据类型和格式
- ⚙️ **设备组态管理** - 配置设备的工作参数和运行规则
- 📚 **字典管理** - 维护系统中使用的各种字典数据
- 📖 **接口文档** - 提供API接口文档查看功能

## 技术栈

- **前端框架**: Vue 3.5.25
- **构建工具**: Vite 7.2.4
- **UI组件库**: Element Plus 2.12.0
- **路由管理**: Vue Router 4.6.3
- **状态管理**: Pinia 3.0.4
- **HTTP客户端**: Axios 1.13.2
- **图标库**: @element-plus/icons-vue 2.3.2

## 项目结构

```
farm-ui/
├── public/                 # 静态资源
├── src/
│   ├── api/              # API接口定义
│   │   ├── axiosInstance.js    # Axios实例配置
│   │   ├── device.js           # 设备相关API
│   │   ├── deviceType.js       # 设备类型API
│   │   ├── deviceTemplate.js   # 设备模板API
│   │   ├── deviceInstance.js   # 设备实例API
│   │   ├── dataBasicType.js    # 数据基础类型API
│   │   ├── dictionary.js        # 字典API
│   │   ├── greenhouse.js       # 温室API
│   │   └── index.js            # API统一导出
│   ├── components/       # 公共组件
│   │   └── Layout.vue          # 主布局组件
│   ├── router/           # 路由配置
│   │   └── index.js            # 路由定义
│   ├── stores/           # Pinia状态管理
│   │   └── counter.js           # 示例store
│   ├── styles/           # 全局样式
│   │   └── main.css             # 主样式文件
│   ├── views/            # 页面组件
│   │   ├── Dashboard.vue        # 仪表盘
│   │   ├── device/              # 设备管理模块
│   │   │   └── Device.vue
│   │   ├── system/              # 系统管理模块
│   │   │   ├── Dictionary.vue
│   │   │   ├── DataBasicType.vue
│   │   │   └── ApiDoc.vue
│   │   └── template/            # 模板管理模块
│   │       ├── DeviceType.vue
│   │       ├── DeviceConfiguration.vue
│   │       └── DeviceConfigurationList.vue
│   ├── App.vue           # 根组件
│   └── main.js           # 应用入口
├── .gitignore            # Git忽略文件
├── index.html            # HTML模板
├── jsconfig.json         # JS配置
├── package.json          # 项目配置
├── vite.config.js        # Vite配置
└── README.md             # 项目文档
```

## 环境要求

- Node.js: ^20.19.0 || >=22.12.0
- 现代浏览器支持 (Chrome, Firefox, Safari, Edge)

## 快速开始

### 安装依赖

```bash
npm install
```

### 开发环境运行

```bash
npm run dev
```

### 生产环境构建

```bash
npm run build
```

### 预览生产构建

```bash
npm run preview
```

## 开发指南

### 推荐的IDE设置

[VS Code](https://code.visualstudio.com/) + [Vue (Official)](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (并禁用 Vetur)。

### 推荐的浏览器设置

- 基于Chromium的浏览器 (Chrome, Edge, Brave等):
  - [Vue.js devtools](https://chromewebstore.google.com/detail/vuejs-devtools/nhdogjmejiglipccpnnnanhbledajbpd) 
  - [在Chrome DevTools中启用自定义对象格式化器](http://bit.ly/object-formatters)
- Firefox:
  - [Vue.js devtools](https://addons.mozilla.org/en-US/firefox/addon/vue-js-devtools/)
  - [在Firefox DevTools中启用自定义对象格式化器](https://fxdx.dev/firefox-devtools-custom-object-formatters/)

### API配置

API基础URL在 `src/api/axiosInstance.js` 中配置，默认为 `http://localhost:8080`。如需修改，请编辑该文件中的 `baseURL` 配置。

### 样式规范

项目使用CSS变量定义主题颜色和间距，主要变量定义在 `src/styles/main.css` 中。新增组件时请遵循现有的样式规范。

## 功能模块详解

### 设备管理

设备管理模块提供设备的增删改查功能，包括：
- 设备基本信息管理（编码、名称、类型、位置等）
- 设备状态监控（启用、停用、维护中）
- 设备制造商、型号、序列号等信息记录
- 设备安装日期记录

### 设备类型管理

定义和管理不同类型的设备模板，为设备实例提供基础模板。

### 数据类型管理

管理设备采集的数据类型和格式，确保数据的一致性和规范性。

### 设备组态管理

配置设备的工作参数和运行规则，实现设备的个性化配置。

### 字典管理

维护系统中使用的各种字典数据，提供统一的数据字典服务。

## 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 许可证

本项目采用 MIT 许可证。详情请参阅 [LICENSE](LICENSE) 文件。

## 联系方式

如有问题或建议，请通过以下方式联系：
- 提交 Issue
- 发送邮件至项目维护者

## 更新日志

### v0.0.0
- 初始版本发布
- 实现基础设备管理功能
- 完成系统框架搭建