SpringBoot3+Vue3+MySQL 城市花园小区维修管理系统源码前后端分离实战

一、项目简介

城市花园小区维修管理系统是一套基于 Spring Boot 3 + Vue 3 前后端分离架构的小区维修服务管理平台。系统采用单体应用架构，后端提供 RESTful API，前端通过 Axios 进行数据交互。系统支持普通居民端、维修工端和管理员端三种角色，提供从报修申请、派单、维修、评价到支付结算的完整闭环管理，同时包含公告发布、在线咨询、数据统计等辅助功能。

二、技术栈

三、功能模块

普通用户端

• 用户注册与登录：填写用户名、密码、真实姓名、手机号、楼栋号、单元号、房间号完成注册，自动绑定 RESIDENT 角色；登录后生成 JWT Token 返回用户信息及角色
• 提交维修申请：填写维修标题、描述、维修类型、地址、联系人、联系电话、期望维修时间，自动生成工单编号并提交，状态初始为“待派单”
• 查看我的工单：按状态（待派单/已派单/维修中/已完成/已评价/已取消）筛选，列表展示工单编号、标题、状态、创建时间
• 查看工单详情：展示工单完整信息，包括维修工信息、费用明细、时间节点（创建时间、派单时间、开始维修时间、完成时间）
• 取消工单：在工单状态为待派单或已派单时，可取消未开始的维修申请
• 在线咨询：提交咨询标题和内容，等待管理员回复，支持查看历史咨询记录
• 提交维修评价：对已完成的工单进行评分（1-5星）并填写评价内容，支持上传图片和匿名评价
• 支付维修费用：对已完成的工单发起支付，系统生成交易单号并记录支付时间和金额
• 我的支付记录：查看历史支付记录列表，包含工单号、支付金额、支付方式、支付时间
• 浏览公告与维修工信息：查看已发布公告（支持按类型筛选和查看详情），浏览在岗维修工列表（支持按专长筛选），查看维修工详情（评分、工龄、总单数）及用户评价
• 修改个人密码：输入原密码和新密码完成密码修改

维修工端

• 查看我的工单：查看分配给自己的工单列表，支持按状态（已派单/维修中/已完成等）筛选
• 开始维修：将工单状态从“已派单”更新为“维修中”，记录开始维修时间
• 完成维修：填写实际维修费用，将工单状态更新为“已完成”，记录完成时间
• 提交维修报告：针对已完成的工单填写维修内容、使用材料、材料费、人工费、总费用、备注并上传图片
• 查看我的维修报告：分页查看自己提交过的维修报告列表
• 回复用户评价：对用户提交的评价进行回复
• 查看个人资料：查看自己的维修工信息，包括专长、工龄、评分、总订单数、描述

管理员端

• 用户管理：分页查询所有用户，支持按角色和关键词（用户名/真实姓名/手机号）筛选；新增用户（自动为维修工创建档案）、编辑用户信息、启用/禁用用户、删除用户
• 维修工管理：分页查询维修工列表，支持按专长筛选；编辑维修工信息（专长、工龄、描述等），更新在岗/离岗状态
• 维修工单管理：分页查询所有工单，支持按用户、维修工、状态、关键词筛选；查看工单详情（含用户、维修工、维修类型信息）
• 派单：将待派单的工单分配给指定维修工，记录派单时间，工单状态变为“已派单”
• 维修类型管理：新增、编辑、删除维修类型（名称、图标、描述、基础价格、排序），启用/停用维修类型
• 公告管理：新增、编辑、删除公告，发布时自动记录发布人和发布时间，支持设置置顶、公告类型、封面图，查看公告阅读次数
• 轮播图管理：新增、编辑、删除轮播图，设置标题、图片链接、跳转链接、排序，启用/停用轮播图
• 在线咨询管理：查看所有咨询列表，支持按状态（待回复/已回复/已关闭）筛选，回复用户咨询，关闭咨询
• 数据统计仪表盘：查看居民总数、维修工总数、总工单数、今日工单数、待派单数、维修中数、已完成数、待回复咨询数、今日收入、总收入，以及各状态工单数量分布
• 文件管理：支持单文件和多文件上传，文件类型限制为图片和视频格式，按日期自动归档存储

四、项目总结

本项目技术亮点在于采用最新的 Spring Boot 3 与 Vue 3 技术栈，实现了小区维修服务的全流程闭环管理。系统通过 JWT 实现前后端分离权限认证，使用 MyBatis-Plus 简化数据访问层开发，前端采用 Pinia 进行状态管理，整体代码结构清晰、注释完整。系统适用于高校课程设计、毕业设计以及小区物业管理类项目的二次开发学习，尤其适合希望学习前后端分离架构和实际业务场景的开发者。

界面展示

交付内容

本项目为完整交付，包含：

• 完整后端源码
• 完整前端源码
• 数据库初始化脚本（SQL）
• 万字项目文档（设计文档 / 论文，可作课程设计、毕业设计参考）

获取完整源码

完整前后端源码 + 数据库脚本 + 万字项目文档见 Gitee 仓库：https://gitee.com/kangxihuang/src-K139