Функционал внешних преподавателей
Зачем нужно
Внешний преподаватель участвует в олимпиадах через преподавательский режим с выбранной организацией и должен управлять только своим разрешённым контуром Learning Groups, registration snapshots и помощников.
Кто использует
- внешний преподаватель;
- координатор олимпиады;
- администратор;
- support.
Сценарии
- зарегистрироваться как внешний преподаватель;
- подтвердить роль;
- выбрать Learning Group;
- создать season snapshot;
- зарегистрировать участников на тур;
- подать заявку на проведение первого тура;
- открыть материалы олимпиады для анонса, проведения и отчёта;
- добавить помощников с урезанными правами;
- отслеживать статусы;
- отправить ответы по ученикам с предупреждением и lock;
- получить результаты;
- скачать документы;
- передать вопрос в support.
Данные
| Сущность | Назначение |
|---|---|
external_teacher_profile | competition-specific projection/access record внешнего преподавателя: identity_user_id, snapshot имени, организация, статус проверки |
external_teacher_student_link | разрешённая связь преподавателя с участником |
learning_group_id | external ref на каноническую группу в Learning Workspace |
competition_group | season-specific snapshot/projection Learning Group |
competition_group_helper | помощник с урезанными правами |
competition_registration | регистрация участника или группы |
competition_teacher_conduct_application | заявка преподавателя на проведение тура для своих учеников |
competition_teacher_material | teacher-facing материал сезона или тура |
competition_result | результат, видимый по правилам публикации |
competition_award_document | документ, доступный после публикации |
Правила
- Внешний преподаватель видит только связанных учеников и разрешённые олимпиады.
- Канонический профиль преподавателя живёт в identity-owned
EducatorProfile. external_teacher_profileне является вторым canonical profile преподавателя.- Права не выдаются из факта наличия profile; они идут через selected organization, Learning Workspace, grants и capabilities.
- Канонический список учеников живёт в Learning Workspace / Learning Group.
competition_groupнельзя использовать как общий список «моих учеников».- Подтверж дение роли должно иметь статус и источник.
- Результаты показываются по правилам публикации конкретной олимпиады.
- Преподаватель не может менять ответы, баллы и итоговые результаты.
- Преподаватель может отправлять ответы за учеников только до lock и в рамках delivery policy.
- Текстовое поле «учитель» в анкете участника не создаёт связь с внешним преподавателем.
- Заявка на проведение не заменяет регистрацию учеников и
competition_groupsnapshot. - Материалы тура открываются только по availability window и visibility.
Заявка преподавателя на проведение
Teacher conduct application — отдельный flow “Провести Олимпиаду” для первого тура или другого teacher-led тура.
Зачем нужна:
- понять, кто реально проводит тур;
- подготовить инструкции и материалы;
- оценить ожидаемое число участников;
- связать проведение с фотоотчётом;
- подготовить благодарственные письма преподавателю, помощникам и организации.
Минимальные поля:
| Поле | Описание |
|---|---|
season_id, tour_id | какая олимпиада и тур проводятся |
identity_organization_id | выбранная организация преподавателя |
location_text | школа, кабинет, адрес или текстовое описание |
expected_participant_count | примерное количество участников |
planned_date_from, planned_date_to | дата или период проведения |
grade_categories | классы |
delivery_mode | teacher_led, online_supervised, mixed |
contact_snapshot | email, телефон, мессенджер |
photo_report_required | ожидается ли фотоотчёт |
Статусы: draft, submitted, approved, needs_changes, rejected, cancelled, completed. Для MVP достаточно submitted, approved, cancelled, completed.
approval_required определяется policy. В обычном первом туре submitted может быть достаточно для регистрации учеников и доступа к открытым материалам; approved нужен для закрытых материалов, официального финала, открытой площадки или risk/admin policy.
После submitted или approved согласно policy преподаватель всё равно выбирает Learning Group, создаёт competition_group snapshot, регистрирует учеников, проводит тур и отправляет ответы. Заявка не создаёт участников автоматически.
Материалы преподавателя
В преподавательском режиме нужен раздел “Материалы Олимпиады”. Это не только материалы тура, а полный набор для анонса, проведения и отчёта.
Типы материалов:
| Тип | Назначение |
|---|---|
poster, banner | распечатать, отправить в чат или опубликовать на сайте школы |
announcement_text, school_news_text | текст анонса или новости |
teacher_instruction, student_instruction, parent_instruction | инструкции |
tour_material | задания, бланки, варианты, если открыты |
participant_list | список участников перед проведением |
report_template, photo_report | отчётность после тура |
results_news, gratitude | итоговая новость и благодарности |
Правила доступности:
- до регистрации доступны афиша, баннер, анонс и правила;
- перед туром открываются инструкции, список и материалы проведения;
- во время тура доступны материалы тура и отправка ответов;
- после тура доступны фотоотчёт и статус проверки;
- после публикации результатов доступны результаты учеников, итоговые материалы и благодарности.
API
| Method | Endpoint | Назначение |
|---|---|---|
POST | /api/v2/competitions/external-teachers/profile | создать или обновить профиль |
POST | /api/v2/competitions/external-teachers/profile/verify | отправить подтверждение роли |
POST | /api/v2/competitions/external-teachers/students | добавить связь с учеником/participant |
DELETE | /api/v2/competitions/external-teachers/students/{participantId} | отозвать связь |
GET | /api/v2/competitions/teacher/organizations/{organizationId}/learning-groups | выбрать Learning Groups |
POST | /api/v2/competitions/teacher/competition-groups | создать snapshot сезона |
POST | /api/v2/competitions/teacher/competition-groups/{groupId}/helpers | добавить помощника |
GET | /api/v2/competitions/teacher/conduct-applications | список заявок на проведение |
POST | /api/v2/competitions/teacher/conduct-applications | подать заявку на проведение |
GET | /api/v2/competitions/teacher/seasons/{seasonId}/materials | материалы сезона |
GET | /api/v2/competitions/teacher/tours/{tourId}/materials | материалы тура |
POST | /api/v2/competitions/registrations | зарегистрировать ученика или группу |
POST | /api/v2/competitions/teacher/tours/{tourId}/group-submissions | отправить ответы по группе |
GET | /api/v2/competitions/external-teachers/results | результаты доступных учеников |
Permissions: competitions.external_teachers.manage.own, competitions.participants.manage.assigned, competitions.results.read.assigned.
Серверная часть
Серверная часть хранит профиль внешнего преподавателя, связи с участниками, season snapshots Learning Groups, статусы подтверждения и аудит действий с регистрациями.
Статусы профиля: pending -> verified -> revoked; pending -> rejected; rejected -> pending после новой заявки.
Интерфейс
- кабинет внешнего преподавателя;
- выбор организации;
- список Learning Groups из Learning Workspace;
- CompetitionGroup snapshots сезона;
- регистрация на олимпиаду;
- помощники;
- заявки на проведение;
- материалы олимпиады;
- отправка ответов по группе с warning;
- статусы участия;
- результаты и документы;
- состояния неподтверждённой роли.
Интеграции
- identity — аккаунт и роль;
- Learning Workspace — canonical groups and rosters;
- CRM — контакты и обращения;
- competitions — участники, туры, результаты;
- storefront — публичная регистрация;
- notifications — статусы и напоминания.
Безопасность
Нужны проверка связи с Learning Group/snapshot, ограничение видимости результатов, урезанные права помощников и аудит действий внешнего преподавателя.
Нестандартные случаи
- роль не подтверждена;
- ученик уже зарегистрирован другим представителем;
- связь с учеником отозвана;
- Learning Group изменилась после snapshot;
- заявка на проведение одобрена, но ученики ещё не зарегистрированы;
- материал тура ещё закрыт по времени;
- помощник пытается превысить права;
- результат ещё не опубликован;
- преподаватель представля ет несколько организаций.
Готовность
- внешний преподаватель проходит регистрацию и подтверждение;
- может вести своих учеников через Learning Groups и season snapshots;
- может подать заявку на проведение и видеть её статус;
- может открыть teacher materials по доступным сезонам и турам;
- может добавить помощника с ограниченными правами;
- не видит чужие данные;
- получает статусы, результаты и документы по правилам публикации.