# 维修派单系统 **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-06-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README --- AIGC: ContentProducer: '001191110102MAD55U9H0F10002' ContentPropagator: '001191110102MAD55U9H0F10002' Label: '1' ProduceID: '155a28da-a5ea-4199-bffe-f3165e1747da' PropagateID: '155a28da-a5ea-4199-bffe-f3165e1747da' ReservedCode1: '7c9cd9b3-3e5d-4c26-a094-62ee8225522e' ReservedCode2: '7c9cd9b3-3e5d-4c26-a094-62ee8225522e' --- # 维修派单系统（MDS） 一套**综合通用型维修派单平台**，覆盖物业管理、设备售后、工业维保等多场景，核心解决维修服务从报修受理、智能派单、现场执行到验收结算的全流程数字化管理问题。 技术栈：Spring Boot 3.2 + Vue 3 + Element Plus + MySQL 8.0 + Docker ## 系统架构 ``` ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ 客户端 │ │ 工程师端 │ │ 管理后台 │ │ 微信小程序/H5│ │ APP/小程序 │ │ PC Web │ │ 报修/查询/评价│ │ 接单/执行/签到│ │ 看板/派单/管理 │ └──────┬──────┘ └──────┬──────┘ └───────┬─────────┘ │ │ │ └─────────────────┼───────────────────┘ │ ┌──────────┴──────────┐ │ 统一后端服务层 │ │ Spring Boot 3.2 │ └─────────────────────┘ ``` ## 功能截图 ### 登录页面 管理后台登录入口，支持管理员、调度员、工程师、客户多角色登录。 ![登录页面](docs/screenshots/01-login.png) ### 运营监控看板 系统首页仪表板，展示今日工单总数、待处理/已完成工单、SLA达标率等核心KPI，以及工单趋势图和类型分布图。 ![运营监控看板](docs/screenshots/02-dashboard.png) ### 工单看板 Kanban风格的工单流转视图，按待处理、已指派、进行中、已完成等状态分列展示，支持拖拽流转。 ![工单看板](docs/screenshots/03-kanban.png) ### 工单列表 工单管理主界面，支持按工单编号、状态、优先级、创建时间等多维度筛选，提供新建、批量删除、导出等操作。 ![工单列表](docs/screenshots/04-workorder-list.png) ### 创建工单 工单创建表单，支持填写故障描述、优先级、区域指派、SLA策略等字段。 ![创建工单](docs/screenshots/05-workorder-create.png) ### 派单任务 派单任务管理，查看待派单工单池，支持手动/自动派单操作。 ![派单任务](docs/screenshots/06-dispatch-index.png) ### 派单规则 派单引擎规则配置，设置自动派单的触发条件和匹配规则。 ![派单规则](docs/screenshots/07-dispatch-rules.png) ### 权重方案 派单权重方案管理，按距离、技能、负荷等维度配置权重评分，优化派单决策。 ![权重方案](docs/screenshots/08-dispatch-weights.png) ### 工程师列表 工程师档案管理，查看工程师基本信息、技能标签、状态和绩效评分。 ![工程师列表](docs/screenshots/09-worker-list.png) ### 入驻申请 工程师入驻审核流程，管理新工程师的入驻申请和资质审查。 ![入驻申请](docs/screenshots/10-worker-onboarding.png) ### 排班管理 工程师排班日历，按区域/专业配置值班表，支撑派单引擎的可用性计算。 ![排班管理](docs/screenshots/11-worker-schedule.png) ### 客户列表 客户主数据管理，展示客户基本信息、VIP等级、区域和关联工单数。 ![客户列表](docs/screenshots/12-customer-list.png) ### 设备台账 设备资产台账，管理设备基本信息、位置、保修状态和维修履历。 ![设备台账](docs/screenshots/13-asset-list.png) ### 备件台账 备件基础信息管理，记录备件编码、规格、分类和安全库存。 ![备件台账](docs/screenshots/14-sparepart-list.png) ### 库存管理 备件库存管理，跟踪各仓库的备件库存数量、出入库记录和安全库存预警。 ![库存管理](docs/screenshots/15-sparepart-inventory.png) ### SLA策略 SLA服务等级协议策略配置，设置不同工单类型的响应时间和完工时间要求。 ![SLA策略](docs/screenshots/16-sla-policies.png) ### SLA预警 SLA超时预警面板，实时监控即将超时和已超时的工单，支撑升级处理。 ![SLA预警](docs/screenshots/17-sla-alerts.png) ### 组织架构 组织树形结构管理，维护公司-部门-班组的层级关系和人员归属。 ![组织架构](docs/screenshots/18-org-tree.png) ### 区域管理 服务区域管理，按地理区域划分维修服务范围，绑定人员和设备。 ![区域管理](docs/screenshots/19-org-region.png) ### 用户管理 系统用户账号管理，支持用户创建、角色分配、区域权限配置和账号启用/禁用。 ![用户管理](docs/screenshots/20-system-user.png) ### 角色管理 RBAC角色权限管理，配置角色关联的菜单权限和数据权限范围。 ![角色管理](docs/screenshots/21-system-role.png) ### 通知中心 系统通知中心，汇集工单指派、SLA预警、完工提醒等各类通知消息。 ![通知中心](docs/screenshots/22-notification.png) ### 知识文章 维修知识库，发布和管理维修技术文章、操作手册和最佳实践。 ![知识文章](docs/screenshots/23-knowledge-articles.png) ### 费用管理 维修费用管理，记录工单关联的人工费、备件费和其他费用明细。 ![费用管理](docs/screenshots/24-finance-cost.png) ### 自定义字段 统一字段扩展框架，支持为工单、设备等实体自定义扩展字段，适配不同行业场景。 ![自定义字段](docs/screenshots/25-customfield.png) ### 导入任务 通用批量导入功能，支持Excel模板上传、数据校验和异步导入结果跟踪。 ![导入任务](docs/screenshots/26-import-task.png) ### H5工程师工作台 移动端工程师首页，展示待接单/进行中/已完工/已验证的工单统计和当前工单列表。 ![H5工作台](docs/screenshots/27-h5-home.png) ### H5工单列表 移动端工单列表，支持Tab筛选（待接单/进行中/待提交/待验收/全部）和搜索。 ![H5工单列表](docs/screenshots/28-h5-orders.png) ### H5签到打卡 移动端GPS签到功能，记录工程师到达和离开现场的时间与位置。 ![H5签到打卡](docs/screenshots/29-h5-checkin.png) ### H5个人中心 工程师个人中心，查看个人信息、评分绩效、技能标签和收入统计。 ![H5个人中心](docs/screenshots/30-h5-mine.png) ## 测试账号 | 角色 | 用户名 | 密码 | 说明 | |------|--------|------|------| | 超级管理员 | admin | admin123 | 全部权限 | | 调度员 | dispatcher01 | admin123 | 工单/派单/人员/客户等 | | 工程师 | worker01 | admin123 | PC端 + H5移动端 | | 客户 | customer01 | admin123 | 工单查看/创建 + 通知 | ## 快速开始 ### 环境要求 - JDK 17+ - Node.js 16+ - MySQL 8.0+ - Redis 7+ - Maven 3.8+ ### Docker Compose 一键部署 ```bash docker compose up -d --build ``` 服务启动后： - 管理后台: http://localhost:8888 - 后端API: http://localhost:8080/api/ - RabbitMQ管理: http://localhost:15672 (mds/mds123) - MinIO控制台: http://localhost:9001 (mdsadmin/mdsadmin123) ### 手动启动 #### 启动后端 ```bash cd mds-server mvn spring-boot:run ``` #### 启动前端 ```bash cd mds-admin npm install npm run dev ``` 前端开发服务器默认运行在 http://localhost:3000，通过代理转发API请求到后端 8080 端口。 ## 项目结构 ``` maintenance-dispatch-system/ ├── mds-server/ # 后端服务（Spring Boot 3.2） │ ├── src/main/java/com/mds/ # Java源码 │ │ ├── modules/ # 业务模块（DDD限界上下文） │ │ └── common/ # 公共组件 │ ├── src/main/resources/ # 配置文件 │ ├── sql/ # 数据库初始化脚本 │ └── pom.xml # Maven依赖 ├── mds-admin/ # 前端管理后台（Vue 3） │ ├── src/ │ │ ├── views/ # 页面视图（18个模块） │ │ ├── api/ # API接口层 │ │ ├── components/ # 公共组件 │ │ ├── store/ # Pinia状态管理 │ │ ├── router/ # 路由配置 │ │ ├── layout/ # 布局组件 │ │ └── utils/ # 工具函数 │ ├── vite.config.js # Vite配置 │ └── package.json # Node.js依赖 ├── docs/ # 文档和截图 │ └── screenshots/ # 功能页面截图 ├── docker-compose.yml # Docker编排 ├── deploy.sh # 自动部署脚本 └── 01~16-*.md # 详细功能规格文档 ``` ## 功能规格文档 | 序号 | 文档 | 说明 | |------|------|------| | 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) | 核心表结构、索引策略、分区方案 | ## 核心设计原则 1. **业务闭环**：工单从创建到结算的完整生命周期闭环 2. **智能驱动**：派单引擎支持自动/半自动/手动三种模式 3. **多维度管控**：功能权限+数据权限，按区域/专业/项目隔离 4. **移动优先**：工程师端支持离线操作、GPS签到、拍照留痕 5. **可扩展架构**：DDD限界上下文，模块化单体起步，预留微服务拆分路径 ## 许可证 MIT License