update docs

2022-01-01 22:19:00 +08:00 · 2022-01-01 22:19:00 +08:00 · 994b05e8db
parent 137d03c1cd
commit 994b05e8db
5 changed files with 57 additions and 6 deletions
--- a/README.md
+++ b/README.md
@ -10,7 +10,7 @@

 ## 一、前言

-基于前后端分离，分布式架构的在线测评平台（hoj），前端使用vue，后端主要使用springboot，redis，mysql，nacos等技术，**支持HDU、POJ、Codeforces（包括GYM）的vjudge判题，同时适配手机端、电脑端浏览，拥有讨论区与站内消息系统，还有完善的比赛功能（打星队伍、关注队伍、外榜）。**
+基于前后端分离，分布式架构的在线测评平台（hoj），前端使用vue，后端主要使用springboot，redis，mysql，nacos等技术，**支持HDU、POJ、Codeforces（包括GYM）的vjudge判题，同时适配手机端、电脑端浏览，拥有讨论区与站内消息系统，支持私有训练、公开训练（题单），还有完善的比赛功能（打星队伍、关注队伍、外榜）。**

 |              在线Demo              |                         在线文档                          |                     Github&Gitee仓库地址                     |   QQ群    |
 | :--------------------------------: | :-------------------------------------------------------: | :----------------------------------------------------------: | :-------: |
@ -97,6 +97,7 @@ docker ps # 查看当前运行的容器状态
 | 2021-10-05 | 增加站内消息系统——评论、回复、点赞、系统通知的消息，优化前端。 | Himit_ZH |
 | 2021-10-06 | 美化比赛排行榜，增加对FPS题目导入的支持                      | Himit_ZH |
 | 2021-12-09 | 美化比赛排行榜，增加外榜、打星队伍、关注队伍的支持           | Himit_ZH |
+| 2022-01-01 | 增加公开训练和公开训练（题单）                               | Himit_ZH |

 ## 五、部分截图

--- a/docs/docs/.vuepress/config.js
+++ b/docs/docs/.vuepress/config.js
@ -88,9 +88,10 @@ module.exports = context => config({
                title: '使用文档',
                collapsable: true,
                children: [
-					'use/testcase',
-					'use/contest',
 					'use/import-problem',
+					'use/testcase',
+					'use/training',
+					'use/contest',
 					'use/import-user',
 					'use/admin-user',
 					'use/notice-announcement',
--- a/docs/docs/README.md
+++ b/docs/docs/README.md
@ -20,7 +20,7 @@ features:
  details: 判题使用 cgroup 隔离用户程序，网站权限控制完善
 - title: 多样化
  details: 独有自身判题服务，同时支持其它知名OJ题目的提交判题
-footer: MIT Licensed | Copyright © 2021.12.23 @Author Himit_ZH  QQ Group:598587305
+footer: MIT Licensed | Copyright © 2022.01.01 @Author Himit_ZH  QQ Group:598587305
 ---

 [![Java](https://img.shields.io/badge/Java-1.8-informational)](http://openjdk.java.net/)
@ -32,7 +32,7 @@ footer: MIT Licensed | Copyright © 2021.12.23 @Author Himit_ZH  QQ Group:598587
 [![Vue](https://img.shields.io/badge/Vue-2.6.11-success)](https://cn.vuejs.org/)
 [![QQ Group 598587305](https://img.shields.io/badge/QQ%20Group-598587305-blue)](https://qm.qq.com/cgi-bin/qm/qr?k=WWGBZ5gfDiBZOcpNvM8xnZTfUq7BT4Rs&jump_from=webapi)

-Hcode Online Judge (HOJ) : 基于前后端分离，分布式架构的在线测评平台（hoj），前端使用vue，后端主要使用springboot，redis，mysql，nacos等技术，**支持HDU、POJ、Codeforces（包括GYM）的vjudge判题，同时适配手机端、电脑端浏览，拥有讨论区与站内消息系统，还有完善的比赛功能（打星队伍、关注队伍、外榜）。**
+Hcode Online Judge (HOJ) : 基于前后端分离，分布式架构的在线测评平台（hoj），前端使用vue，后端主要使用springboot，redis，mysql，nacos等技术，**支持HDU、POJ、Codeforces（包括GYM）的vjudge判题，同时适配手机端、电脑端浏览，拥有讨论区与站内消息系统，支持私有训练、公开训练（题单），还有完善的比赛功能（打星队伍、关注队伍、外榜）。**

 [Github 仓库](https://github.com/HimitZH/HOJ)
 [Gitee 仓库](https://gitee.com/himitzh0730/hoj)
--- a/docs/docs/introducition/README.md
+++ b/docs/docs/introducition/README.md
@ -15,7 +15,7 @@ HOJ，全称 Hcode Online Judge，是基于（springcloud+vue）前后端分离

 ## 二、为什么要开发HOJ？

-因为这是Himit_ZH的毕业设计，同时也是个人志趣所在，目前HOJ从开始开发到现在快有一年了，凭着兴趣与职责一直在不断维护与更新新功能。
+因为这是Himit_ZH的毕业设计，同时也是个人志趣所在，目前HOJ从开始开发到现在已经有一年了，凭着兴趣与职责一直在不断维护与更新新功能。

 ## 三、HOJ的特点
 :::tip
@ -27,6 +27,7 @@ HOJ，全称 Hcode Online Judge，是基于（springcloud+vue）前后端分离
  - 功能：
    - 支持ACM、OI题目及比赛，比赛拥有外榜、打星队伍、关注队伍等功能
    - 拥有讨论区、题目讨论、比赛讨论、同时拥有站内消息系统
+    - 支持私有训练、公开训练（题单）
    - 支持testlib的SPJ
  - 多样：支持自身题目数据评测，也支持其它知名OJ（HDU、Codeforces、POJ）题目的爬取与提交
 :::
--- a/docs/docs/use/training.md
+++ b/docs/docs/use/training.md
@ -0,0 +1,48 @@
+# 训练介绍
+
+:::tip
+
+训练分为**公开训练**与**私有训练**，同时可自定义训练分类 
+
+两种训练其实都是题单功能，区别在于私有训练拥有记录榜单
+
+:::
+
+![训练](https://img-blog.csdnimg.cn/00cd359b634e4483a33f26b10c32e4f6.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASGltaXRfWkg=,size_20,color_FFFFFF,t_70,g_se,x_16)
+
+:::warning
+
+在训练题单里面的题目提交情况与公开题库的对应题目的数据一致，所以只能显示公开权限的题目，其功能主要是汇总对应的题型。
+
+:::
+
+### 1. 公开训练
+
+- 管理员可在后台添加公开权限的题目，同时能对题目进行排序。
+- 题目的所有用户提交情况以及用户自身对该题目的提交情况与题目列表的题目数据同步。
+
+![训练题目列表](https://img-blog.csdnimg.cn/04264e545b034296b5a9f130b85dc985.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASGltaXRfWkg=,size_20,color_FFFFFF,t_70,g_se,x_16)
+
+### 2. 私有训练
+
+- 管理员可在后台添加公开权限的题目，同时能对题目进行排序。
+- 题目的所有用户提交情况以及用户自身对该题目的提交情况与题目列表的题目数据同步。
+
+与**公开训练**的区别：
+
+- 非训练创建者和超级管理员访问私有训练需要对应的密码。
+- **超级管理员与训练创建者的题目提交情况不会计入记录榜单**
+- 系统会同步普通用户对应训练题目的提交情况，生成对应的记录榜单。
+- 用户在进入私有训练后，只有在训练里面的题目提交，记录榜单才会继续更新记录。
+
+**系统同步用户对应题目数据的情况如下：**
+
+:::info
+
+- 用户第一次输入密码成功后，系统会同步其对应题目的提交情况到榜单。
+- 后台管理员增加新的题目，系统会同步训练已成功访问的所有用户对应新题目的提交情况。
+- 后台管理员移除题目，系统会删除对应题目的榜单记录。
+
+:::
+
+![私有训练榜单](https://img-blog.csdnimg.cn/66820e0888064a64b7f091ea60cb64b5.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASGltaXRfWkg=,size_20,color_FFFFFF,t_70,g_se,x_16)