Data mapping — lms

Источники

• GetCourse: курсы, уроки, прогресс, домашки;
• ручные таблицы расписаний и attendance;
• Laravel-сайт roadmap (программа обучения, темы);
• ручные таблицы преподавателей и групп;
• старые группы преподавателей из олимпиадного контура, если они использовались как постоянный учебный roster;
• ручные тетради/проекты (если есть структура).

Mapping сущностей

Исходная сущность	Целевая сущность	Правило
GetCourse course	lms_course + lms_course_version	одна версия на курс при импорте
GetCourse lesson	lms_node (type=lesson) + lms_content_block	парсинг контента в блоки
GetCourse activity/test	lms_activity	mapping типа активности
GetCourse student progress	lms_progress_snapshot, lms_activity_attempt	по пользователю и активности
GetCourse homework	lms_homework + lms_submission	сохраняем оценки и feedback
Laravel roadmap программа	roadmap_program, roadmap_module, roadmap_topic	пересборка иерархии
Storefront/admin roadmap authoring	roadmap_program, roadmap_module, roadmap_topic, topic_pathway	нормализация учебной модели в LMS; editorial-поля остаются во storefront
Laravel topic ↔ course/lesson	topic_pathway + session_topic_link	явные связи
Product/course linkage	topic_pathway.product_refs, product_run_refs	CRM refs, не ownership transfer
Legacy group/session schedule	group, session, session_topic_link, mini_group_track	scheduled state строится в LMS projection
Sheets преподаватели	lms_teacher_assignment + ссылка на educator_profile	educator_profile создаётся/сверяется в identity, LMS хранит учебное назначение
Sheets группы	learning_group	canonical roster «мои группы»
Sheets участники групп	learning_group_participant	canonical roster «мои ученики»
Sheets занятия	session	+ attendance
Sheets attendance	attendance	per session, per student
ручные тетради	lms_workbook	один на ученика-курс
ручные XP/streak	xp_event агрегаты	одна история начисления
старые олимпиадные teacher groups	learning_group + learning_group_participant	только если группа использовалась за пределами одного сезона
результаты олимпиад для разбора	learning_evidence / learning_review_session	source ref на competition_result; не training attempt

Маппинг статусов

Исходный attendance	Целевой attendance
пусто / not_marked	expected
present	present
absent	absent
late	late
excused	excused_absence
makeup	makeup_completed
cancelled	cancelled

Если legacy makeup означает только запланированную компенсацию, а не факт проведённого replacement-занятия, запись переносится как makeup_planned.

Сценарии

• курсы переносятся по одному, в порядке приоритета продаж;
• активные ученики получают enrollment в целевом LMS, прогресс backfill ETL;
• расписание сначала зеркалится, затем переключается на запись в целевой LMS;
• attendance параллельно фиксируется в обеих системах в фазе dual-write;
• топика дорожной карты пересобираются и проверяются куратором;
• public roadmap из storefront/admin импортируется в LMS как normalised roadmap, а entry_requirements, catchup, CTA и SEO copy остаются storefront projection;
• преподавательские списки из старых таблиц и олимпиад переносятся в Learning Workspace, а не в competitions.

Стратегия

• 1. read-only ETL прогресса из GetCourse;
• 2. dual-write: новые активности — в целевой LMS;
• 3. per-course cutover;
• 4. ручные таблицы отключаются по группам;
• 5. Learning Workspace становится единственным источником «мои ученики / мои группы»;
• 6. write switch — новые продажи только в целевой LMS.

Риски и контроль

• утрата прогресса → ETL валидируется по контрольным суммам активностей;
• путаница в связях course ↔ topic → curriculum-команда подтверждает связи;
• расхождение расписания → ежедневный delta-check;
• путаница в XP → исторические XP импортируются как один агрегат xp_event с типом source_aggregate.
• смешение learning_training_attempt и competition_submission → отдельные namespace и source refs.

Связанные документы

• ../cutover.md
• ../../domains/lms/data-model.md