# student-dorm-system

**Repository Path**: Marsfactory/student-dorm-system

## Basic Information

- **Project Name**: student-dorm-system
- **Description**: 大学生宿舍管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-09-16
- **Last Updated**: 2025-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 大学生自选宿舍系统

基于 Spring Boot 3 + Vue 3 + Vite + Pinia 实现的大学生自选宿舍管理系统

## 技术栈

### 后端
- Spring Boot 3.2.0
- JDK 21
- MyBatis Plus 3.5.4
- Sa-Token 1.37.0 (权限认证)
- MySQL 8.0
- Maven

### 前端
- Vue 3.3.4
- Vite 4.4.5
- Pinia 2.1.6 (状态管理)
- Vue Router 4.2.4
- Element Plus 2.3.9 (UI组件库)
- Axios 1.5.0

## 功能模块

### 用户端 (学生)
- 系统登录
- 查看公告
- 选择宿舍系统
- 个人中心
- 宿舍费用支付
- 学生问卷调查
- 宿舍报修

### 管理员端
- 系统登录
- 用户管理
- 宿舍楼管理
- 选宿舍规则管理
- 公告板管理
- 学生住宿费用订单管理
- 统计学生问卷报表
- 学生宿舍报修管理

## 项目结构

```
student-dorm-system/
├── server/                          # 后端项目
│   ├── src/main/java/com/studor/
│   │   ├── controller/              # 控制器层
│   │   ├── service/                 # 服务层
│   │   ├── mapper/                  # 数据访问层
│   │   ├── entity/                  # 实体类
│   │   ├── dto/                     # 数据传输对象
│   │   ├── common/                  # 通用类
│   │   └── config/                  # 配置类
│   ├── src/main/resources/
│   │   └── application.yml          # 应用配置
│   └── pom.xml                      # Maven配置
├── front/                           # 前端项目
│   ├── src/
│   │   ├── components/              # 公共组件
│   │   ├── views/                   # 页面组件
│   │   │   ├── student/             # 学生端页面
│   │   │   └── admin/               # 管理员端页面
│   │   ├── layouts/                 # 布局组件
│   │   ├── router/                  # 路由配置
│   │   ├── stores/                  # Pinia状态管理
│   │   └── utils/                   # 工具函数
│   ├── package.json                 # 前端依赖
│   └── vite.config.js              # Vite配置
└── studor.sql                       # 数据库脚本
```

## 快速开始

### 1. 数据库准备
1. 创建MySQL数据库 `studor`
2. 执行 `studor.sql` 脚本创建表结构和初始数据

### 2. 后端启动
```bash
cd server
mvn clean install
mvn spring-boot:run
```
后端服务将在 http://localhost:8080 启动

### 3. 前端启动
```bash
cd front
npm install
npm run dev
```
前端服务将在 http://localhost:3000 启动

## 测试账号

### 学生账号
- 用户名：w
- 密码：123456

### 管理员账号
- 用户名：test
- 密码：123456

## 主要功能说明

### 学生端功能
1. **登录系统** - 使用学号和密码登录
2. **查看公告** - 浏览学校发布的最新通知和公告
3. **选择宿舍** - 按照楼栋、楼层、房间、床位的顺序选择宿舍
4. **个人中心** - 维护个人信息，包括姓名、专业、联系方式等
5. **费用支付** - 查看和支付宿舍费用订单
6. **问卷调查** - 填写生活习惯问卷，便于宿舍分配
7. **宿舍报修** - 提交宿舍设施报修申请

### 管理员端功能
1. **用户管理** - 查看所有学生信息和宿舍分配情况
2. **宿舍楼管理** - 管理宿舍楼信息，包括楼栋名称和楼层数
3. **规则管理** - 设置选宿规则，如按专业、性别分配
4. **公告管理** - 发布和管理系统公告
5. **订单管理** - 查看所有学生的费用支付情况
6. **问卷统计** - 查看学生问卷调查结果统计
7. **报修管理** - 处理学生提交的报修申请

## 数据库设计

主要数据表：
- `db_account` - 用户账户表
- `db_crudstu` - 学生信息表
- `db_board` - 公告表
- `db_dormitory` - 宿舍楼表
- `db_rooms` - 房间表
- `db_fix` - 报修表
- `db_order` - 订单表
- `db_quest` - 问卷调查表
- `db_rule` - 选宿规则表

## 开发说明

### 后端开发
- 使用 Spring Boot 3 构建 RESTful API
- Sa-Token 提供用户认证和权限控制
- MyBatis Plus 简化数据库操作
- 统一的响应格式和异常处理

### 前端开发
- Vue 3 Composition API 编写组件
- Pinia 管理全局状态
- Element Plus 提供UI组件
- Axios 处理HTTP请求
- Vue Router 实现路由管理

## 贡献

欢迎提交 Issue 和 Pull Request 来改进项目。

## 许可证

MIT License