Как пользоваться pipeline

Локальная HTML-версия документа.

# Как пользоваться

Ниже короткая инструкция не для разработчика, а для учителя или ведущего практики.

## Что умеет система

Система помогает пройти весь цикл:

1. задать тему контрольной;
2. сгенерировать задания;
3. собрать ответы учеников;
4. получить первичную проверку;
5. посмотреть результаты и рекомендации;
6. при необходимости доработать и отправить итоги ученикам.

## Базовый сценарий работы

### Шаг 1. Учитель запускает контрольную

Учитель открывает учительскую форму и указывает:

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

После этого `n8n` создаёт:

- контрольную работу;
- ключи ответов;
- заготовку для сбора ответов учеников.

## Шаг 2. Ученики получают форму для ответов

Ученики открывают форму и отвечают на задания.

В первой версии лучше использовать:

- короткие структурированные ответы;
- по одному полю на каждое задание.

Это делает проверку надёжнее.

## Шаг 3. Автопроверка

После сдачи ответов `n8n`:

- сопоставляет ученика и вариант;
- подставляет нужный ключ;
- делает первичную проверку;
- считает баллы;
- формирует краткие рекомендации.

## Шаг 4. Учитель смотрит результаты

Учитель получает:

- результаты по каждому ученику;
- общую сводку по классу;
- список типичных ошибок;
- рекомендации, что повторить.

## Шаг 5. Учитель при необходимости правит результаты

Это важный шаг.

Автопроверка должна использоваться как:

- черновик проверки;
- экономия времени;
- быстрый первичный разбор.

Но финальное педагогическое решение остаётся у учителя.

## Шаг 6. Отправка результатов ученикам

После проверки учитель может:

- отправить результаты вручную;
- или использовать отдельный workflow для выдачи сообщений ученикам.

## Какой режим лучше для первого запуска

Для первого рабочего сценария лучше так:

1. один общий класс;
2. 5-6 заданий;
3. смешанный формат:
   - тестовые;
   - короткие;
   - один короткий развёрнутый ответ;
4. форма для учителя;
5. форма для учеников;
6. пакетная проверка.

## Что пока не стоит делать

В первой версии лучше не усложнять:

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

## Что будет следующим логичным шагом

После MVP имеет смысл добавить:

1. пакетную проверку 25 учеников;
2. сводную статистику по классу;
3. персональные рекомендации;
4. при необходимости выдачу через бота.