# 维修派单系统

**Repository Path**: xy506/maintenance-dispatch-system

## Basic Information

- **Project Name**: 维修派单系统
- **Description**: 电信AI工具：TeleClaw生成的管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
AIGC:
  ContentProducer: '001191110102MAD55U9H0F10002'
  ContentPropagator: '001191110102MAD55U9H0F10002'
  Label: '1'
  ProduceID: 'e32dfcf8-f9c2-4e07-b608-3b4a65f29c68'
  PropagateID: 'e32dfcf8-f9c2-4e07-b608-3b4a65f29c68'
  ReservedCode1: '663869ce-5acb-44a1-b7f2-77bffa77a0e1'
  ReservedCode2: '663869ce-5acb-44a1-b7f2-77bffa77a0e1'
---

# 维修派单系统 - 功能规格文档

## 文档信息

| 项目 | 内容 |
|------|------|
| 系统名称 | 维修派单系统（Maintenance Dispatch System） |
| 版本 | V1.1 |
| 编制日期 | 2026-05-20 |
| 适用规模 | 中型（50-500用户，多区域/多站点） |
| 技术栈 | Spring Boot 3.2 + Vue 3 + Element Plus + MySQL 8.0 + Docker |

## 文档导航

### 第一部分：系统总览
| 序号 | 文档 | 说明 |
|------|------|------|
| 01 | [系统总览与概述](01-系统总览与概述.md) | 系统定位、设计目标、用户角色、整体架构、限界上下文 |

### 第二部分：前端功能设计
| 序号 | 文档 | 说明 |
|------|------|------|
| 02 | [前端功能-看板界面](02-前端功能-看板界面.md) | 运营监控看板、工作流看板（Kanban） |
| 03 | [前端功能-工单处理界面](03-前端功能-工单处理界面.md) | 工单创建、详情、派单、状态推进、验收评价 |
| 04 | [前端功能-移动端](04-前端功能-移动端.md) | 工程师端APP/小程序、客户端微信小程序 |

### 第三部分：后端核心业务模块
| 序号 | 文档 | 说明 |
|------|------|------|
| 05 | [后端功能-工单管理模块](05-后端功能-工单管理模块.md) | 工单CRUD、状态机、模板、关联关系 |
| 06 | [后端功能-派单引擎模块](06-后端功能-派单引擎模块.md) | 规则配置、权重评分、候选池、派单策略 |
| 07 | [后端功能-工程师管理模块](07-后端功能-工程师管理模块.md) | 入驻、档案、资质证书、排班、施工记录、结算、评价、绩效、退驻 |
| 08 | [后端功能-客户管理](08-后端功能-客户管理.md) | 客户主数据、VIP等级、360视图、SLA联动、客户自助服务 |

### 第四部分：后端支撑业务模块
| 序号 | 文档 | 说明 |
|------|------|------|
| 09 | [后端功能-资产与备件管理](09-后端功能-资产与备件管理.md) | 设备台账、备件库存、采购预警 |
| 10 | [后端功能-SLA管理模块](10-后端功能-SLA管理模块.md) | SLA模板、倒计时监控、超时升级 |
| 11 | [后端功能-其他模块](11-后端功能-其他模块.md) | 通知中心、知识库、财务结算、统计报表、系统配置 |
| 12 | [后端功能-权限与组织管理](12-后端功能-权限与组织管理.md) | RBAC、数据权限、组织架构、区域管理 |

### 第五部分：后端平台基础模块
| 序号 | 文档 | 说明 |
|------|------|------|
| 13 | [后端功能-自定义字段管理](13-后端功能-自定义字段管理.md) | 统一字段扩展框架、动态表单渲染、行业模板 |
| 14 | [通用批量导入模块](14-通用批量导入模块.md) | 通用导入引擎、模板管理、校验链、异步导入、结果报告 |

### 第六部分：技术设计
| 序号 | 文档 | 说明 |
|------|------|------|
| 15 | [技术架构设计](15-技术架构设计.md) | 整体架构、DDD划分、技术选型、部署方案 |
| 16 | [数据库设计](16-数据库设计.md) | 核心表结构、索引策略、分区方案 |

## 系统定位

本系统是一套**综合通用型维修派单平台**，覆盖物业管理、设备售后、工业维保等多场景，核心解决维修服务从报修受理、智能派单、现场执行到验收结算的全流程数字化管理问题。

系统遵循"三端协同"的行业标准架构:

```
┌─────────────┐   ┌─────────────┐   ┌─────────────────┐
│  客户端       │   │  工程师端     │   │  管理后台         │
│  微信小程序/H5│   │  APP/小程序   │   │  PC Web          │
│  报修/查询/评价│   │  接单/执行/签到│   │  看板/派单/管理   │
└──────┬──────┘   └──────┬──────┘   └───────┬─────────┘
       │                 │                   │
       └─────────────────┼───────────────────┘
                         │
              ┌──────────┴──────────┐
              │   统一后端服务层      │
              │   Spring Boot 3.x   │
              └─────────────────────┘
```

## 核心设计原则

1. **业务闭环**：工单从创建到结算的完整生命周期闭环，每个环节有明确的状态和流转规则
2. **智能驱动**：派单引擎支持自动/半自动/手动三种模式，渐进式提升自动化水平
3. **多维度管控**：权限体系覆盖功能权限+数据权限，支持按区域/专业/项目等多维度隔离
4. **移动优先**：工程师端作为核心作业入口，支持离线操作、GPS签到、拍照留痕
5. **可扩展架构**：采用DDD限界上下文划分，模块化单体起步，预留微服务拆分路径

## 系统部署信息

### 访问地址
| 端 | 地址 | 说明 |
|----|------|------|
| PC管理后台 | http://xin.xy506.cool:8888 | 全功能管理界面 |
| H5工程师端 | http://xin.xy506.cool:8888/h5 | 移动端工程师工作台 |
| API接口 | http://xin.xy506.cool:8888/api/ | 后端RESTful API |

### 测试账号
| 角色 | 用户名 | 密码 | 说明 |
|------|--------|------|------|
| 超级管理员 | admin | admin123 | 全部权限，16个顶级菜单 |
| 调度员 | dispatcher01 | admin123 | 工单/派单/人员/客户/资产/备件/SLA/组织/通知/知识库 |
| 工程师 | worker01 | admin123 | PC端5菜单 + H5移动端全部功能 |
| 客户 | customer01 | admin123 | 工单查看/创建 + 通知 |

### 角色权限矩阵

| 功能模块 | 超级管理员 | 调度员 | 工程师 | 客户 |
|----------|:--------:|:-----:|:-----:|:----:|
| 工作台 | Y | Y | Y | Y |
| 工单看板 | Y | Y | Y | - |
| 工单管理-列表 | Y | Y | Y | Y |
| 工单管理-创建 | Y | Y | - | Y |
| 工单管理-编辑/删除 | Y | Y | - | - |
| 工单管理-派单 | Y | Y | - | - |
| 工单管理-接单 | Y | - | Y | - |
| 工单管理-完工提交 | Y | - | Y | - |
| 派单引擎 | Y | Y | - | - |
| 人员管理 | Y | Y(部分) | - | - |
| 客户管理 | Y | Y | - | - |
| 资产管理 | Y | Y | - | - |
| 备件管理 | Y | Y | - | - |
| SLA管理 | Y | Y | - | - |
| 组织管理 | Y | Y | - | - |
| 通知管理 | Y | Y | Y | Y |
| 知识库 | Y | Y | Y | - |
| 系统管理 | Y | - | - | - |
| 财务管理 | Y | - | - | - |
| H5移动端 | - | - | Y | - |

### H5工程师端功能清单
| 功能 | 路径 | 说明 |
|------|------|------|
| 工程师登录 | /h5 | 独立H5登录页 |
| 首页工作台 | /h5/home | 待接单/进行中/待提交统计，当前工单，今日统计 |
| 工单列表 | /h5/orders | Tab筛选(待接单/进行中/待提交/待验收/全部)，搜索 |
| 工单详情 | /h5/order-detail/:id | 基本信息/故障描述/SLA计时/进度/操作(接单/拒单/签到/挂起/完工) |
| 接单/拒单 | (弹窗) | 接单确认/拒单原因选择(5种) |
| 签到打卡 | /h5/checkin | GPS定位/签到/签退/停留时长 |
| 完工报告 | (弹窗) | 维修措施/备件使用/拍照/电子签名 |
| 个人中心 | /h5/mine | 个人信息/评分绩效/技能标签/知识库/通知/排班/收入 |
| 知识库 | /h5/knowledge | 知识文章/维修案例 |
| 消息通知 | /h5/notifications | 通知列表/未读标记/全部已读 |