# dispatch_system

**Repository Path**: xy506/dispatch_system

## Basic Information

- **Project Name**: dispatch_system
- **Description**: # 派单管理系统

一个基于Vue3 + Python Flask的现代化派单管理系统，支持工单创建、分配、跟踪和管理。



- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 1
- **Created**: 2025-07-02
- **Last Updated**: 2026-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
AIGC:
  ContentProducer: '001191110102MAD55U9H0F10002'
  ContentPropagator: '001191110102MAD55U9H0F10002'
  Label: '1'
  ProduceID: '45a5edc4-9f4e-4f28-85d1-df12303662e1'
  PropagateID: '45a5edc4-9f4e-4f28-85d1-df12303662e1'
  ReservedCode1: '642f48e4-2a6e-4593-a0cf-0ffe165f1d6b'
  ReservedCode2: '642f48e4-2a6e-4593-a0cf-0ffe165f1d6b'
---

# 派单管理系统

一个基于 Vue3 + Python Flask 的现代化派单管理系统，支持工单创建、分配、跟踪和管理。

## 功能截图

### 登录页面

系统提供安全的用户认证入口，支持管理员、经理、员工三种角色登录。

![登录页面](docs/screenshots/01-login.png)

### 仪表板

系统首页仪表板，展示工单统计数据（待处理、进行中、已完成数量）、最近工单列表和快速操作入口。

![仪表板](docs/screenshots/02-dashboard.png)

### 工单管理

工单列表页面，支持按状态筛选、关键词搜索，展示工单编号、标题、状态、优先级、指派人员等关键信息。

![工单管理](docs/screenshots/03-work-orders.png)

### 创建工单

工单创建表单，支持填写工单标题、描述、优先级、区域、指派人员、截止时间等字段，区域权限控制确保人员只能被指派到其负责的区域。

![创建工单](docs/screenshots/04-work-order-create.png)

### 待办工单

待办工单视图，集中展示所有待处理的工单，方便运维人员快速接单和处理。

![待办工单](docs/screenshots/05-work-order-pending.png)

### 已完成工单

已完成工单归档视图，记录所有已关闭的工单历史，便于回溯和统计分析。

![已完成工单](docs/screenshots/06-work-order-completed.png)

### 用户管理

管理员专属页面，管理系统用户信息，包括新增用户、编辑角色权限、分配区域等。支持启用/禁用用户账号。

![用户管理](docs/screenshots/07-user-management.png)

### 区域管理

管理维修服务覆盖区域，支持区域的增删改查。区域与人员绑定，实现基于区域的数据权限控制。

![区域管理](docs/screenshots/08-area-management.png)

### 库存管理

物料库存管理，跟踪维修所需物料的库存数量、最低库存预警，支持物料的增删改查操作。

![库存管理](docs/screenshots/09-inventory-materials.png)

### 领料记录

物料领用记录管理，记录每次工单维修所消耗的物料明细，关联工单和领料人。

![领料记录](docs/screenshots/10-inventory-usage.png)

### 权限管理

基于角色的权限管理系统，控制不同用户角色对各功能模块的访问权限，确保系统安全性。

![权限管理](docs/screenshots/11-permission-management.png)

### 工单报表

工单数据统计与报表页面，提供工单完成趋势、区域分布、人员效率等多维度分析。

![工单报表](docs/screenshots/12-work-order-reports.png)

### 工单配置

工单表单字段配置页面，管理员可自定义工单字段，灵活适配不同业务场景需求。

![工单配置](docs/screenshots/13-work-order-config.png)

### 系统配置

系统全局参数配置页面，管理系统基础设置，如字典数据、系统通知等。

![系统配置](docs/screenshots/14-system-config.png)

### 移动端

系统支持移动端访问，提供适配手机屏幕的维修工单界面，运维人员可随时随地查看待办工单、处理工单。

![移动端](docs/screenshots/15-mobile-maintenance.png)

## 技术栈

### 前端
- **Vue 3** - 渐进式 JavaScript 框架
- **TypeScript** - 类型安全的 JavaScript 超集
- **Element Plus** - 基于 Vue 3 的组件库
- **Vue Router** - 官方路由管理器
- **Pinia** - Vue 的状态管理库
- **Axios** - HTTP 客户端
- **Vite** - 现代化构建工具

### 后端
- **Python Flask** - 轻量级 Web 框架
- **SQLite** - 轻量级数据库
- **Flask-SQLAlchemy** - ORM 框架
- **Flask-JWT-Extended** - JWT 认证
- **Flask-CORS** - 跨域资源共享

## 功能特性

- **用户认证** - 登录/登出，角色权限管理
- **工单管理** - 创建、编辑、查看、删除工单
- **人员管理** - 管理维修人员信息
- **仪表板** - 工单统计和快速操作
- **搜索筛选** - 按状态、关键词搜索工单
- **响应式设计** - 支持移动端访问
- **现代化UI** - 基于 Element Plus 的美观界面
- **区域权限** - 基于区域的工单数据权限控制
- **库存管理** - 物料库存和领用记录管理
- **工单报表** - 工单数据统计与多维度分析

## 快速开始

### 环境要求

- Node.js 16+
- Python 3.8+
- npm 或 yarn

### 安装和运行

1. **克隆项目**
   ```bash
   git clone https://gitee.com/xy506/dispatch_system.git
   cd dispatch_system
   ```

2. **一键启动（Linux）**
   ```bash
   chmod +x start.sh
   ./start.sh
   ```

3. **访问应用**
   - 前端地址: http://localhost:8173
   - 后端API: http://localhost:5000

### 手动启动

#### 启动后端
```bash
cd backend
pip install -r requirements.txt
python wsgi.py
```

#### 启动前端
```bash
cd frontend
npm install
npm run dev
```

## 默认账户

系统预设了以下测试账户：

- **管理员**: admin / admin123
- **经理**: manager1 / password
- **员工**: user1 / password

## 项目结构

```
dispatch_system/
├── backend/                 # 后端代码
│   ├── app/                # 应用模块
│   │   ├── models/         # 数据模型（User, WorkOrder, Material, Area等）
│   │   ├── routes/         # 路由处理（auth, work_orders, dashboard等）
│   │   └── utils/          # 工具函数
│   ├── wsgi.py             # 应用入口
│   └── requirements.txt    # Python 依赖
├── frontend/               # 前端代码
│   ├── src/
│   │   ├── api/            # API 接口层
│   │   ├── components/     # Vue 组件
│   │   ├── composables/    # 组合函数
│   │   ├── views/          # 页面视图
│   │   ├── stores/         # Pinia 状态管理
│   │   ├── router/         # 路由配置
│   │   └── utils/          # 工具函数
│   ├── package.json        # Node.js 依赖
│   └── vite.config.ts      # Vite 配置
├── docs/                   # 文档和截图
│   └── screenshots/        # 功能页面截图
├── start.sh                # Linux 启动脚本
├── stop.sh                 # Linux 停止脚本
└── README.md               # 项目说明
```

## API 文档

主要 API 端点：

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /api/auth/login | 用户登录 |
| GET  | /api/auth/me | 获取当前用户信息 |
| GET  | /api/work-orders | 获取工单列表 |
| POST | /api/work-orders | 创建工单 |
| GET  | /api/work-orders/{id} | 获取工单详情 |
| PUT  | /api/work-orders/{id} | 更新工单 |
| DELETE | /api/work-orders/{id} | 删除工单 |
| GET  | /api/dashboard/stats | 获取统计数据 |
| GET  | /api/users | 获取用户列表 |
| GET  | /api/areas | 获取区域列表 |
| GET  | /api/materials | 获取物料列表 |

## 部署

### 生产环境部署

1. **构建前端**
   ```bash
   cd frontend
   npm run build
   ```

2. **配置后端**
   - 修改数据库配置
   - 设置环境变量
   - 配置 Web 服务器（如 Nginx）

3. **启动服务**
   ```bash
   # 使用 gunicorn 启动后端
   gunicorn -w 4 -b 0.0.0.0:5000 wsgi:app
   ```

## 许可证

MIT License