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

Рабочая тетрадь

Зачем нужно

Рабочая тетрадь нужна как персональное учебное пространство ученика внутри курса, модуля или занятия.

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

  • ученик;
  • родитель;
  • внутренний преподаватель;
  • методист.

Сценарии

  • открыть тетрадь из урока;
  • сохранить черновик;
  • приложить файл;
  • отправить работу преподавателю;
  • получить комментарий;
  • посмотреть историю правок;
  • распечатать или экспортировать материал, если это разрешено.

Данные

  • workbook;
  • workbook page;
  • draft;
  • submission;
  • teacher comment;
  • attachment;
  • revision.

Правила

  • Рабочая тетрадь не является каноническим банком заданий.
  • Тетрадь принадлежит конкретному ученику и учебному контексту.
  • Черновики и отправленные версии должны различаться.
  • Комментарии преподавателя сохраняют автора, дату и связь с версией работы.

API

Канонические операции описаны в ../api-map.md: GET /workbooks, GET /workbooks/{workbookId}, GET/POST /workbooks/{workbookId}/revisions, POST /workbooks/{workbookId}/submit, POST /workbooks/{workbookId}/comments и POST /workbooks/{workbookId}/attachments.

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

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

Интерфейс

  • список страниц;
  • редактор ответа;
  • autosave;
  • статус отправки;
  • комментарии преподавателя;
  • история версий;
  • режим просмотра для родителя.

Интеграции

  • lessons — связь с уроком;
  • task-bank — исходные задания;
  • teacher tools — проверка и комментарии;
  • progress — влияние на прохождение;
  • storage — вложения.

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

Доступ к тетради имеют только ученик, связанные родители, назначенные преподаватели и роли поддержки с аудитом.

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

  • потеря соединения при сохранении;
  • преподаватель комментирует устаревшую версию;
  • вложение удалено или недоступно;
  • ученик сменил группу;
  • родитель потерял семейную связь.

Готовность

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