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

Администрирование банка заданий

Зачем нужно​

Администрирование банка заданий нужно для создания, редактирования, версионирования и публикации канонических задач.

Кто использует​

  • автор задачи;
  • методист;
  • редактор;
  • администратор банка заданий;
  • reviewer.

Сценарии​

  • создать задачу;
  • отредактировать условие;
  • задать таксономию;
  • добавить ответы и решения;
  • создать новую версию;
  • отправить на проверку;
  • опубликовать;
  • импортировать из старого источника;
  • модерировать связи задач;
  • управлять public publication profiles;
  • публиковать activity/program templates;
  • создавать export snapshots;
  • посмотреть аудит изменений.

Данные​

  • task;
  • task version;
  • taxonomy;
  • answer key;
  • solution;
  • publication status;
  • public publication profile;
  • problem relations;
  • activity template;
  • program template;
  • content export snapshot;
  • import source;
  • audit event.

Правила​

  • Каноническая задача хранится только в task-bank.
  • Опубликованная задача не меняется без новой версии или фиксируемой правки.
  • Таксономия должна быть обязательной для задач, которые используются в LMS или олимпиадах.
  • Импортированные задачи должны сохранять источник и трассировку.
  • Published templates and locked snapshots immutable.
  • Trust/XP Миролимпа является task-bank governance signal, а не identity role.
  • Organization/team access проверяется через identity references and grants.

API​

Канонические операции описаны в ../api-map.md: GET/POST /problems, GET/PATCH /problems/{problemId}, GET/POST /problems/{problemId}/versions, POST /problem-versions/{versionId}/publish, POST /imports, GET /imports/{jobId}, GET /audit-logs, POST /exports и GET/PATCH /settings.

Серверная часть​

Серверная часть хранит задачи, версии, статусы, таксономию, ответы, решения, импортные идентификаторы и аудит изменений.

Интерфейс​

  • список задач;
  • редактор условия;
  • форма таксономии;
  • управление версиями;
  • редактор activity templates;
  • редактор program templates;
  • relation graph moderation;
  • public catalog preview;
  • export snapshot screen;
  • предпросмотр;
  • модерация и публикация;
  • журнал изменений.

Интеграции​

  • LMS — использование задач в уроках;
  • competitions — задания туров;
  • storefront — публичный каталог;
  • management (diagnostics/trainers) — тренировочные сценарии;
  • storage — изображения и вложения;
  • analytics — качество задач и попытки.

Безопасность​

Редактирование задач, ответов и решений доступно только ролям с соответствующими правами. Закрытые задачи и ответы не раскрываются публичным потребителям.

Нестандартные случаи​

  • задача используется в активном туре;
  • activity template уже экспортирован в LMS;
  • locked snapshot требует исправления;
  • импортный источник содержит дубль;
  • опубликованная задача требует срочного исправления;
  • ответ изменился для одной версии;
  • автор потерял доступ.

Готовность​

  • задачу можно создать, проверить и опубликовать;
  • версии не теряют связь с оригиналом;
  • ответы и решения управляются;
  • импорт трассируется;
  • exports and snapshots трассируются;
  • trust/XP не смешивается с identity membership;
  • изменения аудируются.