События

Правила

• События не содержат полные ответы, сканы, PII, закрытые task-bank данные или raw LMS responses.
• Results events публикуются только после calculation/finalization/publication соответствующего уровня.
• Document events не содержат приватный файл, только id/url по правилам доступа.
• Повторная доставка команд и events обрабатывается идемпотентно.

Общий envelope

type CompetitionEvent<TPayload> = {
  messageId: string;
  messageKind: 'event';
  messageType: string;
  messageVersion: number;
  producer: 'competitions';
  producerInstance: string;
  traceId: string;
  occurredAt: string;
  correlationId?: string;
  actor?: {
    type: 'user' | 'service' | 'system';
    id?: string;
  };
  data: TPayload;
  metadata?: Record<string, unknown>;
};

Исходящие события

Event	Когда
competitions.season.published	сезон стал публичным для storefront/read-models
competitions.season.registration_opened	открыт сезон
competitions.registration.pre_submitted	создана предварительная регистрация
competitions.registration.submitted	подана заявка
competitions.registration.completion_required	нужно дозаполнить регистрацию
competitions.registration.created	создана регистрация
competitions.registration.approved	заявка одобрена
competitions.participant.created	создан участник
competitions.participant.joined	участник присоединился к сезону или туру
competitions.access_claim.approved	claim access одобрен
competitions.learning_group.snapshot_created	создан season snapshot Learning Group
competitions.group.helper_granted	помощнику выданы ограниченные права
competitions.tour.opened	тур открыт
competitions.activity_binding.locked	activity binding и task structure заблокированы
competitions.activity_attempt.started	participant запустил LMS/adapter attempt через competitions
competitions.submission.submitted	работа отправлена
competitions.group_submission.submitted	преподаватель отправил ответы по ученикам группы
competitions.submission.late_files_uploaded	загружены поздние файлы/zip/изображения
competitions.submission.received	работа получена системой
competitions.submission.checked	работа проверена
competitions.score_snapshot.created	score by item сохранён как immutable snapshot
competitions.photo_report.submitted	фотоотчёт отправлен
competitions.photo_report.reviewed	фотоотчёт подтверждён или не подтверждён
competitions.venue.application_submitted	подана заявка площадки
competitions.venue.application_approved	заявка площадки одобрена
competitions.venue.published	площадка опубликована списком/на карте
competitions.venue.assignment_changed	участник выбрал или сменил площадку
competitions.venue.capacity_change_blocked	уменьшение вместимости требует admin process
competitions.result.finalized	результат финализирован
competitions.result.withheld	результат удержан от публикации
competitions.result.published	индивидуальный результат опубликован
competitions.results.published	результаты опубликованы
competitions.publication.revoked	публичная проекция сезона, результата, площадки или документа отозвана
competitions.appeal.submitted	подана MVP-апелляция
competitions.appeal.decided	принято решение по апелляции
competitions.arbitration.opened	открыт арбитраж подозрительной работы
competitions.arbitration.decided	принято решение арбитража
competitions.award.issued	награда выдана
competitions.award_document.generated	документ создан
competitions.gratitude_document.generated	благодарственное письмо создано
competitions.season.closed	сезон закрыт
competitions.training_publication.created	LMS activity/review mode опубликован как training
competitions.training_publication.revoked	training-публикация отозвана для новых назначений
competitions.notification.triggered	создан минимальный trigger для registration/tour/result/document/venue уведомления

Входящие события

Источник	Событие	Использование
identity	identity.organization_student.created/updated/archived	organization participant context and snapshots
identity	identity.organization_membership.activated/suspended	organization access cache
identity	identity.organization.merged	новые регистрации идут в primary organization, historical projections сохраняются
identity	identity.organization_permission_grant.created/revoked	organization-scoped permission cache
identity	family/user updates	права доступа и claim
learning workspace	learning.group.created/updated/archived	обновление доступных Learning Groups, без изменения historical snapshots
learning workspace	learning.group_member.added/removed	обновление доступного выбора перед snapshot/registration
CRM	payment/entitlement events	paid registrations
task-bank	content/source events	source refs before activity binding lock
storefront	campaign/page events	public links and traffic
LMS	activity attempt/checking/score events	competition mode status and score by item; training attempt/result events не создают competition submission/result
management	operational tasks	coordination workflows

Payload examples

type SourceRef = {
  domain: 'identity' | 'task-bank' | 'crm' | 'storefront' | 'lms' | 'learning-workspace' | 'management' | 'competitions';
  type: string;
  id: string;
  version?: string;
};

type RegistrationApprovedPayload = {
  registrationId: string;
  seasonId: string;
  participantId: string;
  source: 'self' | 'parent' | 'teacher' | 'organization' | 'admin';
  learningGroupId?: string;
  childModeRequired?: boolean;
};

type SubmissionSubmittedPayload = {
  submissionId: string;
  lmsActivityAttemptRef?: SourceRef;
  adapterAttemptRef?: SourceRef;
  tourId: string;
  participantId: string;
  deliveryMode: 'online' | 'teacher_led' | 'venue' | 'imported';
  submittedByActorType: 'student' | 'parent' | 'teacher' | 'helper' | 'venue' | 'admin' | 'system';
};

type ScoreSnapshotCreatedPayload = {
  submissionId: string;
  tourId: string;
  participantId: string;
  activityBindingId: string;
  sourceRuntimeRef?: SourceRef;
  itemScores: Array<{
    taskNumber: number;
    lmsActivityItemRef?: SourceRef;
    score: number;
    maxScore: number;
    checkingStatus?: string;
  }>;
};

type ResultFinalizedPayload = {
  resultId: string;
  seasonId: string;
  tourId?: string;
  participantId: string;
  trackId?: string;
  score: number;
  awardStatus?: string;
  isWithheld?: boolean;
};

Идемпотентность

Сценарий	Ключ
registration	season:{seasonId}:participant:{participantId}:source:{source}
pre-registration	season:{seasonId}:actor:{actorId}:pre:{clientKey}
group registration	season:{seasonId}:learningGroup:{learningGroupId}:snapshot:{snapshotHash}
activity binding lock	tour:{tourId}:activityBinding:{activityBindingId}:lock:{version}
submission ref	tourParticipation:{id}:runtime:{runtimeAttemptRef}
group submission	tour:{tourId}:group:{groupId}:runtime:{batchRef}
score snapshot	submission:{submissionId}:scoreSnapshot:{sourceVersion}
photo report	tour:{tourId}:venue:{venueId}:photoReport:{fileHash}
venue assignment	tour:{tourId}:participant:{participantId}:venue:{venueId}
result calculation	season:{seasonId}:track:{trackId}:calc:{version}
appeal decision	appeal:{appealId}:decision:{version}
arbitration decision	arbitration:{caseId}:decision:{version}
document generation	result:{resultId}:document:{type}

Retention

Данные	Срок
registrations/participations	бессрочно или по legal policy
submissions/files	по регламенту сезона
results/rankings	бессрочно
award documents	бессрочно или по document policy
audit logs	5 лет