宿舍管理系统

项目简介

基于 SpringBoot + HTML + MySQL 开发的宿舍管理系统，实现了学生宿舍的信息化管理，包括宿舍楼管理、宿舍分配、学生入住、访客登记、维修报修等功能。系统采用前后端分离架构，后端使用 Spring Boot + JPA，前端使用原生 HTML + JavaScript。

技术栈

后端技术

• 框架: Spring Boot 2.6.1
• 数据库: MySQL 5.7 / 8.0
• ORM: Spring Data JPA
• API: Spring Data REST
• 工具类: FastJSON、JXL (Excel操作)
• 构建工具: Maven

前端技术

• HTML5
• CSS3
• JavaScript
• jQuery

功能模块

1. 系统管理员模块

• 管理员登录/退出
• 宿舍管理员管理（增删改查）
• 系统数据统计与可视化

2. 宿舍管理员模块

• 宿舍楼管理（增删改查）
• 宿舍房间管理（增删改查）
• 学生信息管理
• 学生入住管理
• 访客登记管理
• 维修报修管理

3. 学生模块

• 学生登录
• 个人信息查看
• 宿舍信息查看
• 报修申请

4. 核心功能

• 宿舍楼管理: 宿舍楼信息维护、楼栋分配
• 宿舍房间管理: 房间信息、床位数量、入住情况
• 学生管理: 学生基本信息、入住记录
• 访客登记: 访客信息、来访时间、离开时间
• 维修管理: 报修信息、维修进度跟踪
• 数据导出: Excel 数据导出功能

数据库设计

主要数据表

表名	说明
admin	系统管理员表
dormitory_manager	宿舍管理员表
building	宿舍楼表
dormitory	宿舍房间表
student	学生信息表
live	入住记录表
register	访客登记表
maintenance	维修报修表

项目结构

dormitory-management-system/
├── java/                          # 后端项目
│   ├── src/
│   │   └── main/
│   │       ├── java/             # Java 源代码
│   │       └── resources/        # 配置文件
│   │           ├── static/       # 静态资源（HTML/CSS/JS）
│   │           └── application.properties
│   ├── pom.xml                   # Maven 配置
│   ├── dm.sql                    # 数据库脚本
│   └── index.html                # 前端入口页面
├── 文档类--请注意/                # 项目文档
├── 项目部署文档.docx              # 部署说明
└── 视频.mp4                      # 演示视频

快速开始

环境要求

• JDK 1.8+
• Maven 3.6+
• MySQL 5.7+ / 8.0+
• 现代浏览器（Chrome、Firefox、Edge等）

安装步骤

1. 数据库配置

MySQL 5.7 配置

spring.datasource.url=jdbc:mysql://localhost:3306/dm?useUnicode=true&characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=你的密码
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

MySQL 8.0 配置

spring.datasource.url=jdbc:mysql://localhost:3306/dm?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=你的密码
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

2. 导入数据库

# 登录 MySQL
mysql -u root -p

# 创建数据库
CREATE DATABASE dm DEFAULT CHARACTER SET utf8mb4;

# 导入数据
USE dm;
SOURCE /path/to/dm.sql;

3. 启动项目

# 进入项目目录
cd java

# Maven 编译打包
mvn clean package

# 运行项目
java -jar target/dormitory-manage-0.0.1-SNAPSHOT.jar

# 或使用 Maven 直接运行
mvn spring-boot:run

4. 访问系统

打开浏览器访问: http://localhost:8080

默认账号

系统管理员

• 账号: admin
• 密码: admin

宿舍管理员

• 账号: suguan (工号: SG0001)
• 密码: 123456

学生账号

• 账号: zhangsan (学号: S123456)
• 密码: 123456

主要依赖

<!-- Spring Boot Web -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- Spring Data JPA -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

<!-- Spring Data REST -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-rest</artifactId>
</dependency>

<!-- MySQL 驱动 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

<!-- FastJSON -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.76</version>
</dependency>

<!-- JXL Excel 操作 -->
<dependency>
    <groupId>net.sourceforge.jexcelapi</groupId>
    <artifactId>jxl</artifactId>
    <version>2.6.12</version>
</dependency>

系统特点

1. 前后端分离: 后端提供 RESTful API，前端独立开发
2. JPA 自动建表: 使用 Spring Data JPA 自动生成数据表
3. 数据导出: 支持 Excel 格式数据导出
4. 响应式设计: 前端界面适配不同屏幕尺寸
5. 权限管理: 多角色权限控制（管理员、宿管、学生）

开发说明

配置文件位置

• 数据库配置: src/main/resources/application.properties
• JPA 配置: 同上文件中的 spring.jpa.* 配置项

常用配置项

# 服务器端口
server.port=8080

# JPA 配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

# 数据源配置
spring.datasource.url=jdbc:mysql://localhost:3306/dm
spring.datasource.username=root
spring.datasource.password=root

常见问题

1. 数据库连接失败

• 检查 MySQL 服务是否启动
• 确认数据库名称、用户名、密码是否正确
• MySQL 8.0 需要使用 com.mysql.cj.jdbc.Driver

2. 端口被占用

修改 application.properties 中的 server.port 配置

3. 前端页面无法访问

确保静态资源放在 src/main/resources/static 目录下

项目截图

详见项目中的 视频.mp4 演示视频

许可证

本项目仅供学习交流使用

联系方式

如有问题，请查看项目文档或联系开发者