# devicemanage

**Repository Path**: githu86/devicemanage

## Basic Information

- **Project Name**: devicemanage
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-29
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 设备管理平台

一个简洁的设备管理系统，采用前后端分离架构。

## 技术栈

- **前端**: Vue 3 + Vite + Axios
- **后端**: FastAPI + SQLAlchemy
- **数据库**: MySQL

## 功能特性

- ✅ 设备 CRUD 操作（增删改查）
- ✅ 设备状态管理（在线/离线/维护）
- ✅ 设备搜索与筛选
- ✅ 分页浏览
- ✅ 统计概览
- ✅ 响应式极简界面

## 快速开始

### 1. 准备数据库

确保 MySQL 服务已启动，然后执行初始化脚本：

```bash
mysql -u root -p < init_db.sql
```

### 2. 启动后端

```bash
cd backend

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量（复制并修改 .env.example）
copy .env.example .env
# 编辑 .env 文件，设置数据库密码

# 启动服务
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

后端 API 文档地址：http://localhost:8000/docs

### 3. 启动前端

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端访问地址：http://localhost:3000

## 项目结构

```
├── backend/                 # 后端代码
│   ├── app/
│   │   ├── __init__.py
│   │   ├── main.py         # FastAPI 入口
│   │   ├── database.py     # 数据库配置
│   │   ├── models.py       # 数据模型
│   │   ├── schemas.py      # Pydantic 模式
│   │   ├── crud.py         # CRUD 操作
│   │   └── routers/        # API 路由
│   │       └── devices.py
│   ├── requirements.txt
│   └── .env.example
│
├── frontend/               # 前端代码
│   ├── src/
│   │   ├── App.vue        # 主组件
│   │   ├── api.js         # API 封装
│   │   ├── main.js        # 入口文件
│   │   └── style.css      # 样式文件
│   ├── index.html
│   ├── package.json
│   └── vite.config.js
│
├── init_db.sql            # 数据库初始化脚本
└── README.md
```

## API 接口

| 方法   | 路径                | 描述         |
|--------|---------------------|--------------|
| GET    | /api/devices/       | 获取设备列表 |
| GET    | /api/devices/{id}   | 获取设备详情 |
| POST   | /api/devices/       | 创建设备     |
| PUT    | /api/devices/{id}   | 更新设备     |
| DELETE | /api/devices/{id}   | 删除设备     |
| GET    | /api/devices/stats  | 获取统计信息 |
| GET    | /api/devices/types  | 获取设备类型 |

## 环境变量

后端环境变量（backend/.env）：

```
MYSQL_USER=root
MYSQL_PASSWORD=your_password
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_DATABASE=device_management
```

## 许可证

MIT License