项目名称：宿舍管理系统
技术栈：SpringBoot + Vue3 + MySQL + MyBatis-Plus
开发模式：前后端分离
用户角色：管理员、学生

目录

1. 项目概述

2. 可行性分析

3. 需求分析

4. 系统总体设计

5. 数据库设计

6. 系统功能详细设计

7. 接口设计

8. 开发部署环境

9. 系统测试

10. 总结与展望

1. 项目概述

1.1 项目背景

随着高校办学规模扩大，在校学生数量持续增加，传统人工宿舍管理方式效率低下。宿舍入住登记、设施故障报修、宿舍信息统计、通知公告发布等工作依靠纸质记录，存在查询困难、流程繁琐、信息容易丢失等问题。
为实现宿舍管理数字化、线上化，开发宿舍管理系统，将管理员、学生两类用户纳入平台，线上完成入住申请、维修报修、信息发布、审批管理等业务，提升宿舍管理工作效率。

1.2 项目目标

1. 搭建前后端分离架构的宿舍管理平台，区分管理员、学生两种操作权限；

2. 实现学生账号注册、登录；学生在线查看宿舍、提交入住申请、提交维修申请、浏览公告；

3. 管理员管理学生信息、宿舍信息，审核入住申请、处理维修工单，发布系统公告；

4. 实现维修进度跟踪、入住信息统一管理；

5. 提供数据列表分页、条件搜索、详情查看功能，简化日常管理操作。

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 用户角色

1. 学生
   注册账号、登录系统；查看宿舍信息、提交入住申请；提交设施维修申请；查看维修进度；浏览公告信息；查看个人入住状态。

2. 管理员
   登录后台；管理学生账号、管理员账号；维护宿舍基础信息；审核学生入住申请；管理入住信息；处理维修申请、登记维修进度；发布、管理公告。

3.2 功能性需求

（1）登录注册模块

• 登录页面：选择角色（管理员 / 学生），输入账号密码登录；

• 学生注册：填写学号、密码、姓名、头像、性别、手机号完成注册；

（2）学生端功能

1. 首页：系统欢迎页面；

2. 宿舍管理：浏览宿舍信息，查看宿舍详情、提交入住申请；

3. 维修管理：提交维修申请，查询维修进度；

4. 公告栏：查看全部系统公告；

（3）管理员端功能

1. 首页：系统欢迎页面；

2. 管理员管理：维护平台管理员账号；

3. 学生管理：管理全部学生账号信息；

4. 宿舍管理模块

   • 宿舍信息：维护所有宿舍基础数据；

   • 入住申请：查看学生提交的入住申请，进行审核、查看详情、删除记录；

   • 入住信息：查看所有已审批通过的入住记录；

5. 维修管理模块

   • 维修申请：查看学生报修工单，审核工单；

   • 维修进度：登记维修处理进度；

6. 公告栏：新增、编辑、删除公告，支持标题搜索；

3.3 非功能性需求

1. 安全性：密码加密存储，基于 JWT 实现权限隔离，学生无法访问管理员专属操作；

2. 易用性：所有列表支持分页、条件搜索，表单前端校验；

3. 兼容性：支持 Chrome、Edge 主流浏览器；

4. 扩展性：模块化开发，后续可拓展水电费管理、访客登记、宿舍卫生检查模块；

5. 性能：分页查询优化，图片轻量化加载，页面响应流畅。

4. 系统总体设计

4.1 系统架构（前后端分离）

前端Vue页面 <--HTTP请求--> SpringBoot后端服务 <--> MySQL数据库

分层结构：

• 表现层：Vue 前端页面渲染、交互

• 控制层：Controller 接收请求

• 业务层：Service 实现业务逻辑（审核、申请流程）

• 持久层：Mapper 操作数据库

• 数据层：MySQL 持久化存储数据

4.2 系统模块划分

1. 身份认证模块（登录、学生注册、权限控制）

2. 用户管理模块（管理员管理、学生管理）

3. 宿舍管理模块（宿舍信息、入住申请、入住信息）

4. 维修管理模块（维修申请、维修进度）

5. 公告管理模块

4.3 核心业务流程

1. 学生入住流程
   学生登录 → 浏览宿舍信息 → 提交入住申请 → 管理员后台查看申请 → 管理员审核（通过 / 驳回）→ 审核通过后生成入住信息记录。

2. 维修报修流程
   学生提交维修申请 → 管理员查看报修工单 → 管理员审核工单 → 维修人员处理，管理员登记维修进度 → 学生查看维修进度。

3. 公告发布流程
   管理员登录后台 → 新增公告（标题、图片、内容）→ 保存发布 → 学生在公告栏浏览公告。

5. 数据库设计

5.1 数据表结构

1. admin 管理员表
   | 字段 | 类型 | 说明 |
   |----|----|----|
   |id|bigint | 主键 |
   |username|varchar | 登录账号 |
   |password|varchar | 密码 |
   |name|varchar | 管理员名称 |

2. student 学生表
   | 字段 | 类型 | 说明 |
   |----|----|----|
   |id|bigint | 主键 |
   |stu_id|varchar | 学号（登录账号）|
   |password|varchar | 密码 |
   |name|varchar | 学生姓名 |
   |avatar|varchar | 头像地址 |
   |sex|varchar | 性别 |
   |phone|varchar | 手机号 |
   |create_time|datetime | 注册时间 |

3. dormitory 宿舍信息表
   | 字段 | 类型 | 说明 |
   |----|----|----|
   |id|bigint | 主键 |
   |dorm_no|varchar | 宿舍号 |
   |dorm_type|varchar | 宿舍类型（男生 / 女生宿舍）|
   |location|varchar | 宿舍位置 |
   |bed_num|int | 床位数 |
   |remark|text | 备注信息 |

4. checkin_apply 入住申请表
   | 字段 | 类型 | 说明 |
   |----|----|----|
   |id|bigint | 主键 |
   |dorm_id|bigint | 宿舍 id|
   |stu_id|bigint | 学生 id|
   |apply_date|date | 申请日期 |
   |audit_status|varchar | 审核状态（待审核 / 通过 / 驳回）|
   |audit_reply|text | 管理员审核回复 |

5. checkin_info 入住信息表
   | 字段 | 类型 | 说明 |
   |----|----|----|
   |id|bigint | 主键 |
   |dorm_id|bigint | 宿舍 id|
   |stu_id|bigint | 学生 id|
   |checkin_time|datetime | 入住时间 |

6. 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 | 维修进度 |

7. notice 公告表
   | 字段 | 类型 | 说明 |
   |----|----|----|
   |id|bigint | 主键 |
   |title|varchar | 公告标题 |
   |img_url|varchar | 公告图片 |
   |content|text | 公告内容 |
   |create_time|datetime | 创建时间 |

6. 系统功能详细设计

6.1 登录注册模块

1. 登录界面：提供角色下拉框，支持管理员、学生登录入口；

2. 学生注册页面：填写学号、密码、姓名、头像、性别、手机号完成注册；已有账号可跳转登录。

6.2 管理员功能模块

1. 首页：欢迎页面，系统入口；

2. 管理员管理：新增、修改、删除系统管理员账号；

3. 学生管理：查询、维护所有学生账号信息；

4. 宿舍管理

   • 宿舍信息：新增、编辑、删除宿舍记录；学生可在此页面发起入住申请；

   • 入住申请：展示学生提交申请，支持按学号、状态搜索，执行审核、查看详情、删除操作；

   • 入住信息：展示所有审核通过的学生入住记录；

5. 维修管理

   • 维修申请：查看报修工单，支持条件检索，执行审核；

   • 维修进度：登记工单维修处理进度；

6. 公告栏：公告新增、修改、删除，支持标题搜索查看公告。

6.3 学生功能模块

1. 首页：系统欢迎页面；

2. 宿舍管理：查看全部宿舍信息，选择宿舍提交入住申请；查看个人入住申请状态；

3. 维修管理：填写故障信息提交维修申请；查看自己提交工单的维修进度；

4. 公告栏：浏览管理员发布的所有公告。

7. 核心接口设计（REST 风格）

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 运行

部署步骤

1. 执行 SQL 脚本，创建数据库与数据表；

2. 修改后端 application.yml 数据库连接配置；

3. Maven 打包后端项目为 jar 包；

4. Vue 前端执行npm run build打包静态资源；

5. 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套》
《微信小程序合集》