学生宿舍管理系统产品系统

1. 高校后勤管理的数字化浪潮

近年来，中国高校在校生规模持续扩大（2025年全国高等教育在学总规模已超4700万人），传统
的人工+纸质管理模式已不堪重负。高校后勤信息化是智慧校园建设的核心组成部分，而宿舍管理
又是后勤管理中最复杂、最琐碎的环节。
新生入学季 每年9月数千新生集中入住，需在极短时间内完成宿舍分配、钥匙发放、信息登记，传统方式极易出现重复分配、信息遗漏

2.业务背景
1. 学校管理角色

系统管理员 (SUPER_ADMIN)——最高权限，可以新增账户
宿管员 (ADMIN) ─── 楼栋管理员，负责本楼学生/宿舍/报修/费用
学生 (STUDENT) ─── 报修申请、费用查看、访客登记

2. 核心业务流程
入住流程：学生信息录入 → 分配宿舍/床位 → 确认入住 → 更新床位统计
报修流程：学生提交 → 宿管派单 → 维修员维修 → 宿管验收 → 学生评价（5步闭环）
缴费流程：宿管录入费用 → 学生缴费 → 批量缴费支持 → 欠费统计
访客流程：宿管登记来访 → 记录离开时间 → 历史追溯查询
退宿流程：办理退宿 → 费用清算 → 释放床位
3. 数据层面
系统包含6张核心数据表：user(账号)、student(学生)、dormitory(宿舍)、repair(报修)、fee(
费用)、visitor(访客)，覆盖了宿舍管理的完整业务域。数据看板提供入住率、楼栋统计、报修
概览、欠费概览等关键指标的可视化监控。
三、立项原因
1. 替代手工/Excel模式
大多数中小型高校的宿管中心仍在使用 Excel 表格甚至纸质登记本管理宿舍。

学生宿舍管理系统是一套面向高校后勤的轻量级信息化平台，基于 Spring Boot + Vue 3 +
MySQL 构建，覆盖宿舍管理全生命周期。系统提供三级角色权限：系统管理员可全局管理账号和
系统配置；宿管员负责本楼栋的日常运营；学生可自助办理报修、缴费、查看宿舍信息。登录后
首先呈现数据看板，一目了然地展示当前入住率、各楼栋床位统计、报修工单分布和欠费整体情
况，帮助管理者快速掌握全局动态。

核心功能包括五大模块：学生管理支持学生信息的增删改查，以及入住、退宿、调换宿舍的完整
操作，床位状态实时联动更新。宿舍管理维护楼栋和房间信息，可查看每个房间的入住人数和空
余床位，清晰掌握房源使用情况。报修管理实现了"提交—派单—维修—验收—评价"五步闭环流程，
学生提交报修后宿管派单，维修完成后宿管验收，学生对维修质量进行评价，整个过程可追溯，
杜绝工单丢失和推诿扯皮。费用管理覆盖住宿费、水电费等周期性费用的录入、缴纳和批量收缴
，学生登录即可查看待缴明细，宿管可通过欠费统计精准催缴。访客管理登记外来人员姓名、联
系方式、来访事由和被访学生，并记录到达和离开时间，形成完整的访客日志，保障宿舍安全并
满足事后追溯需求。

系统采用前后端分离架构，后端 Spring Security + JWT 保障接口安全，前端 Element Plus +
ECharts 提供清晰的界面和可视化图表。整体部署简便，功能聚焦实用，适合中小型院校以极低
成本实现宿舍管理从纸质化、Excel化向数字化的转型。

本系统由本人独立完成
本系统采用 Spring Boot + Vue3 前后端分离架构。
后端基于 Spring Boot 2.7 开发，集成 Spring Security + JWT 实现认证授权，MyBatis-Plus 3.5 处理数据持久化；前端基于 Vue3 Composition API + Vite 构建，使用 Element Plus 组件库、Pinia 状态管理、Vue Router 4 路由守卫，ECharts 5.x 实现数据可视化，Axios 拦截器封装 HTTP 请求。数据库采用 MySQL 8.4。
1. JWT无状态认证：自建HMAC-SHA256签名认证体系，Token嵌入userId+username+role三维身份信息，请求过滤器自动校验签名并注入SecurityContext，服务端零状态，重启不丢登录态。
2. 报修状态机：PENDING→ASSIGNED→REPAIRING→COMPLETED→EVALUATED五步严格流转，每步前置状态校验，不合法操作由全局异常处理器统一拦截。
3. 前后端双重权限隔离：后端SecurityConfig控制接口级权限，前端Vue菜单用v-if+Pinia getter按角色显隐，菜单看不到的功能接口也无法越权操作。
4. Axios拦截器统一处理：请求拦截器自动附加Token，响应拦截器统一判断code并处理401/403自动跳转登录页，业务代码零冗余。
5. 统一响应封装Result：泛型响应类区分有数据/无数据场景，静态工厂方法语义清晰，前后端数据结构完全对齐。
6. 数据看板聚合查询：一次接口调用聚合并发查询入住率、学生总数、待处理报修数、欠费统计及楼栋维度分组，减少前端请求次数。
JWT载荷设计、H2迁移MySQL、前后端CORS认证协同