Тренинги

Функциональные требования: Модуль «Тренинги»

Версия: 1.0 Статус: Draft Аудитория: Команда разработки (backend, frontend, QA, PM) Референс: GetCourse (getcourse.ru)

1. Назначение документа

Документ описывает функциональные требования к модулю «Тренинги» — ядру обучающей платформы. Модуль отвечает за:

создание и управление учебным контентом (тренинги, подтренинги, уроки);

выдачу и разграничение доступов к контенту;

управление порядком прохождения (последовательное открытие и расписание).

Документ не описывает технический стек, архитектуру и схему БД — только бизнес-логику и поведение системы.

2. Глоссарий

Термин	Определение
Тренинг	Корневой образовательный контейнер (курс). Содержит уроки и/или подтренинги.
Подтренинг	Вложенный тренинг внутри родительского тренинга. Используется для разбиения курса на модули/темы. По функционалу идентичен тренингу.
Урок	Атомарная единица обучения с контентом (текст, видео, задания и т.д.).
Ученик	Пользователь, получивший доступ к тренингу и проходящий обучение.
Преподаватель	Пользователь, который ведёт тренинг и проверяет задания.
Администратор	Пользователь с полными правами на управление контентом и доступами.
Группа	Сегмент пользователей, используемый для группового управления доступами.
Расписание	Правила открытия уроков во времени (по датам или с задержками).
Стоп-урок	Урок, блокирующий переход к следующим урокам до его выполнения.

3. Роли пользователей

В контексте модуля «Тренинги» предусмотрены следующие роли:

Администратор — имеет полный доступ ко всем тренингам, их настройкам и доступам пользователей. Может создавать, редактировать, удалять и архивировать любые тренинги.

Преподаватель — имеет доступ к назначенным ему тренингам. Может редактировать контент уроков (при наличии прав), проверять задания учеников и управлять расписанием.

Ученик — имеет доступ к тренингам, в которых состоит. Может просматривать уроки (с учётом правил открытия) и отправлять ответы на задания.

Один пользователь может одновременно иметь разные роли в разных тренингах.

4. Иерархия контента

4.1. Модель

Принята двухуровневая модель вложенности:

Тренинг
├── Урок 1
├── Урок 2
├── Подтренинг A
│   ├── Урок A.1
│   ├── Урок A.2
│   └── Урок A.3
├── Подтренинг B
│   ├── Урок B.1
│   └── Урок B.2
└── Урок 3

4.2. Правила

Тренинг может содержать уроки и/или подтренинги в любом сочетании.

Подтренинг может содержать только уроки (дальнейшая вложенность не поддерживается).

Порядок элементов внутри контейнера задаётся вручную и сохраняется.

Урок принадлежит ровно одному родителю (тренинг или подтренинг).

Подтренинг принадлежит ровно одному родительскому тренингу.

4.3. Почему двухуровневая модель

Ограничение вложенности упрощает логику доступов, расписания и UI навигации. Для разделения контента на темы достаточно одного уровня подтренингов. Это осознанное сокращение относительно GetCourse, который поддерживает до 10 уровней вложенности.

5. Сущность «Тренинг»

5.1. Основные атрибуты

Название — отображается в списках и заголовках.

Описание — краткое описание курса, видно ученикам.

Обложка — изображение для карточки тренинга.

Статус — черновик / опубликован / архивный.

Преподаватель — основной ответственный за тренинг.

Дата создания, дата публикации.

5.2. Статусы

Черновик — тренинг создан, но недоступен ученикам. Виден только администраторам и преподавателям.

Опубликован — тренинг активен и может выдаваться ученикам согласно правилам доступа.

Архивный — тренинг скрыт из активных списков, но доступы сохраняются для исторических данных (опционально — с возможностью полного отзыва доступов).

5.3. Действия над тренингом

Создание / редактирование / удаление.

Дублирование (копирование структуры с уроками или без).

Архивация / восстановление из архива.

Управление составом уроков и подтренингов (добавление, удаление, изменение порядка).

Настройка доступов (см. раздел 8).

Настройка расписания (см. раздел 9).

5.4. Условия завершения тренинга

Администратор задаёт правило, при котором тренинг считается завершённым учеником. Возможные варианты:

все уроки тренинга пройдены;

все стоп-уроки пройдены;

конкретный урок пройден (например, финальный тест).

Факт завершения тренинга — это доменное событие, которое может использоваться другими модулями (выдача сертификата, открытие следующего тренинга, начисление баллов и т.д.).

6. Сущность «Подтренинг»

Подтренинг — это тренинг, вложенный в родительский тренинг. С точки зрения функциональности подтренинг идентичен тренингу, за исключением следующего:

не может содержать других подтренингов;

отображается ученику только в контексте родительского тренинга;

имеет собственные настройки доступа и расписания, которые работают независимо от родителя (см. раздел 8.4).

Все действия, доступные для тренинга (редактирование, дублирование, архивация), применимы и к подтренингу.

7. Сущность «Урок»

7.1. Основные атрибуты

Название.

Контент — основное наполнение урока (текст, видео, изображения, файлы).

Порядковый номер внутри родителя.

Родитель — тренинг или подтренинг.

Флаг «Скрыт» — урок не отображается ученикам (используется для черновиков).

Флаг «Стоп-урок» — см. раздел 9.3.

Дата открытия по расписанию — см. раздел 9.

7.2. Типы уроков

Для MVP достаточно одного универсального типа урока с составным контентом (текст + медиа + файлы). В дальнейшем могут быть добавлены специализированные типы (вебинар, тест и т.д.), но это за рамками данного документа.

7.3. Задания в уроке

Урок может содержать задание, требующее ответа от ученика. Задание имеет следующие состояния ответа:

Не отправлен — ученик ещё не ответил.

Отправлен — ответ ждёт проверки.

Принят — ответ проверен и принят преподавателем.

Отклонён — ответ отклонён, требуется доработка.

Статус ответа влияет на логику стоп-уроков (см. раздел 9.3).

7.4. Статусы прохождения урока учеником

Для каждой пары «ученик ↔ урок» система хранит статус:

Недоступен — урок закрыт правилами доступа или расписания.

Доступен — урок можно открыть, но ученик ещё не заходил.

Начат — ученик открыл урок.

Выполнен — урок пройден (критерий выполнения зависит от типа урока: вход, отправка ответа, принятие ответа).

8. Доступы

8.1. Модель доступа: по группам

Доступ к тренингам и подтренингам выдаётся через механизм групп пользователей.

Группа — это именованный сегмент пользователей.

Пользователь может состоять одновременно в нескольких группах.

Тренинг/подтренинг привязан к одной или нескольким группам.

Пользователь имеет доступ к тренингу, если он состоит хотя бы в одной группе, привязанной к тренингу.

8.2. Управление членством в группе

Членство в группе может изменяться следующими способами:

Ручное добавление/удаление администратором через интерфейс управления группой.

Массовое добавление (например, импорт списка пользователей).

Программное добавление через внутренние события системы (покупка, регистрация на событие и т.д.) — реализуется за пределами модуля «Тренинги», но модуль должен корректно реагировать на изменение состава группы.

8.3. Последствия изменения членства

При добавлении пользователя в группу — он немедленно получает доступ ко всем тренингам, привязанным к этой группе.

При удалении пользователя из группы — доступ к тренингу сохраняется, если пользователь остаётся в хотя бы одной другой группе, привязанной к тренингу. Иначе — доступ отзывается.

Прогресс ученика (статусы прохождения уроков, ответы на задания) сохраняется при отзыве доступа. Если доступ будет выдан повторно, ученик продолжит с того места, где остановился.

8.4. Доступы к подтренингам

Подтренинг может иметь один из двух режимов доступа:

Наследовать от родителя — подтренинг доступен всем, у кого есть доступ к родительскому тренингу. Это значение по умолчанию.

Собственные группы — подтренинг доступен только пользователям из указанных групп (независимо от доступа к родителю).

Второй режим решает типовой кейс: на тренинг куплены два тарифа (обычный и премиум), премиум-тариф открывает дополнительный подтренинг с бонусами. Ученики обоих тарифов состоят в группе «Основная», но только премиум-ученики — в группе «Премиум», привязанной к бонусному подтренингу.

8.5. Видимость тренинга без доступа

Для тренингов, к которым у пользователя нет доступа, настраивается поведение отображения:

Не отображать — тренинг скрыт полностью.

Отображать как заблокированный — тренинг виден в общем списке с пометкой «нет доступа» (например, для мотивации к покупке доступа).

Настройка задаётся на уровне тренинга.

9. Управление прохождением уроков

Существует два независимых механизма ограничения доступа к урокам: расписание и стоп-уроки. Механизмы могут работать одновременно — в этом случае урок доступен ученику только при выполнении обоих условий.

9.1. Расписание: общие положения

Расписание определяет, когда урок становится доступным ученику с точки зрения времени. Расписание настраивается на уровне тренинга или подтренинга. Если тренинг содержит подтренинги, расписание для уроков внутри каждого подтренинга настраивается отдельно.

Система поддерживает два типа расписания:

Общее — одинаковые даты открытия для всех учеников.

Индивидуальное — даты рассчитываются для каждого ученика от момента получения доступа.

Тип расписания выбирается на уровне тренинга/подтренинга и распространяется на все его уроки.

9.2. Типы расписания

9.2.1. Общее расписание

Для каждого урока задаётся конкретная дата и время открытия (абсолютная метка времени). Все ученики получают доступ к уроку одновременно в указанный момент.

Кейс: живой поток курса, стартующий 1 сентября для всех участников.

9.2.2. Индивидуальное расписание

Для каждого урока задаётся задержка в днях (или часах) относительно точки отсчёта. Точкой отсчёта служит момент получения учеником доступа к тренингу.

Урок 1 — задержка 0 дней (доступен сразу).

Урок 2 — задержка 2 дня.

Урок 3 — задержка 5 дней.

Если ученик получил доступ 10 марта, то урок 3 откроется для него 15 марта.

Кейс: самостоятельное прохождение курса в индивидуальном темпе.

9.3. Стоп-уроки

Стоп-урок — это урок, блокирующий переход к последующим урокам до его выполнения.

9.3.1. Правила блокировки

Для стоп-урока задаётся критерий «выполнения»:

Вход в урок — достаточно открыть урок.

Отправка ответа — ученик должен отправить ответ на задание.

Принятие ответа — ответ должен быть проверен и принят преподавателем.

Пока критерий не выполнен, все уроки, расположенные после стоп-урока в порядке следования, недоступны ученику.

9.3.2. Область действия

Стоп-уроки работают в пределах одного контейнера (тренинга или подтренинга).

Стоп-урок в подтренинге не блокирует уроки родительского тренинга и наоборот.

Для последовательного открытия подтренингов используется механизм завершения тренинга (см. раздел 9.4).

9.4. Последовательное открытие подтренингов

Для организации поэтапного открытия модулей курса используется связка «условие завершения» ↔ «условие доступа»:

У подтренинга A задаётся условие завершения (например, «все стоп-уроки выполнены»).

У подтренинга B задаётся условие доступа: «доступен тем, кто завершил подтренинг A».

При завершении подтренинга A для ученика — подтренинг B автоматически открывается.

Это позволяет строить цепочки модулей без использования расписания.

9.5. Совместное действие расписания и стоп-уроков

Когда одновременно настроены и расписание, и стоп-уроки — урок доступен ученику только если выполнены оба условия:

дата открытия по расписанию наступила И

все предшествующие стоп-уроки выполнены.

Более строгое ограничение имеет приоритет. Например, если по расписанию урок должен открыться, но предыдущий стоп-урок не пройден — урок остаётся закрытым.

9.6. Видимость закрытых уроков

Для каждого урока настраивается поведение отображения, когда он ещё недоступен:

Скрыт из списка — ученик не видит урок до момента открытия.

Виден, но заблокирован — ученик видит название урока и дату открытия, но не может в него войти.

Настройка задаётся на уровне урока и работает одинаково для ограничений по расписанию и по стоп-урокам.

10. Пользовательские сценарии

10.1. Создание курса (администратор)

Администратор создаёт новый тренинг в статусе «Черновик».

Добавляет уроки и/или подтренинги, задаёт порядок.

Наполняет уроки контентом.

При необходимости настраивает стоп-уроки и расписание.

Создаёт группу доступа и привязывает её к тренингу.

Переводит тренинг в статус «Опубликован».

10.2. Выдача доступа (администратор)

Администратор открывает управление группой доступа.

Добавляет пользователя в группу (вручную или массово).

Пользователь немедленно получает доступ ко всем тренингам группы.

10.3. Прохождение тренинга (ученик)

Ученик видит тренинг в своём списке.

Открывает первый доступный урок.

Изучает контент, отправляет ответ на задание (если есть).

Переходит к следующему уроку — либо сразу, либо после открытия по расписанию, либо после прохождения стоп-урока.

По завершении всех уроков согласно условию завершения тренинг отмечается как пройденный.

10.4. Отзыв доступа (администратор)

Администратор удаляет пользователя из группы.

Если пользователь не состоит в других группах с доступом к тренингу — доступ автоматически отзывается.

Прогресс ученика сохраняется в системе.

11. Требования к логированию

Для аудита и отладки модуль должен логировать следующие события:

создание, изменение, удаление, архивация тренинга/подтренинга/урока;

изменение состава группы доступа;

выдача и отзыв доступа пользователю (с указанием причины: ручная / через группу);

открытие урока учеником;

отправка ответа, смена статуса ответа.

Детализация формата логов — за рамками данного документа.

12. Вне области этой документации

Следующие аспекты платформы GetCourse намеренно не включены в MVP:

продукты, предложения, оплаты и связка доступов с покупками;

процессы и автоворонки;

геймификация (баллы, рейтинги, достижения);

сертификаты;

уроки типа «вебинар», «тест», «опрос» (только универсальный урок);

вложенность более одного уровня (подтренинги в подтренингах);

тест-драйв, промо-уроки;

сквозные чаты в уроках;

потоки обучения (когорты со стартом по датам).

Эти возможности могут быть добавлены в следующих итерациях.

13. Открытые вопросы

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

Какие именно форматы контента поддерживаются в уроке в MVP (только текст + видео? файлы? встраиваемые блоки?).

Нужна ли роль «преподаватель» в MVP или на старте достаточно администратора?

Какие уведомления отправляются ученику при открытии урока по расписанию?

Как ведёт себя система при смещении расписания в тренинге, где уже есть активные ученики?

Нужна ли возможность ручной индивидуальной выдачи доступа к отдельному уроку (в обход групп)?