Роли и доступы
Кто какие эндпоинты может вызывать. Доступ определяется ролью пользователя и — для кураторов — набором гранулярных прав.
Скоупы
В справочнике у каждого эндпоинта есть цветные бейджи скоупа — они показывают, кому он доступен.
| Скоуп | Кто это | Где работает |
|---|---|---|
| Public | Любой клиент без токена | /api/v1/auth/*, /api/v1/public/* |
| Tenant | Любой авторизованный участник школы | Чтение в /api/v1/t/* |
| Admin | Администратор школы | Управление в /api/v1/t/* |
| Curator | Куратор — в пределах своих учеников и прав | Управление в /api/v1/t/* при наличии права |
| Student | Ученик | Прохождение курсов, тестов, заданий |
| Superadmin | Оператор платформы | /api/v1/admin/* (над всеми школами) |
Роли
- superadmin — оператор платформы.
tenant_idотсутствует. Создаёт школы, управляет тарифами и биллингом. - admin — администратор школы. Полный доступ ко всем данным своей школы; обходит все проверки прав куратора.
- curator — преподаватель/куратор. Доступ выдаётся точечными правами (см. ниже) и ограничен его учениками.
- student — ученик. Записывается на курсы, проходит тесты и задания, видит свой рейтинг.
Права куратора
Куратор по умолчанию ничего не может изменять. Администратор выдаёт ему права через PUT /t/users/:id/permissions. В справочнике эндпоинт с требуемым правом помечен бейджем право: ….
| Право | Что разрешает |
|---|---|
manage_courses | Создание и редактирование курсов, модулей, уроков, тестов, заданий, траекторий |
manage_students | Управление учениками, списки записей, проверка и оценивание работ |
can_manage_groups | Создание групп и управление их составом |
manage_exams | Создание и публикация экзаменов (ЕНТ) |
view_analytics | Просмотр аналитики и попыток прохождения тестов |
Ограничение по ученикам (curator scope)
Куратор без расширенных прав видит только своих учеников — тех, кто записан на его курсы или входит в его группы. Списки автоматически фильтруются, а доступ к чужому ученику отдаёт 404. Администратор видит всех.Кэш прав
Права куратора кэшируются на сервере ~60 секунд. После изменения прав новые ограничения вступают в силу в течение минуты.