一、项目简介本系统是一套面向高校或企业宿舍场景的报修与水电缴费一体化管理平台采用前后端分离架构后端基于 SpringBoot 3.x 提供 RESTful API前端基于 Vue 3 构建单页应用。系统内置 JWT 身份认证与 RBAC 权限控制覆盖学生、维修工、管理员三大角色。学生可提交报修工单、跟踪处理进度、查询并缴纳水电账单维修工可接收派单、签到、完成工单并登记备件使用管理员负责用户、楼栋、房间、工单派单、水电抄表计费、SLA 策略、公告与知识库等全链路管理。项目附带完整源码、数据库初始化脚本及万字开发文档适合作为毕业设计或企业级宿舍管理系统的二次开发基底。二、技术栈技术说明后端框架SpringBoot 3.xORM 框架MyBatis-Plus分页插件、逻辑删除权限认证Spring Security JWT自定义令牌生成与校验前端框架Vue 3SPA 单页应用状态管理Vuex / Pinia构建工具Vite数据库MySQL 8.x自动建库建表缓存中间件RedisRedisTemplate 序列化配置文件存储本地磁盘上传按日期分目录存储三、功能模块管理员端数据概览看板统计用户总数、楼栋总数、房间总数、报修工单总数待处理/处理中/已完成以及水电费账单总数、未缴数量、应收总额、已收总额以图表形式直观展示核心运营指标。用户管理支持按用户名/姓名/手机号搜索、按角色筛选可新增用户默认密码 123456、编辑、删除、禁用/启用账号禁用账号无法登录系统。楼栋管理维护楼栋名称、地址、楼层数、负责人、封面图、描述系统自动统计每个楼栋下的房间数量。房间管理维护房间所属楼栋、房间号、楼层、容量、当前人数、电表编号、水表编号支持按楼栋筛选。报修工单派单查看全部报修工单将待派单工单指派给指定维修工从在职维修工列表选择派单后系统自动通知学生。工单统计报表按故障分类统计工单数量计算平均响应时长提交到派单的平均小时数、一次修复率、平均评分等运营指标。水电抄表管理录入房间水电表读数选择房间、类型电/水、读数数值、抄表日期自动关联抄表人。计费规则配置维护阶梯电价/水价规则支持多级阶梯类型、阶梯名称、用量下限、用量上限、单价、生效日期、启用状态。账单管理查看所有房间水电账单支持按状态、账期月份、楼栋、房间筛选支持手动创建或修改账单。SLA 服务等级配置按优先级和分类配置不同工单的响应时限、解决时限、升级时限。公告管理发布宿舍公告标题、内容、封面图、类型、置顶标记支持编辑、删除置顶公告优先展示。知识库管理维护故障知识库条目标题、分类、症状、解决方案、所需零件、平均维修时长支持按分类筛选和关键词搜索。备件库存管理维护备件名称、分类、规格、单位、库存数量、预警库存、单价支持新增、编辑、删除。黑名单管理将违规房间加入黑名单填写原因、类型支持查看黑名单列表含楼栋和房间号、解除黑名单。操作审计日志记录操作人、用户名、操作内容、请求方法、参数、IP 地址、执行结果、耗时、时间按时间倒序展示。文件上传支持上传图片等文件单文件最大 50MB自动按日期分目录存储并返回访问 URL。普通用户端用户注册与登录支持新用户注册默认分配学生角色登录后获取 JWT Token自动校验账号状态禁用账号无法登录。个人资料管理查看用户名、姓名、手机号、邮箱、头像等基本信息支持修改个人资料角色字段禁止修改。报修工单提交填写报修标题、详细描述、故障分类、优先级紧急/普通支持上传故障图片/视频系统自动生成工单编号并记录提交人、所属楼栋与房间。工单进度跟踪查看个人报修工单列表支持按状态待派单/已派单/处理中/已完成/已评价、分类、优先级筛选实时查看工单当前处理节点。工单评价维修完成后对工单进行 1-5 星评分并填写评价内容评价后工单状态变更为“已评价”。水电账单查询查看本人房间的水电账单列表包含用电量、用水量、电费、水费、总金额、账单状态未缴/已缴/逾期、缴费截止日期。在线缴费对未缴账单发起支付支持选择支付方式模拟支付支付成功后自动生成交易流水号并更新账单状态为“已缴”。通知消息中心接收系统推送通知工单派单通知、工单完成通知支持查看未读消息数量、标记单条已读、一键全部已读。公告浏览查看管理员发布的宿舍公告支持按公告类型筛选置顶公告优先展示。知识库查询浏览常见故障知识库支持按分类筛选、关键词搜索查看故障症状、解决方案、所需零件及预计维修时长。维修工端工单列表查看查看分配给本人的工单列表支持按状态、分类、优先级筛选输入关键词可搜索工单标题或工单编号。工单签到到达维修现场后进行签到操作上传签到照片、填写签到经纬度坐标工单状态变更为“处理中”。工单完成维修完成后上传完工照片、填写维修备注、登记使用的备件信息工单状态变更为“已完成”并自动通知学生进行评价。备件库存查询查看备件列表备件名称、分类、规格、单位、库存数量、预警库存、单价支持按名称关键词搜索。知识库参考查询故障知识库获取常见故障的标准解决方案与所需备件清单。四、项目总结本系统的技术亮点在于完整落地了 RBAC 权限模型与 JWT 无状态认证并在业务层面覆盖了报修工单全生命周期、阶梯计费、SLA 策略、操作审计等企业级功能点。前端采用 Vue 3 Vite 的现代化工程化方案后端使用 SpringBoot 3 MyBatis-Plus 提升开发效率Redis 的引入为后续扩展缓存与消息推送留出了空间。系统角色划分清晰、功能边界明确适合作为高校计算机相关专业的毕业设计项目也适合需要快速搭建宿舍管理系统的企业进行二次开发。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K333
