SpringBoot3+Vue3+MySQL 宿舍报修缴费系统源码前后端分离实战-平芜编程栈

一、项目简介

本系统是一套面向高校或企业宿舍场景的报修与水电缴费一体化管理平台，采用前后端分离架构，后端基于 SpringBoot 3.x 提供 RESTful API，前端基于 Vue 3 构建单页应用。系统内置 JWT 身份认证与 RBAC 权限控制，覆盖学生、维修工、管理员三大角色。学生可提交报修工单、跟踪处理进度、查询并缴纳水电账单；维修工可接收派单、签到、完成工单并登记备件使用；管理员负责用户、楼栋、房间、工单派单、水电抄表计费、SLA 策略、公告与知识库等全链路管理。项目附带完整源码、数据库初始化脚本及万字开发文档，适合作为毕业设计或企业级宿舍管理系统的二次开发基底。

二、技术栈

技术	说明
后端框架	SpringBoot 3.x
ORM 框架	MyBatis-Plus（分页插件、逻辑删除）
权限认证	Spring Security + JWT（自定义令牌生成与校验）
前端框架	Vue 3（SPA 单页应用）
状态管理	Vuex / Pinia
构建工具	Vite
数据库	MySQL 8.x（自动建库建表）
缓存中间件	Redis（RedisTemplate 序列化配置）
文件存储	本地磁盘上传，按日期分目录存储

三、功能模块

管理员端

数据概览看板：统计用户总数、楼栋总数、房间总数、报修工单总数（待处理/处理中/已完成）以及水电费账单总数、未缴数量、应收总额、已收总额，以图表形式直观展示核心运营指标。
用户管理：支持按用户名/姓名/手机号搜索、按角色筛选；可新增用户（默认密码 123456）、编辑、删除、禁用/启用账号，禁用账号无法登录系统。
楼栋管理：维护楼栋名称、地址、楼层数、负责人、封面图、描述，系统自动统计每个楼栋下的房间数量。
房间管理：维护房间所属楼栋、房间号、楼层、容量、当前人数、电表编号、水表编号，支持按楼栋筛选。
报修工单派单：查看全部报修工单，将待派单工单指派给指定维修工（从在职维修工列表选择），派单后系统自动通知学生。
工单统计报表：按故障分类统计工单数量，计算平均响应时长（提交到派单的平均小时数）、一次修复率、平均评分等运营指标。
水电抄表管理：录入房间水电表读数，选择房间、类型（电/水）、读数数值、抄表日期，自动关联抄表人。
计费规则配置：维护阶梯电价/水价规则，支持多级阶梯（类型、阶梯名称、用量下限、用量上限、单价、生效日期、启用状态）。
账单管理：查看所有房间水电账单，支持按状态、账期月份、楼栋、房间筛选，支持手动创建或修改账单。
SLA 服务等级配置：按优先级和分类配置不同工单的响应时限、解决时限、升级时限。
公告管理：发布宿舍公告（标题、内容、封面图、类型、置顶标记），支持编辑、删除，置顶公告优先展示。
知识库管理：维护故障知识库条目（标题、分类、症状、解决方案、所需零件、平均维修时长），支持按分类筛选和关键词搜索。
备件库存管理：维护备件名称、分类、规格、单位、库存数量、预警库存、单价，支持新增、编辑、删除。
黑名单管理：将违规房间加入黑名单（填写原因、类型），支持查看黑名单列表（含楼栋和房间号）、解除黑名单。
操作审计日志：记录操作人、用户名、操作内容、请求方法、参数、IP 地址、执行结果、耗时、时间，按时间倒序展示。
文件上传：支持上传图片等文件（单文件最大 50MB），自动按日期分目录存储并返回访问 URL。

普通用户端

用户注册与登录：支持新用户注册（默认分配学生角色），登录后获取 JWT Token，自动校验账号状态，禁用账号无法登录。
个人资料管理：查看用户名、姓名、手机号、邮箱、头像等基本信息，支持修改个人资料，角色字段禁止修改。
报修工单提交：填写报修标题、详细描述、故障分类、优先级（紧急/普通），支持上传故障图片/视频，系统自动生成工单编号并记录提交人、所属楼栋与房间。
工单进度跟踪：查看个人报修工单列表，支持按状态（待派单/已派单/处理中/已完成/已评价）、分类、优先级筛选，实时查看工单当前处理节点。
工单评价：维修完成后对工单进行 1-5 星评分并填写评价内容，评价后工单状态变更为“已评价”。
水电账单查询：查看本人房间的水电账单列表，包含用电量、用水量、电费、水费、总金额、账单状态（未缴/已缴/逾期）、缴费截止日期。
在线缴费：对未缴账单发起支付，支持选择支付方式（模拟支付），支付成功后自动生成交易流水号并更新账单状态为“已缴”。
通知消息中心：接收系统推送通知（工单派单通知、工单完成通知），支持查看未读消息数量、标记单条已读、一键全部已读。
公告浏览：查看管理员发布的宿舍公告，支持按公告类型筛选，置顶公告优先展示。
知识库查询：浏览常见故障知识库，支持按分类筛选、关键词搜索，查看故障症状、解决方案、所需零件及预计维修时长。

维修工端

工单列表查看：查看分配给本人的工单列表，支持按状态、分类、优先级筛选，输入关键词可搜索工单标题或工单编号。
工单签到：到达维修现场后进行签到操作，上传签到照片、填写签到经纬度坐标，工单状态变更为“处理中”。
工单完成：维修完成后上传完工照片、填写维修备注、登记使用的备件信息，工单状态变更为“已完成”并自动通知学生进行评价。
备件库存查询：查看备件列表（备件名称、分类、规格、单位、库存数量、预警库存、单价），支持按名称关键词搜索。
知识库参考：查询故障知识库，获取常见故障的标准解决方案与所需备件清单。

四、项目总结

本系统的技术亮点在于完整落地了 RBAC 权限模型与 JWT 无状态认证，并在业务层面覆盖了报修工单全生命周期、阶梯计费、SLA 策略、操作审计等企业级功能点。前端采用 Vue 3 + Vite 的现代化工程化方案，后端使用 SpringBoot 3 + MyBatis-Plus 提升开发效率，Redis 的引入为后续扩展缓存与消息推送留出了空间。系统角色划分清晰、功能边界明确，适合作为高校计算机相关专业的毕业设计项目，也适合需要快速搭建宿舍管理系统的企业进行二次开发。