服务器配置

腾讯云 2H4G 5M 60GB 轻量应用服务器承载大约 200~400人使用，经过压力测试，评测并发速度可满足130人左右的在线比赛。
系统镜像选 Ubuntu 22.04 LTS。

用户管理

一、批量导入（从方便管理角度建议以学生姓名作为用户名）

用户数据导入仅支持csv格式的用户数据。

共七列数据：用户名和密码不能为空，邮箱、真实姓名、性别、昵称和学校可选填，否则该行数据可能导入失败。
第一行不必写(“用户名”，“密码”，“邮箱”，"真实姓名"，“性别”，“昵称”，“学校”)这7个列名
性别为男请使用“male”或“0”，女请使用“female”或“1”，不填默认为“secrecy”。
excel表格保存为 csv 文件用记事本打开，另存为，保存为UTF-8编码的文件，否则中文可能会乱码。

二、批量生成临时用户后期修改成需要的用户名和密码（学生登录后修改密码）

三、用户自行注册（填写邮箱获取验证码）该方式不方便管理，建议使用前两种方式。

四、管理员角色说明

判题模式

一、普通判题

普通模式是程序在线评测平台(OJ)通用的判题模式，主要的实现逻辑步骤如下：

选手程序读取题目标准输入文件的数据
判题机执行代码逻辑得到选手输出
再将选手输出与题目标准输出文件的数据进行对比，最终得到判题结果

二、特殊判题

特殊判题（Special Judge）是指OJ将使用一个特定的程序来判断提交的程序的输出是不是正确的，而不是单纯地看提交的程序的输出是否和标准输出一模一样。

一般使用Special Judge都是因为题目的答案不唯一，更具体一点说的话一般是两种情况：

题目最终要求输出一个解决方案，而且这个解决方案可能不唯一。
题目最终要求输出一个浮点数，而且会告诉只要答案和标准答案相差不超过某个较小的数就可以，比如0.01。这种情况保留3位小数、4位小数等等都是可以的，而且多保留几位小数也没什么坏处。

用例模式

OJ的测试用例评测模式有以下几种：

ACM题目：默认（全部评测）、遇错止评（顺序评测）

OI题目：全部评测（得分加和）、子任务（最低得分）、子任务（平均得分）

一、ACM题目

1. 默认（全部评测）

用户提交的代码将运行所有的测试用例，然后汇总结果。如果全部测试点都符合预期，则评测状态结果为Accepted，否则遍历所有测试点结果，将第一个非Accepted的测试点的状态作为最终结果。

2. 遇错止评（顺序评测）

用户提交的代码将顺序运行所有测试用例，如果遇到某个测试点的结果（非Accepted）不符合预期，则评测结束，将该测试点的评测结果作为最终结果；否则一直遍历全部测试用例评测直至结束。

二、OI题目

1.全部评测（得分加和）

用户提交的代码将运行所有的测试用例，然后汇总所有评测点的得分和结果。如果全部测试点都符合预期，则评测状态结果为Accepted，得分为该题目的满分；否则遍历所有测试点结果，加和所有测试点的得分，作为该评测的最终得分。

2. 子任务（最低得分）

将全部测试用例按照配置的组数分成多个子任务评测组，每个子任务求该组测试点的最低得分，作为该子任务的得分，然后汇总加和所有子任务组的得分，作为该评测的最终得分。

题目管理

一、自己OJ题目导入导出

1. 导出题目

用于题目备份和迁移。点击选择需要的题目，便可以批量导出成一个zip压缩包，分别对应一个json格式的题目数据，一个对应名字的文件夹存放评测数据文件，具体的文件结构如下：

+-- problem_1000.json
+-- problem_1000
|   +-- 1.in
|   +-- 1.out
|   +-- ....
+-- problem_1001.json
+-- problem_1001
|   +-- 1.in
|   +-- 1.out
|   +-- ....

2. 导入本OJ题目

选择需要导入的题目数据zip压缩包，如果是自己做的题目需要批量导入请注意不要多一层文件夹进行压缩，请保证题目json文件的名字与其对应的存放评测数据的文件夹名字一致。

二、导入QDUOJ、FPS格式的题目

请严格按照青岛oj的后台导出的压缩文件来上传。
请使用标准的FPS格式的题目数据文件(.xml)

三、导入其它OJ题目

（远程判题，题面拉取过来自动分类到对应题库，测试数据在对应服务器上，学员提交题目，远程判题并返回结果。）

导入HDU、Codeforces、POJ、GYM、AtCoder、SPOJ的题目，只需提供该题目的题号便可一键导入。

HDU和POJ的题号一般是 1000以上的数字
Codeforces和GYM的题号是1000A、1000B、这种数字加大写英文字母的格式，具体请到https://codeforces.com (opens new window)查看
SPOJ的题号是大写英文字母，如TEST，具体请到https://www.spoj.com (opens new window)查看
AtCoder的题号是类似abc110_a这种格式，具体请到 https://atcoder.jp (opens new window)查看

添加方法：管理员进入后台，点击题目列表，添加远程OJ题目。

然后添加上方的添加按钮，在弹出窗中选择OJ名字及题号，便可导入

准备工作：对应OJ注册账号，并在后台添加账号。

四、手动录入题目

上传题目测试用例数据可以选择手动输入、Zip文件上传两种方式

一、手动输入（平时老师出题或者录入教案中题目）

每次点击 添加用例 就可以手动填入该用例的输入与输出，该方式比较适合题目数据简单的，同时手动输入的题目数据将记录进数据库，下次对该题目进行修改可以直接获取，然后进行测试数据的修改，同时也会在服务器对应的 testcase 文件夹生成对应的文件。

二、文件上传（用于样例较多，或已经有单独题面和测试数据包）

对于普通题目，测试用例文件包括in、out、ans、txt四种扩展名

例如有两组测试用例，则对于普通题目测试用例的文件名分别为*.in, *.out（*.ans），或者*input*.txt, *output*.txt ，其他形式的文件后台均不识别。

压缩时，请将文件都放在压缩包的根目录，而不是包含在某一个文件夹中，比如正确的格式是：

├── 1.in          
├── 1.out
├── 2.in
├── 2.out

然后压缩测试用例到一个zip中

注意：不要在这些文件外面套多一层文件夹，请直接压缩！！！

建议：尽量减少测试用例组数，这会一定程度上提高判题性能。日常练习测试样例在精不在多。

训练题单

训练分为公开训练与私有训练，同时可自定义训练分类

两种训练其实都是题单功能，区别在于私有训练拥有记录榜单

1. 公开训练

管理员可在后台添加公开权限的题目，同时能对题目进行排序。
题目的所有用户提交情况以及用户自身对该题目的提交情况与题目列表的题目数据同步。

2. 私有训练

管理员可在后台添加公开权限的题目，同时能对题目进行排序。
题目的所有用户提交情况以及用户自身对该题目的提交情况与题目列表的题目数据同步。

与公开训练的区别：

非训练创建者和超级管理员访问私有训练需要对应的密码。
超级管理员与训练创建者的题目提交情况不会计入记录榜单
系统会同步普通用户对应训练题目的提交情况，生成对应的记录榜单。
用户在进入私有训练后，只有在训练里面的题目提交，记录榜单才会继续更新记录。

系统同步用户对应题目数据的情况如下：

后台管理员增加新的题目，系统会同步训练已成功访问的所有用户对应新题目的提交情况。
后台管理员移除题目，系统会删除对应题目的榜单记录。

用于留课后作业可以方便看到每位学员题目完成情况。

创建比赛

一、ACM 比赛模式

该模式是按照ACM-ICPC的比赛规则来进行，Contest设置项中的Seal Time Rank即为是否封榜，封榜后将不再刷新排名。可选择比赛结束前半小时，比赛前一小时，比赛全程封榜。

如果开启封榜，则封榜期间的角色不同如下：

封榜期间，超级管理员与比赛创建者不受影响，正常可查看题目统计数据，提交数据等，排行榜需自行开启强制刷新，同时提交结果可以及时看到评测结果，但不会纳入排行榜！
封榜期间，普通用户与非比赛创建者（包括其它管理员角色），可以及时看到自己的提交结果，但不可看到别人封榜后的提交，不能看到题目的统计情况，排行榜保持封榜前的排名数据。

注意：比赛一结束，默认所有数据变成正常显示，但后台可以设置比赛结束继续封榜！