Создание групп и добавление учеников - Exode

Группы — это учебные потоки внутри курса. Каждая группа привязана к конкретному курсу (продукту), объединяет учеников и кураторов, имеет собственный чат/канал, а также индивидуальные правила доступа к урокам и расписание открытия материалов.

Группы всегда создаются в контексте курса. Раздел «Группы» открывается из карточки курса, поэтому у группы уже есть привязка к курсу и его продукту — отдельно выбирать курс при создании не нужно.

Где находятся группы

Список групп курса доступен по адресу:

/manage/course/:courseId/groups/:page

На странице списка отображаются карточки всех групп курса с указанием количества участников, а также кнопка создания новой группы. Если групп ещё нет, показывается заглушка с предложением создать первую группу. Список групп курса с карточками и кнопкой создания

Список групп курса с карточками и кнопкой создания

Кнопка создания группы и добавления учеников доступна только на платформе онлайн-школы (Platform.School). В других режимах платформы эти действия скрыты.

Создание группы

Создание группы выполняется в модальном окне manage-group-create, которое открывается кнопкой «Создать группу» в шапке списка. В форму передаётся productId текущего курса, поэтому новая группа сразу связывается с курсом.

Откройте список групп курса

Перейдите в управление курсом и откройте раздел «Группы». Нажмите кнопку «Создать группу» в правом верхнем углу.

Введите название группы

Укажите название в поле «Название группы». Ограничение — 100 символов. Пока название не заполнено, кнопка создания остаётся неактивной.

Добавьте учеников (необязательно)

В том же окне можно сразу выбрать учеников через поиск по пользователям школы. За один раз можно выбрать до 250 человек. Этот шаг можно пропустить и добавить учеников позже.

Создайте группу

Нажмите «Создать группу». После создания вы автоматически переходите на страницу настроек новой группы, где можно назначить кураторов и правила доступа.

Форма создания группы: название и выбор учеников

Форма создания поддерживает черновики: если вы случайно закрыли окно, введённые данные (название и выбранные ученики) можно восстановить при повторном открытии.

Добавление учеников в группу

Управление составом группы вынесено на отдельную страницу «Ученики»:

/manage/course/:courseId/groups/:page/:groupId/students

Здесь отображается таблица участников группы с фильтрами и экспортом. Добавить учеников можно кнопкой «Добавить ученика», которая открывает модальное окно manage-group-invite-members. Страница учеников группы с таблицей и кнопкой добавления

Страница учеников группы с таблицей и кнопкой добавления

Как добавляются участники

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

Параметр	Значение
Максимум за одно добавление	250 пользователей
Источник	Пользователи школы (поиск по имени)
Результат операции	Списки `created` (добавлены) и `exist` (уже состояли в группе)
Права	Только платформа онлайн-школы

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

Фильтрация участников

Таблица учеников поддерживает фильтры, помогающие находить нужных участников в больших группах:

Фильтр	Назначение
`search`	Поиск по имени участника
`participantStatuses`	Статус участника в продукте
`currentLessonIds`	Текущий урок, на котором находится ученик
`progressPercentRange`	Диапазон прогресса прохождения курса
`createdAtDateRange`	Дата добавления в группу
`inviterUserIds`	Кто пригласил участника
`participantCuratorIds`	Закреплённый куратор

Отфильтрованный список можно выгрузить через кнопку экспорта (тип GroupMemberFindMany).

Связь группы с курсом и потоком

Группа не существует отдельно от курса: она привязывается к продукту курса (productId). Через продукт группа связана с курсом, его модулями и уроками — это позволяет управлять доступом к материалам именно для участников данной группы.

query GroupFindOne($groupId: Int!) {
    groupFindOne(groupId: $groupId) {
        id
        name
        product {
            id
            course {
                id
                name
                type
            }
        }
    }
}

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

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

​Где находятся группы

​Создание группы

​Добавление учеников в группу

​Как добавляются участники

​Фильтрация участников

​Связь группы с курсом и потоком

Где находятся группы

Создание группы

Добавление учеников в группу

Как добавляются участники

Фильтрация участников

Связь группы с курсом и потоком