一、项目简介

本项目是一套基于 Spring Boot 3 + Vue 3 + MySQL 构建的宿舍管理系统，采用前后端分离架构。系统覆盖宿舍楼栋/房间/床位管理、学生入住退宿、在线报修与维修派单、晚归未归申请与审核、宿舍费用账单与在线缴费、数据统计分析及操作日志审计等核心业务。系统包含管理员、学生、维修人员三种角色，实现宿舍全流程数字化管理。

二、技术栈

三、功能模块

管理员端

• 数据总览仪表盘：展示学生总数、楼栋数、房间数、空闲床位数、待处理报修数、维修中报修数、待审核晚归申请数、未缴费账单数等关键统计指标
• 宿舍楼栋管理：新增/修改/删除楼栋，填写楼栋名称、总楼层数、描述信息；删除时自动校验楼栋下是否存在房间
• 房间管理：新增房间时自动按容量生成对应数量的可用床位（如容量4人则创建4张1号床~4号床）；支持按楼栋筛选、按房间号搜索；删除房间时校验是否有学生入住
• 床位管理：分页查看所有床位列表，支持按房间ID和状态筛选；查看每张床位的所属楼栋、房间号、床号、当前入住学生姓名
• 学生信息管理：新增学生时自动创建系统账号（用户名为学号，默认密码123456），同时自动分配床位并更新房间入住人数；支持修改/删除学生（自动释放床位并删除对应用户账号）；提供按关键词（姓名/学号/班级）、楼栋、入住状态筛选
• 用户管理：新增/修改/删除用户（维修人员/其他角色），支持按用户名、姓名、手机号搜索及按角色筛选；可启用/禁用用户账号；支持重置用户密码为123456
• 报修工单管理：查看所有报修记录，支持按状态和关键词（标题/位置）筛选；指派维修人员；更新维修状态（待处理→已指派→维修中→已完成/已取消）；填写维修反馈
• 晚归/未归申请审核：查看学生提交的晚归/未归记录列表，支持按类型和状态筛选；审核通过或驳回申请，填写审核意见
• 账单管理：新增/修改/删除宿舍费用账单，填写标题、金额、类型、学期、到期日、关联学生；支持按类型和状态筛选，按标题关键词搜索
• 统计分析：展示各楼栋床位总数、已入住数及入住率；查看报修工单状态分布统计（待处理/已指派/维修中/已完成/已取消）；查看缴费统计（已缴费/未缴费数量）
• 操作日志管理：分页展示所有操作记录，支持按模块筛选和按操作人/操作内容关键词搜索；支持一键清空所有日志

普通用户端（学生）

• 个人宿舍信息查看：显示所在楼栋、房间号、床位号、入住日期及入住状态
• 设备报修申请：填写报修标题、详细描述、故障位置（楼栋/房间）、上传图片、设置优先级；支持修改未处理的报修单、取消报修
• 报修记录跟踪：查看个人报修记录列表，实时跟踪报修处理状态（待处理→已指派→维修中→已完成/已取消）
• 晚归/未归申请：选择类型（晚归/未归）、填写原因、预计返回时间；在未审核前可修改申请内容
• 申请记录查看：查看个人晚归/未归申请记录及审核结果（待审核/已通过/已驳回）
• 个人账单查看：查看个人宿舍费用账单列表，支持按类型和状态筛选
• 在线缴费：选择未缴费的账单进行缴费，系统自动记录缴费时间并更新账单状态为已缴费
• 缴费历史查询：查看个人缴费历史记录，包含缴费金额、缴费时间、对应账单标题
• 密码修改：修改个人登录密码，需输入原密码验证

维修人员端

• 任务列表查看：查看分配给自己的维修任务列表，同时可查看所有待处理的报修工单
• 任务状态更新：将任务从已指派更新为维修中，维修完成后标记为已完成并填写维修反馈
• 个人信息查看：查看个人基本信息

四、项目总结

本项目技术亮点包括：基于Spring Boot 3 + Vue 3的前后端分离架构，采用JWT Token实现无状态权限认证，通过MyBatis-Plus简化数据访问层开发。系统覆盖宿舍管理的完整业务流程，包含自动床位分配、报修工单流转、费用在线缴纳等实用功能，适合作为Java全栈开发学习项目或宿舍管理系统的二次开发基础。

界面展示

交付内容

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

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

获取完整源码

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