Перейти к основному содержимому

Обзор домена

Зачем нужно​

Домен учебная-система описывает внутреннюю LMS платформы:

  • учебную структуру контента;
  • уроки и вложенные блоки;
  • интерактивные активности;
  • домашние задания;
  • попытки и evidence;
  • прогресс внутри LMS;
  • Learning Workspace: рабочие группы, приглашения и назначения преподавателя;
  • интеграцию с внешней LMS на переходном этапе.

На текущем этапе фактическая LMS-функция выполняется внешней платформой GetCourse, а данные о прогрессе по API забираются во внутреннюю инфраструктуру. Целевая задача — построить собственную LMS и инфраструктуру вокруг неё.

Границы домена​

В домен входят:

  • структура учебного контента;
  • уроки и урокоподобные единицы;
  • блоки контента внутри урока;
  • активности и задания;
  • домашние задания;
  • попытки прохождения;
  • evidence учебной активности;
  • прогресс по уроку и по LMS-курсу;
  • рабочий контур преподавателя Learning Workspace;
  • правила completion внутри LMS;
  • версии контента;
  • интеграционный слой с внешней LMS.

В домен не входят:

  • продуктовая витрина, цены и продажи;
  • цели семьи и ученика;
  • канонический список учеников, семьи, организации и membership;
  • олимпиадные submission, result, ranking и award status;
  • канонический банк задач как самостоятельный домен.

Ключевые принципы​

  1. Roadmap — подсистема LMS, но не lesson tree.
    Дорожная карта отвечает на вопрос, что должен освоить ученик. LMS content отвечает на вопрос, какой учебный контент, в какой структуре и с какими активностями он проходит.

  2. Тема дорожной карты не равна уроку LMS.
    Один урок может покрывать одну тему, часть темы или несколько тем. Одна тема может покрываться несколькими уроками и через разные форматы.

  3. Жёсткой модели курс → урок недостаточно.
    Базовая структура LMS должна поддерживать иерархию произвольной вложенности: курс, модуль, блок, подкурс, урок, дневной блок интенсива и т.д.

  4. Контент, активность и прогресс разделены.
    Нельзя смешивать:

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

  5. Прогресс в LMS не равен прогрессу по теме roadmap.
    LMS считает, что сделано внутри учебного контента. Roadmap агрегирует это в освоение канонических тем.

  6. Посещаемость не равна mastery.
    Attendance может быть evidence, но не является самостоятельным доказательством освоения темы или полного прохождения учебного материала.

  7. Модель оценки должна быть настраиваемой по предмету и формату.
    Для математики, шахмат, ТРИЗ, биологии и других направлений состав evidence различается.

  8. Learning Workspace — общий рабочий контур преподавателя, а не LMS enrollment. Learning Group задаёт список “моих учеников/моих групп” для LMS, олимпиадных тренировок, разборов, тренажёров и task-bank assignments. Он не создаёт отдельный канонический список учеников и не подменяет lms_enrollment, progress или live group/session.

Базовая модель LMS и Learning Workspace​

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

1. Content structure​

Что существует как учебный материал:

  • курс;
  • версия курса;
  • узел дерева;
  • блок контента.

2. Learning access​

Кто и на каких условиях проходит:

  • enrollment;
  • teacher assignment;
  • source entitlement.

2a. Learning Workspace​

Рабочий контур преподавателя:

  • Learning Group;
  • Learning Group Participant;
  • Learning Group Invite;
  • Learning Group Assignment.

3. Roadmap​

Каноническая учебная траектория:

  • программа;
  • модуль;
  • тема;
  • pathway.

4. Live delivery​

Расписание и факт учебного занятия:

  • группа;
  • session;
  • attendance;
  • room.

5. Learning activity​

Что делает ученик:

  • activity;
  • attempt;
  • submission;
  • workbook revision;
  • chat message.

6. Learning result​

Что система считает:

  • progress snapshot;
  • learning evidence;
  • completion.

7. Gamification​

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

  • xp;
  • badge;
  • streak.

Текущее состояние​

Сейчас:

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

Целевая модель​

Целевая LMS должна:

  • поддерживать вложенную структуру учебного контента;
  • быть связана с roadmap-слоем LMS, но не смешана с lesson tree;
  • поддерживать разные типы evidence и activity;
  • уметь работать с курсами в записи, курсами вживую, интенсивами и дополнительным контентом;
  • давать преподавателю общий Learning Workspace для групп, приглашений и назначений в выбранной организации;
  • размещать олимпиадные тренажёры и разборы в учебном контуре без смешения с competition attempt/result;
  • быть пригодной для аналитики, AI-персонализации и интеграции с банком задач.

Карта документов​

  • scope.md — границы LMS и ответственность соседних доменов.
  • data-model.md — канонические сущности, связи и инварианты данных.
  • database-schema.md — стартовая SQL-схема хранения.
  • state-machines.md — состояния курсов, версий, enrollments, попыток, работ, booking и чатов.
  • api-map.md — карта endpoints и назначение API.
  • api-contracts.md — DTO, команды, ответы, webhooks и ошибки.
  • permissions-matrix.md — permissions, роли, контексты доступа и audit.
  • events.md — outgoing и incoming events LMS.
  • integrations.md — связи с новым слоем integrations/*.md.
  • user-flows.md — учебные, преподавательские и admin-сценарии.
  • screen-spec.md — пользовательские, преподавательские и admin-экраны.
  • security.md — доступ к учебным данным, evidence, live delivery и gamification.
  • test-plan.md — unit, integration, E2E, security и performance проверки.
  • features/courses.md — курсы и структура учебного контента.
  • features/learning-workspace.md — рабочие группы, приглашения и назначения преподавателя.
  • features/lessons.md — уроки, блоки и активности.
  • features/progress.md — прогресс, completion и evidence.
  • features/calendar.md — учебный календарь.
  • features/class-booking.md — запись на занятия.
  • features/workbooks.md — учебные тетради.
  • features/course-projects.md — проекты внутри курса.
  • features/internal-teacher-tools.md — инструменты преподавателя.
  • features/teacher-chat.md — чат с преподавателем.
  • features/onboarding.md — онбординг ученика.
  • features/gamification.md — мотивационные механики без подмены академического результата.
  • features/admin.md — администрирование.
  • integrations.md — связи с соседними доменами.
  • acceptance.md — критерии готовности.

Канон документов​

Каждый домен целевой модели ведётся в 15-файловом каноне: overview.md, scope.md, data-model.md, database-schema.md, state-machines.md, api-map.md, api-contracts.md, permissions-matrix.md, events.md, integrations.md, user-flows.md, screen-spec.md, security.md, test-plan.md, acceptance.md, а детальные возможности лежат в features/*.md.