中山大学研究生管理系统：双选+考勤

考勤系统已经名存实亡，建议仅考虑双选功能。

通过本README，你应该可以将后端搭建起来。在此之前提醒一句，请随机应变，过程出错很有可能与环境或依赖版本有关，请善用github issue、google、stack overflow。实在解决不了的话，联系github@caojen，或你的上一个负责人员。

概述

后端主要有几个模块：

任何系统都离开不了的数据库，我们使用的是Mysql。
一个存放了学生上传文件的文件系统，我们使用的是SeaweedFs
后端api（也就是本项目）

我们按照步骤来搭建相关功能。

MYSQL 搭建

MYSQL Server怎么建起来请自行谷歌，如果害怕污染本地环境的话建议用docker做容器：

docker run --name my-mysql -e MYSQL_ROOT_PASSWORD=123456 -d -p 3306:3306 mysql:8.0

本地测试可以随便搞个简单的密码，生产环境的密码找相关负责人员拿。

然后，将migrations文件夹里面的四个sql文件应用上，按照顺序：

mysql -uroot -p -h 127.0.0.1 -P 3306 < ./migrations/init.sql
mysql -uroot -p -h 127.0.0.1 -P 3306 -D pgms < ./migrations/addfilename.sql
mysql -uroot -p -h 127.0.0.1 -P 3306 -D pgms < ./migrations/feedback.sql
mysql -uroot -p -h 127.0.0.1 -P 3306 -D pgms < ./migrations/feedback-add-createtime.sql

自行处理上面的ip和端口。

文件系统搭建

docker解万愁

cd seaweedfs
cp seaweed-compose.yml docker-compose.yml
docker-compose up -d
rm docker-compose.yml
cd -

如果启动不成功，请自行检查端口是否被占用，并决定修改端口或终止已有程序。

如果你没有改动docker-compose文件，那么应该会监听到9333端口。下面我们都用9333端口。

api搭建

如果没有其他问题的话，你就可以直接启动这个仓库了。在启动之前，有一些环境变量需要你去配置：

MYSQL_HOST: 数据库ip
MYSQL_PORT: 数据库端口
MYSQL_USER: 数据库用户名
MYSQL_PASSWORD: 数据库密码
MYSQL_DATABASE: 数据库名，使用pgms

FILE_SYSTEM: seaweedfs查询ip，如果你不知道的话，用: http://127.0.0.1
FILE_SYSTEM_LOOKUP: seaweedfs查询端口和路径，如果你不知道的话用: :9333/dir/assign

例如：

export MYSQL_HOST=127.0.0.1
export MYSQL_PORT=3306
export MYSQL_USER=root
export MYSQL_PASSWORD=123456
export MYSQL_DATABASE=pgms

export FILE_SYSTEM=http://127.0.0.1
export FILE_SYSTEM_LOOKUP=:9333/dir/assign

npm install
npm run start:dev  # 测试模式
npm run start:prod # 生产模式

或者用docker：

docker build . -t pgms-backend:latest
docker run -itd --name pgms-backend -p 5100:5100 --rm pgms-backend:latest

启动后将会server将会监听5100端口。试试吧：

curl http://127.0.0.1:5100

数据初始化

初始化默认头像

默认头像存放在static/default_image.jpeg中，我们需要首先将它上传到文件服务中。

curl http://localhost:9333/dir/assign
curl -F file=@static/default_image.jpeg http://127.19.0.3:8080

然后将得到的id插入到数据库的表中。

双选全局变量

请登录双选管理员账号，然后在“变量设置”中设置以下的键值对。请注意，这些键值对的key在程序里面是常量，没有这些常量可能就会报莫名其妙的500错误。

stage_count: 3        控制双选有多少个阶段，也代表学生能选多少个志愿老师
current_stage: -1     控制当前阶段，特别地，-1表示未开始。学生只能在“未开始”阶段上传文件。0代表学生选择，[1,2,3...]代表老师选择阶段
begin_time: 2022-08-01 00:00:00 当前阶段开始时间
end_time: 2022-09-01 00:00:00   当前阶段结束时间

caojen/pgms-backend