docs: update ТЗ to v1.2 and README with new sprint plan

ТЗ v1.2: - Versioning logic: 'after first attempt' instead of 'after assignment' - Added section 4.7 AI assistant (DeepSeek) - Removed 'auto question generation' from out-of-scope README: - Sprint table updated: 7 sprints, statuses, Sprint 4 = AI/DeepSeek - Added AI and MAX to stack table Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
docs: insert Sprint 4 LLM/DeepSeek, shift tracker to Sprint 5, auth to Sprint 6
2026-03-21 14:08:50 +05:00 · 2026-03-21 14:05:56 +05:00 · 2026-03-21 14:00:55 +05:00 · 2026-03-21 13:56:55 +05:00 · 2026-03-21 13:54:00 +05:00 · 2026-03-21 13:52:16 +05:00
57 changed files with 4041 additions and 0 deletions
@@ -0,0 +1,2 @@
 # База данных
 DATABASE_URL=postgresql+asyncpg://qa_user:qa_password@db:5432/qa_test
@@ -0,0 +1,223 @@
 # План спринтов
 **Дата:** 2026-03-21
 **Статус:** Согласовано
 ---
 ## Принцип
 Каждый спринт — это готовое работающее приложение (frontend + backend), которое можно запустить локально командой `docker compose up` и протестировать вручную в браузере.
 ---
 ## Спринт 1 — Инфраструктура + Создание тестов ✅
 **Результат:** Поднят весь стек, можно зайти на страницу и создать тест.
 **Статус:** Завершён и протестирован вручную в браузере.
 ### Инфраструктура
 - [x] Структура репозитория: `backend/`, `frontend/`, `nginx/`, `docker-compose.yml`
 - [x] `docker-compose.yml`: сервисы `db`, `backend`, `frontend`, `nginx`
 - [x] PostgreSQL: контейнер, volume для данных
 - [x] FastAPI: контейнер, `GET /api/health` → `{"status": "ok"}`
 - [x] Alembic: инициализирован, первая миграция (`001_init`)
 - [x] React + Vite: контейнер, базовая страница открывается в браузере
 - [x] Nginx: `/` → React SPA, `/api/` → FastAPI
 ### Создание тестов (без авторизации)
 - [x] Модели БД: `Test`, `Question`, `Answer`
 - [x] API: `POST /api/tests` — создать тест с вопросами и ответами
 - [x] API: `GET /api/tests` — список тестов
 - [x] API: `GET /api/tests/{id}` — детали теста
 - [x] Фронт: страница создания теста (название, вопросы, варианты, настройки)
 - [x] Фронт: список тестов
 - [x] Фронт: страница просмотра теста
 **Настройки теста:** порог зачёта (%), таймер (опционально), разрешить возврат к предыдущему вопросу
 ### Баги, найденные и исправленные при тестировании
 - [x] `permission denied` на `entrypoint.sh` — volume mount перекрывал `chmod +x` из Dockerfile → исправлено: `CMD ["bash", "entrypoint.sh"]`
 - [x] `No module named 'app'` в Alembic — Python не видел `/app` → исправлено: `ENV PYTHONPATH=/app` в Dockerfile
 - [x] `host not found in upstream "backend"` в nginx — nginx резолвил хост при старте, до поднятия backend → исправлено: Docker DNS resolver + `set $backend`
 - [x] `http://localhost/api/docs` → 404 — FastAPI отдавал docs по `/docs`, а не `/api/docs` → исправлено: явные `docs_url`, `redoc_url`, `openapi_url` в FastAPI
 ---
 ## Спринт 2 — Прохождение теста ✅
 **Результат:** Можно выбрать тест из списка и пройти его, увидеть результат и разбор ошибок.
 **Статус:** Завершён и протестирован вручную в браузере.
 - [x] Модели БД: `TestAttempt`, `AttemptAnswer`
 - [x] API: `POST /api/attempts` — начать попытку (фиксируем время начала)
 - [x] API: `POST /api/attempts/{id}/submit` — завершить попытку, подсчитать результат
 - [x] API: `GET /api/attempts/{id}/result` — результат с разбором ошибок
 - [x] Фронт: страница прохождения теста
  - Случайный порядок вопросов
  - Таймер с обратным отсчётом (если задан) — автосабмит по истечении
  - Навигация назад (если разрешена настройкой теста)
 - [x] Фронт: страница результата
  - Балл и процент
  - Сдал / Не сдал (относительно порога)
  - Разбор ошибок: вопрос, ответ сотрудника, правильный ответ
 - [x] Фронт: кнопка «Пройти тест» прямо в строке таблицы списка тестов
 ### Доработки после тестирования
 - [x] Страница теста разделена на два вида:
  - `/tests/:id` — вид сотрудника: вопросы и варианты ответов без отметок правильных
  - `/tests/:id/edit` — вид автора: правильные ответы отмечены, жёлтый баннер, кнопка «Редактировать» (задизаблена до Спринта 4)
 - [x] Список тестов: три кнопки действий заменены на выпадающее меню «⋯» — колонка с названием стала полноширинной
 ### Баги, найденные и исправленные при тестировании
 - [x] «Не удалось загрузить тест» × 2 при нажатии «Пройти тест» — миграция `002_attempts` не применилась, т.к. `--reload` перезапускает только код приложения, но не `entrypoint.sh` → исправлено: `docker compose restart backend`
 ---
 ## Спринт 3 — Редактирование теста + версионность ✅
 **Результат:** Тест можно редактировать. Если тест уже проходили — создаётся новая версия, старая сохраняется для истории.
 **Статус:** Завершён и протестирован вручную в браузере.
 ### Backend
 - [x] Миграция `003`: добавить поле `parent_id` в таблицу `tests`
 - [x] `PUT /api/tests/{id}` — редактировать тест:
  - Нет попыток → обновить на месте
  - Есть попытки → создать новый тест (`version + 1`, `parent_id = id`), вернуть `{test, is_new_version: true}`
 - [x] `GET /api/tests` — показывать только активные версии (`is_active = True`)
 - [x] `GET /api/tests/{id}/versions` — цепочка всех версий теста
 - [x] `POST /api/tests/{id}/activate` — сделать версию активной (деактивирует остальные в цепочке)
 ### Frontend
 - [x] Страница `/tests/:id/edit` разделена на режим просмотра и режим редактирования
 - [x] Форма редактирования с предзаполненными данными (общий компонент `TestForm`)
 - [x] При сохранении с новой версией — редирект + уведомление «Создана новая версия v2»
 - [x] Кнопка «← К просмотру теста» в форме редактирования
 - [x] Секция «История версий»: таблица с версиями, статусом, датой, кнопкой «Сделать активной»
 - [x] Активная версия — единственная видимая в списке тестов
 ### Баги, найденные и исправленные при тестировании
 - [x] `ForeignKeyViolationError` при сохранении — bulk `DELETE questions` не каскадирует на `answers` → исправлено: сначала удаляем `answers`, потом `questions`
 - [x] Обе версии показывались «Активными» при создании до введения логики деактивации → исправлено: кнопка «Сделать активной» в шапке и в строке таблицы
 ---
 ## Спринт 4 — AI-помощник (DeepSeek)
 **Результат:** При создании и редактировании теста доступен AI-ассистент на базе DeepSeek. Ключ API настраивается через страницу настроек.
 ### Страница настроек (`/settings`)
 - [ ] Модель БД: `Setting` (key-value, ключ `deepseek_api_key`)
 - [ ] Миграция `004`
 - [ ] API: `GET /api/settings/{key}`, `PUT /api/settings/{key}`
 - [ ] API: `POST /api/llm/check` — проверить подключение (тестовый запрос к DeepSeek)
 - [ ] Фронт: страница `/settings` — поле для ввода ключа + кнопка «Проверить подключение»
 ### AI-функции в форме создания/редактирования теста
 - [ ] API: `POST /api/llm/generate` — сгенерировать вопросы и ответы по теме
 - [ ] API: `POST /api/llm/improve` — улучшить формулировку вопроса
 - [ ] API: `POST /api/llm/distractors` — добавить варианты-дистракторы к вопросу
 - [ ] API: `POST /api/llm/review` — проверить качество всего теста
 ### Интеграция в UI
 - [ ] Кнопка «Сгенерировать с AI» на странице создания теста — вводишь тему, получаешь готовый набор вопросов
 - [ ] Кнопка «✨» рядом с каждым вопросом — улучшить формулировку
 - [ ] Кнопка «+ Дистракторы» рядом с каждым вопросом — дополнить неправильные варианты
 - [ ] Кнопка «Проверить тест» — AI анализирует весь тест и выдаёт рекомендации
 - [ ] Ссылка на страницу `/settings` в шапке приложения
 ### Технические детали
 - DeepSeek API совместим с форматом OpenAI — используем библиотеку `openai` с `base_url=https://api.deepseek.com`
 - Модель: `deepseek-chat`
 - Ключ хранится в таблице `settings`, передаётся из бэкенда — фронт ключ не видит
 ---
 ## Спринт 5 — Трекер результатов
 **Результат:** Таблица всех попыток прохождения тестов.
 - [ ] API: `GET /api/attempts` — все попытки (с фильтрами по тесту, дате)
 - [ ] Фронт: страница трекера
  - Таблица: тест, версия, дата начала, дата завершения, результат, зачёт
  - Фильтрация по тесту и дате
  - Пагинация
 ---
 ## Спринт 6 — Авторизация и управление пользователями
 **Результат:** Вход по логину/паролю, роли ограничивают доступ. Можно создавать сотрудников и подразделения.
 ### Авторизация
 - [ ] Модели БД: `User`, `Department`
 - [ ] API: `POST /api/auth/login` → JWT access token
 - [ ] API: `POST /api/auth/logout`
 - [ ] API: `GET /api/auth/me`
 - [ ] Middleware: проверка JWT на защищённых эндпоинтах
 - [ ] Фронт: страница входа
 - [ ] Фронт: защищённые роуты (редирект на логин если нет токена)
 ### Роли и права
 | Роль | Тесты | Трекер |
 |------|-------|--------|
 | HR-менеджер / Директор | Создаёт и редактирует все тесты | Вся клиника |
 | Руководитель подразделения | Создаёт и редактирует свои тесты | Только свой отдел |
 | Сотрудник | Проходит назначенные тесты | Только свои результаты |
 ### Управление пользователями
 - [ ] API: CRUD подразделений
 - [ ] API: CRUD пользователей (создание, редактирование, деактивация)
 - [ ] Фронт: страница управления подразделениями (HR)
 - [ ] Фронт: страница управления сотрудниками (HR / руководитель)
 ### Назначение тестов
 - [ ] Модели БД: `TestAssignment`
 - [ ] API: `POST /api/assignments` — назначить тест (получатели, дедлайн, кол-во попыток)
 - [ ] Фронт: форма назначения теста
 - [ ] Фронт: дашборд сотрудника — список назначенных тестов со статусами (`Не начат`, `В процессе`, `Завершён`, `Просрочен`)
 ---
 ## Спринт 7 — Уведомления в MAX
 **Результат:** Сотрудники получают уведомления в мессенджер MAX.
 - [ ] Изучить документацию MAX API
 - [ ] Реализовать сервис уведомлений в backend
 - [ ] Уведомление при назначении теста сотруднику
 - [ ] Уведомление за N дней до дедлайна (настраивается)
 - [ ] Поле `max_user_id` в профиле пользователя
 - [ ] Фронт: в профиле пользователя — поле для MAX ID
 ---
 ## Структура репозитория (целевая после Спринта 1)
 ```
 qa_test_app/
 ├── backend/
 │   ├── app/
 │   │   ├── api/          ← роутеры FastAPI
 │   │   ├── models/       ← SQLAlchemy модели
 │   │   ├── schemas/      ← Pydantic схемы
 │   │   ├── services/     ← бизнес-логика
 │   │   └── main.py
 │   ├── alembic/
 │   ├── Dockerfile
 │   └── requirements.txt
 ├── frontend/
 │   ├── src/
 │   │   ├── api/          ← Axios + TanStack Query
 │   │   ├── components/   ← переиспользуемые компоненты
 │   │   ├── pages/        ← страницы
 │   │   └── main.tsx
 │   ├── Dockerfile
 │   └── package.json
 ├── nginx/
 │   └── nginx.conf
 ├── docker-compose.yml
 └── DOC/
 ```
@@ -0,0 +1,121 @@
 # Технологический стек
 **Дата:** 2026-03-21
 **Статус:** Согласовано
 ---
 ## Архитектура
 ```
 ┌─────────────────────────────────────────────┐
 │                   Nginx                     │
 │  /         → React SPA (статика)            │
 │  /api/     → FastAPI backend                │
 └────────────────────┬────────────────────────┘
                     │ Docker network
          ┌──────────┴──────────┐
          │                     │
    ┌─────▼──────┐       ┌──────▼─────┐
    │  FastAPI   │       │  React SPA │
    │  (backend) │       │  (frontend)│
    └─────┬──────┘       └────────────┘
          │
    ┌─────▼──────┐
    │ PostgreSQL │
    └────────────┘
 ```
 ---
 ## Backend
 | Компонент | Технология | Версия |
 |-----------|-----------|--------|
 | Язык | Python | 3.12+ |
 | Фреймворк | FastAPI | 0.115+ |
 | ORM | SQLAlchemy (async) | 2.0+ |
 | Миграции | Alembic | latest |
 | База данных | PostgreSQL | 16+ |
 | Валидация | Pydantic v2 | 2.x |
 | Аутентификация | JWT (python-jose) | latest |
 | Хэширование паролей | passlib + bcrypt | latest |
 | ASGI-сервер | Uvicorn | latest |
 ### Почему FastAPI
 - Автоматическая генерация OpenAPI/Swagger документации — джуниор сразу видит API
 - Async из коробки — правильные привычки с первого проекта
 - Pydantic-схемы = валидация + сериализация в одном месте
 - Активное сообщество, отличная документация на русском
 ---
 ## Frontend
 | Компонент | Технология | Версия |
 |-----------|-----------|--------|
 | Фреймворк | React | 18+ |
 | Язык | TypeScript | 5.x |
 | Сборщик | Vite | 5.x |
 | UI-библиотека | Ant Design (antd) | 5.x |
 | Роутинг | React Router | v6 |
 | Серверный стейт | TanStack Query (React Query) | v5 |
 | HTTP-клиент | Axios | latest |
 ### Почему Ant Design
 - Готовые компоненты: таблицы, формы, прогрессбары, таймеры — сэкономит спринты
 - Хорошо подходит для административных интерфейсов
 - Поддержка русской локализации
 ### Почему TanStack Query
 - Учит джуниора правильной работе с серверным состоянием
 - Кэширование, loading/error состояния, инвалидация — всё из коробки
 - Убирает необходимость в Redux для большинства задач
 ---
 ## Инфраструктура
 | Компонент | Технология |
 |-----------|-----------|
 | Контейнеризация | Docker + Docker Compose |
 | Реверс-прокси | Nginx |
 | ОС сервера | Linux (Ubuntu/Debian) |
 ### Структура Docker Compose
 ```yaml
 services:
  db:        # PostgreSQL
  backend:   # FastAPI + Uvicorn
  frontend:  # React (build) / Vite dev server
  nginx:     # Reverse proxy
 ```
 ---
 ## Инструменты разработки
 | Назначение | Инструмент |
 |-----------|-----------|
 | Линтер Python | Ruff |
 | Форматтер Python | Black |
 | Линтер/форматтер JS | ESLint + Prettier |
 | API-тестирование | Swagger UI (встроен в FastAPI) |
 ---
 ## Уведомления (последний спринт)
 - Канал: мессенджер **MAX**
 - Реализация: отдельный сервис/модуль в backend
 - Интеграция: MAX API (изучить документацию перед спринтом)
 ---
 ## Вне scope (не используем)
 - Redis / очереди задач (Celery) — не нужны для данного масштаба
 - GraphQL — REST достаточно
 - Kubernetes — Docker Compose достаточно для 50–200 пользователей
 - SSR (Next.js) — не нужен, SPA достаточно
@@ -0,0 +1,163 @@
 # Техническое задание
 ## Система тестирования сотрудников клиники
 **Версия:** 1.2
 **Дата:** 2026-03-21
 **Статус:** Согласовано
 ---
 ## 1. Назначение системы
 Веб-приложение для проведения внутреннего тестирования сотрудников клиники. Руководители подразделений и HR-менеджер создают тесты и назначают их сотрудникам. Сотрудники проходят тесты в браузере. Система фиксирует все попытки и результаты.
 ---
 ## 2. Роли и права доступа
 | Роль | Кто | Создаёт тесты | Назначает тесты | Видит результаты |
 |------|-----|:---:|:---:|:---:|
 | **HR-менеджер** | Руководитель службы HR, Директор клиники | ✅ | Всем сотрудникам клиники | Всех сотрудников |
 | **Руководитель подразделения** | Главный врач, рук. службы администраторов и др. | ✅ | Только своему подразделению | Только своего подразделения |
 | **Сотрудник** | Все остальные работники | ❌ | ❌ | Только свои |
 ---
 ## 3. Авторизация
 - Вход по логину и паролю
 - Учётные записи создаются администратором системы вручную
 - Сессия хранится на сервере (cookie-based или JWT — определить при выборе стека)
 - Пароль хранится в зашифрованном виде (bcrypt или аналог)
 ---
 ## 4. Функциональные требования
 ### 4.1. Управление пользователями и подразделениями
 - Создание/редактирование/деактивация учётных записей сотрудников
 - Каждый сотрудник принадлежит одному подразделению
 - Создание/редактирование справочника подразделений
 - Назначение роли сотруднику: HR-менеджер / Руководитель подразделения / Сотрудник
 ### 4.2. Создание и редактирование тестов
 **Тест содержит:**
 - Название теста
 - Описание (опционально)
 - Список вопросов (минимум 7)
 - Порог зачёта — минимальный % правильных ответов (задаётся автором)
 - Таймер прохождения — лимит в минутах (опционально)
 **Вопрос содержит:**
 - Текст вопроса
 - Минимум 3 варианта ответа
 - Один или несколько правильных ответов (чекбокс или радио-кнопка в зависимости от типа)
 **Настройки теста (задаются автором при создании):**
 - Разрешить возврат к предыдущему вопросу: да / нет
 **Правила работы с тестом:**
 - Автор может редактировать тест пока никто его не проходил
 - Если тест уже проходили — создаётся новая версия (`version + 1`), старая сохраняется
 - Все версии теста хранятся; результаты привязаны к конкретной версии
 - Активная версия — та, которую видят сотрудники; автор может вручную переключить активную версию
 - Тест можно деактивировать (скрыть из списка, не удалять)
 ### 4.3. Назначение теста
 При назначении задаются:
 - Список получателей (отдел или конкретные сотрудники)
 - Срок сдачи — дата дедлайна (задаётся в днях от даты назначения или конкретной датой)
 - Допустимое количество попыток (1 или более — задаётся при назначении)
 HR-менеджер может назначить тест сотрудникам любых подразделений.
 Руководитель подразделения — только сотрудникам своего подразделения.
 ### 4.4. Прохождение теста (интерфейс сотрудника)
 - На главной странице сотрудник видит список назначенных ему тестов со статусами:
  - `Не начат` — ещё не открывал
  - `В процессе` — начал, не завершил (если таймер — отсчёт продолжается)
  - `Завершён` — сдал/не сдал
  - `Просрочен` — дедлайн прошёл, не сдан
 - Если задан таймер — отображается обратный отсчёт, по истечении тест завершается автоматически
 - Порядок вопросов **случайный** при каждом прохождении
 - Возможность вернуться к предыдущему вопросу — определяется настройкой теста
 ### 4.5. Результаты после завершения теста
 Сотрудник сразу после сдачи видит:
 - Итоговый балл и процент правильных ответов
 - Факт зачёта: **сдал / не сдал** (относительно порога)
 - Разбор ошибок: по каждому вопросу — его ответ и правильный ответ
 ### 4.6. Трекер попыток
 Система фиксирует каждую попытку прохождения теста:
 | Поле | Описание |
 |------|----------|
 | Сотрудник | ФИО, подразделение |
 | Тест | Название |
 | Попытка № | Порядковый номер попытки |
 | Начало | Дата и время начала |
 | Завершение | Дата и время окончания |
 | Результат | Количество правильных ответов / всего, % |
 | Зачёт | Да / Нет (преодолён ли порог) |
 Руководитель видит трекер по своему подразделению.
 HR-менеджер видит трекер по всей клинике.
 Сотрудник видит только свои попытки.
 ### 4.7. AI-помощник при создании и редактировании тестов
 Интеграция с LLM (DeepSeek) доступна авторам тестов в форме создания и редактирования.
 **Функции AI-помощника:**
 | Функция | Описание |
 |---------|----------|
 | Генерация теста | Автор вводит тему — AI генерирует готовый набор вопросов с вариантами ответов |
 | Улучшение формулировки | AI переформулирует выбранный вопрос более чётко и однозначно |
 | Добавление дистракторов | AI генерирует правдоподобные неправильные варианты ответов к вопросу |
 | Проверка качества | AI анализирует весь тест и выдаёт рекомендации по улучшению |
 **Настройки:**
 - API-ключ DeepSeek вводится на странице `/settings` и хранится в базе данных
 - Страница настроек содержит кнопку «Проверить подключение» — выполняет тестовый запрос к API
 - Ключ хранится только на бэкенде и не передаётся на фронтенд
 ---
 ## 5. Нефункциональные требования
 | Параметр | Требование |
 |----------|-----------|
 | Количество пользователей | 50–200 человек |
 | Платформа | Веб-приложение, браузер (desktop-first) |
 | Доступность | Внутренняя сеть клиники |
 | Язык интерфейса | Русский |
 | Время отклика | < 2 секунды для основных операций |
 ---
 ## 6. Уведомления
 Уведомления реализуются в одном из последних спринтов.
 - Канал: мессенджер **MAX**
 - События для уведомления:
  - Сотруднику назначен новый тест
  - Приближается дедлайн сдачи теста
 - Интеграция с MAX API — отдельная задача спринта
 ---
 ## 7. Вне scope (не реализуем в данной версии)
 - Интеграция с AD/LDAP
 - Мобильное приложение
 - Вопросы с вложениями (изображения, видео)
 - Экспорт отчётов в Excel / PDF
@@ -0,0 +1,80 @@
 # ШАГ 002 — Создание технического задания
 **Дата:** 2026-03-21
 **Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.
 ---
 ## Запрос
 > переходим к следующему шагу: создание тз
 В ходе диалога уточнены требования:
 **О ролях:**
 > разделение по ролям у нас устроено так: есть руководители подразделений, к примеру руководитель службы администраторов, главный врач, руководитель службы администраторов. это те сотрудники, которые создают тесты. каждый тест это не менее 7 вопросов и не менее трёх вариантов ответов на вопрос, один или несколько из которых правильные. руководители подразделений назначают свои тесты сотрудникам своих подразделений, при этом у меня, как у директора клиники есть руководитель службы HR, который может создать и назначить тест сотрудникам сразу же всех подразделений.
 **О времени:**
 > обычно мы даём время в днях на прохождение теста. но я подумал, и решил, что некоторые из тестов надо настроить на время.
 **О результатах:**
 > (выбрано: свой балл/%, свои ошибки)
 > мы должны вести трекер всех попыток сдачи теста: какой сотрудник, какой тест, когда начал выполнение теста, когда закончил, с каким результатом. преодолел ли сотрудник заданный порог правильных ответов.
 ---
 ## Ответ
 ### Подход
 Перед написанием ТЗ проведён диалог с заказчиком (директором клиники) для уточнения требований по ролям, формату теста, ограничениям по времени и логике результатов.
 ТЗ сохранено в отдельный файл: `DOC/ТЗ.md`
 ### Ключевые решения, принятые в ТЗ
 **Роли:**
 - `HR-менеджер` — создаёт тесты и назначает их всем сотрудникам клиники
 - `Руководитель подразделения` — создаёт тесты и назначает только своему подразделению
 - `Сотрудник` — проходит назначенные тесты
 **Формат теста:**
 - Минимум 7 вопросов
 - Минимум 3 варианта ответа на вопрос
 - Один или несколько правильных ответов (смешанный тип)
 - Порог зачёта — задаётся в % при создании теста
 **Временны́е ограничения:**
 - Срок сдачи — дедлайн в днях (обязательно при назначении)
 - Таймер прохождения — лимит в минутах (опционально, настраивается в тесте)
 **После завершения теста сотрудник видит:**
 - Свой балл и процент
 - Зачёт / незачёт
 - Разбор ошибок (где ответил неверно и правильный ответ)
 **Трекер попыток фиксирует:**
 - Сотрудник, тест, № попытки
 - Время начала и завершения
 - Результат и факт зачёта
 ### Что создано
 - `DOC/ТЗ.md` — полное техническое задание
 ### Открытые вопросы (зафиксированы в ТЗ)
 Ряд деталей требует уточнения на следующих шагах:
 - Роль директора клиники
 - Редактирование теста после назначения
 - Случайный или фиксированный порядок вопросов
 - Возможность вернуться к предыдущему вопросу
 - Уведомления о назначении и дедлайне
 - Экспорт отчётов
 ### Следующие шаги
 - [x] Написать ТЗ
 - [ ] Обсудить и закрыть открытые вопросы из ТЗ
 - [ ] Выбрать технологический стек
 - [ ] Составить план спринтов
@@ -0,0 +1,85 @@
 # ШАГ 003 — Закрытие открытых вопросов ТЗ
 **Дата:** 2026-03-21
 **Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.
 ---
 ## Запрос
 > давай обсудим открытые вопросы сейчас
 ---
 ## Ответ
 Проведён диалог с заказчиком по всем 6 открытым вопросам из ТЗ. Все решения приняты и внесены в `DOC/ТЗ.md` (версия 1.1, статус: Согласовано).
 ---
 ## Принятые решения
 ### 1. Роль Директора клиники
 **Решение:** Директор получает права HR-менеджера — те же возможности, отдельная роль не нужна.
 В таблице ролей ТЗ:
 ```
 HR-менеджер | Руководитель службы HR, Директор клиники
 ```
 ---
 ### 2. Редактирование теста после назначения
 **Решение:** Создаётся новая версия теста.
 - Назначенный тест заморожен — изменить его нельзя
 - Для исправления создаётся новая версия
 - Все версии хранятся в системе
 - Результаты прохождений привязаны к конкретной версии теста
 Это важно для целостности данных: нельзя изменить вопросы уже после того, как кто-то прошёл тест.
 ---
 ### 3. Порядок вопросов
 **Решение:** Случайный при каждом прохождении.
 Это усложняет списывание — два сотрудника, проходящих тест одновременно, видят вопросы в разном порядке.
 ---
 ### 4. Возврат к предыдущему вопросу
 **Решение:** Настраивается автором теста при создании.
 Параметр добавлен в настройки теста: `Разрешить возврат к предыдущему вопросу: да / нет`.
 - Для строгих тестов (экзаменационный формат) — выключить
 - Для обучающих тестов — можно включить
 ---
 ### 5. Уведомления
 **Решение:** Нужны, канал — мессенджер **MAX**.
 - Уведомление о назначении нового теста
 - Уведомление о приближении дедлайна
 - **Реализуем в одном из последних спринтов** — интеграция с MAX API отдельная задача
 > **Для джуниора:** MAX — корпоративный мессенджер. Интеграция потребует изучения API MAX и реализации отдельного сервиса уведомлений.
 ---
 ### 6. Экспорт отчётов
 **Решение:** Не нужен в данной версии, вынесен за scope.
 ---
 ## Итог
 ТЗ обновлено до версии 1.1, статус изменён на **Согласовано**. Открытых вопросов не осталось.
 ### Следующие шаги
 - [x] Написать ТЗ
 - [x] Закрыть открытые вопросы ТЗ
 - [ ] Выбрать технологический стек
 - [ ] Составить план спринтов
@@ -0,0 +1,96 @@
 # ШАГ 004 — Выбор технологического стека
 **Дата:** 2026-03-21
 **Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.
 ---
 ## Запрос
 > да (переходим к обсуждению стека)
 Контекст:
 - Команда: джуниор-разработчики, знают Python
 - Архитектура: отдельный API + SPA
 - Деплой: Docker на своём сервере
 - Frontend фреймворк: React
 ---
 ## Ответ
 Стек зафиксирован в `DOC/СТЕК.md`.
 ---
 ## Принятые решения и обоснование
 ### Backend: FastAPI
 Почему не Django:
 - Django — монолитный фреймворк, заточен под SSR, его DRF (Django REST Framework) добавляет сложность
 - FastAPI чище для чистого API-сервиса, меньше магии, проще читать код
 Почему не Flask:
 - Flask слишком минималистичен, джуниор потратит время на сборку инфраструктуры вместо бизнес-логики
 - FastAPI даёт валидацию, документацию и типизацию из коробки
 ### База данных: PostgreSQL
 - SQLite не подходит для многопользовательского доступа (блокировки при записи)
 - PostgreSQL — проверенный выбор для продакшена, отличная поддержка в SQLAlchemy
 ### ORM: SQLAlchemy 2.0 (async)
 - Async-режим важен для FastAPI — приложение не блокируется на запросах к БД
 - Alembic для миграций — джуниор учится правильно управлять схемой БД
 ### Frontend: React 18 + TypeScript
 - React — самый востребованный фреймворк на рынке труда
 - TypeScript добавляет типизацию, ловит ошибки на этапе компиляции
 - Vite — современный и быстрый сборщик (замена устаревшего CRA)
 ### UI: Ant Design
 - Готовые компоненты таблиц, форм, модалок, таймеров — сэкономим 1-2 спринта
 - Хорошо подходит для admin-панелей и внутренних инструментов
 - Встроенная русская локализация
 ### Серверный стейт: TanStack Query
 Обучающий момент для джуниора:
 - Учит разделять серверное состояние (данные с API) и клиентское состояние (UI)
 - Без него джуниоры обычно пишут useEffect + useState везде — это антипаттерн
 - Автоматическое кэширование и перезапросы — меньше кода, больше надёжности
 ### Инфраструктура: Docker Compose + Nginx
 ```
 Nginx (80/443)
 ├── / → React SPA (статика из build)
 └── /api/ → FastAPI backend (uvicorn)
 Docker Compose сервисы:
 ├── db (PostgreSQL)
 ├── backend (FastAPI)
 ├── frontend (React build / Vite в dev)
 └── nginx
 ```
 - Один `docker compose up` запускает весь стек
 - Nginx в одном контейнере раздаёт фронтенд и проксирует запросы к API
 - Для 50–200 пользователей этой архитектуры полностью достаточно
 ---
 ## Итог
 Документ `DOC/СТЕК.md` содержит полное описание стека с версиями и обоснованиями.
 ### Следующие шаги
 - [x] Написать ТЗ
 - [x] Закрыть открытые вопросы ТЗ
 - [x] Выбрать технологический стек
 - [ ] Составить план спринтов
@@ -0,0 +1,45 @@
 # ШАГ 005 — План спринтов
 **Дата:** 2026-03-21
 **Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.
 ---
 ## Запрос
 > мое предложение такое: давай на первом спринте мы сможем создавать тесты. здесь не нужно никакой авторизации и ролей. главное зашел на страницу создания теста и смог его создать. следующий спринт — можем выполнять тест. следующий спринт — трекер результатов. затем аутентификация и управление пользователями и подразделениями. и потом уведомления
 > спринт 0 и спринт 1 соединяем
 ---
 ## Ответ
 ### Ключевое решение по порядку спринтов
 Заказчик выбрал подход **"ценность сначала"**: бизнес-логика (создание и прохождение тестов) реализуется в первых спринтах без авторизации. Это даёт несколько преимуществ:
 1. **Быстрая обратная связь** — уже после спринта 1 можно потрогать живой продукт
 2. **Мотивация для джуниоров** — видят результат, а не бойлерплейт
 3. **Проще отлаживать** — нет JWT, нет проверки прав, чистая бизнес-логика
 4. **Авторизация добавляется поверх** — в спринте 4 она "накладывается" на уже работающее приложение
 Это классический подход Lean/MVP: сначала рабочий продукт, потом безопасность и управление.
 ### Итоговый план
 | Спринт | Что делаем | Результат в браузере |
 |--------|-----------|---------------------|
 | **1** | Инфраструктура + Создание тестов | Создаём тест, видим список тестов |
 | **2** | Прохождение теста | Проходим тест, видим результат и ошибки |
 | **3** | Трекер результатов | Таблица всех попыток |
 | **4** | Авторизация + роли + подразделения + назначение | Вход по логину, разграничение доступа |
 | **5** | Уведомления в MAX | Получаем уведомления в мессенджер |
 ### Следующие шаги
 - [x] Написать ТЗ
 - [x] Закрыть открытые вопросы ТЗ
 - [x] Выбрать технологический стек
 - [x] Составить план спринтов
 - [ ] Начать Спринт 1
@@ -0,0 +1,160 @@
 # ШАГ 006 — Спринт 1: Инфраструктура + Создание тестов
 **Дата:** 2026-03-21
 **Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.
 ---
 ## Запрос
 > готов. поехали (начинаем Спринт 1)
 ---
 ## Ответ
 Реализован Спринт 1 в полном объёме: инфраструктура + создание тестов без авторизации.
 Спринт протестирован вручную в браузере, найдены и исправлены 4 бага.
 ---
 ## Структура проекта после спринта
 ```
 qa_test_app/
 ├── docker-compose.yml          ← поднимает весь стек одной командой
 ├── .env.example
 ├── nginx/
 │   └── nginx.conf              ← / → frontend, /api/ → backend
 ├── backend/
 │   ├── Dockerfile
 │   ├── entrypoint.sh           ← ждёт БД, запускает миграции, стартует сервер
 │   ├── requirements.txt
 │   ├── alembic.ini
 │   ├── alembic/
 │   │   ├── env.py              ← async alembic, берёт URL из settings
 │   │   ├── script.py.mako
 │   │   └── versions/
 │   │       └── 001_init.py     ← создаёт таблицы tests, questions, answers
 │   └── app/
 │       ├── config.py           ← настройки через pydantic-settings
 │       ├── database.py         ← async SQLAlchemy engine + session
 │       ├── main.py             ← FastAPI app, /api/health
 │       ├── models/test.py      ← ORM модели: Test, Question, Answer
 │       ├── schemas/test.py     ← Pydantic схемы с валидацией
 │       └── api/tests.py        ← REST эндпоинты
 └── frontend/
    ├── Dockerfile
    ├── package.json
    ├── vite.config.ts
    ├── index.html
    └── src/
        ├── App.tsx             ← роутер + провайдеры
        ├── api/
        │   ├── client.ts       ← axios с baseURL=/api
        │   └── tests.ts        ← типы + функции запросов
        └── pages/
            ├── TestList/       ← список тестов + кнопка создать
            ├── TestCreate/     ← форма создания теста
            └── TestDetail/     ← просмотр теста с вопросами
 ```
 ---
 ## API эндпоинты
 | Метод | URL | Описание |
 |-------|-----|----------|
 | GET | `/api/health` | Проверка работы сервера |
 | GET | `/api/tests` | Список тестов |
 | GET | `/api/tests/{id}` | Детали теста с вопросами и ответами |
 | POST | `/api/tests` | Создать тест |
 ---
 ## Схема БД
 ```
 tests
  id, title, description, passing_score, time_limit,
  allow_navigation_back, is_active, version, created_at
 questions
  id, test_id → tests.id, text, order
 answers
  id, question_id → questions.id, text, is_correct
 ```
 ---
 ## Валидация
 **Backend (Pydantic):**
 - Тест: минимум 7 вопросов, passing_score 0–100
 - Вопрос: минимум 3 варианта ответа, хотя бы 1 правильный
 **Frontend (Ant Design Form):**
 - Те же правила воспроизведены на клиенте
 - Nested Form.List для динамических вопросов и ответов
 - Таймер показывается только при включённом переключателе (shouldUpdate)
 ---
 ## Как запустить
 ```bash
 docker compose up --build
 ```
 Открыть браузер: `http://localhost`
 - Список тестов → кнопка «Создать тест»
 - Заполнить форму → нажать «Создать тест»
 - Перейти к созданному тесту и увидеть все вопросы и ответы
 - `http://localhost/api/health` → `{"status": "ok"}`
 - `http://localhost/api/docs` → Swagger UI FastAPI
 - `http://localhost/api/redoc` → ReDoc документация
 ---
 ## Баги, найденные и исправленные при ручном тестировании
 | # | Симптом | Причина | Исправление |
 |---|---------|---------|-------------|
 | 1 | `permission denied` на `entrypoint.sh` | `docker-compose.yml` монтирует `./backend:/app` — volume перекрывает файлы образа, включая результат `chmod +x` из Dockerfile | `CMD ["bash", "entrypoint.sh"]` вместо `CMD ["./entrypoint.sh"]` |
 | 2 | `No module named 'app'` в Alembic | Python не добавляет WORKDIR в `sys.path` автоматически | `ENV PYTHONPATH=/app` в Dockerfile |
 | 3 | nginx: `host not found in upstream "backend"` | nginx резолвит upstream-хосты **при старте**, а backend ещё не поднялся | Docker DNS resolver `127.0.0.11` + `set $backend` — резолвинг откладывается до момента запроса |
 | 4 | `http://localhost/api/docs` → 404 | FastAPI по умолчанию отдаёт Swagger по `/docs`, а через nginx путь становится `/api/docs` → `backend:8000/api/docs` (не существует) | Явно указать `docs_url="/api/docs"`, `redoc_url="/api/redoc"`, `openapi_url="/api/openapi.json"` в FastAPI |
 > **Для джуниора:** все четыре бага — типичные для первого запуска Docker + FastAPI + nginx. Запомни их, встретишь снова.
 ---
 ## Ключевые решения для джуниора
 **Async SQLAlchemy 2.0:**
 - `async_sessionmaker` + `AsyncSession` — не блокируем event loop при запросах к БД
 - `selectinload` для жадной загрузки связей (вместо N+1 запросов)
 **Alembic async:**
 - `async_engine_from_config` + `connection.run_sync(do_run_migrations)`
 - URL берётся из `app.config.settings` — одно место для конфига
 **Docker Compose healthcheck:**
 - `db` объявляет `healthcheck`, `backend` ждёт `condition: service_healthy`
 - Дополнительно `entrypoint.sh` вызывает `pg_isready` для надёжности
 **TanStack Query:**
 - `useQuery` для чтения данных — кэш, loading state, error state из коробки
 - `useMutation` для создания — `invalidateQueries` обновляет список после успеха
 ---
 ## Следующие шаги
 - [x] Спринт 1: Инфраструктура + Создание тестов
 - [ ] Спринт 2: Прохождение теста + результаты
 - [ ] Спринт 3: Трекер результатов
 - [ ] Спринт 4: Авторизация и роли
 - [ ] Спринт 5: Уведомления в MAX
@@ -0,0 +1,97 @@
 # ШАГ 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`, радио-кнопки для одиночного ответа
 ---
 ## Следующие шаги
 - [x] Спринт 1: Инфраструктура + Создание тестов
 - [x] Спринт 2: Прохождение теста + результат
 - [ ] Спринт 3: Трекер результатов
 - [ ] Спринт 4: Авторизация и роли
 - [ ] Спринт 5: Уведомления в MAX
@@ -0,0 +1,73 @@
 # ШАГ 008 — Спринт 2: Баг «Не удалось загрузить тест»
 **Дата:** 2026-03-21
 **Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.
 ---
 ## Запрос
 > вот такой баг при нажатии кнопки «Пройти тест» — «Не удалось загрузить тест» × 2
 ---
 ## Симптом
 При нажатии кнопки «Пройти тест» фронт выполняет `POST /api/attempts` и получает ошибку.
 В консоли backend:
 ```
 sqlalchemy.exc.ProgrammingError: (asyncpg.exceptions.UndefinedTableError)
 relation "test_attempts" does not exist
 ```
 Ошибка появляется дважды — из-за React StrictMode, который в dev-режиме намеренно монтирует компоненты дважды.
 ---
 ## Причина
 `uvicorn --reload` следит только за изменениями Python-файлов и перезапускает **процесс приложения**, но **не перезапускает контейнер целиком** и не выполняет `entrypoint.sh` повторно.
 Миграция `002_attempts` (создаёт таблицы `test_attempts` и `attempt_answers`) была добавлена уже после первого запуска стека — поэтому она ни разу не применялась.
 ---
 ## Исправление
 ```bash
 docker compose restart backend
 ```
 При перезапуске контейнер выполняет `entrypoint.sh` заново:
 ```
 Running migrations...
 INFO  [alembic.runtime.migration] Context impl PostgresqlImpl.
 INFO  [alembic.runtime.migration] Will assume transactional DDL.
 INFO  [alembic.runtime.migration] Running upgrade 001 -> 002, attempts
 Starting server...
 INFO:     Application startup complete.
 ```
 Таблицы созданы — баг исчезает.
 ---
 ## Правило для джуниора
 > `uvicorn --reload` ≠ перезапуск контейнера.
 >
 > Если ты добавил новую миграцию Alembic и стек уже работает — выполни `docker compose restart backend`, чтобы миграция применилась.
 >
 > `docker compose up` запускает контейнер только если он не запущен. `restart` — принудительно пересоздаёт его.
 ---
 ## Следующие шаги
 - [x] Спринт 1: Инфраструктура + Создание тестов
 - [x] Спринт 2: Прохождение теста + результат
 - [ ] Спринт 3: Трекер результатов
 - [ ] Спринт 4: Авторизация и роли
 - [ ] Спринт 5: Уведомления в MAX
@@ -0,0 +1,73 @@
 # ШАГ 009 — Спринт 2: Доработки UX после тестирования
 **Дата:** 2026-03-21
 **Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.
 ---
 ## Запросы
 > 1. На странице теста видны правильные ответы — зачем тогда проходить тест?
 > 2. На главной колонка с названием теста стала слишком узкой из-за трёх кнопок действий.
 ---
 ## Изменения
 ### 1. Разделение страницы теста на два вида
 **Проблема:** `/tests/:id` показывала зелёные галочки у правильных ответов. Пользователь мог подсмотреть ответы до прохождения теста.
 **Решение:** два отдельных маршрута с разным содержимым.
 | Маршрут | Для кого | Что показывает |
 |---------|----------|----------------|
 | `/tests/:id` | Сотрудник | Вопросы и варианты ответов без отметок |
 | `/tests/:id/edit` | Автор | Все ответы с отметками ✓/✗ + жёлтый баннер «Вид автора» |
 Кнопка «Редактировать» на странице автора пока задизаблена — активируется в Спринте 4 вместе с авторизацией.
 **Затронутые файлы:**
 ```
 frontend/src/pages/TestDetail/index.tsx   ← убраны CheckCircleTwoTone / CloseCircleTwoTone
 frontend/src/pages/TestEdit/index.tsx     ← новый файл, бывший TestDetail + баннер
 frontend/src/App.tsx                      ← добавлен маршрут /tests/:id/edit
 ```
 ---
 ### 2. Выпадающее меню «⋯» в списке тестов
 **Проблема:** Три кнопки («Открыть», «Изменить», «Пройти тест») в одной ячейке сжимали колонку с названием теста.
 **Решение:** Все три действия убраны в `Dropdown` по кнопке `MoreOutlined` (⋯). Колонка действий сужена до 60px, колонка с названием занимает всю оставшуюся ширину.
 ```
 frontend/src/pages/TestList/index.tsx   ← Space + 3 Button → Dropdown с menu.items
 ```
 **Структура меню:**
 ```
 Открыть
 Изменить
 ─────────
 Пройти тест
 ```
 ---
 ## Архитектурное решение для джуниора
 > Разделение «вид сотрудника» / «вид автора» сделано через **два отдельных React-компонента** на разных маршрутах, а не через условный рендеринг внутри одного компонента.
 >
 > Почему: в Спринте 4 эти маршруты будут защищены разными ролями (`ProtectedRoute`). Если бы логика была в одном компоненте, пришлось бы прятать данные на фронте — это ненадёжно. Два маршрута = два разных запроса = чистое разграничение доступа.
 ---
 ## Следующие шаги
 - [x] Спринт 1: Инфраструктура + Создание тестов
 - [x] Спринт 2: Прохождение теста + результат
 - [ ] Спринт 3: Трекер результатов
 - [ ] Спринт 4: Авторизация и роли
 - [ ] Спринт 5: Уведомления в MAX
@@ -0,0 +1,98 @@
 # ШАГ 010 — Спринт 3: Редактирование теста + версионность
 **Дата:** 2026-03-21
 **Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.
 ---
 ## Запрос
 > запускаем спринт 3
 ---
 ## Реализовано
 Полноценное редактирование тестов с автоматическим версионированием.
 ---
 ## Новые файлы
 ```
 backend/alembic/versions/003_test_versioning.py  ← добавляет parent_id в tests
 frontend/src/components/TestForm/index.tsx        ← переиспользуемая форма теста
 ```
 ## Изменённые файлы
 ```
 backend/app/models/test.py        ← добавлено поле parent_id
 backend/app/schemas/test.py       ← TestOut.parent_id, TestUpdateResponse
 backend/app/api/tests.py          ← PUT + /versions + /activate
 frontend/src/api/tests.ts         ← update, versions, activate
 frontend/src/pages/TestCreate/    ← упрощён через TestForm
 frontend/src/pages/TestEdit/      ← полноценный просмотр + редактирование
 ```
 ---
 ## API эндпоинты (новые)
 | Метод | URL | Описание |
 |-------|-----|----------|
 | PUT | `/api/tests/{id}` | Редактировать тест |
 | GET | `/api/tests/{id}/versions` | Цепочка всех версий |
 | POST | `/api/tests/{id}/activate` | Сделать версию активной |
 ---
 ## Схема БД (изменено)
 ```
 tests
  + parent_id → tests.id   ← ссылка на предыдущую версию (NULL у первой)
 ```
 ---
 ## Логика версионирования
 | Условие при сохранении | Результат |
 |------------------------|-----------|
 | Попыток нет | Редактируем на месте, версия не меняется |
 | Есть хотя бы одна попытка | Новый тест: `version+1`, `parent_id=old.id`, `is_active=True`; старый: `is_active=False` |
 **Список тестов** показывает только `is_active=True` версии.
 **История версий** отображается на странице `/tests/:id/edit` — таблица всех версий цепочки.
 ---
 ## UX редактирования
 - Страница `/tests/:id/edit` работает в двух режимах: просмотр автора → нажать «Редактировать» → форма редактирования
 - Кнопка «← К просмотру теста» в шапке формы
 - При создании новой версии: редирект на `/tests/:newId/edit` + уведомление
 - В таблице «История версий»: статус (Активная/Неактивная), кнопка «Сделать активной» для любой версии
 ---
 ## Баги, найденные и исправленные при тестировании
 | # | Симптом | Причина | Исправление |
 |---|---------|---------|-------------|
 | 1 | `ForeignKeyViolationError` при сохранении теста | `DELETE FROM questions` bulk-запросом не каскадирует на `answers` — в схеме нет `ON DELETE CASCADE` | Сначала удаляем `answers` по `question_id IN (...)`, затем `questions` |
 | 2 | Обе версии показывались «Активными» | Тест был создан до введения логики деактивации родителя | Добавлена кнопка «Сделать активной» в шапке и в строке таблицы для любой версии |
 > **Для джуниора:** `cascade="all, delete-orphan"` в SQLAlchemy работает только при удалении через ORM-объекты (`session.delete(obj)`). При bulk-delete через `db.execute(delete(Model)...)` ORM-каскад не срабатывает — нужно вручную удалять дочерние записи в правильном порядке.
 ---
 ## Следующие шаги
 - [x] Спринт 1: Инфраструктура + Создание тестов
 - [x] Спринт 2: Прохождение теста + результат
 - [x] Спринт 3: Редактирование + версионность
 - [ ] Спринт 4: Трекер результатов
 - [ ] Спринт 5: Авторизация и роли
 - [ ] Спринт 6: Уведомления в MAX
@@ -0,0 +1,73 @@
 # QA Test App — Система тестирования сотрудников клиники
 Веб-приложение для проведения внутреннего тестирования сотрудников. Руководители подразделений создают тесты, назначают их сотрудникам, система фиксирует результаты.
 > Проект разрабатывается как **мастер-класс для джуниор-разработчиков**. История разработки — пошаговые запросы и решения — сохраняется в `DOC/ШАГИ/`.
 ---
 ## Формат тестирования
 - Вопрос + минимум 3 варианта ответа (один или несколько правильных)
 - Минимум 7 вопросов в тесте
 - Случайный порядок вопросов при каждом прохождении
 - Опциональный таймер на прохождение
 - Порог зачёта задаётся автором теста (%)
 ---
 ## Роли
 | Роль | Возможности |
 |------|------------|
 | **HR-менеджер / Директор** | Создаёт тесты, назначает всем сотрудникам клиники, видит все результаты |
 | **Руководитель подразделения** | Создаёт тесты, назначает только своему отделу, видит результаты своего отдела |
 | **Сотрудник** | Проходит назначенные тесты, видит свои результаты и ошибки |
 ---
 ## Стек
 | Слой | Технология |
 |------|-----------|
 | Backend | Python 3.12 + FastAPI + SQLAlchemy 2.0 + Alembic |
 | База данных | PostgreSQL 16 |
 | Frontend | React 18 + TypeScript + Vite + Ant Design + TanStack Query |
 | Инфраструктура | Docker Compose + Nginx |
 | AI-помощник | DeepSeek API (openai-совместимый) — Спринт 4 |
 | Уведомления | Мессенджер MAX — Спринт 7 |
 ---
 ## План спринтов
 | Спринт | Содержание | Статус |
 |--------|-----------|--------|
 | **1** | Инфраструктура (Docker, FastAPI, React, PostgreSQL) + создание тестов | ✅ |
 | **2** | Прохождение теста + результаты и разбор ошибок | ✅ |
 | **3** | Редактирование тестов + версионность | ✅ |
 | **4** | AI-помощник при создании/редактировании тестов (DeepSeek) | ⬜ |
 | **5** | Трекер результатов | ⬜ |
 | **6** | Авторизация, роли, подразделения, управление пользователями | ⬜ |
 | **7** | Уведомления в MAX | ⬜ |
 ---
 ## Документация
 | Файл | Содержание |
 |------|-----------|
 | `DOC/ТЗ.md` | Техническое задание (v1.1) |
 | `DOC/СТЕК.md` | Технологический стек с обоснованием |
 | `DOC/СПРИНТЫ.md` | Детальный план спринтов с задачами |
 | `DOC/ШАГИ/` | История разработки шаг за шагом |
 ---
 ## Запуск (после Спринта 1)
 ```bash
 docker compose up --build
 ```
 Приложение будет доступно на `http://localhost`.
@@ -0,0 +1,18 @@
 FROM python:3.12-slim
 # pg_isready нужен для проверки готовности БД в entrypoint
 RUN apt-get update && apt-get install -y --no-install-recommends postgresql-client \
    && rm -rf /var/lib/apt/lists/*
 WORKDIR /app
 ENV PYTHONPATH=/app
 COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt
 COPY . .
 RUN chmod +x entrypoint.sh
 CMD ["bash", "entrypoint.sh"]
@@ -0,0 +1,39 @@
 [alembic]
 script_location = alembic
 # URL переопределяется в alembic/env.py из переменной окружения DATABASE_URL
 sqlalchemy.url = driver://user:pass@localhost/dbname
 [loggers]
 keys = root,sqlalchemy,alembic
 [handlers]
 keys = console
 [formatters]
 keys = generic
 [logger_root]
 level = WARN
 handlers = console
 qualname =
 [logger_sqlalchemy]
 level = WARN
 handlers =
 qualname = sqlalchemy.engine
 [logger_alembic]
 level = INFO
 handlers =
 qualname = alembic
 [handler_console]
 class = StreamHandler
 args = (sys.stderr,)
 level = NOTSET
 formatter = generic
 [formatter_generic]
 format = %(levelname)-5.5s [%(name)s] %(message)s
 datefmt = %H:%M:%S
@@ -0,0 +1,57 @@
 import asyncio
 from logging.config import fileConfig
 from sqlalchemy import pool
 from sqlalchemy.ext.asyncio import async_engine_from_config
 from alembic import context
 # Alembic config
 config = context.config
 if config.config_file_name is not None:
    fileConfig(config.config_file_name)
 # Берём DATABASE_URL из настроек приложения
 from app.config import settings
 from app.database import Base
 from app.models import attempt, test  # noqa: F401 — импортируем модели, чтобы Alembic их видел
 config.set_main_option("sqlalchemy.url", settings.database_url)
 target_metadata = Base.metadata
 def run_migrations_offline() -> None:
    url = config.get_main_option("sqlalchemy.url")
    context.configure(
        url=url,
        target_metadata=target_metadata,
        literal_binds=True,
        dialect_opts={"paramstyle": "named"},
    )
    with context.begin_transaction():
        context.run_migrations()
 def do_run_migrations(connection):
    context.configure(connection=connection, target_metadata=target_metadata)
    with context.begin_transaction():
        context.run_migrations()
 async def run_migrations_online() -> None:
    connectable = async_engine_from_config(
        config.get_section(config.config_ini_section, {}),
        prefix="sqlalchemy.",
        poolclass=pool.NullPool,
    )
    async with connectable.connect() as connection:
        await connection.run_sync(do_run_migrations)
    await connectable.dispose()
 if context.is_offline_mode():
    run_migrations_offline()
 else:
    asyncio.run(run_migrations_online())
@@ -0,0 +1,25 @@
 """${message}
 Revision ID: ${up_revision}
 Revises: ${down_revision | comma,n}
 Create Date: ${create_date}
 """
 from typing import Sequence, Union
 from alembic import op
 import sqlalchemy as sa
 ${imports if imports else ""}
 revision: str = ${repr(up_revision)}
 down_revision: Union[str, None] = ${repr(down_revision)}
 branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
 depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
 def upgrade() -> None:
    ${upgrades if upgrades else "pass"}
 def downgrade() -> None:
    ${downgrades if downgrades else "pass"}
@@ -0,0 +1,62 @@
 """init
 Revision ID: 001
 Revises:
 Create Date: 2026-03-21
 """
 from typing import Sequence, Union
 import sqlalchemy as sa
 from alembic import op
 revision: str = "001"
 down_revision: Union[str, None] = None
 branch_labels: Union[str, Sequence[str], None] = None
 depends_on: Union[str, Sequence[str], None] = None
 def upgrade() -> None:
    op.create_table(
        "tests",
        sa.Column("id", sa.Integer(), nullable=False),
        sa.Column("title", sa.String(255), nullable=False),
        sa.Column("description", sa.Text(), nullable=True),
        sa.Column("passing_score", sa.Integer(), nullable=False),
        sa.Column("time_limit", sa.Integer(), nullable=True),
        sa.Column("allow_navigation_back", sa.Boolean(), nullable=False, server_default="true"),
        sa.Column("is_active", sa.Boolean(), nullable=False, server_default="true"),
        sa.Column("version", sa.Integer(), nullable=False, server_default="1"),
        sa.Column(
            "created_at",
            sa.DateTime(timezone=True),
            server_default=sa.text("now()"),
        ),
        sa.PrimaryKeyConstraint("id"),
    )
    op.create_table(
        "questions",
        sa.Column("id", sa.Integer(), nullable=False),
        sa.Column("test_id", sa.Integer(), sa.ForeignKey("tests.id"), nullable=False),
        sa.Column("text", sa.Text(), nullable=False),
        sa.Column("order", sa.Integer(), nullable=False),
        sa.PrimaryKeyConstraint("id"),
    )
    op.create_table(
        "answers",
        sa.Column("id", sa.Integer(), nullable=False),
        sa.Column(
            "question_id", sa.Integer(), sa.ForeignKey("questions.id"), nullable=False
        ),
        sa.Column("text", sa.Text(), nullable=False),
        sa.Column("is_correct", sa.Boolean(), nullable=False),
        sa.PrimaryKeyConstraint("id"),
    )
 def downgrade() -> None:
    op.drop_table("answers")
    op.drop_table("questions")
    op.drop_table("tests")
@@ -0,0 +1,53 @@
 """attempts
 Revision ID: 002
 Revises: 001
 Create Date: 2026-03-21
 """
 from typing import Sequence, Union
 import sqlalchemy as sa
 from alembic import op
 revision: str = "002"
 down_revision: Union[str, None] = "001"
 branch_labels: Union[str, Sequence[str], None] = None
 depends_on: Union[str, Sequence[str], None] = None
 def upgrade() -> None:
    op.create_table(
        "test_attempts",
        sa.Column("id", sa.Integer(), nullable=False),
        sa.Column("test_id", sa.Integer(), sa.ForeignKey("tests.id"), nullable=False),
        sa.Column(
            "started_at",
            sa.DateTime(timezone=True),
            server_default=sa.text("now()"),
            nullable=False,
        ),
        sa.Column("finished_at", sa.DateTime(timezone=True), nullable=True),
        sa.Column("score", sa.Float(), nullable=True),
        sa.Column("passed", sa.Boolean(), nullable=True),
        sa.Column("correct_count", sa.Integer(), nullable=True),
        sa.Column("total_count", sa.Integer(), nullable=True),
        sa.Column("status", sa.String(20), nullable=False, server_default="in_progress"),
        sa.PrimaryKeyConstraint("id"),
    )
    op.create_table(
        "attempt_answers",
        sa.Column("id", sa.Integer(), nullable=False),
        sa.Column(
            "attempt_id", sa.Integer(), sa.ForeignKey("test_attempts.id"), nullable=False
        ),
        sa.Column("question_id", sa.Integer(), sa.ForeignKey("questions.id"), nullable=False),
        sa.Column("answer_id", sa.Integer(), sa.ForeignKey("answers.id"), nullable=False),
        sa.PrimaryKeyConstraint("id"),
    )
 def downgrade() -> None:
    op.drop_table("attempt_answers")
    op.drop_table("test_attempts")
@@ -0,0 +1,29 @@
 """test versioning
 Revision ID: 003
 Revises: 002
 Create Date: 2026-03-21
 """
 from typing import Sequence, Union
 import sqlalchemy as sa
 from alembic import op
 revision: str = "003"
 down_revision: Union[str, None] = "002"
 branch_labels: Union[str, Sequence[str], None] = None
 depends_on: Union[str, Sequence[str], None] = None
 def upgrade() -> None:
    op.add_column(
        "tests",
        sa.Column("parent_id", sa.Integer(), sa.ForeignKey("tests.id"), nullable=True),
    )
    op.create_index("ix_tests_parent_id", "tests", ["parent_id"])
 def downgrade() -> None:
    op.drop_index("ix_tests_parent_id", table_name="tests")
    op.drop_column("tests", "parent_id")
@@ -0,0 +1,223 @@
 import random
 from datetime import datetime, timezone
 from fastapi import APIRouter, Depends, HTTPException
 from sqlalchemy import select
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import selectinload
 from app.database import get_db
 from app.models.attempt import AttemptAnswer, TestAttempt
 from app.models.test import Question, Test
 from app.schemas.attempt import (
    AttemptResult,
    AttemptStart,
    AttemptStarted,
    AttemptSubmitDto,
    AnswerForTest,
    AnswerResult,
    QuestionForTest,
    QuestionResult,
 )
 router = APIRouter(prefix="/api/attempts", tags=["attempts"])
@router.post("", response_model=AttemptStarted, status_code=201)
 async def start_attempt(data: AttemptStart, db: AsyncSession = Depends(get_db)):
    """Начать попытку прохождения теста. Возвращает вопросы в случайном порядке без правильных ответов."""
    result = await db.execute(
        select(Test)
        .options(selectinload(Test.questions).selectinload(Question.answers))
        .where(Test.id == data.test_id, Test.is_active == True)
    )
    test = result.scalar_one_or_none()
    if not test:
        raise HTTPException(status_code=404, detail="Тест не найден")
    attempt = TestAttempt(test_id=test.id, status="in_progress")
    db.add(attempt)
    await db.commit()
    await db.refresh(attempt)
    # Перемешиваем вопросы и ответы случайно
    questions_shuffled = list(test.questions)
    random.shuffle(questions_shuffled)
    questions_for_test = []
    for q in questions_shuffled:
        correct_count = sum(1 for a in q.answers if a.is_correct)
        answers_shuffled = list(q.answers)
        random.shuffle(answers_shuffled)
        questions_for_test.append(
            QuestionForTest(
                id=q.id,
                text=q.text,
                is_multiple=correct_count > 1,
                answers=[AnswerForTest(id=a.id, text=a.text) for a in answers_shuffled],
            )
        )
    return AttemptStarted(
        id=attempt.id,
        test_id=test.id,
        test_title=test.title,
        test_description=test.description,
        started_at=attempt.started_at,
        time_limit=test.time_limit,
        allow_navigation_back=test.allow_navigation_back,
        questions=questions_for_test,
    )
@router.post("/{attempt_id}/submit", response_model=AttemptResult)
 async def submit_attempt(
    attempt_id: int, data: AttemptSubmitDto, db: AsyncSession = Depends(get_db)
 ):
    """Завершить попытку: сохранить ответы, подсчитать результат."""
    result = await db.execute(
        select(TestAttempt)
        .where(TestAttempt.id == attempt_id, TestAttempt.status == "in_progress")
    )
    attempt = result.scalar_one_or_none()
    if not attempt:
        raise HTTPException(status_code=404, detail="Попытка не найдена или уже завершена")
    # Загружаем тест с вопросами и ответами
    test_result = await db.execute(
        select(Test)
        .options(selectinload(Test.questions).selectinload(Question.answers))
        .where(Test.id == attempt.test_id)
    )
    test = test_result.scalar_one()
    # Сохраняем выбранные ответы
    submitted = {qa.question_id: set(qa.answer_ids) for qa in data.answers}
    for qa in data.answers:
        for answer_id in qa.answer_ids:
            db.add(AttemptAnswer(
                attempt_id=attempt.id,
                question_id=qa.question_id,
                answer_id=answer_id,
            ))
    # Подсчёт результата
    correct_count = 0
    question_results = []
    for question in test.questions:
        correct_ids = {a.id for a in question.answers if a.is_correct}
        selected_ids = submitted.get(question.id, set())
        is_correct = selected_ids == correct_ids
        if is_correct:
            correct_count += 1
        question_results.append(
            QuestionResult(
                id=question.id,
                text=question.text,
                is_answered_correctly=is_correct,
                answers=[
                    AnswerResult(
                        id=a.id,
                        text=a.text,
                        is_correct=a.is_correct,
                        is_selected=a.id in selected_ids,
                    )
                    for a in question.answers
                ],
            )
        )
    total = len(test.questions)
    score = round((correct_count / total) * 100, 1) if total > 0 else 0.0
    passed = score >= test.passing_score
    finished_at = datetime.now(timezone.utc)
    attempt.finished_at = finished_at
    attempt.score = score
    attempt.passed = passed
    attempt.correct_count = correct_count
    attempt.total_count = total
    attempt.status = "finished"
    await db.commit()
    return AttemptResult(
        id=attempt.id,
        test_id=test.id,
        test_title=test.title,
        started_at=attempt.started_at,
        finished_at=finished_at,
        score=score,
        passed=passed,
        passing_score=test.passing_score,
        correct_count=correct_count,
        total_count=total,
        questions=question_results,
    )
@router.get("/{attempt_id}/result", response_model=AttemptResult)
 async def get_result(attempt_id: int, db: AsyncSession = Depends(get_db)):
    """Получить результат завершённой попытки."""
    result = await db.execute(
        select(TestAttempt)
        .options(selectinload(TestAttempt.answers).selectinload(AttemptAnswer.answer))
        .where(TestAttempt.id == attempt_id, TestAttempt.status == "finished")
    )
    attempt = result.scalar_one_or_none()
    if not attempt:
        raise HTTPException(status_code=404, detail="Результат не найден")
    test_result = await db.execute(
        select(Test)
        .options(selectinload(Test.questions).selectinload(Question.answers))
        .where(Test.id == attempt.test_id)
    )
    test = test_result.scalar_one()
    # Восстанавливаем выбранные ответы из БД
    selected_by_question: dict[int, set[int]] = {}
    for aa in attempt.answers:
        selected_by_question.setdefault(aa.question_id, set()).add(aa.answer_id)
    question_results = []
    for question in test.questions:
        correct_ids = {a.id for a in question.answers if a.is_correct}
        selected_ids = selected_by_question.get(question.id, set())
        question_results.append(
            QuestionResult(
                id=question.id,
                text=question.text,
                is_answered_correctly=selected_ids == correct_ids,
                answers=[
                    AnswerResult(
                        id=a.id,
                        text=a.text,
                        is_correct=a.is_correct,
                        is_selected=a.id in selected_ids,
                    )
                    for a in question.answers
                ],
            )
        )
    return AttemptResult(
        id=attempt.id,
        test_id=test.id,
        test_title=test.title,
        started_at=attempt.started_at,
        finished_at=attempt.finished_at,
        score=attempt.score,
        passed=attempt.passed,
        passing_score=test.passing_score,
        correct_count=attempt.correct_count,
        total_count=attempt.total_count,
        questions=question_results,
    )
@@ -0,0 +1,236 @@
 from fastapi import APIRouter, Depends, HTTPException
 from sqlalchemy import delete, func, select, update
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import selectinload
 from app.database import get_db
 from app.models.attempt import TestAttempt
 from app.models.test import Answer, Question, Test
 from app.schemas.test import TestCreate, TestListItem, TestOut, TestUpdateResponse
 router = APIRouter(prefix="/api/tests", tags=["tests"])
@router.get("", response_model=list[TestListItem])
 async def list_tests(db: AsyncSession = Depends(get_db)):
    # Показываем только активные версии (is_active = True)
    result = await db.execute(
        select(Test)
        .options(selectinload(Test.questions))
        .where(Test.is_active == True)
        .order_by(Test.created_at.desc())
    )
    tests = result.scalars().all()
    items = []
    for test in tests:
        item = TestListItem.model_validate(test)
        item.questions_count = len(test.questions)
        items.append(item)
    return items
@router.get("/{test_id}", response_model=TestOut)
 async def get_test(test_id: int, db: AsyncSession = Depends(get_db)):
    # Загружаем любую версию по id (без фильтра is_active — нужно для просмотра истории)
    result = await db.execute(
        select(Test)
        .options(selectinload(Test.questions).selectinload(Question.answers))
        .where(Test.id == test_id)
    )
    test = result.scalar_one_or_none()
    if not test:
        raise HTTPException(status_code=404, detail="Тест не найден")
    return test
@router.post("", response_model=TestOut, status_code=201)
 async def create_test(data: TestCreate, db: AsyncSession = Depends(get_db)):
    test = Test(
        title=data.title,
        description=data.description,
        passing_score=data.passing_score,
        time_limit=data.time_limit,
        allow_navigation_back=data.allow_navigation_back,
    )
    db.add(test)
    await db.flush()
    for order, q_data in enumerate(data.questions):
        question = Question(test_id=test.id, text=q_data.text, order=order)
        db.add(question)
        await db.flush()
        for a_data in q_data.answers:
            db.add(Answer(
                question_id=question.id,
                text=a_data.text,
                is_correct=a_data.is_correct,
            ))
    await db.commit()
    result = await db.execute(
        select(Test)
        .options(selectinload(Test.questions).selectinload(Question.answers))
        .where(Test.id == test.id)
    )
    return result.scalar_one()
@router.get("/{test_id}/versions", response_model=list[TestListItem])
 async def get_test_versions(test_id: int, db: AsyncSession = Depends(get_db)):
    """Возвращает все версии теста (от первой к последней)."""
    result = await db.execute(select(Test).where(Test.id == test_id))
    test = result.scalar_one_or_none()
    if not test:
        raise HTTPException(status_code=404, detail="Тест не найден")
    # Идём вверх до корневой версии
    root = test
    while root.parent_id is not None:
        result = await db.execute(select(Test).where(Test.id == root.parent_id))
        root = result.scalar_one()
    # Идём вниз от корня, собирая цепочку
    versions: list[Test] = []
    current = root
    while current is not None:
        result = await db.execute(
            select(Test)
            .options(selectinload(Test.questions))
            .where(Test.id == current.id)
        )
        current_with_qs = result.scalar_one()
        versions.append(current_with_qs)
        result = await db.execute(select(Test).where(Test.parent_id == current.id))
        current = result.scalar_one_or_none()
    items = []
    for v in versions:
        item = TestListItem.model_validate(v)
        item.questions_count = len(v.questions)
        items.append(item)
    return items
@router.post("/{test_id}/activate", response_model=TestOut)
 async def activate_test_version(test_id: int, db: AsyncSession = Depends(get_db)):
    """Делает указанную версию активной, деактивирует все остальные в цепочке."""
    result = await db.execute(select(Test).where(Test.id == test_id))
    test = result.scalar_one_or_none()
    if not test:
        raise HTTPException(status_code=404, detail="Тест не найден")
    # Идём вверх до корневой версии
    root = test
    while root.parent_id is not None:
        result = await db.execute(select(Test).where(Test.id == root.parent_id))
        root = result.scalar_one()
    # Собираем все id версий в цепочке
    all_ids: list[int] = []
    current = root
    while current is not None:
        all_ids.append(current.id)
        result = await db.execute(select(Test).where(Test.parent_id == current.id))
        current = result.scalar_one_or_none()
    # Деактивируем все, активируем нужную
    await db.execute(update(Test).where(Test.id.in_(all_ids)).values(is_active=False))
    await db.execute(update(Test).where(Test.id == test_id).values(is_active=True))
    await db.commit()
    result = await db.execute(
        select(Test)
        .options(selectinload(Test.questions).selectinload(Question.answers))
        .where(Test.id == test_id)
    )
    return result.scalar_one()
@router.put("/{test_id}", response_model=TestUpdateResponse)
 async def update_test(test_id: int, data: TestCreate, db: AsyncSession = Depends(get_db)):
    result = await db.execute(select(Test).where(Test.id == test_id))
    test = result.scalar_one_or_none()
    if not test:
        raise HTTPException(status_code=404, detail="Тест не найден")
    attempts_count = await db.scalar(
        select(func.count()).select_from(TestAttempt).where(TestAttempt.test_id == test_id)
    )
    if attempts_count == 0:
        # Редактируем на месте
        test.title = data.title
        test.description = data.description
        test.passing_score = data.passing_score
        test.time_limit = data.time_limit
        test.allow_navigation_back = data.allow_navigation_back
        # Сначала удаляем ответы (FK: answers.question_id → questions.id)
        q_ids_result = await db.execute(select(Question.id).where(Question.test_id == test_id))
        q_ids = [row[0] for row in q_ids_result.fetchall()]
        if q_ids:
            await db.execute(delete(Answer).where(Answer.question_id.in_(q_ids)))
        await db.execute(delete(Question).where(Question.test_id == test_id))
        await db.flush()
        for order, q_data in enumerate(data.questions):
            question = Question(test_id=test.id, text=q_data.text, order=order)
            db.add(question)
            await db.flush()
            for a_data in q_data.answers:
                db.add(Answer(
                    question_id=question.id,
                    text=a_data.text,
                    is_correct=a_data.is_correct,
                ))
        await db.commit()
        result = await db.execute(
            select(Test)
            .options(selectinload(Test.questions).selectinload(Question.answers))
            .where(Test.id == test.id)
        )
        return {"test": result.scalar_one(), "is_new_version": False}
    else:
        # Есть попытки — создаём новую версию, деактивируем текущую
        test.is_active = False
        new_test = Test(
            title=data.title,
            description=data.description,
            passing_score=data.passing_score,
            time_limit=data.time_limit,
            allow_navigation_back=data.allow_navigation_back,
            version=test.version + 1,
            parent_id=test.id,
            is_active=True,
        )
        db.add(new_test)
        await db.flush()
        for order, q_data in enumerate(data.questions):
            question = Question(test_id=new_test.id, text=q_data.text, order=order)
            db.add(question)
            await db.flush()
            for a_data in q_data.answers:
                db.add(Answer(
                    question_id=question.id,
                    text=a_data.text,
                    is_correct=a_data.is_correct,
                ))
        await db.commit()
        result = await db.execute(
            select(Test)
            .options(selectinload(Test.questions).selectinload(Question.answers))
            .where(Test.id == new_test.id)
        )
        return {"test": result.scalar_one(), "is_new_version": True}
@@ -0,0 +1,11 @@
 from pydantic_settings import BaseSettings
 class Settings(BaseSettings):
    database_url: str = "postgresql+asyncpg://qa_user:qa_password@db:5432/qa_test"
    class Config:
        env_file = ".env"
 settings = Settings()
@@ -0,0 +1,17 @@
 from sqlalchemy.ext.asyncio import create_async_engine, async_sessionmaker, AsyncSession
 from sqlalchemy.orm import DeclarativeBase
 from app.config import settings
 engine = create_async_engine(settings.database_url, echo=True)
 AsyncSessionLocal = async_sessionmaker(engine, expire_on_commit=False)
 class Base(DeclarativeBase):
    pass
 async def get_db() -> AsyncSession:
    async with AsyncSessionLocal() as session:
        yield session
@@ -0,0 +1,27 @@
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 from app.api import attempts, tests
 app = FastAPI(
    title="QA Test App API",
    version="0.1.0",
    docs_url="/api/docs",
    redoc_url="/api/redoc",
    openapi_url="/api/openapi.json",
 )
 app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    allow_methods=["*"],
    allow_headers=["*"],
 )
 app.include_router(tests.router)
 app.include_router(attempts.router)
@app.get("/api/health")
 async def health():
    return {"status": "ok"}
@@ -0,0 +1,49 @@
 from datetime import datetime
 from sqlalchemy import Boolean, DateTime, Float, ForeignKey, Integer, String
 from sqlalchemy.orm import Mapped, mapped_column, relationship
 from sqlalchemy.sql import func
 from app.database import Base
 class TestAttempt(Base):
    __tablename__ = "test_attempts"
    id: Mapped[int] = mapped_column(Integer, primary_key=True)
    test_id: Mapped[int] = mapped_column(Integer, ForeignKey("tests.id"), nullable=False)
    started_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True), server_default=func.now()
    )
    finished_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
    score: Mapped[float | None] = mapped_column(Float, nullable=True)  # процент 0–100
    passed: Mapped[bool | None] = mapped_column(Boolean, nullable=True)
    correct_count: Mapped[int | None] = mapped_column(Integer, nullable=True)
    total_count: Mapped[int | None] = mapped_column(Integer, nullable=True)
    # in_progress | finished
    status: Mapped[str] = mapped_column(String(20), default="in_progress", nullable=False)
    test: Mapped["Test"] = relationship("Test")  # type: ignore[name-defined]
    answers: Mapped[list["AttemptAnswer"]] = relationship(
        "AttemptAnswer", back_populates="attempt", cascade="all, delete-orphan"
    )
 class AttemptAnswer(Base):
    """Одна запись = один выбранный вариант ответа сотрудника."""
    __tablename__ = "attempt_answers"
    id: Mapped[int] = mapped_column(Integer, primary_key=True)
    attempt_id: Mapped[int] = mapped_column(
        Integer, ForeignKey("test_attempts.id"), nullable=False
    )
    question_id: Mapped[int] = mapped_column(
        Integer, ForeignKey("questions.id"), nullable=False
    )
    answer_id: Mapped[int] = mapped_column(
        Integer, ForeignKey("answers.id"), nullable=False
    )
    attempt: Mapped["TestAttempt"] = relationship("TestAttempt", back_populates="answers")
    answer: Mapped["Answer"] = relationship("Answer")  # type: ignore[name-defined]
@@ -0,0 +1,57 @@
 from datetime import datetime
 from sqlalchemy import Boolean, DateTime, ForeignKey, Integer, String, Text
 from sqlalchemy.orm import Mapped, mapped_column, relationship
 from sqlalchemy.sql import func
 from app.database import Base
 class Test(Base):
    __tablename__ = "tests"
    id: Mapped[int] = mapped_column(Integer, primary_key=True)
    title: Mapped[str] = mapped_column(String(255), nullable=False)
    description: Mapped[str | None] = mapped_column(Text, nullable=True)
    passing_score: Mapped[int] = mapped_column(Integer, nullable=False)
    time_limit: Mapped[int | None] = mapped_column(Integer, nullable=True)  # минуты
    allow_navigation_back: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
    is_active: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
    version: Mapped[int] = mapped_column(Integer, default=1, nullable=False)
    parent_id: Mapped[int | None] = mapped_column(
        Integer, ForeignKey("tests.id"), nullable=True
    )
    created_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True), server_default=func.now()
    )
    questions: Mapped[list["Question"]] = relationship(
        "Question", back_populates="test", cascade="all, delete-orphan"
    )
 class Question(Base):
    __tablename__ = "questions"
    id: Mapped[int] = mapped_column(Integer, primary_key=True)
    test_id: Mapped[int] = mapped_column(Integer, ForeignKey("tests.id"), nullable=False)
    text: Mapped[str] = mapped_column(Text, nullable=False)
    order: Mapped[int] = mapped_column(Integer, nullable=False)
    test: Mapped["Test"] = relationship("Test", back_populates="questions")
    answers: Mapped[list["Answer"]] = relationship(
        "Answer", back_populates="question", cascade="all, delete-orphan"
    )
 class Answer(Base):
    __tablename__ = "answers"
    id: Mapped[int] = mapped_column(Integer, primary_key=True)
    question_id: Mapped[int] = mapped_column(
        Integer, ForeignKey("questions.id"), nullable=False
    )
    text: Mapped[str] = mapped_column(Text, nullable=False)
    is_correct: Mapped[bool] = mapped_column(Boolean, nullable=False)
    question: Mapped["Question"] = relationship("Question", back_populates="answers")
@@ -0,0 +1,89 @@
 from datetime import datetime
 from typing import Optional
 from pydantic import BaseModel
 # ── Начало попытки ──────────────────────────────────────────
 class AttemptStart(BaseModel):
    test_id: int
 class AnswerForTest(BaseModel):
    """Вариант ответа без поля is_correct — не раскрываем правильные ответы."""
    id: int
    text: str
    model_config = {"from_attributes": True}
 class QuestionForTest(BaseModel):
    id: int
    text: str
    is_multiple: bool  # True = несколько правильных ответов → показываем чекбоксы
    answers: list[AnswerForTest]  # перемешаны случайно
    model_config = {"from_attributes": True}
 class AttemptStarted(BaseModel):
    """Возвращается после старта попытки."""
    id: int
    test_id: int
    test_title: str
    test_description: Optional[str]
    started_at: datetime
    time_limit: Optional[int]          # минуты, из теста
    allow_navigation_back: bool        # из теста
    questions: list[QuestionForTest]   # перемешаны случайно
    model_config = {"from_attributes": True}
 # ── Сдача попытки ────────────────────────────────────────────
 class QuestionAnswer(BaseModel):
    """Ответы сотрудника на один вопрос."""
    question_id: int
    answer_ids: list[int]  # выбранные варианты (может быть пустым)
 class AttemptSubmitDto(BaseModel):
    answers: list[QuestionAnswer]
 # ── Результат ────────────────────────────────────────────────
 class AnswerResult(BaseModel):
    id: int
    text: str
    is_correct: bool    # правильный ли ответ вообще
    is_selected: bool   # выбрал ли его сотрудник
    model_config = {"from_attributes": True}
 class QuestionResult(BaseModel):
    id: int
    text: str
    is_answered_correctly: bool  # вся комбинация ответов верна
    answers: list[AnswerResult]
    model_config = {"from_attributes": True}
 class AttemptResult(BaseModel):
    id: int
    test_id: int
    test_title: str
    started_at: datetime
    finished_at: datetime
    score: float         # процент правильных ответов
    passed: bool         # преодолён ли порог зачёта
    passing_score: int   # порог из теста
    correct_count: int
    total_count: int
    questions: list[QuestionResult]
    model_config = {"from_attributes": True}
@@ -0,0 +1,91 @@
 from datetime import datetime
 from typing import Optional
 from pydantic import BaseModel, Field, field_validator
 class AnswerCreate(BaseModel):
    text: str = Field(min_length=1)
    is_correct: bool
 class AnswerOut(BaseModel):
    id: int
    text: str
    is_correct: bool
    model_config = {"from_attributes": True}
 class QuestionCreate(BaseModel):
    text: str = Field(min_length=1)
    answers: list[AnswerCreate]
    @field_validator("answers")
    @classmethod
    def validate_answers(cls, v: list[AnswerCreate]) -> list[AnswerCreate]:
        if len(v) < 3:
            raise ValueError("Минимум 3 варианта ответа на вопрос")
        if not any(a.is_correct for a in v):
            raise ValueError("Хотя бы один ответ должен быть правильным")
        return v
 class QuestionOut(BaseModel):
    id: int
    text: str
    order: int
    answers: list[AnswerOut]
    model_config = {"from_attributes": True}
 class TestCreate(BaseModel):
    title: str = Field(min_length=1, max_length=255)
    description: Optional[str] = None
    passing_score: int = Field(ge=0, le=100)
    time_limit: Optional[int] = Field(None, ge=1)
    allow_navigation_back: bool = True
    questions: list[QuestionCreate]
    @field_validator("questions")
    @classmethod
    def validate_questions(cls, v: list[QuestionCreate]) -> list[QuestionCreate]:
        if len(v) < 7:
            raise ValueError("Минимум 7 вопросов в тесте")
        return v
 class TestOut(BaseModel):
    id: int
    title: str
    description: Optional[str]
    passing_score: int
    time_limit: Optional[int]
    allow_navigation_back: bool
    is_active: bool
    version: int
    parent_id: Optional[int]
    created_at: datetime
    questions: list[QuestionOut] = []
    model_config = {"from_attributes": True}
 class TestUpdateResponse(BaseModel):
    test: TestOut
    is_new_version: bool
 class TestListItem(BaseModel):
    id: int
    title: str
    description: Optional[str]
    passing_score: int
    time_limit: Optional[int]
    is_active: bool
    version: int
    created_at: datetime
    questions_count: int = 0
    model_config = {"from_attributes": True}
@@ -0,0 +1,13 @@
 #!/bin/bash
 set -e
 echo "Waiting for PostgreSQL..."
 until pg_isready -h db -p 5432 -U qa_user; do
  sleep 1
 done
 echo "Running migrations..."
 alembic upgrade head
 echo "Starting server..."
 exec uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
@@ -0,0 +1,7 @@
 fastapi==0.115.0
 uvicorn[standard]==0.30.6
 sqlalchemy==2.0.35
 asyncpg==0.29.0
 alembic==1.13.3
 pydantic==2.9.2
 pydantic-settings==2.5.2
@@ -0,0 +1,46 @@
 services:
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: qa_test
      POSTGRES_USER: qa_user
      POSTGRES_PASSWORD: qa_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U qa_user -d qa_test"]
      interval: 5s
      timeout: 5s
      retries: 10
  backend:
    build: ./backend
    environment:
      DATABASE_URL: postgresql+asyncpg://qa_user:qa_password@db:5432/qa_test
    depends_on:
      db:
        condition: service_healthy
    volumes:
      - ./backend:/app
  frontend:
    build: ./frontend
    volumes:
      - ./frontend/src:/app/src
      - ./frontend/index.html:/app/index.html
    depends_on:
      - backend
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - backend
      - frontend
 volumes:
  postgres_data:
@@ -0,0 +1,12 @@
 FROM node:20-alpine
 WORKDIR /app
 COPY package*.json ./
 RUN npm install
 COPY . .
 EXPOSE 5173
 CMD ["npm", "run", "dev", "--", "--host", "0.0.0.0"]
@@ -0,0 +1,12 @@
 <!doctype html>
 <html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>QA Test App</title>
  </head>
  <body>
    <div id="root"></div>
    <script type="module" src="/src/main.tsx"></script>
  </body>
 </html>
@@ -0,0 +1,26 @@
 {
  "name": "qa-test-frontend",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "tsc && vite build",
    "preview": "vite preview"
  },
  "dependencies": {
    "@ant-design/icons": "^5.4.0",
    "@tanstack/react-query": "^5.59.0",
    "antd": "^5.21.0",
    "axios": "^1.7.7",
    "react": "^18.3.1",
    "react-dom": "^18.3.1",
    "react-router-dom": "^6.27.0"
  },
  "devDependencies": {
    "@types/react": "^18.3.11",
    "@types/react-dom": "^18.3.1",
    "@vitejs/plugin-react": "^4.3.2",
    "typescript": "^5.6.3",
    "vite": "^5.4.8"
  }
 }
@@ -0,0 +1,32 @@
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
 import { ConfigProvider } from 'antd'
 import ruRU from 'antd/locale/ru_RU'
 import { BrowserRouter, Route, Routes } from 'react-router-dom'
 import AttemptResult from './pages/AttemptResult'
 import TestCreate from './pages/TestCreate'
 import TestDetail from './pages/TestDetail'
 import TestEdit from './pages/TestEdit'
 import TestList from './pages/TestList'
 import TestTake from './pages/TestTake'
 const queryClient = new QueryClient()
 export default function App() {
  return (
    <QueryClientProvider client={queryClient}>
      <ConfigProvider locale={ruRU}>
        <BrowserRouter>
          <Routes>
            <Route path="/" element={<TestList />} />
            <Route path="/tests/create" element={<TestCreate />} />
            <Route path="/tests/:id" element={<TestDetail />} />
            <Route path="/tests/:id/edit" element={<TestEdit />} />
            <Route path="/tests/:testId/take" element={<TestTake />} />
            <Route path="/attempts/:attemptId/result" element={<AttemptResult />} />
          </Routes>
        </BrowserRouter>
      </ConfigProvider>
    </QueryClientProvider>
  )
 }
@@ -0,0 +1,68 @@
 import client from './client'
 export interface AnswerForTest {
  id: number
  text: string
 }
 export interface QuestionForTest {
  id: number
  text: string
  is_multiple: boolean   // true → показываем чекбоксы, false → радио-кнопки
  answers: AnswerForTest[]
 }
 export interface AttemptStarted {
  id: number
  test_id: number
  test_title: string
  test_description: string | null
  started_at: string
  time_limit: number | null   // минуты
  allow_navigation_back: boolean
  questions: QuestionForTest[]
 }
 export interface QuestionAnswer {
  question_id: number
  answer_ids: number[]
 }
 export interface AnswerResult {
  id: number
  text: string
  is_correct: boolean
  is_selected: boolean
 }
 export interface QuestionResult {
  id: number
  text: string
  is_answered_correctly: boolean
  answers: AnswerResult[]
 }
 export interface AttemptResult {
  id: number
  test_id: number
  test_title: string
  started_at: string
  finished_at: string
  score: number
  passed: boolean
  passing_score: number
  correct_count: number
  total_count: number
  questions: QuestionResult[]
 }
 export const attemptsApi = {
  start: (test_id: number) =>
    client.post<AttemptStarted>('/attempts', { test_id }),
  submit: (attempt_id: number, answers: QuestionAnswer[]) =>
    client.post<AttemptResult>(`/attempts/${attempt_id}/submit`, { answers }),
  getResult: (attempt_id: number) =>
    client.get<AttemptResult>(`/attempts/${attempt_id}/result`),
 }
@@ -0,0 +1,7 @@
 import axios from 'axios'
 const client = axios.create({
  baseURL: '/api',
 })
 export default client
@@ -0,0 +1,74 @@
 import client from './client'
 export interface Answer {
  id: number
  text: string
  is_correct: boolean
 }
 export interface Question {
  id: number
  text: string
  order: number
  answers: Answer[]
 }
 export interface Test {
  id: number
  title: string
  description: string | null
  passing_score: number
  time_limit: number | null
  allow_navigation_back: boolean
  is_active: boolean
  version: number
  parent_id: number | null
  created_at: string
  questions: Question[]
 }
 export interface UpdateTestResponse {
  test: Test
  is_new_version: boolean
 }
 export interface TestListItem {
  id: number
  title: string
  description: string | null
  passing_score: number
  time_limit: number | null
  is_active: boolean
  version: number
  created_at: string
  questions_count: number
 }
 export interface CreateAnswerDto {
  text: string
  is_correct: boolean
 }
 export interface CreateQuestionDto {
  text: string
  answers: CreateAnswerDto[]
 }
 export interface CreateTestDto {
  title: string
  description?: string
  passing_score: number
  time_limit?: number
  allow_navigation_back: boolean
  questions: CreateQuestionDto[]
 }
 export const testsApi = {
  list: () => client.get<TestListItem[]>('/tests'),
  get: (id: number) => client.get<Test>(`/tests/${id}`),
  create: (data: CreateTestDto) => client.post<Test>('/tests', data),
  update: (id: number, data: CreateTestDto) =>
    client.put<UpdateTestResponse>(`/tests/${id}`, data),
  versions: (id: number) => client.get<TestListItem[]>(`/tests/${id}/versions`),
  activate: (id: number) => client.post<Test>(`/tests/${id}/activate`),
 }
@@ -0,0 +1,268 @@
 import { ArrowLeftOutlined, MinusCircleOutlined, PlusOutlined } from '@ant-design/icons'
 import {
  Button,
  Card,
  Checkbox,
  Form,
  Input,
  InputNumber,
  Space,
  Switch,
  Typography,
 } from 'antd'
 const { Title } = Typography
 const EMPTY_ANSWER = { text: '', is_correct: false }
 const EMPTY_QUESTION = { text: '', answers: [EMPTY_ANSWER, EMPTY_ANSWER, EMPTY_ANSWER] }
 export interface TestFormValues {
  title: string
  description?: string
  passing_score: number
  has_timer: boolean
  time_limit?: number
  allow_navigation_back: boolean
  questions: { text: string; answers: { text: string; is_correct: boolean }[] }[]
 }
 interface TestFormProps {
  heading: string
  initialValues?: Partial<TestFormValues>
  onSubmit: (values: TestFormValues) => void
  isPending: boolean
  submitLabel: string
  onCancel: () => void
  onBack?: () => void
  backLabel?: string
 }
 export default function TestForm({
  heading,
  initialValues,
  onSubmit,
  isPending,
  submitLabel,
  onCancel,
  onBack,
  backLabel = 'Назад',
 }: TestFormProps) {
  const [form] = Form.useForm<TestFormValues>()
  const defaultValues: Partial<TestFormValues> = {
    allow_navigation_back: true,
    has_timer: false,
    passing_score: 70,
    questions: Array(7).fill(null).map(() => ({ ...EMPTY_QUESTION })),
    ...initialValues,
  }
  return (
    <div style={{ maxWidth: 820, margin: '0 auto', padding: 24 }}>
      {onBack && (
        <Button
          icon={<ArrowLeftOutlined />}
          onClick={onBack}
          style={{ marginBottom: 16 }}
        >
          {backLabel}
        </Button>
      )}
      <Title level={2}>{heading}</Title>
      <Form form={form} layout="vertical" onFinish={onSubmit} initialValues={defaultValues}>
        {/* ── Основные настройки ── */}
        <Card title="Основные настройки" style={{ marginBottom: 16 }}>
          <Form.Item
            name="title"
            label="Название теста"
            rules={[{ required: true, message: 'Введите название теста' }]}
          >
            <Input placeholder="Например: Пожарная безопасность 2026" />
          </Form.Item>
          <Form.Item name="description" label="Описание (необязательно)">
            <Input.TextArea rows={2} placeholder="Краткое описание теста" />
          </Form.Item>
          <Form.Item
            name="passing_score"
            label="Порог зачёта"
            rules={[{ required: true, message: 'Укажите порог' }]}
          >
            <InputNumber min={0} max={100} addonAfter="%" style={{ width: 140 }} />
          </Form.Item>
          <Form.Item label="Ограничение по времени">
            <Space align="center">
              <Form.Item name="has_timer" valuePropName="checked" noStyle>
                <Switch />
              </Form.Item>
              <Form.Item
                noStyle
                shouldUpdate={(prev, cur) => prev.has_timer !== cur.has_timer}
              >
                {({ getFieldValue }) =>
                  getFieldValue('has_timer') ? (
                    <Form.Item
                      name="time_limit"
                      noStyle
                      rules={[{ required: true, message: 'Укажите время' }]}
                    >
                      <InputNumber min={1} addonAfter="мин" style={{ width: 150 }} />
                    </Form.Item>
                  ) : (
                    <span style={{ color: '#999' }}>без ограничения</span>
                  )
                }
              </Form.Item>
            </Space>
          </Form.Item>
          <Form.Item
            name="allow_navigation_back"
            label="Разрешить возврат к предыдущему вопросу"
            valuePropName="checked"
          >
            <Switch />
          </Form.Item>
        </Card>
        {/* ── Вопросы ── */}
        <Form.List
          name="questions"
          rules={[
            {
              validator: async (_, questions) => {
                if (!questions || questions.length < 7) {
                  return Promise.reject(new Error('Минимум 7 вопросов'))
                }
              },
            },
          ]}
        >
          {(questionFields, { add: addQuestion, remove: removeQuestion }, { errors }) => (
            <>
              {questionFields.map(({ key, name: qName }, index) => (
                <Card
                  key={key}
                  title={`Вопрос ${index + 1}`}
                  extra={
                    questionFields.length > 7 ? (
                      <MinusCircleOutlined
                        style={{ color: '#ff4d4f', fontSize: 16 }}
                        onClick={() => removeQuestion(qName)}
                      />
                    ) : null
                  }
                  style={{ marginBottom: 16 }}
                >
                  <Form.Item
                    name={[qName, 'text']}
                    rules={[{ required: true, message: 'Введите текст вопроса' }]}
                  >
                    <Input.TextArea rows={2} placeholder="Текст вопроса" />
                  </Form.Item>
                  <Form.List
                    name={[qName, 'answers']}
                    rules={[
                      {
                        validator: async (_, answers) => {
                          if (!answers || answers.length < 3) {
                            return Promise.reject(new Error('Минимум 3 варианта ответа'))
                          }
                          if (!answers.some((a: { is_correct: boolean }) => a?.is_correct)) {
                            return Promise.reject(
                              new Error('Отметьте хотя бы один правильный ответ'),
                            )
                          }
                        },
                      },
                    ]}
                  >
                    {(
                      answerFields,
                      { add: addAnswer, remove: removeAnswer },
                      { errors: answerErrors },
                    ) => (
                      <>
                        {answerFields.map(({ key: ak, name: aName }) => (
                          <Space
                            key={ak}
                            style={{ display: 'flex', marginBottom: 8 }}
                            align="start"
                          >
                            <Form.Item
                              name={[aName, 'is_correct']}
                              valuePropName="checked"
                              initialValue={false}
                              style={{ marginBottom: 0 }}
                            >
                              <Checkbox />
                            </Form.Item>
                            <Form.Item
                              name={[aName, 'text']}
                              rules={[{ required: true, message: 'Введите вариант ответа' }]}
                              style={{ marginBottom: 0, flex: 1 }}
                            >
                              <Input placeholder="Вариант ответа" style={{ width: 440 }} />
                            </Form.Item>
                            {answerFields.length > 3 && (
                              <MinusCircleOutlined
                                style={{ color: '#ff4d4f' }}
                                onClick={() => removeAnswer(aName)}
                              />
                            )}
                          </Space>
                        ))}
                        <Form.ErrorList errors={answerErrors} />
                        <Button
                          type="dashed"
                          size="small"
                          icon={<PlusOutlined />}
                          onClick={() => addAnswer({ text: '', is_correct: false })}
                          style={{ marginTop: 4 }}
                        >
                          Добавить вариант
                        </Button>
                      </>
                    )}
                  </Form.List>
                </Card>
              ))}
              <Form.ErrorList errors={errors} />
              <Button
                type="dashed"
                block
                icon={<PlusOutlined />}
                style={{ marginBottom: 24 }}
                onClick={() =>
                  addQuestion({ text: '', answers: [EMPTY_ANSWER, EMPTY_ANSWER, EMPTY_ANSWER] })
                }
              >
                Добавить вопрос
              </Button>
            </>
          )}
        </Form.List>
        <Form.Item>
          <Space>
            <Button type="primary" htmlType="submit" loading={isPending}>
              {submitLabel}
            </Button>
            <Button onClick={onCancel}>Отмена</Button>
          </Space>
        </Form.Item>
      </Form>
    </div>
  )
 }
@@ -0,0 +1,8 @@
 * {
  box-sizing: border-box;
 }
 body {
  margin: 0;
  background: #f5f5f5;
 }
@@ -0,0 +1,10 @@
 import React from 'react'
 import ReactDOM from 'react-dom/client'
 import App from './App'
 import './index.css'
 ReactDOM.createRoot(document.getElementById('root')!).render(
  <React.StrictMode>
    <App />
  </React.StrictMode>,
 )
@@ -0,0 +1,153 @@
 import {
  CheckCircleTwoTone,
  CloseCircleTwoTone,
  MinusCircleOutlined,
  TrophyOutlined,
 } from '@ant-design/icons'
 import { useQuery } from '@tanstack/react-query'
 import { Button, Card, Col, Divider, List, Result, Row, Space, Spin, Tag, Typography } from 'antd'
 import { useNavigate, useParams } from 'react-router-dom'
 import { AnswerResult, attemptsApi } from '../../api/attempts'
 const { Title, Text } = Typography
 export default function AttemptResult() {
  const { attemptId } = useParams<{ attemptId: string }>()
  const navigate = useNavigate()
  const { data: result, isLoading } = useQuery({
    queryKey: ['attempts', attemptId, 'result'],
    queryFn: () => attemptsApi.getResult(Number(attemptId)).then((r) => r.data),
  })
  if (isLoading) return <Spin size="large" style={{ display: 'block', margin: '48px auto' }} />
  if (!result) return null
  const duration = Math.round(
    (new Date(result.finished_at).getTime() - new Date(result.started_at).getTime()) / 1000,
  )
  const minutes = Math.floor(duration / 60)
  const seconds = duration % 60
  return (
    <div style={{ maxWidth: 800, margin: '0 auto', padding: 24 }}>
      {/* Итог */}
      <Result
        icon={
          result.passed ? (
            <TrophyOutlined style={{ color: '#52c41a' }} />
          ) : (
            <CloseCircleTwoTone twoToneColor="#ff4d4f" />
          )
        }
        status={result.passed ? 'success' : 'error'}
        title={result.passed ? 'Тест сдан!' : 'Тест не сдан'}
        subTitle={result.test_title}
      />
      {/* Статистика */}
      <Card style={{ marginBottom: 24 }}>
        <Row gutter={32} justify="center" style={{ textAlign: 'center' }}>
          <Col>
            <Title level={1} style={{ margin: 0, color: result.passed ? '#52c41a' : '#ff4d4f' }}>
              {result.score}%
            </Title>
            <Text type="secondary">Результат</Text>
          </Col>
          <Col>
            <Title level={1} style={{ margin: 0 }}>
              {result.correct_count}/{result.total_count}
            </Title>
            <Text type="secondary">Правильных ответов</Text>
          </Col>
          <Col>
            <Title level={1} style={{ margin: 0 }}>
              {result.passing_score}%
            </Title>
            <Text type="secondary">Порог зачёта</Text>
          </Col>
          <Col>
            <Title level={1} style={{ margin: 0 }}>
              {minutes > 0 ? `${minutes}м ` : ''}{seconds}с
            </Title>
            <Text type="secondary">Время</Text>
          </Col>
        </Row>
      </Card>
      {/* Разбор ошибок */}
      <Title level={3}>Разбор ответов</Title>
      {result.questions.map((question, index) => (
        <Card
          key={question.id}
          style={{
            marginBottom: 12,
            borderColor: question.is_answered_correctly ? '#b7eb8f' : '#ffccc7',
          }}
          title={
            <Space>
              {question.is_answered_correctly ? (
                <CheckCircleTwoTone twoToneColor="#52c41a" />
              ) : (
                <CloseCircleTwoTone twoToneColor="#ff4d4f" />
              )}
              <Text strong>
                {index + 1}. {question.text}
              </Text>
            </Space>
          }
        >
          <List
            dataSource={question.answers}
            renderItem={(answer: AnswerResult) => {
              const icon = answer.is_correct ? (
                <CheckCircleTwoTone twoToneColor="#52c41a" />
              ) : answer.is_selected ? (
                <CloseCircleTwoTone twoToneColor="#ff4d4f" />
              ) : (
                <MinusCircleOutlined style={{ color: '#d9d9d9' }} />
              )
              return (
                <List.Item style={{ padding: '4px 0' }}>
                  <Space>
                    {icon}
                    <Text
                      style={{
                        fontWeight: answer.is_correct ? 600 : 400,
                        color: answer.is_selected && !answer.is_correct ? '#ff4d4f' : undefined,
                      }}
                    >
                      {answer.text}
                    </Text>
                    {answer.is_selected && answer.is_correct && (
                      <Tag color="green">ваш ответ ✓</Tag>
                    )}
                    {answer.is_selected && !answer.is_correct && (
                      <Tag color="red">ваш ответ ✗</Tag>
                    )}
                    {!answer.is_selected && answer.is_correct && (
                      <Tag color="green">правильный ответ</Tag>
                    )}
                  </Space>
                </List.Item>
              )
            }}
          />
        </Card>
      ))}
      <Divider />
      <Space>
        <Button onClick={() => navigate('/')}>К списку тестов</Button>
        <Button type="primary" onClick={() => navigate(`/tests/${result.test_id}`)}>
          Страница теста
        </Button>
      </Space>
    </div>
  )
 }
@@ -0,0 +1,45 @@
 import { useMutation, useQueryClient } from '@tanstack/react-query'
 import { message } from 'antd'
 import { useNavigate } from 'react-router-dom'
 import { CreateTestDto, testsApi } from '../../api/tests'
 import TestForm, { TestFormValues } from '../../components/TestForm'
 export default function TestCreate() {
  const navigate = useNavigate()
  const queryClient = useQueryClient()
  const { mutate: createTest, isPending } = useMutation({
    mutationFn: (data: CreateTestDto) => testsApi.create(data).then((r) => r.data),
    onSuccess: (test) => {
      queryClient.invalidateQueries({ queryKey: ['tests'] })
      message.success('Тест успешно создан')
      navigate(`/tests/${test.id}`)
    },
    onError: (error: unknown) => {
      const err = error as { response?: { data?: { detail?: string } } }
      message.error(err.response?.data?.detail || 'Ошибка при создании теста')
    },
  })
  const onSubmit = (values: TestFormValues) => {
    createTest({
      title: values.title,
      description: values.description,
      passing_score: values.passing_score,
      time_limit: values.has_timer ? values.time_limit : undefined,
      allow_navigation_back: values.allow_navigation_back ?? true,
      questions: values.questions,
    })
  }
  return (
    <TestForm
      heading="Создание теста"
      onSubmit={onSubmit}
      isPending={isPending}
      submitLabel="Создать тест"
      onCancel={() => navigate('/')}
    />
  )
 }
@@ -0,0 +1,89 @@
 import { ArrowLeftOutlined, PlayCircleOutlined } from '@ant-design/icons'
 import { useQuery } from '@tanstack/react-query'
 import { Button, Card, Descriptions, List, Space, Spin, Tag, Typography } from 'antd'
 import { useNavigate, useParams } from 'react-router-dom'
 import { Answer, testsApi } from '../../api/tests'
 const { Title, Text } = Typography
 export default function TestDetail() {
  const { id } = useParams<{ id: string }>()
  const navigate = useNavigate()
  const { data: test, isLoading } = useQuery({
    queryKey: ['tests', id],
    queryFn: () => testsApi.get(Number(id)).then((r) => r.data),
  })
  if (isLoading) {
    return <Spin size="large" style={{ display: 'block', margin: '48px auto' }} />
  }
  if (!test) return null
  return (
    <div style={{ maxWidth: 820, margin: '0 auto', padding: 24 }}>
      <Space style={{ width: '100%', justifyContent: 'space-between', marginBottom: 16 }}>
        <Button icon={<ArrowLeftOutlined />} onClick={() => navigate('/')}>
          К списку тестов
        </Button>
        <Button
          type="primary"
          icon={<PlayCircleOutlined />}
          onClick={() => navigate(`/tests/${test.id}/take`)}
        >
          Пройти тест
        </Button>
      </Space>
      <Title level={2}>{test.title}</Title>
      {test.description && (
        <Text type="secondary" style={{ display: 'block', marginBottom: 16 }}>
          {test.description}
        </Text>
      )}
      <Card style={{ marginBottom: 24 }}>
        <Descriptions column={3}>
          <Descriptions.Item label="Вопросов">{test.questions.length}</Descriptions.Item>
          <Descriptions.Item label="Порог зачёта">{test.passing_score}%</Descriptions.Item>
          <Descriptions.Item label="Таймер">
            {test.time_limit ? `${test.time_limit} мин` : 'Без ограничений'}
          </Descriptions.Item>
          <Descriptions.Item label="Возврат к вопросу">
            {test.allow_navigation_back ? (
              <Tag color="green">Разрешён</Tag>
            ) : (
              <Tag color="red">Запрещён</Tag>
            )}
          </Descriptions.Item>
          <Descriptions.Item label="Версия">{test.version}</Descriptions.Item>
          <Descriptions.Item label="Создан">
            {new Date(test.created_at).toLocaleDateString('ru-RU')}
          </Descriptions.Item>
        </Descriptions>
      </Card>
      <Title level={3}>Вопросы ({test.questions.length})</Title>
      {test.questions.map((question, index) => (
        <Card key={question.id} style={{ marginBottom: 12 }}>
          <Text strong>
            {index + 1}. {question.text}
          </Text>
          <List
            style={{ marginTop: 10 }}
            dataSource={question.answers}
            renderItem={(answer: Answer) => (
              <List.Item style={{ padding: '4px 0' }}>
                <Text>{answer.text}</Text>
              </List.Item>
            )}
          />
        </Card>
      ))}
    </div>
  )
 }
@@ -0,0 +1,285 @@
 import {
  ArrowLeftOutlined,
  CheckCircleTwoTone,
  CloseCircleTwoTone,
  EditOutlined,
  PlayCircleOutlined,
 } from '@ant-design/icons'
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
 import { Alert, Button, Card, Descriptions, List, Space, Spin, Table, Tag, Typography, message } from 'antd'
 import type { ColumnsType } from 'antd/es/table'
 import { useState } from 'react'
 import { useNavigate, useParams } from 'react-router-dom'
 import { Answer, CreateTestDto, TestListItem, testsApi } from '../../api/tests'
 import TestForm, { TestFormValues } from '../../components/TestForm'
 const { Title, Text } = Typography
 export default function TestEdit() {
  const { id } = useParams<{ id: string }>()
  const navigate = useNavigate()
  const queryClient = useQueryClient()
  const [editMode, setEditMode] = useState(false)
  const { data: test, isLoading } = useQuery({
    queryKey: ['tests', id],
    queryFn: () => testsApi.get(Number(id)).then((r) => r.data),
  })
  const { data: versions = [] } = useQuery({
    queryKey: ['tests', id, 'versions'],
    queryFn: () => testsApi.versions(Number(id)).then((r) => r.data),
    enabled: !editMode,
  })
  const { mutate: activateVersion, isPending: isActivating } = useMutation({
    mutationFn: (versionId: number) => testsApi.activate(versionId).then((r) => r.data),
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['tests'] })
      queryClient.invalidateQueries({ queryKey: ['tests', id, 'versions'] })
      queryClient.invalidateQueries({ queryKey: ['tests', id] })
      message.success('Активная версия изменена')
    },
    onError: () => message.error('Не удалось изменить активную версию'),
  })
  const { mutate: updateTest, isPending } = useMutation({
    mutationFn: (data: CreateTestDto) => testsApi.update(Number(id), data).then((r) => r.data),
    onSuccess: (result) => {
      queryClient.invalidateQueries({ queryKey: ['tests'] })
      if (result.is_new_version) {
        message.success(`Создана новая версия теста (v${result.test.version})`)
        navigate(`/tests/${result.test.id}/edit`)
      } else {
        message.success('Тест обновлён')
        queryClient.invalidateQueries({ queryKey: ['tests', id] })
        setEditMode(false)
      }
    },
    onError: (error: unknown) => {
      const err = error as { response?: { data?: { detail?: string } } }
      message.error(err.response?.data?.detail || 'Ошибка при сохранении теста')
    },
  })
  if (isLoading) {
    return <Spin size="large" style={{ display: 'block', margin: '48px auto' }} />
  }
  if (!test) return null
  // Режим редактирования — показываем форму с предзаполненными данными
  if (editMode) {
    const initialValues: TestFormValues = {
      title: test.title,
      description: test.description ?? undefined,
      passing_score: test.passing_score,
      has_timer: test.time_limit !== null,
      time_limit: test.time_limit ?? undefined,
      allow_navigation_back: test.allow_navigation_back,
      questions: test.questions.map((q) => ({
        text: q.text,
        answers: q.answers.map((a) => ({ text: a.text, is_correct: a.is_correct })),
      })),
    }
    const onSubmit = (values: TestFormValues) => {
      updateTest({
        title: values.title,
        description: values.description,
        passing_score: values.passing_score,
        time_limit: values.has_timer ? values.time_limit : undefined,
        allow_navigation_back: values.allow_navigation_back ?? true,
        questions: values.questions,
      })
    }
    return (
      <TestForm
        heading={`Редактирование теста — v${test.version}`}
        initialValues={initialValues}
        onSubmit={onSubmit}
        isPending={isPending}
        submitLabel="Сохранить"
        onCancel={() => setEditMode(false)}
        onBack={() => setEditMode(false)}
        backLabel="К просмотру теста"
      />
    )
  }
  // Режим просмотра (вид автора)
  return (
    <div style={{ maxWidth: 820, margin: '0 auto', padding: 24 }}>
      <Space style={{ width: '100%', justifyContent: 'space-between', marginBottom: 16 }}>
        <Button icon={<ArrowLeftOutlined />} onClick={() => navigate('/')}>
          К списку тестов
        </Button>
        <Space>
          {versions.length > 1 && (!test.is_active || versions.some(v => v.id !== test.id && v.is_active)) && (
            <Button
              loading={isActivating}
              onClick={() => activateVersion(test.id)}
            >
              Сделать активной
            </Button>
          )}
          <Button
            icon={<EditOutlined />}
            onClick={() => setEditMode(true)}
          >
            Редактировать
          </Button>
          <Button
            type="primary"
            icon={<PlayCircleOutlined />}
            onClick={() => navigate(`/tests/${test.id}/take`)}
          >
            Пройти тест
          </Button>
        </Space>
      </Space>
      <Alert
        type="warning"
        showIcon
        message="Вид автора — правильные ответы отмечены"
        style={{ marginBottom: 16 }}
      />
      <Title level={2}>{test.title}</Title>
      {test.description && (
        <Text type="secondary" style={{ display: 'block', marginBottom: 16 }}>
          {test.description}
        </Text>
      )}
      <Card style={{ marginBottom: 24 }}>
        <Descriptions column={3}>
          <Descriptions.Item label="Вопросов">{test.questions.length}</Descriptions.Item>
          <Descriptions.Item label="Порог зачёта">{test.passing_score}%</Descriptions.Item>
          <Descriptions.Item label="Таймер">
            {test.time_limit ? `${test.time_limit} мин` : 'Без ограничений'}
          </Descriptions.Item>
          <Descriptions.Item label="Возврат к вопросу">
            {test.allow_navigation_back ? (
              <Tag color="green">Разрешён</Tag>
            ) : (
              <Tag color="red">Запрещён</Tag>
            )}
          </Descriptions.Item>
          <Descriptions.Item label="Версия">{test.version}</Descriptions.Item>
          <Descriptions.Item label="Создан">
            {new Date(test.created_at).toLocaleDateString('ru-RU')}
          </Descriptions.Item>
        </Descriptions>
      </Card>
      {versions.length > 1 && (
        <>
          <Title level={3}>История версий</Title>
          <Table<TestListItem>
            dataSource={versions}
            rowKey="id"
            size="small"
            pagination={false}
            style={{ marginBottom: 24 }}
            rowClassName={(record) => (record.id === test.id ? 'ant-table-row-selected' : '')}
            columns={
              [
                {
                  title: 'Версия',
                  dataIndex: 'version',
                  width: 70,
                  render: (v: number) => <Tag color="default">v{v}</Tag>,
                },
                {
                  title: 'Статус',
                  dataIndex: 'is_active',
                  width: 130,
                  render: (active: boolean) =>
                    active ? (
                      <Tag color="green">Активная</Tag>
                    ) : (
                      <Tag color="default">Неактивная</Tag>
                    ),
                },
                {
                  title: 'Дата',
                  dataIndex: 'created_at',
                  width: 120,
                  render: (d: string) => new Date(d).toLocaleDateString('ru-RU'),
                },
                {
                  title: 'Вопросов',
                  dataIndex: 'questions_count',
                  width: 100,
                  align: 'center' as const,
                },
                {
                  title: 'Порог зачёта',
                  dataIndex: 'passing_score',
                  width: 120,
                  align: 'center' as const,
                  render: (s: number) => `${s}%`,
                },
                {
                  title: '',
                  key: 'action',
                  render: (_: unknown, record: TestListItem) => (
                    <Space>
                      {record.id !== test.id && (
                        <Button size="small" onClick={() => navigate(`/tests/${record.id}/edit`)}>
                          Открыть
                        </Button>
                      )}
                      {(record.id !== test.id || !record.is_active) && (
                        <Button
                          size="small"
                          type={record.is_active ? 'default' : 'primary'}
                          loading={isActivating}
                          onClick={() => activateVersion(record.id)}
                        >
                          Сделать активной
                        </Button>
                      )}
                    </Space>
                  ),
                },
              ] as ColumnsType<TestListItem>
            }
          />
        </>
      )}
      <Title level={3}>Вопросы ({test.questions.length})</Title>
      {test.questions.map((question, index) => (
        <Card key={question.id} style={{ marginBottom: 12 }}>
          <Text strong>
            {index + 1}. {question.text}
          </Text>
          <List
            style={{ marginTop: 10 }}
            dataSource={question.answers}
            renderItem={(answer: Answer) => (
              <List.Item style={{ padding: '4px 0' }}>
                <Space>
                  {answer.is_correct ? (
                    <CheckCircleTwoTone twoToneColor="#52c41a" />
                  ) : (
                    <CloseCircleTwoTone twoToneColor="#d9d9d9" />
                  )}
                  <Text>{answer.text}</Text>
                </Space>
              </List.Item>
            )}
          />
        </Card>
      ))}
    </div>
  )
 }
@@ -0,0 +1,123 @@
 import { EditOutlined, MoreOutlined, PlayCircleOutlined, PlusOutlined } from '@ant-design/icons'
 import { useQuery } from '@tanstack/react-query'
 import { Button, Dropdown, Spin, Table, Typography } from 'antd'
 import type { ColumnsType } from 'antd/es/table'
 import { useNavigate } from 'react-router-dom'
 import { TestListItem, testsApi } from '../../api/tests'
 const { Title } = Typography
 export default function TestList() {
  const navigate = useNavigate()
  const { data: tests = [], isLoading } = useQuery({
    queryKey: ['tests'],
    queryFn: () => testsApi.list().then((r) => r.data),
  })
  const columns: ColumnsType<TestListItem> = [
    {
      title: 'Название',
      dataIndex: 'title',
      key: 'title',
      render: (text: string, record: TestListItem) => (
        <a onClick={() => navigate(`/tests/${record.id}`)}>{text}</a>
      ),
    },
    {
      title: 'Вопросов',
      dataIndex: 'questions_count',
      key: 'questions_count',
      width: 100,
      align: 'center',
    },
    {
      title: 'Порог зачёта',
      dataIndex: 'passing_score',
      key: 'passing_score',
      width: 130,
      align: 'center',
      render: (score: number) => `${score}%`,
    },
    {
      title: 'Таймер',
      dataIndex: 'time_limit',
      key: 'time_limit',
      width: 110,
      align: 'center',
      render: (limit: number | null) => (limit ? `${limit} мин` : '—'),
    },
    {
      title: 'Создан',
      dataIndex: 'created_at',
      key: 'created_at',
      width: 130,
      render: (date: string) => new Date(date).toLocaleDateString('ru-RU'),
    },
    {
      title: '',
      key: 'actions',
      width: 60,
      align: 'center',
      render: (_: unknown, record: TestListItem) => (
        <Dropdown
          menu={{
            items: [
              {
                key: 'open',
                label: 'Открыть',
                onClick: () => navigate(`/tests/${record.id}`),
              },
              {
                key: 'edit',
                icon: <EditOutlined />,
                label: 'Изменить',
                onClick: () => navigate(`/tests/${record.id}/edit`),
              },
              { type: 'divider' },
              {
                key: 'take',
                icon: <PlayCircleOutlined />,
                label: 'Пройти тест',
                onClick: () => navigate(`/tests/${record.id}/take`),
              },
            ],
          }}
          trigger={['click']}
        >
          <Button size="small" icon={<MoreOutlined />} />
        </Dropdown>
      ),
    },
  ]
  if (isLoading) {
    return <Spin size="large" style={{ display: 'block', margin: '48px auto' }} />
  }
  return (
    <div style={{ maxWidth: 1000, margin: '0 auto', padding: 24 }}>
      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 16 }}>
        <Title level={2} style={{ margin: 0 }}>
          Тесты
        </Title>
        <Button
          type="primary"
          icon={<PlusOutlined />}
          onClick={() => navigate('/tests/create')}
        >
          Создать тест
        </Button>
      </div>
      <Table
        dataSource={tests}
        columns={columns}
        rowKey="id"
        locale={{ emptyText: 'Тестов пока нет. Создайте первый!' }}
        pagination={{ pageSize: 20 }}
      />
    </div>
  )
 }
@@ -0,0 +1,225 @@
 import { useEffect, useRef, useState } from 'react'
 import { useNavigate, useParams } from 'react-router-dom'
 import {
  Alert,
  Button,
  Card,
  Checkbox,
  Progress,
  Radio,
  Space,
  Spin,
  Tag,
  Typography,
  message,
 } from 'antd'
 import { ArrowLeftOutlined, ArrowRightOutlined, SendOutlined } from '@ant-design/icons'
 import { AttemptStarted, QuestionAnswer, attemptsApi } from '../../api/attempts'
 const { Title, Text } = Typography
 export default function TestTake() {
  const { testId } = useParams<{ testId: string }>()
  const navigate = useNavigate()
  const [attempt, setAttempt] = useState<AttemptStarted | null>(null)
  const [loading, setLoading] = useState(true)
  const [submitting, setSubmitting] = useState(false)
  const [currentIndex, setCurrentIndex] = useState(0)
  // answers: questionId → выбранные answerId[]
  const [answers, setAnswers] = useState<Map<number, number[]>>(new Map())
  const [timeLeft, setTimeLeft] = useState<number | null>(null)
  const timerRef = useRef<ReturnType<typeof setInterval> | null>(null)
  // Стартуем попытку при монтировании
  useEffect(() => {
    attemptsApi
      .start(Number(testId))
      .then((r) => {
        setAttempt(r.data)
        if (r.data.time_limit) {
          setTimeLeft(r.data.time_limit * 60)
        }
      })
      .catch(() => message.error('Не удалось загрузить тест'))
      .finally(() => setLoading(false))
  }, [testId])
  // Таймер
  useEffect(() => {
    if (timeLeft === null) return
    timerRef.current = setInterval(() => {
      setTimeLeft((prev) => {
        if (prev === null || prev <= 1) {
          clearInterval(timerRef.current!)
          handleSubmit()
          return 0
        }
        return prev - 1
      })
    }, 1000)
    return () => clearInterval(timerRef.current!)
  }, [timeLeft !== null]) // запускаем один раз когда timeLeft появился
  const handleSubmit = async () => {
    if (!attempt || submitting) return
    clearInterval(timerRef.current!)
    setSubmitting(true)
    const payload: QuestionAnswer[] = attempt.questions.map((q) => ({
      question_id: q.id,
      answer_ids: answers.get(q.id) ?? [],
    }))
    try {
      await attemptsApi.submit(attempt.id, payload)
      navigate(`/attempts/${attempt.id}/result`)
    } catch {
      message.error('Ошибка при отправке теста')
      setSubmitting(false)
    }
  }
  const handleAnswer = (questionId: number, answerId: number, isMultiple: boolean) => {
    setAnswers((prev) => {
      const next = new Map(prev)
      if (isMultiple) {
        const current = next.get(questionId) ?? []
        next.set(
          questionId,
          current.includes(answerId)
            ? current.filter((id) => id !== answerId)
            : [...current, answerId],
        )
      } else {
        next.set(questionId, [answerId])
      }
      return next
    })
  }
  const formatTime = (seconds: number) => {
    const m = Math.floor(seconds / 60)
    const s = seconds % 60
    return `${m}:${s.toString().padStart(2, '0')}`
  }
  if (loading) return <Spin size="large" style={{ display: 'block', margin: '48px auto' }} />
  if (!attempt) return null
  const question = attempt.questions[currentIndex]
  const selectedIds = answers.get(question.id) ?? []
  const total = attempt.questions.length
  const isLast = currentIndex === total - 1
  const isTimeCritical = timeLeft !== null && timeLeft < 60
  return (
    <div style={{ maxWidth: 720, margin: '0 auto', padding: 24 }}>
      {/* Шапка */}
      <Space style={{ width: '100%', justifyContent: 'space-between', marginBottom: 16 }}>
        <Title level={3} style={{ margin: 0 }}>
          {attempt.test_title}
        </Title>
        {timeLeft !== null && (
          <Tag color={isTimeCritical ? 'red' : 'blue'} style={{ fontSize: 16, padding: '4px 12px' }}>
            ⏱ {formatTime(timeLeft)}
          </Tag>
        )}
      </Space>
      {/* Прогресс */}
      <Progress
        percent={Math.round(((currentIndex + 1) / total) * 100)}
        format={() => `${currentIndex + 1} / ${total}`}
        style={{ marginBottom: 16 }}
      />
      {isTimeCritical && (
        <Alert
          message="Осталось меньше минуты!"
          type="warning"
          showIcon
          style={{ marginBottom: 16 }}
        />
      )}
      {/* Вопрос */}
      <Card
        title={
          <Text strong style={{ fontSize: 16 }}>
            Вопрос {currentIndex + 1}
          </Text>
        }
        style={{ marginBottom: 24 }}
      >
        <Text style={{ fontSize: 15, display: 'block', marginBottom: 20 }}>
          {question.text}
        </Text>
        {question.is_multiple && (
          <Text type="secondary" style={{ display: 'block', marginBottom: 12 }}>
            Выберите все правильные варианты
          </Text>
        )}
        <Space direction="vertical" style={{ width: '100%' }} size={10}>
          {question.answers.map((answer) =>
            question.is_multiple ? (
              <Checkbox
                key={answer.id}
                checked={selectedIds.includes(answer.id)}
                onChange={() => handleAnswer(question.id, answer.id, true)}
                style={{ fontSize: 14 }}
              >
                {answer.text}
              </Checkbox>
            ) : (
              <Radio
                key={answer.id}
                checked={selectedIds.includes(answer.id)}
                onChange={() => handleAnswer(question.id, answer.id, false)}
                style={{ fontSize: 14 }}
              >
                {answer.text}
              </Radio>
            ),
          )}
        </Space>
      </Card>
      {/* Навигация */}
      <Space style={{ width: '100%', justifyContent: 'space-between' }}>
        <Button
          icon={<ArrowLeftOutlined />}
          onClick={() => setCurrentIndex((i) => i - 1)}
          disabled={currentIndex === 0 || !attempt.allow_navigation_back}
        >
          Назад
        </Button>
        {isLast ? (
          <Button
            type="primary"
            icon={<SendOutlined />}
            loading={submitting}
            onClick={handleSubmit}
          >
            Завершить тест
          </Button>
        ) : (
          <Button
            type="primary"
            icon={<ArrowRightOutlined />}
            onClick={() => setCurrentIndex((i) => i + 1)}
          >
            Далее
          </Button>
        )}
      </Space>
    </div>
  )
 }
@@ -0,0 +1,21 @@
 {
  "compilerOptions": {
    "target": "ES2020",
    "useDefineForClassFields": true,
    "lib": ["ES2020", "DOM", "DOM.Iterable"],
    "module": "ESNext",
    "skipLibCheck": true,
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": true,
    "jsx": "react-jsx",
    "strict": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noFallthroughCasesInSwitch": true
  },
  "include": ["src"],
  "references": [{ "path": "./tsconfig.node.json" }]
 }
@@ -0,0 +1,10 @@
 {
  "compilerOptions": {
    "composite": true,
    "skipLibCheck": true,
    "module": "ESNext",
    "moduleResolution": "bundler",
    "allowSyntheticDefaultImports": true
  },
  "include": ["vite.config.ts"]
 }
@@ -0,0 +1,10 @@
 import { defineConfig } from 'vite'
 import react from '@vitejs/plugin-react'
 export default defineConfig({
  plugins: [react()],
  server: {
    host: '0.0.0.0',
    port: 5173,
  },
 })
@@ -0,0 +1,25 @@
 server {
    listen 80;
    # Docker внутренний DNS — резолвим хосты в момент запроса, а не при старте nginx
    resolver 127.0.0.11 valid=30s;
    # API запросы → FastAPI backend
    location /api/ {
        set $backend http://backend:8000;
        proxy_pass $backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    # Всё остальное → Vite dev server (с поддержкой WebSocket для HMR)
    location / {
        set $frontend http://frontend:5173;
        proxy_pass $frontend;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
 }
Author	SHA1	Message	Date
Aleksey Razorvin	c1a38bfef8	docs: update ТЗ to v1.2 and README with new sprint plan ТЗ v1.2: - Versioning logic: 'after first attempt' instead of 'after assignment' - Added section 4.7 AI assistant (DeepSeek) - Removed 'auto question generation' from out-of-scope README: - Sprint table updated: 7 sprints, statuses, Sprint 4 = AI/DeepSeek - Added AI and MAX to stack table Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 14:08:50 +05:00
Aleksey Razorvin	6cb2d527e1	docs: insert Sprint 4 LLM/DeepSeek, shift tracker to Sprint 5, auth to Sprint 6 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 14:05:56 +05:00
Aleksey Razorvin	d7409c5fa4	docs: mark Sprint 3 complete, add step 010 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 14:00:55 +05:00
Aleksey Razorvin	0977eb0c38	fix: delete answers before questions in update_test to avoid FK violation Bulk DELETE bypasses ORM cascade — must manually delete child rows first. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:56:55 +05:00
Aleksey Razorvin	8097672917	fix: show activate button in table row for current inactive version Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:54:00 +05:00
Aleksey Razorvin	c64b34edb7	fix: always show activate button for non-current versions and in page header - Header: 'Сделать активной' appears when current version is not the sole active one - Versions table: button shown for all non-current versions regardless of is_active status Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:52:16 +05:00
Aleksey Razorvin	1103201ee3	feat: add version activation — choose which version is active Backend: - POST /api/tests/{id}/activate — deactivates all versions in chain, activates selected - GET /api/tests — simplified to is_active=True only (no parent_id subquery) - GET/PUT /api/tests/{id} — removed is_active filter, any version accessible by id - PUT /api/tests/{id} — new version auto-activates, parent deactivates Frontend: - Version history table: status column (Активная/Неактивная), 'Сделать активной' button Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:46:42 +05:00
Aleksey Razorvin	8df6077798	feat: add back button to test edit form TestForm now accepts optional onBack/backLabel props. TestEdit passes 'К просмотру теста' back button when in edit mode. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:42:07 +05:00
Aleksey Razorvin	60b9121a05	fix: move version history section below metadata card Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:39:07 +05:00
Aleksey Razorvin	6178e6cb5f	fix: move version history section below header on test edit page Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:37:14 +05:00
Aleksey Razorvin	6b52bca55f	feat: add version history section to test edit page - GET /api/tests/{id}/versions — returns full version chain from oldest to newest - TestEdit: shows 'История версий' table when multiple versions exist, current version highlighted, links to navigate between versions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:35:53 +05:00
Aleksey Razorvin	b2a3bda01b	feat: Sprint 3 — test editing with versioning Backend: - migration 003: add parent_id to tests table - PUT /api/tests/{id}: edit in place if no attempts, create new version otherwise - GET /api/tests: show only latest versions (no successor) Frontend: - TestForm: extracted reusable form component - TestCreate: refactored to use TestForm - TestEdit: full edit mode with pre-populated form, version redirect on new version Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:28:06 +05:00
Aleksey Razorvin	2b5dc379e1	docs: reorder sprints — editing+versioning moves to Sprint 3, tracker to Sprint 4 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:22:24 +05:00
Aleksey Razorvin	98049244ae	docs: document Sprint 2 UX improvements Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:18:18 +05:00
Aleksey Razorvin	f414f62f31	feat: replace action buttons with dropdown menu in test list Колонка с названием теста теперь занимает всю свободную ширину. Три действия (Открыть, Изменить, Пройти тест) убраны в выпадающее меню по кнопке «…». Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:16:28 +05:00
Aleksey Razorvin	4f788a9cf6	feat: split test detail into employee view and author view - /tests/:id — employee view, answers shown without correct/incorrect markers - /tests/:id/edit — author view, correct answers highlighted + edit button (disabled until Sprint 4) - TestList: add 'Изменить' button linking to author view Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:13:00 +05:00
Aleksey Razorvin	4762f86187	docs: mark Sprint 2 complete, document migration restart bug Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 13:03:33 +05:00
Aleksey Razorvin	a7937c937b	feat: add 'Пройти тест' button to test list table Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 12:58:38 +05:00
Aleksey Razorvin	d5f6abb5ad	feat: Sprint 2 — test taking + results Backend: - Models: TestAttempt, AttemptAnswer (migration 002) - POST /api/attempts: start attempt, shuffle questions/answers, hide is_correct, expose is_multiple for UI hints - POST /api/attempts/{id}/submit: save answers, calculate score, strict matching (selected == correct), return full result - GET /api/attempts/{id}/result: fetch saved result - Register attempts router in main.py Frontend: - api/attempts.ts: types + API functions - TestTake page: one question at a time, progress bar, timer with auto-submit, back navigation controlled by test setting, radio/checkbox based on is_multiple - AttemptResult page: score, pass/fail, per-question breakdown with correct/selected/missed answer highlighting - App.tsx: add /tests/:testId/take and /attempts/:id/result routes - TestDetail: add "Пройти тест" button Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 12:53:11 +05:00
Aleksey Razorvin	5551202d6f	docs: update sprint 1 docs after manual testing - СПРИНТЫ.md: mark Sprint 1 as completed (✅), check all tasks, add 4 bugs found and fixed during testing - ШАГ_006.md: add bugs table with symptoms, causes and fixes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 12:46:30 +05:00
Aleksey Razorvin	3d21110dd9	fix: serve FastAPI docs under /api prefix Set docs_url=/api/docs, redoc_url=/api/redoc, openapi_url=/api/openapi.json so Swagger UI is accessible through nginx at http://localhost/api/docs Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 12:44:15 +05:00
Aleksey Razorvin	cc23783e2a	fix: resolve container startup issues backend/Dockerfile: - Add ENV PYTHONPATH=/app so alembic can import app.config - Change CMD to bash entrypoint.sh (volume mount breaks chmod +x) nginx/nginx.conf: - Add resolver 127.0.0.11 (Docker internal DNS) - Use set $backend/$frontend variables so nginx resolves hostnames per-request instead of at startup Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 12:15:37 +05:00
Aleksey Razorvin	8b17c5d3c4	feat: Sprint 1 — infrastructure + test creation Backend: - FastAPI + SQLAlchemy 2.0 async + Alembic - Models: Test, Question, Answer - API: GET /api/tests, GET /api/tests/{id}, POST /api/tests - Pydantic validation: min 7 questions, min 3 answers, ≥1 correct Frontend: - React 18 + TypeScript + Vite + Ant Design + TanStack Query - Pages: TestList, TestCreate (nested Form.List), TestDetail Infrastructure: - Docker Compose: db (postgres:16), backend, frontend, nginx - Nginx: /api/ → FastAPI, / → Vite dev server with HMR - Alembic migration 001_init: tests, questions, answers tables - entrypoint.sh: wait for db, migrate, start uvicorn Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 12:05:04 +05:00
Aleksey Razorvin	054376bca7	docs: rewrite README with full project overview - Add project description, roles, test format - Add tech stack table - Add sprint plan summary - Add documentation index - Add quick start command Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 11:41:30 +05:00
Aleksey Razorvin	d013a16e98	docs: add sprint plan and step 005 log - Create DOC/СПРИНТЫ.md: 5 sprints, value-first approach - Sprint 1: infra + test creation (no auth) - Sprint 2: taking tests + results - Sprint 3: results tracker - Sprint 4: auth + roles + user management - Sprint 5: MAX notifications - Add DOC/ШАГИ/ШАГ_2026-03-21_005.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 11:39:43 +05:00
Aleksey Razorvin	15de1e9369	docs: add tech stack document and step 004 log - Create DOC/СТЕК.md: FastAPI + React + PostgreSQL + Docker - Add DOC/ШАГИ/ШАГ_2026-03-21_004.md with decisions log Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 11:31:57 +05:00
Aleksey Razorvin	52c8aff459	docs: close all open questions, update ТЗ to v1.1 - Director role = HR-manager (same permissions) - Editing assigned test creates new version - Question order is random per attempt - Navigation back configurable by test author - Notifications via MAX messenger (last sprint) - Export out of scope - Add step 003 log Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 11:27:26 +05:00
Aleksey Razorvin	7ff7d9b1d0	docs: add technical specification and step 002 log - Create DOC/ТЗ.md with full system requirements - Add DOC/ШАГИ/ШАГ_2026-03-21_002.md with step log Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-21 11:20:22 +05:00
Aleksey Razorvin	c1406c4ed1	merge: combine remote initial commit with local history	2026-03-21 11:07:35 +05:00
arazor72	c689013d20	Initial commit	2026-03-21 10:56:22 +05:00
		`@@ -0,0 +1,2 @@`
							`# База данных`
							`DATABASE_URL=postgresql+asyncpg://qa_user:qa_password@db:5432/qa_test`