# 087-Springboot+HTML宿舍管理系统

**Repository Path**: klq007/087-springboot-html-dormitory-management

## Basic Information

- **Project Name**: 087-Springboot+HTML宿舍管理系统
- **Description**: Spring Boot 宿舍管理源码，包含学生、宿舍、卫生、报修和访客管理。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-22
- **Last Updated**: 2026-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 087-Springboot+HTML宿舍管理系统

## 1. 项目简介

Spring Boot 与独立 HTML 前端构成的宿舍管理系统，覆盖楼栋、楼层、宿舍、床位、学生、宿舍选择、缺勤、报修、访客、通知和住宿记录。 项目适合作为 Java Web、软件工程或数据库相关课程设计与毕业设计的学习参考。

> 关注微信小程序：南音源码库，获取更多免费源码资源

![南音源码库小程序二维码](./南音源码库小程序二维码.jpg)

运行教程入口见 [需要运行教程请看这里！.txt](./需要运行教程请看这里！.txt)。

### 1.1 主要角色与功能

| 角色 | 主要功能 |
| --- | --- |
| 宿舍管理员 | 维护楼栋、宿舍、床位、学生、分配与住宿记录，处理缺勤、报修、访客和通知 |
| 学生 | 查看住宿信息、参与宿舍选择、提交报修并接收通知 |

### 1.2 技术栈

| 层次 | 技术 |
| --- | --- |
| 后端 | Java、Spring Boot、MyBatis |
| 前端 | HTML、Layui、Axios |
| 数据库 | MySQL |

### 1.3 项目目录

```text
.
├─ 后端代码/
│  └─ dormitory/        # Java 后端源码与配置
├─ 前端代码/
│  └─ front/        # 独立 HTML 前端
├─ 数据库/                         # MySQL 初始化脚本
├─ 南音源码库小程序二维码.jpg
└─ 需要运行教程请看这里！.txt
```

## 2. 环境要求

- JDK 8
- Maven
- MySQL

## 3. 本地部署

### 3.1 初始化数据库

数据库脚本包含 `DROP TABLE`，导入时会重建同名表，请勿对已有同名业务库直接执行。

```sql
CREATE DATABASE IF NOT EXISTS `dormitory`
  DEFAULT CHARACTER SET utf8mb4;
```

Linux/macOS 命令行示例：

```bash
mysql -u root -p "dormitory" < "数据库/dormitory.sql"
```

Windows CMD 示例：

```bat
mysql -u root -p "dormitory" < "数据库\dormitory.sql"
```

### 3.2 配置并启动后端

1. 编辑 `后端代码/dormitory/src/main/resources/application.yml`，按本机环境设置数据库连接参数和项目运行配置。
2. 进入后端目录并启动：

```bash
cd "后端代码/dormitory"
mvn spring-boot:run
```

后端启动后访问 `http://localhost:8888/dormitory`。

### 3.3 启动静态前端

使用本地静态 Web 服务器托管 `前端代码/front`，并按部署环境调整前端请求的后端地址。


## 4. 服务器构建与部署

### 4.1 构建并运行后端

```bash
cd "后端代码/dormitory"
mvn clean package
java -jar target/*.jar
```

### 4.2 托管静态前端

将 `前端代码/front` 复制到 Nginx 静态站点目录，并把前端请求地址指向已部署的后端服务。