# 学生宿舍管理系统

**Repository Path**: hellorester/dormitory_management_system

## Basic Information

- **Project Name**: 学生宿舍管理系统
- **Description**: 0123456789
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

```markdown
# 高校学生宿舍管理系统 (Dormitory Management System)

这是一个基于 **Vue 3** 前端、**Node.js (Express)** 后端以及 **MySQL 8.0** 数据库开发的完整全栈宿舍管理系统。系统支持“学生”和“管理员”两种角色，具备身份鉴权（JWT）、宿舍床位动态分配、水电费管理、故障报修、卫生评比红黑榜以及出入安保登记等核心功能。

---

## 环境准备

在运行本项目前，请确保你的电脑上已经安装了以下软件：
1. **Node.js**：建议使用 v18.x 或更高 LTS 版本（[下载官网](https://nodejs.org/)）。

---

## 快速启动指南

整个项目分为三大步：运行数据库脚本、启动后端、启动前端。

### 第一步：运行数据库脚本

找到database/database.txt，里面是我用到的全部数据库脚本，数据库管理系统用的是MySQL，如果你用的是别的数据库管理系统，让AI转一下就行。先创建一个数据库，使用这个数据库，然后直接运行整个脚本初始化数据库。

---

### 第二步：配置并启动后端服务 (Node.js)

1. 在终端中进入后端文件夹：
   ```bash
   cd backend_end

```

2. **修改数据库连接**：
用编辑器打开 `app.js`，找到第 14-17 行的 `pool` 配置，将 `user` 和 `password` 修改为你本地 MySQL 的账号和密码：
```javascript
const pool = mysql.createPool({
    host: 'localhost',       
    user: '你的数据库用户名', // 默认为 root
    password: '你的数据库密码', // 修改为你本地的密码
    database: 'dormitory_management_system',
    // ... 其他配置保持不动
});

```


3. **安装依赖包**：
在终端运行以下命令：
```bash
npm install

```


4. **启动服务**：
```bash
node app.js

```


*控制台输出 `后端服务器已启动，监听端口: http://localhost:3000` 即代表成功。请保持该窗口不要关闭。*

---

### 第三步：启动前端服务 (Vue 3)

1. 重新打开一个终端窗口，进入前端项目文件夹：
```bash
cd front_end

```


2. **安装依赖包**：
```bash
npm install

```


3. **启动开发服务器**：
```bash
npm run dev

```


4. **访问系统**：
控制台会输出一个本地访问链接（通常是 `http://localhost:5173` ），复制该链接到浏览器中打开，即可进入系统登录页面。

---

在database.txt中有用到存储过程初始化room和bed两张表的信息，但是user表是空的，可以先运行"insert into user values"插入一条管理员的信息，然后用管理员登录进去，在管理员登录进去之后可以添加学生或者管理员用户。

---

## 项目目录结构参考

```text
dormitory_management_system/
├── back_end/                   # 后端项目 (Node.js Express)
│   ├── app.js                  # 后端核心业务接口及逻辑
│   ├── package.json            # 后端依赖配置文件
│   └── ...
├── front_end/                  # 前端项目 (Vue 3 + Vite)
│   ├── src/                    # 源码目录 (Views、Router、Stores等)
│   ├── index.html              # 入口 HTML
│   ├── package.json            # 前端依赖配置文件
│   └── ...
├── database/                   # 数据库 
│   ├── database.txt/           # 数据库脚本 
│
└── README.md                   # 项目使用说明书（本文件）

```

---

## 常见问题排查 (FAQ)

1. **报错：`Port 3000 already in use**`
* **原因**：上一次运行的 Node 进程没有关闭彻底，或者其他程序占用了 3000 端口。
* **解决**：Windows 下运行 `taskkill /f /im node.exe` 强行杀死所有 Node 进程，然后再重新启动。


2. **前端页面打不开，或者点击登录没反应**
* **原因**：后端没有成功启动，或者前端请求的后端接口地址/端口与后端不匹配。
* **解决**：请确保后端 `app.js` 正在运行，且终端没有报错提示。