|
|
@@ -0,0 +1,191 @@
|
|
|
+# 宿舍管理系统 (Dormitory Management System)
|
|
|
+
|
|
|
+基于 **SSM（Spring + Spring MVC + MyBatis）** 框架的高校宿舍管理系统，提供线上化的宿舍资源管理和学生自助服务。
|
|
|
+
|
|
|
+## 项目背景
|
|
|
+
|
|
|
+传统高校宿舍管理多依赖纸质表格或 Excel 记录，存在信息分散、更新滞后、学生体验差、管理效率低等问题。本系统旨在通过信息化手段解决上述痛点，实现宿舍管理的数字化和自动化。
|
|
|
+
|
|
|
+## 技术栈
|
|
|
+
|
|
|
+| 层级 | 技术 | 版本 |
|
|
|
+|------|------|------|
|
|
|
+| 语言 | Java | JDK 8 |
|
|
|
+| 核心框架 | Spring (IoC, AOP, TX) | 5.3.31 |
|
|
|
+| Web MVC | Spring MVC | 5.3.31 |
|
|
|
+| ORM | MyBatis | 3.5.6 |
|
|
|
+| 数据库 | MySQL | 8.0.25 |
|
|
|
+| 连接池 | Druid | 1.2.8 |
|
|
|
+| 分页 | PageHelper | 5.3.2 |
|
|
|
+| 视图 | JSP + JSTL + EL | Servlet 4.0 |
|
|
|
+| 前端 | Bootstrap 4.3.1 + jQuery 3.3.1 | CDN |
|
|
|
+| 构建工具 | Maven | 3.x |
|
|
|
+| 服务器 | Apache Tomcat | 9.x |
|
|
|
+
|
|
|
+## 系统架构
|
|
|
+
|
|
|
+采用 **SSM 三层架构 + MVC 设计模式**：
|
|
|
+
|
|
|
+```
|
|
|
+表示层 (JSP + Bootstrap + jQuery)
|
|
|
+ ↓ HTTP 请求 / 响应
|
|
|
+控制层 (Spring MVC @Controller)
|
|
|
+ ↓
|
|
|
+服务层 (Service Interface + Impl + @Transactional)
|
|
|
+ ↓
|
|
|
+持久层 (MyBatis Mapper Interface + XML SQL)
|
|
|
+ ↓
|
|
|
+数据库 (MySQL)
|
|
|
+```
|
|
|
+
|
|
|
+请求经过 `DispatcherServlet` → 拦截器链（`LoginInterceptor` → `AuthInterceptor`）→ `@Controller` → `Service` → `Mapper` → 数据库。
|
|
|
+
|
|
|
+## 功能模块
|
|
|
+
|
|
|
+### 1. 认证与授权
|
|
|
+- 用户名/密码登录，MD5 密码加密
|
|
|
+- Session 会话管理
|
|
|
+- 双角色：管理员（role=0）和学生（role=1）
|
|
|
+- 未登录拦截 + 管理员权限拦截
|
|
|
+
|
|
|
+### 2. 宿舍楼管理（管理员）
|
|
|
+- 宿舍楼的增删改查
|
|
|
+- 分页查询与条件过滤（名称、编号、性别类型）
|
|
|
+- 删除时校验是否存在关联房间
|
|
|
+
|
|
|
+### 3. 房间管理（管理员）
|
|
|
+- 按楼栋管理房间，增删改查
|
|
|
+- 分页查询，按楼栋和楼层过滤
|
|
|
+- 删除时校验是否存在关联床位
|
|
|
+
|
|
|
+### 4. 床位管理（管理员）
|
|
|
+- 按房间管理床位，增删改查
|
|
|
+- 分页查询，按楼栋和房间号过滤
|
|
|
+- 床位状态：空闲 / 已入住 / 维修
|
|
|
+- 删除时校验是否为占用状态
|
|
|
+
|
|
|
+### 5. 用户管理（管理员）
|
|
|
+- 学生账户的增删改查
|
|
|
+- 分页查询，按姓名、性别、学号过滤
|
|
|
+- 头像上传功能
|
|
|
+- 删除时校验是否当前有住宿记录
|
|
|
+
|
|
|
+### 6. 分配管理（管理员）
|
|
|
+- 查看所有住宿分配记录（关联用户、楼栋、房间、床位）
|
|
|
+- 手动分配学生到指定床位
|
|
|
+- 退宿操作（结宿日期 + 床位释放）
|
|
|
+
|
|
|
+### 7. 学生自助服务（学生端）
|
|
|
+- 查看个人信息和当前住宿情况
|
|
|
+- 头像上传（验证图片类型，最大 2MB）
|
|
|
+- 三步选宿向导：选择楼栋 → 选择房间 → 选择床位
|
|
|
+- 按性别过滤可选床位
|
|
|
+- 事务保障：防止重复分配
|
|
|
+
|
|
|
+## 数据库设计
|
|
|
+
|
|
|
+| 表名 | 说明 |
|
|
|
+|------|------|
|
|
|
+| `user` | 用户表（管理员 + 学生） |
|
|
|
+| `dormitory_building` | 宿舍楼表 |
|
|
|
+| `room` | 房间表 |
|
|
|
+| `bed` | 床位表 |
|
|
|
+| `assignment` | 分配记录表 |
|
|
|
+
|
|
|
+**预置数据：**
|
|
|
+
|
|
|
+| 用户名 | 密码 | 角色 |
|
|
|
+|--------|------|------|
|
|
|
+| admin | admin123 | 管理员 |
|
|
|
+| zhangsan | 123456 | 学生 |
|
|
|
+| lisi | 123456 | 学生 |
|
|
|
+| wangwu | 123456 | 学生 |
|
|
|
+
|
|
|
+## 快速开始
|
|
|
+
|
|
|
+### 环境要求
|
|
|
+
|
|
|
+- JDK 8+
|
|
|
+- Maven 3.x
|
|
|
+- MySQL 8.0
|
|
|
+- Apache Tomcat 9.x（或使用 `tomcat7-maven-plugin`）
|
|
|
+
|
|
|
+### 安装步骤
|
|
|
+
|
|
|
+1. **克隆项目**
|
|
|
+ ```bash
|
|
|
+ git clone <repository-url>
|
|
|
+ cd dormitory_manage
|
|
|
+ ```
|
|
|
+
|
|
|
+2. **初始化数据库**
|
|
|
+ ```bash
|
|
|
+ mysql -u root -p < sql/init.sql
|
|
|
+ ```
|
|
|
+
|
|
|
+3. **配置数据库连接**
|
|
|
+
|
|
|
+ 编辑 `src/main/resources/jdbc.properties`，修改数据库用户名和密码：
|
|
|
+ ```properties
|
|
|
+ jdbc.driver=com.mysql.cj.jdbc.Driver
|
|
|
+ jdbc.url=jdbc:mysql://localhost:3306/dormitory_manage?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
|
|
|
+ jdbc.username=root
|
|
|
+ jdbc.password=root
|
|
|
+ ```
|
|
|
+
|
|
|
+4. **启动项目**
|
|
|
+
|
|
|
+ 方式一：使用 Maven 插件
|
|
|
+ ```bash
|
|
|
+ mvn tomcat7:run
|
|
|
+ ```
|
|
|
+
|
|
|
+ 方式二：部署 WAR 包到 Tomcat
|
|
|
+ ```bash
|
|
|
+ mvn package
|
|
|
+ # 将 target/dormitory_manage.war 部署到 Tomcat 的 webapps 目录
|
|
|
+ ```
|
|
|
+
|
|
|
+5. **访问系统**
|
|
|
+
|
|
|
+ 打开浏览器访问 `http://localhost:8080/`
|
|
|
+
|
|
|
+### 默认账号
|
|
|
+
|
|
|
+- **管理员**：`admin` / `admin123`
|
|
|
+- **学生**：`zhangsan` / `123456`
|
|
|
+
|
|
|
+## 项目结构
|
|
|
+
|
|
|
+```
|
|
|
+dormitory_manage/
|
|
|
+├── doc/ # 项目文档
|
|
|
+│ └── work.md # 详细项目报告
|
|
|
+├── sql/
|
|
|
+│ └── init.sql # 数据库初始化脚本
|
|
|
+├── src/
|
|
|
+│ └── main/
|
|
|
+│ ├── java/space/anyi/
|
|
|
+│ │ ├── common/ # 公共工具类（Result, PageResult）
|
|
|
+│ │ ├── controller/ # Controller 层
|
|
|
+│ │ ├── entity/ # 实体类
|
|
|
+│ │ ├── interceptor/ # 拦截器（登录 + 权限）
|
|
|
+│ │ ├── mapper/ # MyBatis Mapper 接口
|
|
|
+│ │ └── service/ # Service 层（接口 + 实现）
|
|
|
+│ ├── resources/
|
|
|
+│ │ ├── mapper/ # MyBatis XML 映射文件
|
|
|
+│ │ ├── jdbc.properties # 数据库配置
|
|
|
+│ │ ├── logback.xml # 日志配置
|
|
|
+│ │ ├── mybatis-config.xml
|
|
|
+│ │ ├── spring-context.xml
|
|
|
+│ │ └── spring-mvc.xml
|
|
|
+│ └── webapp/
|
|
|
+│ ├── WEB-INF/
|
|
|
+│ │ ├── web.xml
|
|
|
+│ │ └── views/ # JSP 视图文件
|
|
|
+│ │ ├── admin/ # 管理员页面
|
|
|
+│ │ └── student/ # 学生页面
|
|
|
+│ └── static/
|
|
|
+│ └── uploads/ # 头像上传目录
|
|
|
+└── pom.xml # Maven 构建配置
|
|
|
+```
|
