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

Шаблоны задачных активностей

Зачем нужно​

activity_template нужен для сценариев, где простой подборки задач недостаточно. Занятие, домашняя работа, тренажёр, диагностика, разбор олимпиады или олимпиадный тур имеют структуру: блоки, роли задач, рекомендуемое время, инструкции ученику, teacher notes и visibility policies.

Что является activity template​

Примеры:

  • занятие кружка;
  • урок курса как content design;
  • домашнее задание;
  • тренажёр;
  • диагностика;
  • олимпиадный тур как дизайн задач;
  • разбор олимпиады;
  • самостоятельная работа;
  • интенсивное занятие.

Что не является activity template​

Activity template не содержит:

  • LMS group;
  • roster;
  • schedule;
  • attendance;
  • homework assignment как факт выдачи;
  • student attempts;
  • progress;
  • competition registration, submission или result.

Эти данные принадлежат LMS или competitions.

Структура​

activity_template состоит из:

  • metadata: subject, title, age group, difficulty, objective, duration;
  • sections: warmup, theory bridge, main, practice, homework, challenge, reserve, reflection, diagnostic;
  • items: problem versions или references с version policy;
  • roles: main, warmup, reserve, homework, challenge, diagnostic, example;
  • teacher notes;
  • student instructions;
  • recommended scoring and time;
  • solution and hint visibility policies.

Versioning​

  • Draft/review template можно редактировать.
  • Published template immutable или получает новую version при изменении.
  • Изменение списка задач, порядка, roles, scoring, teacher notes или visibility policy создаёт новую version.
  • Внешний домен не должен использовать mutable draft.

Export​

Для использования во внешнем домене создаётся content_export_snapshot.

Типовые target flows:

TargetЧто получаетЧем владеет target
LMS lesson/homework/trainerlocked activity snapshotlesson/training instance, roster, attempts, progress
competitions tourlocked competition activity snapshottour, submissions, official results
storefront public catalogpublic-safe projection onlyrendering and SEO delivery
management diagnosticdiagnostic content snapshotdiagnostic lifecycle and conclusions

Инварианты​

  • Activity template не меняет саму problem.
  • Item role внутри активности не меняет canonical problem metadata.
  • Answer keys, hidden solutions, rubrics и teacher notes попадают в snapshot только по target scope and visibility.
  • Один шаблон может использоваться много раз, но каждое внешнее использование должно быть воспроизводимо через snapshot.

Готовность​

  • можно создать activity template с sections и problem items;
  • можно задать roles, scoring, comments и policies;
  • можно опубликовать immutable version;
  • можно экспортировать locked snapshot в LMS или competitions;
  • изменение template не меняет уже выданные занятия, домашки, тренажёры или туры.