События LMS

Зачем нужно

LMS события нужны для интеграций с CRM, task-bank, notifications, management analytics, storefront и внешней LMS. События должны быть минимальными, безопасными и идемпотентными.

Общий envelope

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

Правила безопасности

Events не должны содержать:

• полный ответ ученика;
• приватный комментарий преподавателя;
• содержимое чата;
• состав Learning Group с ФИО или контактами;
• персональные данные сверх необходимых IDs;
• payment details;
• access tokens;
• storage signed URLs.

Если потребителю нужны подробности, он должен запросить их через API с permission checks.

Outgoing events

Content events

Event	Когда	Payload
lms.course.created	создан course	courseId, subjectKey, createdByUserId
lms.course.updated	изменена metadata	courseId, changedFields
lms.course.archived	course архивирован	courseId, reason
lms.course_version.created	создан draft	courseId, courseVersionId, sourceVersionId
lms.course_version.submitted_for_review	отправлено на review	courseVersionId
lms.course_version.published	опубликована version	courseId, courseVersionId, version, contentHash
lms.course_version.retired	version retired	courseVersionId, reason

Потребители:

• storefront получает публичную проекцию;
• management получает факт публикации;
• notifications может уведомить внутренних пользователей;
• sync service может подготовить migration.

Enrollment events

Event	Когда	Payload
lms.enrollment.created	создан enrollment	enrollmentId, studentProfileId, courseId, courseVersionId, source
lms.enrollment.activated	открыт доступ	enrollmentId, studentProfileId, courseId
lms.enrollment.paused	доступ остановлен	enrollmentId, reason
lms.enrollment.resumed	доступ возобновлён	enrollmentId
lms.enrollment.revoked	доступ отозван	enrollmentId, reason
lms.enrollment.completed	курс завершён	enrollmentId, completedAt, completionPercent
lms.entitlement.consumed	LMS списала учебное потребление CRM entitlement	entitlementId, sessionId, attendanceId, quantity
lms.entitlement.consumption_reverted	списание entitlement отменено	entitlementId, consumerRef, reason

Потребители:

• notifications отправляет учебные уведомления;
• management строит агрегаты;
• CRM может сверить entitlement lifecycle;
• roadmap может получить learning evidence.

Learning Workspace events

Event	Когда	Payload
lms.learning_group.created	создана Learning Group	groupId, organizationId, ownerTeacherUserId
lms.learning_group.updated	изменены title/description/status	groupId, changedFields
lms.learning_group.archived	группа архивирована	groupId, reason
lms.learning_group_participant.added	участник добавлен	groupId, studentProfileId, source
lms.learning_group_participant.removed	участник удалён	groupId, studentProfileId, reason
lms.learning_group_invite.sent	invite отправлен	inviteId, groupId, targetType
lms.learning_group_invite.accepted	invite принят	inviteId, groupId, studentProfileId
lms.learning_group_assignment.created	создано назначение	assignmentId, groupId, targetDomain, targetType
lms.learning_group_assignment.cancelled	назначение отменено	assignmentId, reason

Learning Workspace events описывают рабочий контур преподавателя. Они не являются событиями enrollment, progress или competition result.

Learning activity events

Event	Когда	Payload
lms.lesson.opened	ученик впервые открыл lesson	enrollmentId, nodeId, courseVersionId
lms.content_block.viewed	просмотрен required block	enrollmentId, nodeId, contentBlockId
lms.activity.started	начата attempt	attemptId, enrollmentId, contentBlockId
lms.activity.attempted	attempt создана или обновлена	attemptId, enrollmentId, contentBlockId, status
lms.activity.submitted	attempt отправлена	attemptId, enrollmentId, contentBlockId
lms.activity.checked	attempt проверена	attemptId, status, score, maxScore, checkerSource
lms.activity.completed	activity завершена	attemptId, enrollmentId, contentBlockId, completedAt
lms.homework.submitted	домашняя работа отправлена	submissionId, enrollmentId, nodeId
lms.homework.graded	домашняя работа оценена	submissionId, score, statusDecision
lms.submission.submitted	работа отправлена	submissionId, enrollmentId, sourceType, sourceId
lms.feedback.created	создан feedback	feedbackId, submissionId, statusDecision, score
lms.progress.updated	пересчитан snapshot	enrollmentId, nodeId, status, completionPercent
lms.lesson.progress_updated	изменён прогресс урока	enrollmentId, nodeId, status, completionPercent
lms.topic.completion_updated	изменён topic completion	topicId, studentProfileId, status, masteryScore
lms.evidence.recorded	записано evidence	evidenceId, sourceType, sourceId, studentProfileId

Roadmap events

Event	Когда	Payload
lms.roadmap.published	опубликована roadmap program/version	programId, version, publishedAt
lms.roadmap.topic_changed	изменена тема roadmap	topicId, changedFields
lms.fact.changed	создан, опубликован или изменён публичный учебный факт для витрины	factKey, sourceRef, changedFields

Live delivery events

Event	Когда	Payload
lms.attendance.recorded	зафиксирована посещаемость	attendanceId, sessionId, studentProfileId, status
lms.session.completed	занятие завершено	sessionId, groupId, completedAt
lms.teacher_session.completed	занятие преподавателя завершено для payroll	sessionId, teacherUserId, durationMinutes

Gamification events

Event	Когда	Payload
lms.xp.awarded	начислен опыт	xpEventId, studentProfileId, amount, sourceRef
lms.badge.awarded	выдан badge	badgeAwardId, badgeId, studentProfileId
lms.streak.updated	обновлён streak	streakId, studentProfileId, currentCount

Workbook and project events

Event	Когда	Payload
lms.workbook.revision_saved	сохранена revision	workbookId, revisionNo, enrollmentId
lms.workbook.submitted	тетрадь отправлена	workbookId, enrollmentId
lms.project.created	создан проект	projectId, enrollmentId
lms.project_milestone.submitted	milestone отправлен	projectId, milestoneId, enrollmentId
lms.project_milestone.completed	milestone принят	projectId, milestoneId, enrollmentId

Booking events

Event	Когда	Payload
lms.booking_slot.created	создан учебный слот	slotId, courseId, startsAt, teacherUserId
lms.booking.held	слот удержан	slotId, enrollmentId, expiresAt
lms.booking.booked	запись подтверждена	bookingId, slotId, enrollmentId
lms.booking.cancelled	запись отменена	bookingId, reason
lms.booking.completed	занятие завершено	bookingId
lms.booking.missed	ученик не пришёл	bookingId

Chat events

Event	Когда	Payload
lms.chat.thread_created	создан thread	threadId, contextType, contextId
lms.chat.message_created	создано сообщение	threadId, messageId, senderUserId
lms.chat.message_hidden	сообщение скрыто	threadId, messageId, reason
lms.chat.thread_closed	thread закрыт	threadId, reason

lms.chat.message_created не содержит текст сообщения.

Incoming events

From CRM

Event	Действие LMS
crm.entitlement.activated	создать или активировать enrollment
crm.entitlement.suspended	перевести enrollment в paused
crm.entitlement.resumed	вернуть enrollment в active, если курс доступен
crm.entitlement.expired	перевести enrollment в revoked или paused по политике продукта
crm.entitlement.revoked	перевести enrollment в revoked
crm.entitlement.changed_course_version	создать migration request

LMS не должна открывать доступ, если course или version не найдены.

From task-bank

Event	Действие LMS
task-bank.attempt.checked	обновить attempt, создать feedback/evidence, пересчитать progress
task-bank.problem.updated	пометить draft references как needing review
task-bank.problem.retired	запретить публикацию draft с устаревшей ссылкой

Published version не меняется автоматически при изменениях task-bank.

From identity

Event	Действие LMS
identity.family_relation.changed	инвалидировать family access cache
identity.user.deactivated	закрыть login-dependent действия, не удалять history
identity.role.changed	пересчитать permission cache
identity.organization_membership.changed	пересчитать teacher mode и Learning Workspace visibility
identity.invite.accepted	активировать Learning Group participant, если invite относится к группе
identity.student_profile.merged	relink Learning Group participant refs после явного merge

From competitions

Event	Действие LMS
competitions.training_publication.created	разрешить назначение опубликованного комплекта как LMS/training material
competitions.training_publication.revoked	скрыть новое назначение тренировки, не менять historical LMS attempts

Competitions events не создают competition_result внутри LMS. Разборы и тренировочные попытки пишутся в учебный контур.

From external LMS sync

Event	Действие LMS
external_lms.progress.imported	создать external sync record и learning evidence
external_lms.course_mapping.updated	обновить mapping для migration
external_lms.sync.failed	сохранить error и показать admin

Event versioning

• Новые поля добавляются optional.
• Удаление или изменение смысла поля требует новой messageVersion.
• Consumer должен игнорировать неизвестные поля.
• Producer должен сохранять совместимость минимум на один major cycle.

Idempotency

Каждый event обрабатывается по messageId.

Для webhook источников также используется natural key:

• CRM: entitlementId + messageType + occurredAt;
• task-bank: attemptId + checkerResultId;
• external LMS: externalSystem + externalId + syncedAt.

Повторная доставка не должна создавать дубликаты enrollments, attempts, feedback или evidence.

Ordering

Ordering гарантируется только внутри aggregate:

• course version;
• enrollment;
• attempt;
• submission;
• chat thread;
• booking slot.

Если событие пришло раньше зависимости, consumer создаёт retry или dead-letter entry.

Observability

Для каждого event flow должны быть метрики:

• produced count;
• consumed count;
• failed count;
• retry count;
• dead-letter count;
• processing latency;
• idempotent duplicate count.

Минимальный event backlog для MVP

Для MVP обязательны:

• lms.course_version.published;
• lms.enrollment.created;
• lms.enrollment.activated;
• lms.enrollment.revoked;
• lms.learning_group.created;
• lms.learning_group_assignment.created;
• lms.lesson.opened;
• lms.activity.submitted;
• lms.feedback.created;
• lms.progress.updated;
• incoming crm.entitlement.activated;
• incoming task-bank.attempt.checked.