Course-Selection-System: An HTML repository from AIboy996

前置要求

本项目需要用docker来部署，在Windows系统下安装docker可以参考文章Install On Windows。

另外在Windows上运行docker容器还极有可能发生端口映射的问题，详见博文Win10 Docker 启动报错端口占用，大概和HyperV以及WSL有关。

就我的经验来说每次遇到这个问题重启电脑，然后在电脑开启之后不要启动其他软件、而是直接打开docker就可以解决问题，希望对你有所帮助。

服务部署

1、配置文件修改（如有必要）

本项目的配置文件为docker-compose.yml。

需要特别注意 如果宿主机器上的8000或3306端口已经被占用，需要修改端口映射否则容器将无法运行。

举例来说，下面是配置文件中django的默认端口映射，它把容器的8000端口映射到宿主机器的8000端口

ports:
  - 8000:8000

如有冲突，可以修改为：

ports:
  - 8000:任意可用端口

2、容器运行

在项目文件夹打开终端，输入命令：

docker-compose up -d --build

即可构建并运行mysql和django服务器

配置文件以及每个选项的解释贴在下面：

# 配置文件的版本
version: "3.8"
# 服务器群
services:
  # 网页服务
  django:
    restart: always
    # 用当前文件夹的Dockerfile来构建
    build: .
    # 在数据库搭建完成之后启动
    depends_on:
      - mysql
    ports:
      - 8000:8000
    # 把当前文件夹映射为django的工作目录，从而达到本地修改同步到容器的效果
    volumes:
      - .:/xk
    # 运行命令
    command: sh -c "python3 manage.py makemigrations xk_models && python3 manage.py migrate && python3 manage.py runserver 0.0.0.0:8000"
  # 数据库服务
  mysql:
    # 使用最新的mysql镜像
    image: mysql
    # restart: always
    # 数据库的端口映射到本地3306
    ports:
     - 3306:3306
    environment:
      MYSQL_DATABASE : "xk"
      MYSQL_ROOT_PASSWORD : 123456
    command: --default-authentication-plugin=mysql_native_password
    volumes:
      # 数据文件
      - ./mysql/xk.sql:/xk.sql
      # 配置文件（默认文件编码存在问题
      # - ./mysql/conf.d:/etc/mysql/conf.d

等待docker build完成、启动容器后，就可以在docker后台看到这两个容器的运行情况*（由于mysql服务启动需要较长时间，在此期间django会不断报错并且重启，稍等片刻即可）*：

3、数据导入

等待两个容器都启动完毕后，在mysql容器的terminal运行下面的命令导入数据：

# 修改配置文件为只读，否则mysql会忽视该文件
chmod 700  /etc/mysql/conf.d/my.cnf
# 使用sql脚本导入数据
mysql --user='root' --password='123456' --database='xk' < '/xk.sql'

看到下图即为数据导入成功：

如果不修改配置文件则有可能出现编码问题（我们写好的utf8编码sql文件不能被正确地输入到sql服务器中），下图是修改前mysql的默认编码设置：
-- 查询mysql的编码设置情况
show variables like '%char%';
而通过修改配置文件即可解决编码问题，下图为修改后的编码设置：

映射到/etc/mysql/conf.d/my.cnf的配置文件如下：
[mysqld]
character-set-server=utf8mb4 
[client]
default-character-set=utf8mb4
[mysql]
default-character-set=utf8mb4

4、容器销毁

运行

docker-compsoe down

即可关闭并删除之前创建的容器，数据并不会保存！

通用页面

1、时间操纵

出于演示需求，需要手动调节 当前是学期的第几周，例如调节为第2周（以下语句需要连接数据库执行）：

UPDATE xk_models_week SET xk_models_week.week=2 WHERE xk_models_week.id=1;

并且由于前端的设计，每次修改完周数后需要重新登录才可以读取到正确的周数。

2、super user的创建

进行Django容器的terminal，在项目文件夹（默认为/xk）运行下面的命令，按照提示即可创建super user：

python3 manage.py createsuperuser

/xk # python3 manage.py createsuperuser
Username (leave blank to use 'root'): root
Email address: 
Password: 
Password (again): 
This password is too short. It must contain at least 8 characters.
This password is too common.
This password is entirely numeric.
Bypass password validation and create user anyway? [y/N]: y
Superuser created successfully.
/xk #

我创建了用户名为root密码为123的super user.

3、admin页面

网址为http://localhost:8000/admin

登录刚才创建的super user账户

管理选课系统的用户：

当然，我们也可以直接连接mysql在数据库中直接改动这些用户的信息。

4、登陆页面

网址为http://localhost:8000/login

特性介绍：

**【账号管理】**需要用指定的账号登录，账号无法公开注册只能由管理员添加。
**【登录保护】**未登录情况下访问域名下任何的地址都会重定向到这个页面。
**【页面样式】**使用了复旦统一身份认证的CSS样式文件。
**【DjangoForm】**表单是利用Django的Form构建的，有一定的验证功能，并且登陆失败也会有相应的提示。
**【通知公告】**右侧有一栏通知栏，会通告邮箱封禁情况以及解答常见的疑问。
- 但是我们并没有去写这些页面的具体信息，而是引用了复旦的相关链接充数
**【找回密码】**这个功能暂未完成，如果点击会进入404页面。

初次访问：

表单验证：

错误提示：

点击找回密码：

学生身份登录

用账号：19307100027@fudan.edu.cn 密码：123456 来演示

我们做了相关的验证：如果登录了学生页面，试图访问老师的一些页面，会提示访问限制：

1、首页

网址为http://localhost:8000/index

特性介绍：

【侧边栏】：常驻的侧边栏，会高亮显示当前所在的板块。
【弱密码警告】：如果密码较弱（例如默认的123456），则会进行相应的提示，提示可以关闭。
- 但是我们并没有写很高深的算法来检验密码的复杂性，只是判断是否含有片段12345
【备忘录】：点击即可在右边打开一个悬浮组件，可以方便进行选课时记录课程号等。
【账号管理】：右下角为折叠菜单，点击可以看到个人中心以及登出按钮。