Результаты, зачёты и публикация

Зачем нужно

Документ описывает, как в домене олимпиад рассчитываются баллы, финальные результаты, места, наградные статусы и публикации на основе immutable score snapshots, полученных из LMS activity runtime или temporary compatible adapter.

Ключевая особенность домена: один и тот же сезон или тур может иметь несколько отдельных зачётов. Например, во втором туре математической олимпиады может быть очный зачёт и онлайн-зачёт. Эти зачёты не должны смешиваться при расчёте победителей, призёров, дипломов, публичных списков и отчётности.

Зачёт не равен способу прохождения. Способ прохождения описывает, где и через кого участник пишет тур. Зачёт описывает, в каком контуре считаются результаты и награды.

Что входит

Документ фиксирует:

• отличие Score, FinalResult, Ranking и AwardStatus;
• immutable score snapshots по LMS activity item;
• модель ResultTrack как отдельного зачётного контура;
• расчёт результата по туру и сезону;
• связь результата с классом или категорией;
• правила наградных порогов;
• процентные ориентиры порогов и ручное утверждение;
• удержание результата от публикации;
• публикацию личных результатов;
• публикацию результатов группы;
• публичные списки победителей и призёров;
• официальные публикации и внутренние публикации;
• правила аудита изменений результатов;
• edge cases для пересчёта, MVP-апелляций, арбитража и смены зачёта.

Что не входит

Документ не проектирует подробно:

• работу проверяющих и жюри;
• критерии ручной проверки;
• полноценные апелляции;
• арбитраж подозрительных работ как дисциплинарный workflow за пределами расчёта результата;
• генерацию PDF-документов;
• официальные форматы внешних реестров;
• публичные UI-страницы;
• финальные API-контракты.

4. Главный принцип модели

Нельзя смешивать четыре уровня результата.

Уровень	Что означает	Пример
Score	балл за задание, часть работы или тур	7 баллов за задачу
FinalResult	утверждённый результат участника в туре или зачёте	42 балла в очном зачёте
Ranking	место или позиция участника внутри зачёта и категории	3 место среди 5 класса
AwardStatus	наградной статус по правилам зачёта	диплом 2 места

Результат всегда должен считаться в контексте ResultTrack, класса или категории и сезона или тура.

5. Основные сущности

Сущность	Назначение
Score	балл за работу, задачу, часть работы или тур
FinalScore	финальный утверждённый балл
FinalResult	финальный результат участника в зачёте
ResultTrack	отдельный зачётный контур
Ranking	ранжирование участников внутри зачёта
Place	место участника
AwardPolicy	правила выдачи наград
ScoreThreshold	балльный порог награды
AwardStatus	итоговый наградной статус
ResultCalculationRun	запуск расчёта результатов
ResultPublication	публикация результатов
PublicResultList	публичный список результатов
PrivateResultView	личное отображение результата участнику
GroupResultView	отображение результатов для учителя или организации
Appeal	MVP-апелляция по проверке или результату
ArbitrationCase	отдельный кейс подозрительной работы или нарушения регламента

6. Score и FinalScore

Score — отдельный балл, полученный по задаче, части работы, автоматической проверке или ручной проверке. Для competition result он фиксируется как immutable score snapshot, полученный из LMS activity runtime, temporary adapter или imported/manual mode.

FinalScore — итоговый утверждённый балл, который используется для расчёта результата.

Поле Score	Описание
id	уникальный идентификатор
tour_participation_id	участие в туре
submission_id	работа или отправка
task_id	задание, если балл относится к заданию
lms_activity_item_ref	item ref внутри LMS activity или adapter
task_number	номер задачи для отображения результата
score_type	автоматический, ручной, модерационный, апелляционный
value	значение балла
max_value	максимум
source	источник балла
created_by_user_id	кто выставил или создал балл
status	статус балла

Статусы Score:

Статус	Значение
draft	балл черновой
submitted	балл выставлен
moderated	балл прошёл модерацию
disputed	балл оспаривается
final	балл финализирован
voided	балл отменён

Правила:

1. Сырые Score не должны напрямую публиковаться как итоговый результат.
2. Result calculation использует score snapshots, а не raw answers.
3. FinalScore формируется после автоматической проверки, ручной проверки, модерации и возможных корректировок.
4. Любое изменение Score после финализации должно аудироваться.
5. Если была апелляция, исходный балл не удаляется, а фиксируется новая версия или корректировка.
6. Training scores из LMS не попадают в competition score snapshots.

7. FinalResult

FinalResult — утверждённый результат участника в конкретном зачёте.

Поле	Описание
id	уникальный идентификатор
competition_season_id	сезон
tour_id	тур, если результат относится к туру
result_track_id	зачёт
season_participation_id	участие в сезоне
tour_participation_id	участие в туре, если применимо
student_record_id	запись ученика
grade_category_id	класс или категория
final_score	финальный балл
max_score	максимум
result_status	статус результата
calculated_at	когда рассчитан
finalized_at	когда финализирован
finalized_by_user_id	кто финализировал, если вручную
threshold_policy_snapshot	зафиксированные пороги и процентные ориентиры
is_withheld	результат удержан от публикации
withheld_reason	причина удержания

Статусы result_status:

Статус	Значение
pending	результат ещё не готов
calculated	результат рассчитан
needs_review	требуется проверка или модерация
finalized	результат финализирован
ready_for_publication	результат финализирован и готов к отдельному publication action
published_private	результат опубликован лично участнику через publication
published_public	результат включён в публичную публикацию через publication
withheld	результат удержан от публикации
cancelled	результат отменён

Правила:

1. FinalResult всегда относится к ResultTrack.
2. FinalResult не должен существовать без grade_category_id, если в сезоне результаты считаются по классам.
3. Один участник может иметь разные FinalResult в разных зачётах.
4. Результаты разных ResultTrack не смешиваются в одном Ranking.
5. FinalResult может быть рассчитан заново, но история расчётов должна сохраняться.
6. Удержанный результат исключается из личной/публичной публикации до release action, если policy не задаёт иной личный показ.
7. FinalResult не меняется от LMS training attempts после публикации тренажёра.

8. ResultTrack

ResultTrack — отдельный зачётный контур.

Примеры:

Код	Смысл
main	основной зачёт
in_person	очный зачёт
online	онлайн-зачёт
official	официальный зачёт
community	отдельный неофициальный зачёт
external	внешний или партнёрский зачёт

Правила:

1. ResultTrack определяет контур расчёта результата, наград и публикации.
2. ResultTrack может быть связан с туром, сезоном, способом прохождения или правилом участия.
3. DeliveryMode может помогать назначить ResultTrack, но не должен заменять его.
4. Официальность должна быть свойством ResultTrack или его политики, а не только следствием очного формата.
5. Очный и онлайн-зачёт второго тура должны иметь отдельные ResultTrack.
6. У каждого ResultTrack могут быть свои пороги наград, правила ранжирования и публикации.

9. Ranking и Place

Ranking — результат ранжирования участников внутри зачёта.

Place — место конкретного участника в Ranking.

Поле Ranking	Описание
id	уникальный идентификатор
result_track_id	зачёт
competition_season_id	сезон
tour_id	тур, если рейтинг относится к туру
grade_category_id	класс или категория
ranking_policy_id	правило ранжирования
status	статус рейтинга
calculated_at	дата расчёта

Поле Place	Описание
id	уникальный идентификатор
ranking_id	рейтинг
final_result_id	финальный результат
place_number	место
rank_position	позиция в отсортированном списке
tie_group	группа равенства, если есть
status	статус места

Статусы Ranking:

Статус	Значение
draft	рейтинг готовится
calculated	рейтинг рассчитан
needs_review	требуется проверка
finalized	рейтинг финализирован
published	рейтинг опубликован
archived	рейтинг архивирован

Правила:

1. Ranking строится отдельно для каждого ResultTrack и grade_category_id.
2. При равных баллах политика мест должна быть задана явно.
3. Публичный список может показывать не все места, а только победителей и призёров.
4. Изменение FinalResult после финализации рейтинга требует пересчёта.

10. AwardPolicy, ScoreThreshold и AwardStatus

AwardPolicy задаёт правила выдачи наград в конкретном зачёте.

ScoreThreshold задаёт балльные пороги для наград. Порог может быть абсолютным баллом или процентным ориентиром от распределения результатов в классе/зачёте.

AwardStatus — итоговый наградной статус участника.

Стартовые наградные статусы участников:

Код	Название
diploma_1	диплом первого места
diploma_2	диплом второго места
diploma_3	диплом третьего места
honorable_mention_1	похвальная грамота первой степени
honorable_mention_2	похвальная грамота второй степени
participation_certificate	сертификат участника, если включён правилами
no_award	без награды

Поле AwardStatus	Описание
id	уникальный идентификатор
final_result_id	финальный результат
result_track_id	зачёт
award_policy_id	правило наград
award_code	код награды
award_title	название награды
assigned_by	система или администратор
threshold_snapshot	балльный порог, процентный ориентир и ручное решение
status	статус наградного статуса
assigned_at	дата назначения

Статусы AwardStatus:

Статус	Значение
calculated	награда рассчитана
approved	награда утверждена
revoked	награда отозвана
published	награда опубликована
document_generated	документ сгенерирован

Правила:

1. Пороги наград задаются отдельно по зачётам.
2. Пороги могут отличаться по классам или категориям.
3. Очный и онлайн-зачёт могут иметь разные пороги дипломов и грамот.
4. Наградной статус не равен сгенерированному документу.
5. Генерация документа должна опираться на AwardStatus, но жить в общем механизме документов.
6. Изменение порогов после расчёта требует пересчёта и аудита.
7. Процентные ориентиры не публикуются автоматически: администратор должен утвердить итоговые пороги перед публикацией.

11. ResultCalculationRun

ResultCalculationRun фиксирует запуск расчёта результатов.

Поле	Описание
id	уникальный идентификатор
competition_season_id	сезон
tour_id	тур, если расчёт по туру
result_track_id	зачёт
grade_category_id	класс или категория, если расчёт ограничен
calculation_type	первичный расчёт, пересчёт, расчёт после апелляций
triggered_by_user_id	кто запустил расчёт
status	статус запуска
started_at	начало
finished_at	завершение
summary	краткий результат расчёта

Статусы:

Статус	Значение
queued	поставлен в очередь
running	выполняется
completed	завершён
completed_with_warnings	завершён с предупреждениями
failed	не завершён
cancelled	отменён

Правила:

1. Каждый массовый расчёт результатов должен создавать ResultCalculationRun.
2. Пересчёт не должен затирать историю предыдущего расчёта.
3. Если часть работ не проверена, расчёт должен либо блокироваться, либо завершаться с предупреждениями по явному правилу.
4. После апелляций должен быть отдельный пересчёт или корректировка с историей.

12. ResultPublication

ResultPublication — публикация результатов в определённом контуре доступа.

Виды публикации:

Вид	Кто видит
private	только участник и разрешённые семейные пользователи
group	учитель или организация видит своих учеников
venue	площадка видит результаты участников площадки, если это разрешено
public	открытый список на сайте
official	официальный список для регламентной публикации или отчётности
admin_internal	внутренняя административная публикация

Поле	Описание
id	уникальный идентификатор
competition_season_id	сезон
tour_id	тур, если публикация по туру
result_track_id	зачёт
publication_type	тип публикации
grade_category_id	класс или категория, если публикация ограничена
status	статус публикации
visible_fields_policy	какие поля показывать
opens_at	начало публикации
closes_at	окончание, если есть
published_at	когда опубликовано
published_by_user_id	кто опубликовал

Статусы:

Статус	Значение
draft	публикация готовится
scheduled	публикация запланирована
published	опубликована
paused	временно остановлена
retracted	отозвана
archived	архивирована

Правила:

1. Личная публикация не равна публичной публикации.
2. Публичная публикация не обязана содержать все баллы и всех участников.
3. Публикации должны разделяться по ResultTrack.
4. Нельзя публиковать общий список, смешивающий очный и онлайн-зачёт, если это не задано отдельным агрегированным правилом.
5. Публичные списки должны формироваться отдельно по классам и зачётам.
6. Удержанные результаты исключаются из публикации.
7. Отзыв публикации должен сохранять историю.

13. PrivateResultView

PrivateResultView — личный результат участника в кабинете.

Может показывать:

• статус участия;
• допуск к следующему туру;
• баллы;
• место, если опубликовано;
• наградной статус;
• ссылку на просмотр работы;
• ссылку на документ, если он сгенерирован;
• комментарий или статус проверки, если разрешено.

Правила:

1. Участник видит только свои результаты.
2. Родитель видит результаты ребёнка по правилам семейного доступа.
3. Личный результат может открыться раньше публичных списков.
4. Личный результат может содержать больше деталей, чем публичный список.

14. GroupResultView

GroupResultView — представление результатов для преподавателя в выбранной организации.

Может показывать:

• список учеников CompetitionGroup snapshot;
• статус прохождения;
• баллы;
• допуск к следующему туру;
• наградной статус;
• ссылки на документы;
• статусы получения аккаунта учеником;
• признаки проблем: нет работы, дубль, неявка, не проверено.

Правила:

1. Преподаватель видит только учеников своих Learning Groups/CompetitionGroup snapshots, если у него нет расширенной роли.
2. Административный подслой выбранной организации может видеть несколько snapshots в рамках роли.
3. Результаты внешних участников площадки не должны автоматически попадать в преподавательский слой.
4. Организация, совмещающая свои группы и открытую площадку, должна видеть эти контуры раздельно.

15. PublicResultList

PublicResultList — публичный список результатов, победителей, призёров или награждённых.

Поле	Описание
id	уникальный идентификатор
result_publication_id	публикация
title	название списка
result_track_id	зачёт
grade_category_id	класс или категория
list_type	победители, призёры, все опубликованные, награждённые
status	статус списка
generated_at	когда список сформирован

Типы list_type:

Тип	Описание
winners	победители
prize_winners	призёры
honorable_mentions	похвальные грамоты
awardees	все награждённые
full_results	полный список, если разрешено
official_report_list	официальный список для регламентной публикации

Правила:

1. Публичный список должен быть связан с ResultTrack.
2. Публичные списки очного и онлайн-зачёта должны формироваться отдельно.
3. Состав публичных полей должен задаваться политикой публикации.
4. Публичный список должен учитывать согласия и требования к персональным данным.
5. Публичный список может быть архивным материалом прошлых лет.

16. Visible fields policy

Политика видимых полей определяет, какие данные показываются в публикации.

Возможные поля:

Поле	Комментарий
full_name	ФИО участника
grade_category	класс или категория
city	город
country	страна
organization_name	школа или организация
teacher_name	учитель, если публикуется
final_score	итоговый балл
place	место
award_status	наградной статус
result_track_title	зачёт

Правила:

1. Публичная политика видимости должна быть настроена до публикации.
2. Не все личные данные из кабинета должны попадать в публичный список.
3. Для официальных списков набор полей может отличаться от обычных публичных списков.
4. Если согласия не покрывают публикацию персональных данных, список должен быть ограничен или обезличен.

17. Статусная модель: результат

Состояние	Значение
work_submitted	работа отправлена
checking	работа проверяется
scored	баллы выставлены
final_score_ready	финальный балл готов
result_calculated	результат рассчитан
ranking_calculated	рейтинг рассчитан
award_calculated	наградной статус рассчитан
result_finalized	результат финализирован
result_withheld	результат удержан от публикации
private_published	личный результат опубликован
public_published	публичный список опубликован
document_ready	документ доступен
archived	результат архивирован

18. MVP-апелляция и арбитраж

MVP-апелляция — пользовательский workflow несогласия с проверкой или результатом.

ArbitrationCase — отдельный административный workflow для подозрительных работ, нарушений регламента и санкций.

Сущность	Что решает	Кто инициирует
Appeal	ошибка проверки, несогласие с баллом, техническая претензия к результату	участник, родитель, преподаватель
ArbitrationCase	подозрение на нарушение, списывание, недопуск, санкция	проверяющий, админ «Систематики»

Правила:

1. Appeal не используется для дисциплинарных подозрений.
2. Accepted appeal создаёт новую версию Score/FinalScore или ResultCalculationRun.
3. ArbitrationCase может удержать результат от публикации.
4. Решения appeal и arbitration требуют reason, actor и audit.
5. UI-статус апелляции “Новая” соответствует техническому статусу submitted; отдельный technical new не вводится.

19. Админские требования

Администратор должен иметь возможность:

• видеть готовность результатов по сезону, туру, зачёту и классу;
• запускать расчёт результатов;
• видеть предупреждения расчёта;
• пересчитывать результаты после изменений;
• финализировать результаты отдельно от publication;
• удерживать или release результат;
• настраивать пороги наград;
• утверждать процентные ориентиры порогов вручную;
• утверждать наградные статусы;
• настраивать публикации;
• отдельно публиковать личные результаты, групповые результаты и публичные списки;
• отозвать публикацию с сохранением истории;
• выгрузить списки по зачёту, классу и статусу награды;
• видеть аудит изменений баллов, результатов, порогов и публикаций.

20. Права доступа

Право	Назначение
result.view_own	смотреть свой результат
result.view_child	смотреть результат ребёнка
result.view_group	смотреть результаты группы
result.view_organization	смотреть результаты организации
result.view_venue	смотреть результаты участников площадки, если разрешено
result.admin_view	административный просмотр результатов
result.calculate	запускать расчёт результатов
result.finalize	финализировать результаты
result.withhold	удержать результат от публикации
result.recalculate	запускать пересчёт
award_policy.configure	настраивать правила наград
award_status.approve	утверждать наградные статусы
appeal.create	подать MVP-апелляцию
appeal.decide	принять решение по апелляции
arbitration_case.create	открыть кейс подозрительной работы
arbitration_case.decide	принять решение арбитража
result_publication.configure	настраивать публикацию
result_publication.publish	публиковать результаты
result_publication.retract	отзывать публикацию
public_result_list.generate	формировать публичный список

21. Требования к аудиту

Аудироваться должны:

• создание и изменение Score;
• создание и изменение FinalScore;
• запуск расчёта результатов;
• ошибки и предупреждения расчёта;
• финализация результата;
• изменение ResultTrack участника;
• изменение AwardPolicy;
• изменение ScoreThreshold;
• ручное утверждение процентных ориентиров порогов;
• пересчёт AwardStatus;
• ручная корректировка наградного статуса;
• удержание и release результата;
• решение appeal;
• решение arbitration case;
• создание публикации;
• публикация результатов;
• отзыв публикации;
• генерация публичного списка;
• изменение политики видимых полей.

22. Доменные события

Событие	Когда возникает
ScoreSubmitted	балл выставлен
FinalScoreCalculated	финальный балл рассчитан
ResultCalculationStarted	расчёт результатов запущен
ResultCalculationCompleted	расчёт результатов завершён
FinalResultCalculated	финальный результат рассчитан
RankingCalculated	рейтинг рассчитан
AwardStatusCalculated	наградной статус рассчитан
ThresholdsApproved	пороги утверждены вручную
ResultsFinalized	результаты финализированы
ResultWithheld	результат удержан от публикации
AppealSubmitted	подана MVP-апелляция
AppealDecided	принято решение по апелляции
ArbitrationCaseOpened	открыт арбитражный кейс
ArbitrationCaseDecided	принято решение арбитража
PrivateResultsPublished	личные результаты опубликованы
GroupResultsPublished	групповые результаты опубликованы
PublicResultListGenerated	публичный список сформирован
PublicResultsPublished	публичные результаты опубликованы
ResultPublicationRetracted	публикация отозвана

23. Нестандартные случаи

Ситуация	Требуемое поведение
В зачёте есть непроверенные работы	расчёт блокируется или завершается с предупреждением по явному правилу
Участник ошибочно попал в онлайн-зачёт вместо очного	изменение ResultTrack требует аудита и пересчёта
После публикации изменился балл	нужна новая версия результата, пересчёт наград и решение по публикации
Пороги наград изменились после расчёта	требуется пересчёт AwardStatus и аудит
Процентные ориентиры дали спорный порог	администратор вручную утверждает итоговый threshold snapshot
Результат удержан арбитражем	результат исключается из публикации до release
Участник подал апелляцию на подозрение в нарушении	запрос маршрутизируется в arbitration/support, а не в MVP appeal
У двух участников одинаковые баллы	применяется RankingPolicy для равенства мест
Участник дисквалифицирован после расчёта	результат переводится в специальный статус и рейтинг пересчитывается
Личный результат опубликован, публичный список ещё нет	это допустимо, если так настроена публикация
Публичный список отозван	список не удаляется из истории, а получает статус retracted
Участник без аккаунта получил диплом	доступ к документу должен быть связан с AccountClaim или семейной группой

Готовность

1. Добавить модели Score и FinalScore.
2. Добавить модель FinalResult.
3. Добавить модель Ranking и Place.
4. Расширить ResultTrack политиками результата и публикации.
5. Добавить модели AwardStatus и ResultCalculationRun.
6. Добавить модель ResultPublication.
7. Добавить модели PrivateResultView, GroupResultView и PublicResultList или их сервисные представления.
8. Добавить настройку visible_fields_policy для публикаций.
9. Добавить ручное утверждение процентных ориентиров порогов.
10. Добавить result withholding.
11. Добавить разделение MVP appeal и arbitration case.
12. Добавить права расчёта, финализации и публикации результатов.
13. Добавить аудит изменения баллов, порогов, результатов и публикаций.
14. Добавить запрет смешивания ResultTrack в одном публичном списке без явного агрегирующего правила.
15. Добавить административный запуск расчёта и пересчёта результатов.

25. Статус документа

Документ является первой версией модели результатов, зачётов, наградных статусов и публикации. Следующий рекомендуемый документ: документы и награды.