【万字文档+源码】 基于springboot+vue宿舍管理系统项目-可用于毕设-课程设计-练手学习-学习资料分享
基于springboot+vue宿舍管理系统
项目名称:宿舍管理系统
技术栈:SpringBoot + Vue3 + MySQL + MyBatis-Plus
开发模式:前后端分离
用户角色:管理员、学生
目录
项目概述
可行性分析
需求分析
系统总体设计
数据库设计
系统功能详细设计
接口设计
开发部署环境
系统测试
总结与展望
1. 项目概述
1.1 项目背景
随着高校办学规模扩大,在校学生数量持续增加,传统人工宿舍管理方式效率低下。宿舍入住登记、设施故障报修、宿舍信息统计、通知公告发布等工作依靠纸质记录,存在查询困难、流程繁琐、信息容易丢失等问题。
为实现宿舍管理数字化、线上化,开发宿舍管理系统,将管理员、学生两类用户纳入平台,线上完成入住申请、维修报修、信息发布、审批管理等业务,提升宿舍管理工作效率。
1.2 项目目标
搭建前后端分离架构的宿舍管理平台,区分管理员、学生两种操作权限;
实现学生账号注册、登录;学生在线查看宿舍、提交入住申请、提交维修申请、浏览公告;
管理员管理学生信息、宿舍信息,审核入住申请、处理维修工单,发布系统公告;
实现维修进度跟踪、入住信息统一管理;
提供数据列表分页、条件搜索、详情查看功能,简化日常管理操作。
1.3 技术选型
后端
SpringBoot 2.7.x:服务快速开发框架
MyBatis-Plus:持久层操作框架
MySQL 8.0:关系型数据库
JWT:登录身份认证
Maven:项目依赖管理
前端
Vue3
Element Plus UI 组件库
Axios:前后端接口通信
Vue Router:路由管理
开发工具
IDEA、VSCode、Navicat、Postman
2. 可行性分析
2.1 技术可行性
SpringBoot+Vue 是主流成熟前后端分离方案,登录注册、表单提交、列表分页、文件上传、流程审核等功能都具备成熟实现方案,开发难度可控。
2.2 经济可行性
系统全部采用开源组件,无版权费用;可部署在普通云服务器,硬件成本低,后期维护简单,适合院校长期使用。
2.3 操作可行性
系统界面采用标准后台管理布局,导航清晰,表单操作简单,管理员与学生经过简单指导即可熟练使用。
2.4 社会可行性
系统实现宿舍管理数字化,减少线下纸质流程,降低宿管人员工作压力,方便学生线上办理宿舍相关业务,具备很高实用价值。
3. 需求分析
3.1 用户角色
学生
注册账号、登录系统;查看宿舍信息、提交入住申请;提交设施维修申请;查看维修进度;浏览公告信息;查看个人入住状态。管理员
登录后台;管理学生账号、管理员账号;维护宿舍基础信息;审核学生入住申请;管理入住信息;处理维修申请、登记维修进度;发布、管理公告。
3.2 功能性需求
(1)登录注册模块
登录页面:选择角色(管理员 / 学生),输入账号密码登录;
学生注册:填写学号、密码、姓名、头像、性别、手机号完成注册;
(2)学生端功能
首页:系统欢迎页面;
宿舍管理:浏览宿舍信息,查看宿舍详情、提交入住申请;
维修管理:提交维修申请,查询维修进度;
公告栏:查看全部系统公告;
(3)管理员端功能
首页:系统欢迎页面;
管理员管理:维护平台管理员账号;
学生管理:管理全部学生账号信息;
宿舍管理模块
宿舍信息:维护所有宿舍基础数据;
入住申请:查看学生提交的入住申请,进行审核、查看详情、删除记录;
入住信息:查看所有已审批通过的入住记录;
维修管理模块
维修申请:查看学生报修工单,审核工单;
维修进度:登记维修处理进度;
公告栏:新增、编辑、删除公告,支持标题搜索;
3.3 非功能性需求
安全性:密码加密存储,基于 JWT 实现权限隔离,学生无法访问管理员专属操作;
易用性:所有列表支持分页、条件搜索,表单前端校验;
兼容性:支持 Chrome、Edge 主流浏览器;
扩展性:模块化开发,后续可拓展水电费管理、访客登记、宿舍卫生检查模块;
性能:分页查询优化,图片轻量化加载,页面响应流畅。
4. 系统总体设计
4.1 系统架构(前后端分离)
前端Vue页面 <--HTTP请求--> SpringBoot后端服务 <--> MySQL数据库分层结构:
表现层:Vue 前端页面渲染、交互
控制层:Controller 接收请求
业务层:Service 实现业务逻辑(审核、申请流程)
持久层:Mapper 操作数据库
数据层:MySQL 持久化存储数据
4.2 系统模块划分
身份认证模块(登录、学生注册、权限控制)
用户管理模块(管理员管理、学生管理)
宿舍管理模块(宿舍信息、入住申请、入住信息)
维修管理模块(维修申请、维修进度)
公告管理模块
4.3 核心业务流程
学生入住流程
学生登录 → 浏览宿舍信息 → 提交入住申请 → 管理员后台查看申请 → 管理员审核(通过 / 驳回)→ 审核通过后生成入住信息记录。维修报修流程
学生提交维修申请 → 管理员查看报修工单 → 管理员审核工单 → 维修人员处理,管理员登记维修进度 → 学生查看维修进度。公告发布流程
管理员登录后台 → 新增公告(标题、图片、内容)→ 保存发布 → 学生在公告栏浏览公告。
5. 数据库设计
5.1 数据表结构
admin 管理员表
| 字段 | 类型 | 说明 |
|----|----|----|
|id|bigint | 主键 |
|username|varchar | 登录账号 |
|password|varchar | 密码 |
|name|varchar | 管理员名称 |student 学生表
| 字段 | 类型 | 说明 |
|----|----|----|
|id|bigint | 主键 |
|stu_id|varchar | 学号(登录账号)|
|password|varchar | 密码 |
|name|varchar | 学生姓名 |
|avatar|varchar | 头像地址 |
|sex|varchar | 性别 |
|phone|varchar | 手机号 |
|create_time|datetime | 注册时间 |dormitory 宿舍信息表
| 字段 | 类型 | 说明 |
|----|----|----|
|id|bigint | 主键 |
|dorm_no|varchar | 宿舍号 |
|dorm_type|varchar | 宿舍类型(男生 / 女生宿舍)|
|location|varchar | 宿舍位置 |
|bed_num|int | 床位数 |
|remark|text | 备注信息 |checkin_apply 入住申请表
| 字段 | 类型 | 说明 |
|----|----|----|
|id|bigint | 主键 |
|dorm_id|bigint | 宿舍 id|
|stu_id|bigint | 学生 id|
|apply_date|date | 申请日期 |
|audit_status|varchar | 审核状态(待审核 / 通过 / 驳回)|
|audit_reply|text | 管理员审核回复 |checkin_info 入住信息表
| 字段 | 类型 | 说明 |
|----|----|----|
|id|bigint | 主键 |
|dorm_id|bigint | 宿舍 id|
|stu_id|bigint | 学生 id|
|checkin_time|datetime | 入住时间 |repair_apply 维修申请表
| 字段 | 类型 | 说明 |
|----|----|----|
|id|bigint | 主键 |
|dorm_id|bigint | 宿舍 id|
|stu_id|bigint | 学生 id|
|repair_item|varchar | 维修项目 |
|fault_desc|text | 故障详情 |
|audit_status|varchar | 审核状态 |
|audit_reply|text | 审核回复 |
|progress|varchar | 维修进度 |notice 公告表
| 字段 | 类型 | 说明 |
|----|----|----|
|id|bigint | 主键 |
|title|varchar | 公告标题 |
|img_url|varchar | 公告图片 |
|content|text | 公告内容 |
|create_time|datetime | 创建时间 |
6. 系统功能详细设计
6.1 登录注册模块
登录界面:提供角色下拉框,支持管理员、学生登录入口;
学生注册页面:填写学号、密码、姓名、头像、性别、手机号完成注册;已有账号可跳转登录。
6.2 管理员功能模块
首页:欢迎页面,系统入口;
管理员管理:新增、修改、删除系统管理员账号;
学生管理:查询、维护所有学生账号信息;
宿舍管理
宿舍信息:新增、编辑、删除宿舍记录;学生可在此页面发起入住申请;
入住申请:展示学生提交申请,支持按学号、状态搜索,执行审核、查看详情、删除操作;
入住信息:展示所有审核通过的学生入住记录;
维修管理
维修申请:查看报修工单,支持条件检索,执行审核;
维修进度:登记工单维修处理进度;
公告栏:公告新增、修改、删除,支持标题搜索查看公告。
6.3 学生功能模块
首页:系统欢迎页面;
宿舍管理:查看全部宿舍信息,选择宿舍提交入住申请;查看个人入住申请状态;
维修管理:填写故障信息提交维修申请;查看自己提交工单的维修进度;
公告栏:浏览管理员发布的所有公告。
7. 核心接口设计(REST 风格)
| 接口地址 | 请求方式 | 功能 | 访问角色 |
|---|---|---|---|
| /api/admin/login | POST | 管理员登录 | 管理员 |
| /api/student/login | POST | 学生登录 | 学生 |
| /api/student/register | POST | 学生注册 | 学生 |
| /api/dorm/list | GET | 获取宿舍列表 | 全部 |
| /api/checkin/apply | POST | 提交入住申请 | 学生 |
| /api/checkin/apply/list | GET | 查询入住申请 | 全部 |
| /api/checkin/audit | PUT | 审核入住申请 | 管理员 |
| /api/repair/apply | POST | 提交维修申请 | 学生 |
| /api/repair/list | GET | 查询维修工单 | 全部 |
| /api/repair/progress | PUT | 登记维修进度 | 管理员 |
| /api/notice/list | GET | 公告列表查询 | 全部 |
| /api/notice/save | POST | 新增公告 | 管理员 |
8. 部署运行环境
开发环境
操作系统:Windows10/Windows11
JDK:1.8
MySQL:8.0
Node.js:16.x
后端工具:IntelliJ IDEA
前端工具:VS Code
生产部署环境
服务器系统:CentOS7 / CentOS8
数据库:MySQL8.0
前端打包 dist,Nginx 反向代理部署
SpringBoot 项目打包 Jar 运行
部署步骤
执行 SQL 脚本,创建数据库与数据表;
修改后端 application.yml 数据库连接配置;
Maven 打包后端项目为 jar 包;
Vue 前端执行
npm run build打包静态资源;Nginx 托管前端页面,启动后端 jar 包。
9. 系统测试
9.1 功能测试
验证登录注册、宿舍信息维护、入住申请提交与审核、维修工单提交、维修进度登记、公告发布、列表搜索分页、图片上传、表单校验等全部业务功能。
9.2 权限测试
学生无法访问管理员专属管理功能;
学生只能查看、操作本人提交的申请工单;
接口增加权限拦截,防止越权访问。
9.3 兼容性测试
Chrome、Edge 浏览器访问页面,验证页面布局正常,无样式错乱。
9.4 测试结论
系统所有需求功能正常运行,角色权限隔离有效,页面交互符合设计预期,能够满足高校宿舍日常管理业务需求。
10. 总结与展望
10.1 项目总结
本宿舍管理系统基于 SpringBoot+Vue 前后端分离架构开发,分为管理员与学生两大角色。系统实现学生注册登录、宿舍信息查询、入住申请、设施维修报修、公告浏览;管理员完成账号管理、入住审核、维修工单处理、公告发布等核心业务。系统规范宿舍管理流程,将传统线下业务线上化,有效降低宿舍管理工作负担。
11 项目资料
👇🏻 精彩专栏推荐订阅👇🏻 在下方专栏👇🏻不然下次找不到哟
《Java精品推荐项目》
《springboot+vue项目100套》
《ssm项目100套》
《微信小程序合集》
