Приложение для тестирования сотрудников клиники методом один вопрос - до пяти ответов один из которых правильный. Сотрудник должен выбрать правильный вариант ответа

4.1 KiB

Raw Blame History

ШАГ 007 — Спринт 2: Прохождение теста + результат

Дата: 2026-03-21 Контекст: Мастер-класс по разработке системы тестирования сотрудников клиники.

Запрос

запускай реализацию спринта 2

Ответ

Реализован Спринт 2: прохождение теста с таймером и навигацией, результат с разбором ошибок.

Новые файлы

backend/app/models/attempt.py       ← TestAttempt, AttemptAnswer
backend/app/schemas/attempt.py      ← схемы для старта, сдачи и результата
backend/app/api/attempts.py         ← 3 эндпоинта
backend/alembic/versions/002_attempts.py  ← миграция

frontend/src/api/attempts.ts        ← типы и запросы
frontend/src/pages/TestTake/        ← страница прохождения теста
frontend/src/pages/AttemptResult/   ← страница результата

API эндпоинты (новые)

Метод	URL	Описание
POST	`/api/attempts`	Начать попытку → возвращает вопросы перемешанные, без правильных ответов
POST	`/api/attempts/{id}/submit`	Сдать тест → подсчитать и вернуть результат
GET	`/api/attempts/{id}/result`	Получить результат сохранённой попытки

Схема БД (добавлено)

test_attempts
  id, test_id → tests.id, started_at, finished_at,
  score, passed, correct_count, total_count, status

attempt_answers
  id, attempt_id → test_attempts.id,
  question_id → questions.id, answer_id → answers.id

Одна строка attempt_answers = один выбранный вариант ответа. Для вопросов с несколькими правильными ответами — несколько строк.

Логика прохождения теста

Старт попытки:

Создаётся запись TestAttempt со статусом in_progress
Вопросы и ответы внутри каждого вопроса перемешиваются случайно
Поле is_correct не передаётся на фронт — нельзя смошенничать через DevTools
Поле is_multiple: bool говорит фронту: показывать радио-кнопки или чекбоксы

Сдача теста:

Фронт отправляет [{ question_id, answer_ids[] }] для каждого вопроса
Вопрос засчитывается правильным только если selected_ids == correct_ids (точное совпадение)
Балл = (правильных / всего) × 100
Зачёт: балл ≥ порогу из теста

Разбор ошибок:

Для каждого вопроса: is_answered_correctly
Для каждого варианта: is_correct + is_selected → фронт показывает что выбрал и что было правильно

UX прохождения теста

Вопросы по одному, прогресс-бар сверху
Таймер: если задан — обратный отсчёт, при < 60 сек — предупреждение, при 0 — автосабмит
Кнопка «Назад» заблокирована если allow_navigation_back = false
Чекбоксы для is_multiple, радио-кнопки для одиночного ответа

Следующие шаги

Спринт 1: Инфраструктура + Создание тестов
Спринт 2: Прохождение теста + результат
Спринт 3: Трекер результатов
Спринт 4: Авторизация и роли
Спринт 5: Уведомления в MAX

4.1 KiB Raw Blame History