说明文档

韩佳乐 PB16051152

---

工具

python==3.7
Django==2.2
mysqlclient>=1.3.13
mysql>=5.7

部署

1. 安装 django

pip install django==2.2

2. 安装 mysqlclient

pip install mysqlclient

3. 修改 DjangoDemo\settings.py 数据库配置。使用 root 账户登录 mysql ，新建数据库 django_mysql（数据库名可以修改，但应和 NAME 保持一致）。其次，将 PASSWORD 修改为你的数据库密码。HOST 和 PORT 无需改动。

DATABASES = { 'default': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME': 'django_mysql',  #  --> 新建数据库
    'USER': 'root',
    'PASSWORD': '',          #  --> 修改为你的密码
    'HOST': '127.0.0.1',
    'PORT': '3306',
    }
}

4. 数据库迁移。在 DjangoDemo 目录下执行

python manage.py makemigrations
python manage.py migrate

5. 运行项目。在 DjangoDemo 目录下执行

python manage.py runserver

代码风格约定

pylint==2.5.0

接口说明

1. /，home 页面接口名为 DjangoDemo\myapp\forms.py 中自定义表单 DateForm 中的 date，接受的参数为 YY-MM-DD 格式的字符串，返回格式为字符串，在后端使用 session 判断用户是否处于登录状态。

   登录前

   登录后

2. /user/signin/，继承 home 页面，signin 页面接口名为 DjangoDemo\myapp\forms.py 中自定义表单 UserForm 中的 username 和 password，接受的参数为非空字符串，返回格式为字符串。若登录失败，后端返回 Incorrect username or password.；若登录成功，后端通过 session 设置用户处于登录状态，并直接跳转至 home 页面，右上角显示用户信息。

   登录页面

   登录失败

3. /user/signup/，继承 home 页面，signup 页面接口名为 DjangoDemo\myapp\forms.py 中自定义表单 RegisterForm 中的 username 和 password，接受的参数为非空字符串，返回格式为字符串。若注册失败，后端返回 Username is already taken；若注册成功，后端返回 Sign up successfully!。

   注册成功

   注册失败