ПКУ предназначен для
- Расчета метрик и критериев
- Взаимодействия с платформой в рамках работы квалификационных сессий (алгоритмическая, техническая квалификация)
- Взаимодействия с платформой в рамках работы финала
- docker
- docker-compose последней версии. (Не менее версии 1.24)
- linux окружение (bash оболочка) на машине, с которой запускается docker
- Быть зарегистрированным участником на платформе
Используйте рекомендации пост-установки Docker.
-
Скачиваем актуальную версию в виде архива с портала readable.upgreat.one.
При наличии ошибок всегда проверяйте наличие актуальной версии.
-
Корректировка настроек и поднятие сервиса
Если вы разворачиваете проект в первый раз, скопируйте
.env
файл и внесите туда токен который можно взять в личном кабинете в разделе профиль.# Копируем файл настроек cp .env.example .env # Скачиваем актуальную версию образа docker-compose pull # Поднимаем сервис docker-compose up -d --force-recreate # Проверить что сервис поднят (в случае успех вы должны увидеть State Up) docker-compose ps
-
Начните работу с сервисом
# Получение списка команд ./pku --help # Получение списка параметров конкретной команды ./pku commandName --help
примечание: самая актуальная документация - в консоли
В комплексе используется json формат указанный в приложении 3 к техническому регламенту.
Наименование поля | Тип данных | Пустое значение | Соответствие синтаксическим конструкциям языка разметки |
---|---|---|---|
meta.third | boolean | Не допускается. При отсутствии поля в файле, алгоритмы считают равным false. | Признак того что эксперт разметил данные в режиме просмотра предыдущих двух разметок. |
-
Файл без разметки или файл с разметкой участником содержит только id файла. Пример: 000105.json
-
Файл разметки экспертов содержит помимо id файла еще и id эксперта Пример:
- 000105_exp13.json
- 000105_exp12.json
- 000105_exp55.json
/custom
- директория для работы с расчетом метрик и критериев/in
- директория для входных файлов в рамках сессии/out
- директория размеченных файлов в рамках сессии
В ближайших версиях появится разделение директорий in/out на вложенные директории сессий.
- Пакет ПКУ (корень репозитория/папки)
- Пакет расчет критериев /node_modules/@webpractik/readable_io.criterion
- Пакет расчет метрик /node_modules/@webpractik/readable_io.psr
Если у вас не запускается контейнер, не пулится образ или permission denied, рекомендуем:
- Проверить что у вас скачена последняя версия docker с официального сайта
- Проверить что у вас скачена последняя версия docker-compose
- Проверить что вы выполнили рекомендации пост-установки Docker в части работы из под non-root пользователя.
При выполнении docker-compose pull
ничего не происходит
export $(cat .env | grep READEABLE_PKU)
export $(cat .env | grep TAG)
docker pull $READEABLE_PKU:$TAG
Параметр настройки логирования в .env файле
# формат логов
LOG_FORMAT=pretty|json
# вывод подробной информации в логах
DEBUG_FLAG=false|true
После смены параметров перезапустите контейнер
docker-compose up -d --force-recreate
Если у вас есть предложения - оформляйте issue или присылайте pull request. Помимо этого можно присылать предложения на почту readable@webpractik.ru.
Код предназначен для участников конкурса ПРО//ЧТЕНИЕ у которых одобрена заявка на участие в конкурсе.