基于 Python + Django 的大学生自习室预约系统

安装部署

1. 环境要求

• Python 3.8+
• MySQL 5.7+
• pip

2. 克隆项目

cd /path/to/your/project

3. 安装依赖

pip install -r requirements.txt

4. 配置数据库

创建 MySQL 数据库：

CREATE DATABASE study_room_booking CHARACTERSET utf8mb4 COLLATE utf8mb4_unicode_ci;

修改 study_room_booking/settings.py 中的数据库配置：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'study_room_booking',
        'USER': 'your_mysql_user',
        'PASSWORD': 'your_mysql_password',
        'HOST': 'localhost',
        'PORT': '3306',
        'OPTIONS': {
            'charset': 'utf8mb4',
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'"
        }
    }
}

5. 执行数据库迁移

python manage.py makemigrations
python manage.py migrate

6. 创建超级管理员

python manage.py createsuperuser

按提示输入用户名、学号、邮箱和密码。

7. 运行开发服务器

python manage.py runserver 0.0.0.0:8000

访问 http://localhost:8000 查看系统。

使用说明

普通用户

1. 注册账号: 访问首页点击'注册'，填写学号、邮箱等信息
2. 浏览自习室: 登录后可查看所有开放的自习室
3. 预约座位: 选择自习室 → 查看座位布局 → 点击'预约座位'按钮
4. 管理预约: 在'我的预约'页面可查看、取消预约
5. 签到: 到达自习室后，在预约时段内点击'签到'按钮
6. 查看记录: 在'签到记录'页面查看历史学习记录

管理员

1. 登录后台: 访问 http://localhost:8000/admin
2. 管理自习室: 添加/编辑自习室信息、设置开放时间
3. 管理座位: 批量添加座位、设置座位状态和配置
4. 用户管理: 查看用户信息、封禁违规用户
5. 预约管理: 查看所有预约记录、处理异常预约
6. 数据统计: 查看座位利用率、活跃用户等数据

数据库设计

主要数据表

• accounts_user: 用户表（扩展自 Django User）
• accounts_blacklist: 黑名单表
• rooms_studyroom: 自习室表
• rooms_seat: 座位表
• bookings_booking: 预约表
• bookings_checkin: 签到表

关系说明

• 一个自习室有多个座位（一对多）
• 一个用户可以有多个预约（一对多）
• 一个座位可以有多个预约（一对多）
• 一个预约对应一个签到记录（一对一）

开发说明

添加新功能

1. 在对应的 app 中创建模型
2. 生成并执行迁移文件
3. 创建视图函数和表单
4. 配置 URL 路由
5. 创建模板页面
6. 注册到 Admin 后台

代码规范

• 遵循 PEP 8 Python 编码规范
• 模型、视图、表单分离
• 使用 Django 的类视图（可选）
• 添加必要的注释和文档字符串

常见问题

1. 数据库连接错误

检查 MySQL 服务是否启动，数据库配置是否正确。

2. 静态文件无法加载

确保执行了 collectstatic 命令，并检查 STATIC_ROOT 配置。

3. 图片上传失败

检查 MEDIA_ROOT 目录权限，确保 Django 有写入权限。

4. 时区问题

系统默认使用 Asia/Shanghai 时区，可在 settings.py 中修改 TIME_ZONE 配置。

许可证

本项目仅供学习交流使用。不得商用。