基于 Django 的学生宿舍管理系统设计与实现
项目简介
面向高校后勤的宿舍管理系统：以「楼栋—楼层—房间—床位」四级结构管理宿舍资源，覆盖入住、调寝、退宿、报修受理、卫生检查与统计报表导出。床位状态机与事务保证数据一致，演示数据可一键重置。
演示视频
视频也可在 B 站视频页 观看
运行环境
| 编程语言 | Python 3.8 及以上 |
|---|---|
| Web 框架 | Django 4.2 |
| 数据库 | MySQL 5.7 及以上 |
| 前端 | Bootstrap 5（CDN 引入，无需前端构建） |
| 报表导出 | openpyxl |
| 图片处理 | Pillow（报修单现场图片） |
| 操作系统 | Windows / macOS / Linux |
| 启动方式 | 双击一键脚本，或 python manage.py runserver |
功能模块
- 用户与角色：学生 / 宿管员 / 管理员，菜单与操作按角色控制
- 宿舍资源：楼栋 · 楼层 · 房间 · 床位 四级结构，床位状态可视化（空闲 / 已入住 / 维修中 / 锁定）
- 住宿管理：入住、调寝、退宿办理，床位冲突校验 + 事务原子性，调寝自动释放旧床位并留痕
- 报修管理：提交 → 派单 → 处理 → 完成 → 评价，全流程状态机约束与日志留痕
- 卫生检查：按五项检查打分，自动汇总总分并评级（优秀 / 合格 / 不合格）
- 统计报表：各楼栋入住率、报修状态与类别分布、卫生评分排行，一键导出 Excel
交付内容
- 完整源码（已跑通，含 4 栋楼 / 120 房间 / 480 床位 / 360 学生演示数据）
- 毕业设计任务书（Word）
- 开题报告（Word）
- 毕业论文（Word，七章制，含图表）
- 系统使用与二次开发说明（Word + md）
- 11 张系统运行截图
界面截图
文档预览
交付的任务书、开题报告与论文均为 Word 文档，下面是真实页面预览：
常见问题
项目能直接跑起来吗？
能。源码里已带数据库与演示数据，安装依赖后双击一键脚本或按说明启动即可。
数据是怎么来的？
本系统是校内管理系统，演示数据由 seed_data 命令按真实业务规则程序生成（固定随机种子，结果可复现），不涉及外部数据抓取。
床位会不会重复分配？
不会。住宿记录表对「同一床位」与「同一学生」建立了条件唯一约束，配合事务处理，重复分配会被拦截。
调寝时旧床位怎么处理？
调寝在同一个事务里完成：关闭旧记录、释放旧床位、建立新记录、占用新床位，不会出现中间状态。
网站文字、颜色怎么改？
页面在 templates/ 目录，配色的在 static/css/style.css；《系统使用与二次开发说明》里给了逐处对照表。
有几种系统角色？
三种：学生、宿管员、管理员；文档里给了新增角色的做法。