Дорожная карта LMS
Зачем нужно
Дорожная карта LMS — учебная навигационная система. Она связывает программы, модули, темы, способы прохождения, треки, live delivery, записи, интенсивы, бесплатные курсы, события, progress, completion и рекомендации следующего шага.
Roadmap отвечает на вопросы:
- что входит в программу;
- где находится ученик;
- какие темы закрыты;
- где есть пробелы;
- как тему можно пройти;
- что идёт сейчас;
- можно ли присоединиться;
- что нужно знать перед входом;
- как догнать текущий модуль или трек.
Source of truth, authoring и projection
В целевой архитектуре LMS является source of truth для нормализованной учебной модели roadmap: roadmap_program, roadmap_module, roadmap_topic, topic_pathway, topic_progress и topic_completion.
На переходном этапе storefront admin может оставаться source of authoring для редактирования публичной дорожной карты, модулей, тем и витринных текстов. Это не делает storefront владельцем учебного progress или completion. Storefront может хранить editorial-поля: entry_requirements, catchup, CTA copy, SEO copy и landing-specific группировки.
Projection/read-model — это представление roadmap для public, student, parent, teacher, management или storefront API. Проекция может скрывать часть канонической структуры, но не должна менять учебный смысл исходных сущностей.
Границы
| Область | Входит в roadmap | Не входит |
|---|---|---|
| Учебная структура | programs, modules, topics | коммерческие продукты и цены |
| Способы прохождения | pathways, track refs, LMS refs, product refs | покупка и billing |
| Completion | topic progress, topic completion, evidence usage | XP, badges и streaks как мотивационный слой |
| Live delivery | group/session refs, scheduled state | CRM entitlement и финансовый доступ |
| Entry/catchup | non-blocking projection/editing fields | admission gate и completion rule |
| Events/competitions | layer или alternative pathway | official competition result |
| Projections | public/student/parent/teacher/management | PII в public projection |
Roadmap не равна lesson, session, task-bank problem, homework, product, landing page или competition season.
Основные сущности
| Сущность | Владелец | Назначение |
|---|---|---|
roadmap_program | LMS | программа направления и уровня |
roadmap_module | LMS | кру пный раздел программы |
roadmap_topic | LMS | каноническая учебная тема |
topic_pathway | LMS | способ пройти тему |
mini_group_track | LMS | календарный маршрут live/mini-group формата |
topic_progress | LMS | агрегированное состояние ученика по теме |
topic_completion | LMS | факт закрытия темы по rule |
topic_enrichment | LMS | evidence и углубление после закрытия |
entry_requirements | Storefront/LMS projection | требования комфортного входа |
catchup | Storefront projection | рекомендация по догону |
roadmap_layer | LMS projection | слой отображения: core, free, event и т.д. |
Типовая годовая программа может содержать около 32 тем, но это стандарт, а не инвариант. Пилоты, интенсивы, вводные программы и новые направления могут иметь меньше или больше тем.
Topic completion
Тема считается закрытой только при наличии topic_completion. Посещение занятия, просмотр записи, завершение урока, домашка, task-bank result, диагностика или competition result могут быть evidence, но не закрывают тему напрямую.
Completion rule должна быть настраиваемой:
| Тип темы | Возможное правило |
|---|---|
| live topic | attendance present + homework accepted |
| record topic | lesson completed + homework accepted |
| intro/free topic | course completed |
| diagnostic topic | diagnostic passed + teacher approval |
| enrichment topic | optional evidence, не влияет на core completion |
| manual topic | teacher approval |
Manual override разрешён преподавателю, методисту или LMS admin при наличии audit: actor, reason, old state, new state, evidence refs и timestamp.
Topic pathway
topic_pathway — способ пройти или закрыть тему через формат, продукт, курс, группу, запись, интенсив или индивидуальный сценарий.
Поддерживаемые форматы:
| Format key | Назначение |
|---|---|
mini_group | регулярные мини-группы |
live_course | живой курс |
record_course | курс в записи |
summer_intensive | интенсив |
offline | очный формат |
one_to_one | индивидуальные занятия |
free_course | бесплатный вводный или bridge-курс |
event | мероприятие как учебный способ |
competition | олимпиада, если rule это допускает |
Pathway должен поддерживать product_refs, product_run_refs, group_refs, session_refs, track_ref, availability_state, roadmap_layer, completion_contribution, is_recommended и status.
Одна тема может иметь несколько равноправных pathway: мини-группа, запись, летний интенсив, индивидуально или бесплатный bridge-курс.
Треки
Треки — универсальная настройка программы и формата, а не только олимпиадная математика. Программа может поддерживать один или несколько треков. Трек задаёт календарный маршрут: какие темы и модули идут в какие недели.
Публичный UI может показывать максимум два основных трека, но это ограничение интерфейса, а не доменной модели. Модель должна позволять больше треков, если программа и продукт это поддерживают.
Scheduled state
Для календарных продуктов roadmap projection отдаёт scheduled_state: текущий модуль, тему, занятие, номер занятия в модуле, количество занятий, трек, возможность присоединиться и необходимость догона.
Источники данных:
| Данные | Источник |
|---|---|
| группа и занятие | LMS live delivery |
| связь занятия с темой | session_topic_link |
| запись и enrollment | LMS enrollment/booking или текущая система расписаний |
| трек | mini_group_track или track projection |
| догон | storefront catchup projection |
Для незаписанного пользователя показываются доступные группы, окно дат, текущий модуль, возможность присоединиться, catchup и CTA. Для записанного пользователя показываются конкретная группа, ближайшее занятие, attendance, запись, homework state и следующий шаг.
Entry requirements
entry_requirements — необязательный блок требований комфортного входа к продукту, product run, курсу, модулю или индивидуальному сценарию.
Он может быть пустым, текстовым, списком требований, списком со ссылками “где закрыть” или ссылкой на диагностику. Requirements не являются admission gate и не становятся completion rule.
Базовая формулировка: “Мы не ограничиваем доступ: вы можете присоединиться, даже если часть тем ещё незнакома. Но для комфортного старта рекомендуем закрыть минимум.”
Catchup
catchup — редакционная рекомендация, как догнать, если продукт, модуль или трек уже идёт.
Правила:
- catchup не является completion rule;
- catchup не блокирует доступ;
- catchup может быть пустым;
- catchup может быть переопределён для product run или track;
- в авторизованной версии catchup может учитывать progress ученика.
Редакционный текст хранится в storefront, а связи с LMS модулем, темой и треком передаются через projection refs.
Диагностика и бесплатные курсы
Диагностика всегда необязательна. Она может рекомендовать уровень, показать пробелы, предложить free entry course или gap-closing pathway, но не закрывает тему без completion rule.
Бесплатный курс может быть:
- entry bridge;
- gap closing;
- public preview;
- partial progress;
- full completion, если rule явно разрешает;
- lead-in к платному продукту.
Roadmap layers
| Layer | Смысл |
|---|---|
core | основная программа |
supplemental | дополнительные темы и материалы |
free_entry | бесплатные вводные курсы |
gap_closing | закрытие пробелов |
event | мероприятия |
competition | олимпиады и соревнования |
enrichment | углубление после прохождения |
diagnostic | диагностики и тестирования |
individual | индивидуальный pathway или персональная альтернатива |
Events и competitions показываются отдельным слоем и не являются default completion pathway. Individual lessons являются универсальной альтернативой и могут появляться почти в любом месте roadmap.
Проекции
| Projection | Что показывает |
|---|---|
| public | опубликованную структуру без PII, progress, attendance, purchases и private recommendations |
| student | личный progress, next step, gaps, purchased/access state |
| parent | roadmap ребёнка в family context |
| teacher | roadmap ученика в assigned teacher scope |
| management | агрегаты по программам, темам и completion без лишних персональных данных |
Фильтры и сортировки являются частью API projection, а не только UI: subject, level, format, layer, availability, track, product, scheduled state, completion state и recommendation state.
MVP scope
MVP должен поддержать:
- canonical programs/modules/topics;
- pathways с LMS, CRM, group/session и track refs;
- public projection без приватных данных;
- student/parent/teacher projections с проверкой доступа;
- topic completion только через rule или audited manual override;
- transitional authoring из storefront admin;
- entry requirements и catchup как non-blocking projection/editorial fields.