Модель мероприятия, сезона, тура и зачёта

Зачем нужно

Документ фиксирует ядро доменной модели олимпиад, конкурсов, турниров и других интеллектуальных соревнований «Систематики».

Модель должна поддерживать разные предметы и форматы мероприятий: математическую олимпиаду, олимпиады по биологии и физике, платный конкурс «Кенгуру», а позже — шахматный турнир и другие форматы.

Математическая олимпиада является референсом, но не единственной моделью. В математике сейчас типично два тура, а в других предметах может быть один тур. Поэтому количество туров, расписание, формат проведения и зачёты должны задаваться настройками сезона, а не кодом.

Что входит

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

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

Что не входит

В этом документе не проектируются подробно:

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

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

В ядре домена нельзя смешивать пять разных осей.

Ось	Что описывает	Пример
Тип мероприятия	Что это за событие	олимпиада, конкурс, турнир
Предмет	По какой области проводится	математика, биология, физика
Формат тура	Как устроены задания и ответы	тест, письменная работа, сканы
Способ прохождения	Где и через кого участник проходит тур	онлайн, у учителя, на площадке
Зачёт	Как считаются результаты и награды	очный зачёт, онлайн-зачёт, официальный зачёт

Нельзя считать, что онлайн всегда означает отдельный зачёт, а очный всегда означает официальный зачёт. Это независимые настройки.

5. Верхнеуровневая структура

Уровень	Сущность	Назначение
1	CompetitionEvent	устойчивое мероприятие, например олимпиада по математике
2	CompetitionSeason	конкретный сезон мероприятия
3	GradeCategory	классы, параллели или возрастные категории сезона
4	Tour	тур внутри сезона
5	TourWindow	окно или слот проведения тура
6	ResultTrack	отдельный зачёт для расчёта результатов
7	AwardPolicy	правила дипломов, грамот и других наград
8	TourParticipation	участие конкретного ученика в конкретном туре; подробно описывается отдельно

Пример чтения модели:

• есть мероприятие «Олимпиада Систематика по математике»;
• у него есть сезон «20-й сезон»;
• в сезоне есть первый и второй тур;
• первый тур может идти две недели онлайн или через учителя;
• второй тур может иметь очный зачёт и онлайн-зачёт;
• у каждого зачёта свои результаты, пороги дипломов и публикации.

6. CompetitionEvent

CompetitionEvent — стабильная сущность мероприятия, которая существует дольше одного сезона.

Она отвечает на вопрос: «Что это за мероприятие?»

Примеры:

• Международная олимпиада по математике «Систематика»;
• Олимпиада по биологии «Систематика»;
• Олимпиада по физике «Систематика»;
• Конкурс «Кенгуру»;
• Шахматный турнир «Систематика».

Основные поля

Поле	Описание
id	уникальный идентификатор
code	стабильный код мероприятия
title	название мероприятия
short_title	краткое название
competition_type_id	тип мероприятия
competition_subject_id	предмет или область соревнования
default_grade_range	базовый диапазон классов, если применимо
owner_team	команда-владелец процесса
status	статус мероприятия
public_visibility	видимость на публичной витрине
description	краткое описание

Статусы

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

Правила

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

7. CompetitionType

CompetitionType задаёт тип соревновательного мероприятия.

Код	Название	Комментарий
olympiad	Олимпиада	основной формат для математики, биологии, физики
contest	Конкурс	подходит для «Кенгуру» и похожих мероприятий
tournament	Турнир	подходит для шахматного турнира и будущих турнирных механик

Правила:

1. Тип мероприятия не должен определять всю механику автоматически.
2. Тип используется для интерфейсов, фильтров, публичной витрины и базовых шаблонов настроек.
3. Специальные механики должны добавляться через расширения или настройки.

8. CompetitionSubject

CompetitionSubject описывает предмет или область соревнования.

Важно: CompetitionSubject не равен напрямую направлению обучения. Он может ссылаться на направление обучения, но остаётся отдельной сущностью домена олимпиад.

Поле	Описание
id	уникальный идентификатор
code	код предмета
title	название предмета
linked_learning_direction_id	связь с направлением обучения, если есть
status	активен или архивен

Примеры:

code	title	Комментарий
math	Математика	может быть связана с олимпиадной математикой
biology	Биология	уже существует как предмет мероприятий
physics	Физика	уже существует как предмет мероприятий
chess	Шахматы	для турнира может потребовать расширения модели
kangaroo	Кенгуру	может быть отдельной областью или внешним конкурсом

9. CompetitionSeason

CompetitionSeason — конкретный запуск мероприятия в определённый период.

Она отвечает на вопрос: «Как проводится это мероприятие в этом году или сезоне?»

Все ключевые настройки проведения относятся к сезону:

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

Основные поля

Поле	Описание
id	уникальный идентификатор
competition_event_id	ссылка на мероприятие
code	код сезона
title	название сезона
season_number	номер сезона, если используется
academic_year	учебный год или период
starts_at	дата начала сезона
ends_at	дата завершения сезона
registration_opens_at	начало регистрации
registration_closes_at	окончание регистрации
status	статус сезона
fee_policy	бесплатное или платное участие
public_visibility	видимость сезона на сайте
result_publication_policy	общая политика публикации результатов

Статусы

Статус	Значение
draft	сезон создаётся и настраивается
configured	основные настройки заполнены, но сезон ещё не опубликован
published	сезон виден пользователям, но регистрация может быть закрыта
registration_open	регистрация открыта
registration_closed	регистрация закрыта, подготовка к проведению
active	сезон находится в процессе проведения
results_processing	туры завершены, идёт проверка и расчёт результатов
results_published	результаты опубликованы
archived	сезон завершён и архивирован
cancelled	сезон отменён

Правила

1. Один CompetitionEvent может иметь много CompetitionSeason.
2. У каждого сезона должен быть хотя бы один Tour перед публикацией.
3. Количество туров задаётся настройками сезона.
4. Сезон может быть бесплатным или платным.
5. Платный сезон или платное участие должны быть связаны с доменом продуктов и каталога.
6. Нельзя публиковать сезон, если не заданы обязательные классы, туры и базовые правила регистрации.
7. Архивный сезон остаётся доступным для истории, результатов, документов и материалов прошлых лет.

10. GradeCategory

GradeCategory описывает класс, параллель или возрастную категорию внутри сезона.

Она нужна потому, что правила, задания, пороги и результаты часто различаются по классам.

Поле	Описание
id	уникальный идентификатор
competition_season_id	сезон
code	код категории
title	название
min_grade	минимальный класс, если применимо
max_grade	максимальный класс, если применимо
sort_order	порядок отображения
is_active	используется ли категория в сезоне

Примеры:

code	title
grade_1	1 класс
grade_2	2 класс
grade_3_4	3–4 класс
grade_5_7	5–7 класс
beginners	Начинающие

Правила:

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

11. Tour

Tour — логический этап внутри сезона.

Примеры:

• первый тур;
• второй тур;
• отборочный тур;
• заключительный тур;
• единственный тур конкурса;
• финальный раунд турнира.

Основные поля

Поле	Описание
id	уникальный идентификатор
competition_season_id	сезон
code	код тура
title	название тура
sequence_number	порядковый номер
tour_kind	тип этапа: отборочный, заключительный, единственный, дополнительный
status	статус тура
default_tour_format	базовый формат тура
admission_policy	правила допуска к туру
result_policy	общие правила результата тура
sort_order	порядок отображения

Статусы

Статус	Значение
draft	тур создаётся
configured	настройки тура заполнены
registration_open	открыта регистрация или выбор формата участия
ready	тур готов к проведению
running	тур проводится
closed	приём ответов завершён
checking	идёт проверка
results_ready	результаты рассчитаны, но ещё не опубликованы
published	результаты тура опубликованы
archived	тур архивирован
cancelled	тур отменён

Правила

1. Тур принадлежит одному сезону.
2. У сезона может быть один или несколько туров.
3. Порядок туров задаётся явно.
4. Тур может иметь один или несколько способов прохождения.
5. Тур может быть связан с одним или несколькими зачётами.
6. Тур может быть доступен не всем участникам сезона, если есть правила допуска.
7. Для каждого тура должны быть заданы окна проведения или слоты.

12. TourFormat

TourFormat описывает формат заданий и отправки ответов. Он отвечает на вопрос: «Что участник сдаёт?»

Код	Название	Описание
test	Тестирование	участник выбирает вариант или вводит короткий ответ
written_scan	Письменная работа со сканом	участник решает письменно, затем загружается фото или скан
mixed	Смешанный формат	есть и тестовые ответы, и загружаемые материалы
external	Внешний формат	используется для мероприятий по внешним правилам

Правила:

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

13. DeliveryMode

DeliveryMode описывает способ прохождения тура конкретным участником или группой участников.

Он отвечает на вопрос: «Где и через кого участник проходит тур?»

Код	Название	Описание
student_online	Онлайн самостоятельно	ученик проходит тур в личном кабинете
teacher_offline	Очно у учителя	учитель проводит тур у себя и затем вносит ответы или сканы
teacher_supervised_online	Онлайн под контролем учителя	ученики проходят на платформе, но в рамках группы учителя
venue_offline	Очно на площадке	участник приходит на подтверждённую площадку
external_delivery	Внешнее проведение	для внешних конкурсов или специальных форматов

Правила:

1. DeliveryMode должен задаваться на уровне TourParticipation, а не только на уровне группы.
2. В одной группе разные ученики могут иметь разные DeliveryMode.
3. DeliveryMode может влиять на доступные окна, слоты, инструкции, материалы и требования к загрузке работ.
4. DeliveryMode может быть связан с ResultTrack, но не должен автоматически определять его.

14. TourWindow

TourWindow описывает окно проведения тура или отдельный слот.

Поле	Описание
id	уникальный идентификатор
tour_id	тур
code	код окна или слота
title	название
window_type	тип окна
starts_at	начало доступности
ends_at	конец доступности
start_policy	как участник начинает тур
duration_minutes	длительность попытки, если ограничена
delivery_mode	ограничение окна по способу прохождения
grade_category_id	ограничение по классу или категории
venue_id	ограничение по площадке, если это слот площадки
capacity	вместимость окна или слота
status	статус окна

Типы окон

Тип	Описание	Пример
fixed_start	фиксированное начало	все начинают 15 марта в 10:00
open_window	открытое окно	можно начать в любой момент в течение недели
limited_start_window	окно старта	можно начать с 10:00 до 14:00, далее идёт таймер
venue_slot	слот площадки	поток на площадке в конкретное время
teacher_controlled	окно управляется учителем	учитель проводит в разрешённый период

Правила:

1. Тур должен иметь хотя бы одно окно проведения перед запуском.
2. Для онлайн-тура может быть длинное окно и индивидуальный таймер.
3. Для очной площадки могут быть отдельные слоты с вместимостью.
4. Для учительского проведения может быть разрешённый период, внутри которого учитель сам выбирает время.
5. Окно может быть ограничено классом, способом прохождения или площадкой.

15. ResultTrack

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

Он отвечает на вопрос: «В каком зачёте считаются результаты участника?»

ResultTrack нужен, чтобы не смешивать очный и онлайн-зачёт, официальный и неофициальный зачёт, а также другие возможные контуры результатов.

Поле	Описание
id	уникальный идентификатор
competition_season_id	сезон
tour_id	тур, если зачёт относится к конкретному туру
code	код зачёта
title	название зачёта
track_type	тип зачёта
official_status	официальный, неофициальный, внутренний, партнёрский
allowed_delivery_modes	какие способы прохождения могут попадать в зачёт
award_policy_id	правила наград
ranking_policy_id	правила ранжирования
publication_policy_id	правила публикации
status	статус зачёта

Типы зачётов

Код	Название	Пример
main	Основной зачёт	единственный зачёт в однотуровом конкурсе
in_person	Очный зачёт	второй тур на площадках
online	Онлайн-зачёт	второй тур онлайн
official	Официальный зачёт	зачёт для официальных отчётов
community	Комьюнити-зачёт	отдельный продуктовый или неофициальный зачёт
external	Внешний зачёт	для партнёрских или внешних мероприятий

Статусы

Статус	Значение
draft	зачёт создаётся
configured	заданы основные правила
active	зачёт используется для участников
scoring	идёт расчёт результатов
results_ready	результаты готовы
published	результаты опубликованы
archived	зачёт архивирован

Правила

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

16. AwardPolicy и ScoreThreshold

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

ScoreThreshold задаёт балльные пороги для конкретных наград.

AwardPolicy

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

ScoreThreshold

Поле	Описание
id	уникальный идентификатор
award_policy_id	правило наград
award_type	диплом, грамота, сертификат
award_level	уровень награды
min_score	минимальный балл
max_score	максимальный балл, если нужен
sort_order	порядок применения

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

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

Правила:

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

17. Связи сущностей

Связь	Кардинальность	Комментарий
CompetitionType → CompetitionEvent	1 ко многим	один тип используется многими мероприятиями
CompetitionSubject → CompetitionEvent	1 ко многим	один предмет может иметь несколько мероприятий
CompetitionEvent → CompetitionSeason	1 ко многим	у мероприятия много сезонов
CompetitionSeason → GradeCategory	1 ко многим	категории задаются внутри сезона
CompetitionSeason → Tour	1 ко многим	у сезона один или несколько туров
Tour → TourWindow	1 ко многим	у тура одно или несколько окон проведения
CompetitionSeason → ResultTrack	1 ко многим	зачёты задаются в контексте сезона
Tour → ResultTrack	1 ко многим, optional	зачёт может относиться к конкретному туру
ResultTrack → AwardPolicy	1 ко многим	правила наград могут различаться по классам
AwardPolicy → ScoreThreshold	1 ко многим	у правила несколько порогов

18. Пример настройки математической олимпиады

Уровень	Значение
CompetitionEvent	Олимпиада Систематика по математике
CompetitionType	olympiad
CompetitionSubject	math
CompetitionSeason	20-й сезон
Fee policy	free
Tours	первый тур, второй тур

Первый тур:

Настройка	Значение
Tour kind	отборочный
TourFormat	test
DeliveryMode	student_online, teacher_offline, teacher_supervised_online
TourWindow	длинное окно или ограниченное окно сезона
ResultTrack	основной зачёт первого тура

Второй тур:

Настройка	Значение
Tour kind	заключительный
TourFormat	written_scan или mixed
DeliveryMode	venue_offline, student_online
ResultTrack	очный зачёт, онлайн-зачёт
AwardPolicy	отдельные пороги по каждому зачёту

19. Пример однотуровой олимпиады

Поле	Значение
CompetitionEvent	Олимпиада по биологии
CompetitionSeason	сезон 2026
Tours	один тур
TourFormat	test или mixed
ResultTrack	основной зачёт
AwardPolicy	пороги по классам или категориям

Однотуровая олимпиада должна использовать ту же модель, что и двухтуровая математика.

20. Пример конкурса «Кенгуру»

Поле	Значение
CompetitionEvent	Конкурс «Кенгуру»
CompetitionType	contest
Fee policy	paid
DeliveryMode	teacher_offline, venue_offline, external_delivery
ResultTrack	зависит от правил конкурса

Особенность: коммерческая часть должна быть связана с доменом продуктов и каталога. Если «Систематика» выступает площадкой, это должно моделироваться через организацию и роль площадки.

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

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

• создать CompetitionEvent;
• выбрать CompetitionType;
• выбрать CompetitionSubject;
• создать CompetitionSeason;
• задать классы или категории сезона;
• задать бесплатную или платную модель участия;
• создать один или несколько Tour;
• задать порядок туров;
• выбрать TourFormat;
• настроить доступные DeliveryMode;
• задать TourWindow и слоты;
• создать ResultTrack;
• связать ResultTrack с туром, способом прохождения или правилами участия;
• задать AwardPolicy и ScoreThreshold;
• настроить видимость сезона и результатов;
• архивировать сезон без потери истории.

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

Минимальные права для будущей модели доступа:

Право	Назначение
competition_event.create	создать мероприятие
competition_event.update	изменить мероприятие
competition_season.create	создать сезон
competition_season.configure	настраивать сезон
competition_season.publish	публиковать сезон
tour.create	создать тур
tour.configure	настраивать тур
tour.run	запускать проведение тура
result_track.configure	настраивать зачёты
award_policy.configure	настраивать пороги наград
competition.archive	архивировать сезон или мероприятие

Права должны быть согласованы с доменом идентификации и доступа.

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

Событие	Когда возникает
CompetitionEventCreated	создано мероприятие
CompetitionSeasonCreated	создан сезон
CompetitionSeasonPublished	сезон опубликован
TourCreated	создан тур
TourConfigured	тур настроен
TourWindowCreated	создано окно проведения
TourStarted	тур начался
TourClosed	приём работ завершён
ResultTrackCreated	создан зачёт
AwardPolicyUpdated	изменены правила наград
SeasonArchived	сезон архивирован

Все изменения, влияющие на проведение, результаты и публикации, должны попадать в аудит.

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

Ситуация	Требуемое поведение
Сезон создан без туров	нельзя публиковать сезон
Тур создан без окна проведения	нельзя запускать тур
У второго тура два зачёта	результаты и награды считаются отдельно
Один DeliveryMode подходит под несколько зачётов	нужны явные правила назначения участника в зачёт
Платный конкурс создан без продукта	нельзя открыть регистрацию до настройки коммерческой части
Класс есть в сезоне, но не имеет заданий	нельзя открыть тур для этой категории
Изменились пороги наград после расчёта	нужен аудит и пересчёт результатов
Тур отменён	участия и результаты не удаляются, а переводятся в корректные статусы

Готовность

1. Добавить базовые модели CompetitionEvent, CompetitionType и CompetitionSubject.
2. Добавить модель CompetitionSeason со статусами.
3. Добавить модель GradeCategory внутри сезона.
4. Добавить модель Tour со статусами и порядком.
5. Добавить модель TourWindow для окон и слотов проведения.
6. Добавить справочники TourFormat и DeliveryMode.
7. Добавить модель ResultTrack.
8. Добавить модели AwardPolicy и ScoreThreshold.
9. Добавить административные CRUD-экраны или API для настройки сезона.
10. Добавить аудит изменений для сезона, тура, окна проведения, зачёта и порогов наград.

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

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