gregorjerse/timetable

UL FRI 课程表系统

镜像概述和主要用途

UL FRI Timetabling system是一个基于Django框架开发的Web应用，核心功能为课程表管理。主应用为urnik_fri，包含设置模块。系统提供开发与生产环境的配置分离，新部署可基于settings-example.py模板定制。依赖管理清晰，支持Docker容器化部署，确保开发环境一致性。

核心功能和特性

• Django框架：采用Django开发，具备成熟的Web应用架构和管理功能
• 配置分离：示例设置分为通用配置和计算机特定配置，便于环境定制
• 依赖管理：Python依赖列于requirements_development.txt（开发环境）和requirements_production.txt（生产环境，版本固定），当前生产镜像建议使用开发环境依赖构建
• Docker支持：提供Dockerfile和docker-compose配置，支持容器化部署，简化环境搭建

使用场景和适用范围

• 教育机构（如大学、学院）的课程表管理系统开发与部署
• 需要统一开发环境的团队协作开发
• 课程表Web应用的测试和生产环境部署

详细使用方法和配置说明

开发者指南

直接运行（Linux系统）

在Linux系统中，安装必要的Python依赖（见requirements文件）和系统依赖（可从Dockerfile查看），即可像普通Python应用一样运行。

使用Docker（推荐）

为确保所有开发环境一致性，推荐使用Docker部署。

构建与运行

Dockerfile包含镜像构建指令，推荐使用docker-compose-development.yml配置运行，该配置会启动数据库和UWSGI服务器，并设置环境变量。

启动命令：

bash
docker-compose -f docker-compose-development.yml up

执行后将启动两个容器：

• PostgreSQL数据库容器
• UWSGI服务器容器（运行urnik应用）

容器配置说明

• UWSGI服务器默认暴露在主机的8080端口
• 当前源代码挂载到UWSGI容器内的/home/timetable/urnik目录
• UWSGI配置为代码变更时自动重启，提升开发效率

系统初始化

系统运行前需创建数据库和超级用户，通过Django管理命令完成。进入运行中的容器的命令：

bash
docker exec -it ${DOCKER_CONTAINER_ID} /bin/bash

进入容器后，执行标准Django管理命令（如python manage.py migrate创建数据库表、python manage.py createsuperuser创建超级用户）。