volunteer-certificate

安装并启动项目(How to build dev environment):

Dependency Installation

python3 -m pip install --user -r requirements.txt

Startup shell

You can use shell script to start or stop the application

cd volunteer-certificate
# start up
./bin/start.sh

# shutdown
./bin/stop.sh

# restart
./bin/restart.sh

Extra data file

You need to put data.json, pic.jpg in the project root directory.

cp config/data.json ./

Optionally you can make a file email.json and edit the configuration.

cp config/email.json.config email.json

To start the server, run the following command in project root directory

python3 app.py

To test whether the server works, you can use curl

curl http://127.0.0.1:5000/api/getUserInfo?token=dsfasgdafgaggsdagdsg

志愿者证书

一、前端接口

1.通过token获取用户信息

类型：get请求

https://api.wuhan2020.org.cn/api/getUserInfo?token=dsfasgdafgaggsdagdsg

成功：

{
  "code": 0,
  "data": {
      "email":"xxxx@yeah.net",                  //邮箱,在页面不可以编辑
      "name":"xxxxx",                           //称呼
   },
   "message": "success"
}

失败

{
    "code": 1,
    "data": "",
    "message": "user not in server"
}

2. 用户提交信息：

https://api.wuhan2020.org.cn/api/submitUserInfo

类型：post请求 post的Content-Type一定是application/json

入参

{
    "token":"dsfasgdafgaggsdagdsg",  // token
    "name":"new namw"                //修改后的称呼
}

结果

成功：

   {
      "code":0,      // 成功
      "message": "",
      "data":null
   }

失败：

   {
      "code":1,   // 失败
      "message": "网络异常",
      "data":null    
   }

3.添加新用户（管理员）

http://47.75.179.6:5000/api/addUserData

二、数据表

按照github 拼音顺序进行排列

三、数据流

第1步. 后端项目批量给用户邮箱发邮件

将为当前邮箱状态为0的邮箱生成token（可以定时任务扫描），并更新本行记录的token为新token 每个邮件的关键内容为确认称呼的ur： https://community.wuhan2020.org.cn/zh-cn/certification/index.html?token=dsfasgdafgaggsdagdsg

邮件发送完毕后，状态置为 1

第2步. 用户打开网页

调用接口1.通过token获取用户信息展示数据

第3步. 用户修改并提交数据

调用接口**2.用户提交信息：**提交到后端

第4步. 后端服务生成图片，发送邮件

后端更新本行记录：name 为新称呼，状态置为 2

调用生成图片接口，更新pic_url，更新status 为3

调用发邮件接口 更新status 为4

状态2后每一次断掉可以重试（定时任务扫描）