testingwebapp fixes, weeek tasks 2948-2958

Made-with: Cursor

DOC/ШАГИ/Untitled

@@ -0,0 +1 @@
+тестирования

README.md

@@ -1,202 +1,200 @@
 # Система тестирования сотрудников клиники
 
-Веб-приложение для проведения внутреннего тестирования сотрудников клиники. Руководители подразделений и HR-менеджеры создают тесты и назначают их сотрудникам. Система фиксирует все попытки и результаты.
+Веб-приложение для проведения внутреннего тестирования сотрудников клиники.
+Руководители подразделений и HR-менеджеры создают тесты и назначают их
+сотрудникам. Все попытки и результаты сохраняются.
 
-**Версия ТЗ:** 1.2  
+- **Прод:** **[https://edullm.pirogov.ai/](https://edullm.pirogov.ai/)**
-**Дата:** 2026-03-21  
+- **Ветка разработки:** `dev`
-**Статус:** Согласовано
+- **ТЗ:** v1.2 от 2026-03-21 (статус — согласовано)
-
-**Актуальное состояние кода (не ТЗ, а «что уже есть»):** [docs/PROJECT_STATUS.md](docs/PROJECT_STATUS.md) · [инструкция для проверяющих на dev](docs/DEV_CONTOUR_USER_GUIDE.md) · [кабинет: коротко для врачей/кураторов](docs/РУКОВОДСТВО_КАБИНЕТ_ТЕСТОВ.md).  
-**Спринты мобильного UI (чек-лист для разработки):** [docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md](docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md).  
-**Унификация стека (текущий этап) и слияние с HR-кабинетом (на будущее):** план и журнал — [docs/migration-final.md](docs/migration-final.md). Этап 1 — Express → Flask + React → Jinja **внутри TestingWebApp** (БД остаётся `clinic_tests`). Этап 2 (на будущее) — слияние с `HR_TG_Bot/tgFlaskForm`: [docs/migration-to-tgflaskform.md](docs/migration-to-tgflaskform.md) · [простым языком](docs/migration-to-tgflaskform-plain.md). Карта Express-функционала и справочный gap-analysis с уже существующим модулем HR-кабинета: [docs/migration-final-inventory.md](docs/migration-final-inventory.md).  
-**Заготовка `flask_app/`** (отдельный Flask) больше **не развивается** — выбран сценарий «модуль внутри `tgFlaskForm`».
 
 ---
 
-## Стек технологий
+## Стек и состояние
 
-### Этот репозиторий (TestingWebApp)
+**Целевой и единственный рабочий стек** — Python 3.11 + Flask 3 +
+Jinja2 + Tailwind CDN + SQLAlchemy / psycopg2, код в
+[`flask_app/`](flask_app/). На нём работает и прод, и dev (кабинетный UI,
+порт **:3107** в Docker, см. ниже).
 
-| Слой | Технологии |
+Старые каталоги `backend/` (Node.js / Express) и `frontend/`
-|------|------------|
+(React + Vite) — **архив**: не разворачиваются, в `docker-compose.dev.yml`
-| **Backend** | Node.js (ESM), **Express** 4, **pg**, миграции SQL; аутентификация — cookie + **JWT** (**jsonwebtoken**), пароли **bcryptjs**; опционально вход через HR (`HR_AUTH`, отдельное подключение к БД HR). |
+поднимается сервис **`testing-flask`**, удаление папок запланировано
-| **Frontend** | **React** 18, **React Router** 6, сборка **Vite** 5; статика в проде через Nginx (см. `docker-compose.dev.yml`). |
+в спринте **E1.6**. Использовать их не надо, миграции и SQL-схема
-| **Данные** | **PostgreSQL**, отдельная БД **`clinic_tests`**: UUID-ключи, таблицы `tests`, `test_versions`, `questions`, `answer_options`, назначения, попытки (см. `backend/src/db/migrations/`). |
+сохранены в `backend/src/db/migrations/` исключительно как источник
-| **Прочее** | Извлечение текста из PDF/DOCX (**pdf-parse**, **mammoth**), опционально LLM для черновиков тестов; **dotenv**, **cors**, **multer**. |
+структуры БД.
 
-### Целевой стек (Flask, как в кабинете / мини-приложении)
+БД — **`clinic_tests`** (PostgreSQL, UUID-ключи). В Этапе 1 схема
+не меняется.
 
-Тот же класс технологий, что в **`HR_TG_Bot/tgFlaskForm`**: Python, Flask, шаблоны, Postgres. Сейчас допускается **отдельный деплой** нового контура из каталога [`flask_app/`](flask_app/README.md); позже — слияние с полным кабинетом при необходимости.
+**Этап 2** — слияние с общим HR-кабинетом `HR_TG_Bot/tgFlaskForm` —
-
+запланирован на будущее, сейчас не делается. План:
-Эталон реализации модуля в монорепозитории HR — общий веб-кабинет **`HR_TG_Bot/tgFlaskForm`**:
+[`docs/migration-to-tgflaskform.md`](docs/migration-to-tgflaskform.md)
-
+([простыми словами](docs/migration-to-tgflaskform-plain.md)).
-| Слой | Технологии |
-|------|------------|
-| **Приложение** | **Python 3**, **Flask** 3, шаблоны **Jinja2** + **PyPug**, blueprint `/cabinet/testing`; прод-сервер типично **waitress**. |
-| **Данные** | **SQLAlchemy** 2, **psycopg2**, БД **`hr_bot_test`**: таблицы `testing_*`, связи с **`staff_members`**. |
-| **Клиент** | HTML-шаблоны кабинета, JS в `webApp/templates/static/js/cabinet/` (без отдельного SPA в этом репозитории). |
-| **Инфра** | Тот же кластер Postgres, что и у Postgres_TG_Bots / HR (см. раздел установки ниже). |
-
-Подробности переноса и миграции данных: [docs/migration-to-tgflaskform.md](docs/migration-to-tgflaskform.md).  
-Скрипт ETL в монорепозитории HR: [`../HR_TG_Bot/tgFlaskForm/tools/migrate_clinic_tests_to_hr.py`](../HR_TG_Bot/tgFlaskForm/tools/migrate_clinic_tests_to_hr.py) (`--dry-run` / `--apply`, переменные `CLINIC_TESTS_URL` и `HR_BOT_URL`).
 
 ---
 
-## Содержание
+## Интерфейс (кабинет)
 
-- [Стек технологий](#стек-технологий) · [flask_app/ — новый контур](flask_app/README.md)
+Единственный вариант UI — **как у основного HR-веба**: в
-- [Состояние реализации (сводка)](#состояние-реализации-сводка)
+[`base.html`](flask_app/app/templates/base.html) корень
-- [Функциональные возможности](#функциональные-возможности)
+`cabinet-app` → шапка `cabinet-header` → контент `cabinet-main`; на
-- [Роли и права доступа](#роли-и-права-доступа)
+`<body>` всегда класс **`ui-legacy`**, стили в [`app.css`](flask_app/app/static/css/app.css)
-- [Установка и запуск](#установка-и-запуск)
+с префиксом **`body.ui-legacy`** (primary/teal, `.btn`, `.surface-card`,
-- [Данные, сотрудники, интеграция с HR](#данные-сотрудники-интеграция-с-hr)
+`legacy-list-shell`, `test-detail-page` и т.д.).
-- [Нефункциональные требования](#нефункциональные-требования)
+
-- [Вне scope](#вне-scope-не-реализуется-в-данной-версии)
+В [`docker-compose.dev.yml`](docker-compose.dev.yml) один сервис
+**`testing-flask`** (`container_name: testing_webapp_flask`), порт **3107**.
 
 ---
 
-## Состояние реализации (сводка)
+## Что уже работает на новом (Flask) контуре
 
-Коротко и по-человечески: [docs/PROJECT_STATUS.md](docs/PROJECT_STATUS.md) (черновики и версии, разбор попыток, список тестов, dev-стенд).  
+E1.0–E1.3 и E1.8 закрыты. Чек-лист и журнал —
-Как пользоваться локальным **dev** без чтения кода: [docs/DEV_CONTOUR_USER_GUIDE.md](docs/DEV_CONTOUR_USER_GUIDE.md).
+[`docs/migration-final.md`](docs/migration-final.md).
 
----
+- **Авторизация** через куки-сессию Flask: bcrypt (локальные пользователи
+  `clinic_tests.users`) или Werkzeug-хеши при включённом `HR_AUTH=1`
+  (UPSERT в `clinic_tests.users` по `staff_id` из `hr_bot_test`).
+  UI: `/login`, JSON: `/api/auth/{login,logout,me}`.
+- **Каталог тестов** `/tests` (видны активные + блок «Скрытые вами»),
+  создание теста через модалку.
+- **Редактор** `/tests/<id>/edit`: правка названия/описания/проходного
+  балла, добавление/удаление/перемещение вопросов и вариантов,
+  переключатель «Цепочка активна», авто-форк новой версии при правке
+  после первой попытки.
+- **AI-помощник** в редакторе:
+  - «По названию» — генерация всего теста по теме (количество вопросов
+    и вариантов задаёт автор);
+  - «По текущей сетке» — генерация по уже расставленным карточкам;
+  - «Проверить» — рецензия теста с вердиктом и разделами рекомендаций;
+  - «Улучшить» — массовое «было → стало» с чекбоксами;
+  - «AI: вопрос/переформулировать» — на отдельной карточке вопроса.
+- **Импорт документа** в редакторе: PDF / DOCX / TXT / MD до 16 МБ,
+  через `pypdf` и `python-docx` → AI-черновик.
+- **Настройки** `/settings` — статус общего LLM-ключа из ENV (DeepSeek
+  или OpenAI-совместимый), кнопка «Проверить подключение».
 
-## Функциональные возможности
+Подробная инструкция для тестировщика (только UI, без консоли) —
+[`docs/QA-versioning-and-ai.md`](docs/QA-versioning-and-ai.md).
 
-### Управление пользователями и подразделениями
+## Что ещё не реализовано
 
-- Создание/редактирование/деактивация учётных записей сотрудников
+| Спринт | Что включает |
-- Каждый сотрудник принадлежит одному подразделению
+|---|---|
-- Создание/редактирование справочника подразделений
+| **E1.4** — Назначение и прохождение | Назначить тест сотруднику, экран прохождения, экран результата с разбором ошибок. |
-- Назначение роли сотруднику: HR-менеджер / Руководитель подразделения / Сотрудник
+| **E1.5** — Трекер и настройки модуля | Единый список попыток с фильтрами, страница настроек цепочки. |
-
+| **E1.6** — Cutover внутри репозитория | Удаление `backend/` и `frontend/`, чистка `docker-compose.dev.yml` от архивных Node/React-сервисов. |
-### Создание и редактирование тестов
+| **E1.7** — UX-полировка редактора | 4 аккордеона (Шапка / AI / Вопросы / Действия) и drag-n-drop из [Спринта 3](docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md). |
-
-**Тест содержит:**
-- Название теста
-- Описание (опционально)
-- Список вопросов (минимум 7)
-- Порог зачёта — минимальный % правильных ответов
-- Таймер прохождения — лимит в минутах (опционально)
-
-**Вопрос содержит:**
-- Текст вопроса
-- Минимум 3 варианта ответа
-- Один или несколько правильных ответов
-
-**Настройки теста:**
-- Разрешить возврат к предыдущему вопросу: да / нет
-
-**Версионирование:**
-- Автор может редактировать тест пока никто его не проходил
-- Если тест уже проходили — создаётся новая версия (`version + 1`), старая сохраняется
-- Все версии теста хранятся; результаты привязаны к конкретной версии
-- Активная версия — та, которую видят сотрудники; автор может вручную переключить активную версию
-- Тест можно деактивировать (скрыть из списка, не удалять)
-
-### Назначение теста
-
-- Список получателей (отдел или конкретные сотрудники)
-- Срок сдачи — дата дедлайна
-- Допустимое количество попыток (1 или более)
-
-### Прохождение теста
-
-- На главной странице сотрудник видит список назначенных тестов со статусами:
-  - `Не начат` — ещё не открывал
-  - `В процессе` — начал, не завершил
-  - `Завершён` — сдал/не сдал
-  - `Просрочен` — дедлайн прошёл, не сдан
-- Если задан таймер — отображается обратный отсчёт, по истечении тест завершается автоматически
-- Порядок вопросов **случайный** при каждом прохождении
-- Возможность вернуться к предыдущему вопросу — определяется настройкой теста
-
-### Результаты после завершения теста
-
-- Итоговый балл и процент правильных ответов
-- Факт зачёта: **сдал / не сдал**
-- Разбор ошибок: по каждому вопросу — его ответ и правильный ответ
-
-### Трекер попыток
-
-Единый интерфейс просмотра всех попыток прохождения тестов:
-- Фильтрация по подразделению, сотруднику, тесту, статусу, результату
-- Пагинация и сортировка
-
-### AI-помощник
-
-Интеграция с LLM для помощи при создании тестов:
-
-| Функция | Описание |
-|---------|----------|
-| Генерация теста | AI генерирует готовый набор вопросов с вариантами ответов по теме |
-| Улучшение формулировки | AI переформулирует выбранный вопрос более чётко |
-| Добавление дистракторов | AI генерирует правдоподобные неправильные варианты ответов |
-| Проверка качества | AI анализирует весь тест и выдаёт рекомендации |
-
----
-
-## Роли и права доступа
-
-| Роль | Кто | Создаёт тесты | Назначает тесты | Видит результаты |
-|------|-----|:---:|:---:|:---:|
-| **HR-менеджер** | Руководитель службы HR, Директор клиники | ✅ | Всем сотрудникам клиники | Всех сотрудников |
-| **Руководитель подразделения** | Главный врач, рук. службы администраторов | ✅ | Только своему подразделению | Только своего подразделения |
-| **Сотрудник** | Все остальные работники | ❌ | ❌ | Только свои |
 
 ---
 
 ## Установка и запуск
 
-### База данных (как в HR_TG_Bot / Postgres_TG_Bots)
+### Предпосылка: общий Postgres
 
-Используется **тот же** экземпляр PostgreSQL, что и в [Postgres_TG_Bots](../Postgres_TG_Bots) (`docker-compose.dev.yml`, контейнер `hr_postgres_dev`, учётка `hr_bot_user` / сеть `hr_postgres_dev_net` — см. [HR_TG_Bot docker-compose](../HR_TG_Bot/docker-compose.dev.yml)).
+Используется **тот же** PostgreSQL, что и в
+[Postgres_TG_Bots](../Postgres_TG_Bots) (контейнер `hr_postgres_dev`,
+сеть `hr_postgres_dev_net`, учётка `hr_bot_user`).
 
-Схема приложения (таблицы `users`, `tests`, `departments`, …) **не** совмещается с БД `hr_bot_test` — для TestingWebApp заведена отдельная база **`clinic_tests`**.
+```bash
+# (один раз) создать базу
+psql "postgresql://hr_bot_user:hrbot123@localhost:5432/postgres" \
+  -c "CREATE DATABASE clinic_tests;"
 
-1. Поднять Postgres из `Postgres_TG_Bots` (и при необходимости внешнюю сеть: `docker network create hr_postgres_dev_net` — как в compose этих репозиториев).
+# (один раз) внешняя сеть, если ещё не создана соседом
-2. Один раз создать базу:  
+docker network create hr_postgres_dev_net || true
-   `psql "postgresql://hr_bot_user:hrbot123@localhost:5432/postgres" -c "CREATE DATABASE clinic_tests;"`
+```
-3. Скопировать `backend/.env.example` в `backend/.env`, при необходимости поправить `DATABASE_URL` (внутри Docker кластера — хост `hr_postgres_dev`, порт `5432`).
-4. Миграции: из каталога `backend/`: `npm run migrate`, затем `npm start` (и фронт из `frontend/` — `npm run dev`).
 
-**Docker (UI + API + общий Postgres):** поднять `Postgres_TG_Bots` (сеть `hr_postgres_dev_net`), создать БД `clinic_tests`, затем из корня `TestingWebApp`:  
+### Dev-стенд
-`docker compose -f docker-compose.dev.yml up --build` — интерфейс **http://localhost:3107** (Nginx проксирует `/api` в backend), API с хоста **http://localhost:3001** (см. [docker-compose.dev.yml](docker-compose.dev.yml), миграции в entrypoint). **Новый Flask-контур** (тот же стек, что кабинет HR): **http://localhost:3108** — сервис `testing-flask`, см. [flask_app/README.md](flask_app/README.md). Локальный `npm run dev` фронта (Vite) — тоже **:3107**, прокси `/api` на **:3001**. В БД `clinic_tests` для локального логина нужен активный `users` с bcrypt-паролем, либо включите `HR_AUTH=1` + `HR_DATABASE_URL` в compose/`.env` (см. `backend/.env.example`). В `backend/.env` задайте `PORT=3001`, если поднимаете API отдельно от compose.
 
-`docker compose -f docker-compose.dev.yml down` — остановка.
+```bash
+docker compose -f docker-compose.dev.yml up -d --build
+```
 
-**Без общего кластера** (только отладка): `docker compose --profile standalone up -d` в TestingWebApp — Postgres на **5433**, тогда в `.env` укажите `DATABASE_URL=...localhost:5433/clinic_tests` или `DB_PORT=5433` с `DB_NAME`/`DB_USER` из compose.
+| Что | URL |
+|---|---|
+| Приложение (Flask) | <http://localhost:3107> |
+| Health-check | <http://localhost:3107/health> |
 
-**Если `npm run migrate` пишет `ECONNREFUSED ...:5433`:** в `backend/.env` нет (или кривой) `DATABASE_URL` на **5432**, и сработал старый `DB_PORT=5433`. Задайте `DATABASE_URL` как в `backend/.env.example` для общего Postgres.
+`docker-compose.dev.yml` пробрасывает в контейнер **`testing-flask`**:
+- `DATABASE_URL` (по умолчанию на контейнерный Postgres `clinic_tests`);
+- `HR_AUTH=1` / `HR_DATABASE_URL` по умолчанию — вход через HR-кабинет;
+- `DEEPSEEK_API_KEY` / `OPENAI_API_KEY` / `LLM_BASE_URL` / `LLM_MODEL` —
+  для AI-функций. Достаточно положить ключ в корневой `.env` репозитория.
 
-### Данные, сотрудники, интеграция с HR
+### Локально без Docker
 
-- **Две роли кластера Postgres:** в **`clinic_tests`** — только сущности модуля тестирования (тесты, версии, назначения, попытки, локальные технические учётки при необходимости). В **`hr_bot_test`** (Postgres_TG_Bots / hr_web_viewer) — штат, справочники, существующий **RBAC** и веб-логины. Так мы не смешиваем схемы и не дублируем «источник правды» по людям.
+См. [`flask_app/README.md`](flask_app/README.md) — `venv` +
-- **Сотрудник в процессах** (назначения, дашборды, доступ к результатам) — везде по **`staff_members.id`**. Ссылки в `clinic_tests` храним как **тот же идентификатор** (логическая связь с `staff_members` в `hr_bot_test`); **ФИО, отдел, роли** подтягиваем из HR при отображении или кэшируем по согласованной политике, а не ведём второй кадровый учёт.
+`pip install -r requirements.txt` + `python run.py`.
-- **`telegram_id`** в данных сотрудника **не участвует** в бизнес-логике модуля: ни вход, ни проверка прав, ни выбор сотрудника в сценариях, ни фильтрация — только **справочная** информация при необходимости (отображение, история).
-- **RBAC в перспективе:** единая система разрешений — та, что уже в HR (роли, `staff_role_assignments`, permissions). Модуль тестирования **не** развивает отдельную полную копию матрицы; проверка действий в целевом виде — через **HR** (внутренний API / токен / согласованные запросы к БД). Пока договор и API не готовы — допустимы временные флаги в `clinic_tests`, явно помечаемые как MVP.
 
-Детализация задач и варианты A.x: [docs/revision_task/card1.md](docs/revision_task/card1.md).
+---
+
+## Данные и интеграция с HR
+
+- **Две роли кластера Postgres.** В **`clinic_tests`** — только сущности
+  модуля тестирования (тесты, версии, назначения, попытки, локальные
+  технические учётки). В **`hr_bot_test`** (Postgres_TG_Bots /
+  hr_web_viewer) — штат, справочники, RBAC и веб-логины. Схемы не
+  смешиваем, второй кадровый учёт в `clinic_tests` не ведём.
+- **Сотрудник** во всех бизнес-процессах — по
+  **`staff_members.id`** из `hr_bot_test`. В `clinic_tests` храним тот же
+  идентификатор; ФИО / отдел / роли подтягиваем из HR при отображении.
+- **`telegram_id` сотрудника** в бизнес-логике модуля **не участвует**
+  (ни вход, ни проверка прав, ни выбор сотрудника, ни фильтрация).
+- **Целевой RBAC** — единая система разрешений HR
+  (`staff_role_assignments`, `permissions`). Модуль тестирования
+  не дублирует матрицу; пока единый API не готов — в `clinic_tests`
+  допустимы временные флаги, явно помеченные как MVP.
+- **`HR_AUTH=1`**: в Flask-контуре включает вход через `hr_bot_test.users`
+  (Werkzeug-хеши) с UPSERT в `clinic_tests.users`. См.
+  [`flask_app/.env.example`](flask_app/.env.example).
+
+---
+
+## Роли и права (по ТЗ)
+
+| Роль | Кто | Создаёт тесты | Назначает | Видит результаты |
+|---|---|:---:|:---:|:---:|
+| **HR-менеджер** | Руководитель HR, директор | ✅ | Всем | Всех |
+| **Руководитель подразделения** | Главврач, рук. отделения | ✅ | Только своему подразделению | Только своего подразделения |
+| **Сотрудник** | Все остальные | ❌ | ❌ | Только свои |
+
+> На текущем Flask-контуре (E1.0–E1.3, E1.8) проверяется только
+> `@login_required`; разделение по ролям задействуется на E1.4–E1.5.
 
 ---
 
 ## Нефункциональные требования
 
 | Параметр | Значение |
-|----------|----------|
+|---|---|
 | Количество пользователей | 50–200 человек |
-| Платформа | Веб-приложение, браузер (desktop-first) |
+| Платформа | Веб, браузер; mobile-friendly |
 | Доступность | Внутренняя сеть клиники |
 | Язык интерфейса | Русский |
 | Время отклика | < 2 секунды |
 
+## Вне scope (в текущей версии не делаем)
+
+- Интеграция с AD / LDAP.
+- Нативное мобильное приложение.
+- Вопросы с вложениями (картинки, видео).
+- Экспорт отчётов в Excel / PDF.
+- Уведомления в MAX (отдельный спринт).
+
 ---
 
-## Вне scope (не реализуется в данной версии)
+## Документация
 
-- Интеграция с AD/LDAP
+| Файл | О чём |
-- Мобильное приложение
+|---|---|
-- Вопросы с вложениями (изображения, видео)
+| [`docs/PROJECT_STATUS.md`](docs/PROJECT_STATUS.md) | Что работает «прямо сейчас», что в работе, что в бэклоге. |
-- Экспорт отчётов в Excel / PDF
+| [`docs/migration-final.md`](docs/migration-final.md) | Главный трекер миграции: спринты Этапа 1, журнал, критерии готовности. |
-- Уведомления в MAX (отдельный спринт)
+| [`docs/migration-final-inventory.md`](docs/migration-final-inventory.md) | Карта 22 эндпоинтов Express + gap-analysis с `tgFlaskForm`. |
+| [`docs/migration-to-tgflaskform.md`](docs/migration-to-tgflaskform.md) | План Этапа 2 (слияние с HR-кабинетом). |
+| [`docs/QA-versioning-and-ai.md`](docs/QA-versioning-and-ai.md) | Инструкция для тестировщика — только через сайт. |
+| [`docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md`](docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md) | Целевой мобильный UX редактора (база для E1.7). |
+| [`docs/РУКОВОДСТВО_КАБИНЕТ_ТЕСТОВ.md`](docs/РУКОВОДСТВО_КАБИНЕТ_ТЕСТОВ.md) | Кратко для врачей-кураторов. |
+| [`flask_app/README.md`](flask_app/README.md) | Конкретные команды для нового контура. |
+| [`docs/ТЗ.md`](docs/ТЗ.md) | Исходное ТЗ заказчика. |

docker-compose.dev.yml

@@ -4,73 +4,29 @@
 # База clinic_tests: один раз
 #   psql "postgresql://hr_bot_user:hrbot123@localhost:5432/postgres" -c "CREATE DATABASE clinic_tests;"
 #
-# Запуск: из каталога TestingWebApp
+# Flask UI (кабинетный стиль): http://localhost:3107
-#   docker compose -f docker-compose.dev.yml up --build
-# UI (Node): http://localhost:3107  (Nginx: /api → backend:3001), API: http://localhost:3001
-# UI (Flask, новый контур): http://localhost:3108
 
 services:
-  testing-backend:
-    build:
-      context: ./backend
-      dockerfile: Dockerfile
-    container_name: testing_webapp_backend
-    # LLM и прочие секреты из хоста (не копируются в образ — см. .dockerignore)
-    env_file:
-      - ./backend/.env
-    environment:
-      DATABASE_URL: postgresql://hr_bot_user:hrbot123@hr_postgres_dev:5432/clinic_tests
-      JWT_SECRET: ${JWT_SECRET:-testing_webapp_jwt_dev}
-      # development: httpOnly-cookie без Secure (иначе на http://localhost:3107 логин не сработает)
-      NODE_ENV: development
-      FRONTEND_URL: http://localhost:3107
-      PORT: "3001"
-      # Вход теми же учётками, что в HR: проверка пароля в hr_bot_test + привязка сотрудника по web_login.
-      # Без HR_AUTH / HR_DATABASE_URL логин ищется только в clinic_tests.users (локальные dev-учётки).
-      HR_AUTH: ${HR_AUTH:-1}
-      HR_DATABASE_URL: postgresql://hr_bot_user:hrbot123@hr_postgres_dev:5432/hr_bot_test
-    # Прямой доступ к API с хоста (Vite proxy в dev: см. frontend/vite.config.js)
-    ports:
-      - "3001:3001"
-    networks:
-      - app
-      - postgres
-
-  testing-web:
-    build:
-      context: ./frontend
-      dockerfile: Dockerfile
-    container_name: testing_webapp_nginx
-    depends_on:
-      - testing-backend
-    ports:
-      - "3107:80"
-    networks:
-      - app
-
-  # Новый контур: Flask (тот же стек, что кабинет HR), отдельный порт
   testing-flask:
     build:
       context: ./flask_app
       dockerfile: Dockerfile
     container_name: testing_webapp_flask
     environment:
-      PORT: "3108"
+      PORT: "3107"
       WEB_USE_WAITRESS: "1"
       FLASK_DEBUG: "0"
       SECRET_KEY: ${FLASK_SECRET_KEY:-testing_flask_dev_change_me}
-      # БД (clinic_tests). Хост postgres — в общей сети hr_postgres_dev_net.
+      DATABASE_URL: ${DATABASE_URL:-postgresql+psycopg2://hr_bot_user:hrbot123@hr_postgres_dev:5432/clinic_tests}
-      DATABASE_URL: ${DATABASE_URL:-postgresql+psycopg2://app:app@postgres:5432/clinic_tests}
+      HR_AUTH: ${HR_AUTH:-1}
-      # Опц. HR-кабинет (E1.1): включается флагом + URL базы hr_bot_test.
+      HR_DATABASE_URL: ${HR_DATABASE_URL:-postgresql://hr_bot_user:hrbot123@hr_postgres_dev:5432/hr_bot_test}
-      HR_AUTH: ${HR_AUTH:-0}
+      DEV_FIO_PASSWORD: ${DEV_FIO_PASSWORD:-}
-      HR_DATABASE_URL: ${HR_DATABASE_URL:-}
-      # LLM (E1.2/E1.3/E1.8): один общий ключ, читается из .env проекта.
       DEEPSEEK_API_KEY: ${DEEPSEEK_API_KEY:-}
       OPENAI_API_KEY: ${OPENAI_API_KEY:-}
       LLM_BASE_URL: ${LLM_BASE_URL:-}
       LLM_MODEL: ${LLM_MODEL:-}
     ports:
-      - "3108:3108"
+      - "3107:3107"
     networks:
       - app
       - postgres

docs/PROJECT_STATUS.md

@@ -1,78 +1,148 @@
-# Состояние проекта (человеческий обзор)
+# Состояние проекта
 
-**Репозиторий:** [TestingWebApp](https://git.pirogov.ai/l_konstantin/TestingWebApp) · ветка разработки: **`dev`**  
+**Репозиторий:** [TestingWebApp](https://git.pirogov.ai/l_konstantin/TestingWebApp) · ветка разработки **`dev`**
-**Дата среза:** 2026-04-24
+**Прод:** **[https://edullm.pirogov.ai/](https://edullm.pirogov.ai/)**
+**Дата среза:** 2026-04-28
 
-Этот документ — не дублирование ТЗ, а **короткое объяснение**, что уже работает в коде и что логично делать дальше. Подробные задачи: [revision_task/card1.md](revision_task/card1.md), [revision_task/BACKLOG.md](revision_task/BACKLOG.md).
+Не дубль ТЗ, а карта «что реально работает в коде, на каком контуре,
+и что логично сделать дальше».
 
 ---
 
-## Что уже сделано (как это устроено)
+## TL;DR
 
-### Вход и роли
+- Прод и dev работают **только на Flask-контуре** (`flask_app/`,
+  Python 3.11 + Flask 3 + Jinja2 + Tailwind CDN + SQLAlchemy).
+- Каталоги `backend/` (Express) и `frontend/` (React) — архив, не
+  разворачиваются и не используются; удаление запланировано в
+  спринте **E1.6**.
+- БД — **`clinic_tests`** (PostgreSQL). Схема в Этапе 1 не меняется.
+- Этап 2 (слияние с `HR_TG_Bot/tgFlaskForm`) пока не делаем —
+  [`migration-to-tgflaskform.md`](migration-to-tgflaskform.md).
 
-- Сотрудник входит по **логину и паролю** (сессия через cookie + JWT).
+Главный трекер по спринтам — [`migration-final.md`](migration-final.md).
-- В шапке показываются **роль** и **Фамилия с инициалами** (например, *Иванов И. О.*), полное ФИО — во всплывающей подсказке.
-- В **режиме разработки** (`NODE_ENV=development`) у удобного тестирования могут быть дополнительные кнопки (например, создание теста сотрудником — `devUi` в ответе `/api/auth/me`).
-
-### «Цепочка» теста и черновики
-
-- У каждого теста есть **одна логическая цепочка** в базе: все правки вопросов относятся к ней, но **версия контента** (`v1`, `v2`, …) может расти.
-- **Пока никто не проходил** этот тест — автор правит **на месте**: сохраняет черновик, и меняется текущая активная версия **без** лишнего дублирования строк в истории.
-- **Как только по цепочке появилась хотя бы одна завершённая попытка** — каждое **содержательное** сохранение с изменениями создаёт **новую версию** (новый номер, старая остаётся в истории). Старые результаты остаются привязаны к **той** версии, с которой человек реально отвечал.
-- **Активная версия** — та, с которой сейчас стартуют новые попытки. Автор может **вручную** переключить активную версию в таблице истории (с подтверждением), если бизнесу так нужно.
-- **Публикация / видимость:** в кабинете (аккордеон **«Показ в каталоге»**, подсекция **«Видимость»**) тест можно **скрыть из общего списка** (цепочка остаётся в базе) или **снова показать**; **назначения** (подсекция **«Кому выдать»**) — при включённой фиче, см. раздел «Назначения» ниже.
-- **Мобильный UI** кабинета (колонка списка на узком экране, фикс-футер, группировка разделов, копи): [СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md](СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md) · [РУКОВОДСТВО_КАБИНЕТ_ТЕСТОВ.md](РУКОВОДСТВО_КАБИНЕТ_ТЕСТОВ.md) (тезисы для врачей/кураторов).
-- **Унификация стека (Этап 1, текущий)**: Express → Flask + React → Jinja **внутри TestingWebApp** (`flask_app/`). БД остаётся `clinic_tests`, схема не меняется. План и журнал — [migration-final.md](migration-final.md).
-- **Слияние с HR-кабинетом (Этап 2, на будущее, без сроков)**: перенос в `HR_TG_Bot/tgFlaskForm` как blueprint `cabinet/testing`, ETL `clinic_tests → hr_bot_test`. План — [migration-to-tgflaskform.md](migration-to-tgflaskform.md). Карта Express-функционала и справочный gap-analysis с уже существующим модулем HR-кабинета — [migration-final-inventory.md](migration-final-inventory.md).
-
-### Список тестов и доступ
-
-- В каталоге **«Тесты»** видны цепочки, где вы **автор**, и тесты, **назначенные вам** (через назначение на пользователя; в dev назначения обычно **включены**).
-- Под названием показывается **«Автор: Вы»** для своих тестов и **«Автор: Фамилия И. О.»** для чужих (назначенных).
-- **Пройти** тест — кнопка **справа** в строке; **карточка** теста — клик по названию **слева** (попытка с карточки не стартует сама).
-
-### Прохождение и результат
-
-- Открывается экран вопросов (один или несколько верных вариантов); после **«Завершить тест»** — итог: сколько верно, процент, **зачёт** по порогу.
-- **Разбор:** после сдачи показывается, по **каждому вопросу**, что выбрал пользователь и какие варианты верны. Отдельная страница разбора доступна по ссылке; **автор** в аккордеоне **«История»** (подсекция **«Прохождения»**) видит **завершённые** попытки и кнопку **«Разбор»** (раньше секция называлась **«Прогоны и разбор»**).
-
-### Импорт и ИИ (MVP)
-
-- Можно загрузить **файл** (PDF, DOCX, текст): сервер **извлекает текст** и при настроенном ключе **LLM** (например, `DEEPSEEK_API_KEY` / `OPENAI_API_KEY` в окружении) предлагает **черновик** вопросов. В UI: подсекция **«Документ в вопросы»** внутри **«Вопросы»** (раньше — отдельный блок «Импорт из файла»). Дальше тот же поток, что и при ручном редактировании: правки → **сохранить черновик** (с учётом правил версий выше).
-- **Полный** набор сценариев из ТЗ (отдельная страница настроек ключа, «проверить тест целиком», модалки с чекбоксами и т.д.) — в [sprint-02](revision_task/sprint-02.md); часть уже заложена в сервисах, UI доводится.
-
-### Назначения (MVP)
-
-- **Автор** в **«Показ в каталоге»** → **«Кому выдать»** может **назначить** сотрудников из справочника (поиск, фильтры, **«Выбрать всех»** в текущем списке; в dev — при включённой фиче в `docker-compose` / `.env`). Назначение **не** перепривязывается автоматически к каждой новой версии контента: **старт попытки** всегда берёт **текущую активную** версию на момент нажатия **«Пройти»**.
-
-### Интеграция с HR (в зачатке)
-
-- Поддержан сценарий **входа через учётки HR** (`HR_AUTH` + `HR_DATABASE_URL`) для проверок на одном кластере Postgres с экосистемой `Postgres_TG_Bots` (см. [README — установка](../README.md)).  
-- Целевой **RBAC** из HR-таблиц — [card1, часть A](revision_task/card1.md#часть-a--авторизация-по-паролю-бд-postgres_tg_bots); сейчас — упрощённое сопоставление ролей.
 
 ---
 
-## Что в планах (логичный следующий слой)
+## Что уже работает на новом контуре (E1.0–E1.3, E1.8)
+
+### Вход
+- `/login` (форма) и `/api/auth/login` (JSON), `/api/auth/logout`,
+  `/api/auth/me`.
+- По умолчанию — bcrypt-хеши из `clinic_tests.users`.
+- `HR_AUTH=1` + `HR_DATABASE_URL` — вход через `hr_bot_test.users`
+  (Werkzeug); запись синхронизируется в `clinic_tests.users` UPSERT-ом по
+  `staff_id`. Сценарий «пользователь без `staff_id`» — пропускается с
+  предупреждением в логах.
+
+### Каталог тестов (`/tests`)
+- Видны цепочки, где вы автор, и активные публичные.
+- Создание теста через модалку («Название» + «Описание»).
+- Кнопка «Скрыть» / «Вернуть» работает на цепочку целиком.
+
+### Редактор теста (`/tests/<id>/edit`)
+- Поля шапки: название, описание, проходной балл, переключатель
+  «Цепочка активна».
+- Вопросы и варианты: добавить / удалить / переместить, отметить верные.
+- **Версионирование.** Пока по цепочке нет завершённых попыток —
+  правки идут «на месте». После первой попытки любое содержательное
+  сохранение делает форк (`version + 1`, `parent_id` = прежняя),
+  старая версия остаётся в БД и не видна в каталоге.
+- Подробная модель поведения и проверочные сценарии —
+  [`QA-versioning-and-ai.md`](QA-versioning-and-ai.md).
+
+### AI-помощник в редакторе
+| Кнопка | Что делает |
+|---|---|
+| По названию | Генерирует весь набор вопросов по теме. Параметры — кол-во вопросов и вариантов. |
+| По текущей сетке | Дописывает варианты для уже расставленных карточек. |
+| Проверить | Рецензирует тест: вердикт + блоки рекомендаций. |
+| Улучшить | «Было → стало» по каждому вопросу/варианту с чекбоксами. |
+| AI: вопрос | На карточке вопроса — переформулировка / генерация дистракторов. |
+
+При отсутствии ключа — единая ошибка с ссылкой на `/settings`.
+
+### Импорт документа
+- PDF / DOCX / TXT / MD до 16 МБ.
+- `pypdf` для PDF, `python-docx` для DOCX, плоский текст — как есть.
+- Извлечённый текст идёт в LLM, на выходе — черновик теста, который
+  открывается в редакторе.
+
+### Настройки (`/settings`)
+- Статус общего LLM-ключа (берётся из ENV: `DEEPSEEK_API_KEY` →
+  `OPENAI_API_KEY`).
+- Провайдер, модель, base URL.
+- Кнопка «Проверить подключение» — пинг `/v1/chat/completions` через
+  `ping_llm()`.
+- Ключ на клиента не уходит и в БД не пишется.
+
+---
+
+## Чего на Flask пока нет
+
+Эти сценарии будут реализованы в E1.4–E1.5. До этого в приложении они
+просто отсутствуют (старый Express-контур не используется и не
+поднимается):
+
+- **Назначение теста сотруднику** — поиск по справочнику, «Выбрать
+  всех», фильтры по подразделениям.
+- **Прохождение** — экран вопросов, таймер, сохранение попытки.
+- **Результат и разбор ошибок** — отдельная страница с ответами
+  пользователя и правильными вариантами.
+- **Трекер попыток** — единый список завершённых попыток с фильтрами
+  (подразделение / сотрудник / тест / статус / результат).
+
+---
+
+## Что в работе и в планах
+
+### Этап 1 — паритет внутри TestingWebApp
+
+| Спринт | Содержание | Статус |
+|---|---|---|
+| E1.0 | База Flask-приложения (БД-пул, сессии, `base.html`). | ✅ |
+| E1.1 | Auth + `/api/me` (bcrypt + Werkzeug, опц. `HR_AUTH`). | ✅ |
+| E1.2 | Каталог тестов и редактор (функциональный минимум). | ✅ |
+| E1.3 | Импорт документов (PDF / DOCX / TXT / MD). | ✅ |
+| E1.4 | Назначения и прохождение тестов. | ⬜ Следующий. |
+| E1.5 | Трекер попыток + страница настроек цепочки. | ⬜ |
+| E1.6 | Cutover внутри репозитория (удаление `backend/` + `frontend/`). | ⬜ |
+| E1.7 | UX-полировка редактора: 4 аккордеона + drag-n-drop. | ⬜ |
+| E1.8 | AI-функции v2 (`/settings`, generate-by-title, check, improve). | ✅ |
+
+Подробности — [`migration-final.md`](migration-final.md).
+
+### Этап 2 — слияние с HR-кабинетом (на будущее)
+
+- Перенос blueprint'ом в `HR_TG_Bot/tgFlaskForm` под путь
+  `/cabinet/testing`.
+- ETL `clinic_tests → hr_bot_test`. Скрипт-заготовка:
+  [`HR_TG_Bot/tgFlaskForm/tools/migrate_clinic_tests_to_hr.py`](../../HR_TG_Bot/tgFlaskForm/tools/migrate_clinic_tests_to_hr.py)
+  (`--dry-run` / `--apply`).
+- Авторизация — через сессию HR-кабинета.
+- Подробности и риски — [`migration-to-tgflaskform.md`](migration-to-tgflaskform.md)
+  (и [простыми словами](migration-to-tgflaskform-plain.md)).
+
+### Долгий бэклог
 
 | Направление | Суть |
-|-------------|------|
+|---|---|
-| **AI по ТЗ §4.2** | Ключ в настройках (не на клиенте), кнопки «сгенерировать/проверить/улучшить» с превью и подтверждением, регресс с версиями. |
+| Дашборды (ТЗ этап 2) | Единая картина по отделу / клинике, фильтры, история. |
-| **Дашборды (ТЗ этап 2)** | Единая картина по отделу / клинике, фильтры, история. |
+| MAX / мини-приложение | Встраивание в общий HR-контур клиники. |
-| **MAX / мини-приложение** | Встраивание в общий HR-контур клиники. |
+| Таймер, подсказки, медиа в вопросах | Режимы прохождения и вложения — отдельные этапы ТЗ. |
-| **Таймер, подсказки, медиа в вопросах** | Режимы прохождения и вложения — отдельные этапы ТЗ. |
+| E2E и интеграционные тесты | Расширение `V.9`, стабильный CI. |
-| **E2E и интеграционные тесты** | Расширение `V.9`, стабильный CI. |
+| Назначения по отделу | Сроки, лимит попыток, групповые назначения. |
-| **Назначения** | Сроки, лимит попыток, назначения «по отделу» (частично в бэклоге [BACKLOG_IDEAS](revision_task/BACKLOG_IDEAS.md)). |
-
-Журнал приёмок и чек-листы: [TESTING_JOURNAL.md](revision_task/TESTING_JOURNAL.md).
 
 ---
 
-## Связанные файлы
+## Связанные документы
 
-- [Руководство пользователя dev-контура](DEV_CONTOUR_USER_GUIDE.md)
+- [README репозитория](../README.md)
-- [Руководство кабинета (простыми словами)](РУКОВОДСТВО_КАБИНЕТ_ТЕСТОВ.md)
+- [Главный трекер миграции — `migration-final.md`](migration-final.md)
-- [Спринты: мобильный UI](СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md)
+- [Карта Express + gap-analysis с `tgFlaskForm` — `migration-final-inventory.md`](migration-final-inventory.md)
-- [Предложение по дизайну (ист. + актуализация)](ПРЕДЛОЖЕНИЕ_ДИЗАЙН_СОЗДАНИЕ_ТЕСТА.md)
+- [План Этапа 2 — `migration-to-tgflaskform.md`](migration-to-tgflaskform.md)
-- [README с установкой](../README.md)
+- [Инструкция тестировщику — `QA-versioning-and-ai.md`](QA-versioning-and-ai.md)
-- [Карта задач card1](revision_task/card1.md)
+- [Спринты мобильного UX редактора](СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md)
+- [Кратко для врачей-кураторов](РУКОВОДСТВО_КАБИНЕТ_ТЕСТОВ.md)
+- [Руководство по dev-контуру](DEV_CONTOUR_USER_GUIDE.md)
+- [ТЗ заказчика](ТЗ.md)

docs/QA-versioning-and-ai.md

@@ -0,0 +1,414 @@
+# Инструкция для тестировщика: версионирование тестов и AI
+
+Сайт: **[https://edullm.pirogov.ai/](https://edullm.pirogov.ai/)**
+
+Учётка: подойдёт **любая** учётная запись на сайте — никаких особых ролей
+не требуется. Любой залогиненный пользователь, который создаёт тест,
+автоматически становится его автором и может его редактировать. Если
+учётки нет — попросите её у разработчика.
+
+> Всё, что описано ниже, проверяется **только через сайт**. Если в каком-то
+> сценарии написано «недоступно сейчас» — это **не баг**, это значит, что
+> функция UI ещё не сделана и появится позже. Просто пропускайте.
+
+---
+
+## Часть 1. Версии теста — что меняется при правках
+
+### О чём вообще задача
+
+Когда автор правит тест, в системе важно не сломать историю прохождений
+сотрудников. Поэтому правила такие:
+
+- Пока **никто не прошёл** тест — автор правит на месте, версия одна.
+- Как только **хотя бы один сотрудник прошёл** тест — следующее сохранение
+  изменений создаёт **новую версию** (v2, v3, …), старая сохраняется.
+- В каталоге всегда видна **только одна** активная версия.
+- Автор может **скрыть** тест целиком (чекбокс «Цепочка активна»).
+- Автор может **переключить** активную версию на другую из истории.
+
+> Сейчас на сайте нельзя пройти тест сотруднику и нельзя из UI открыть
+> историю версий — это будет в следующих спринтах. Поэтому из шести
+> правил тестировщик пока проверяет четыре, остальные помечены ниже.
+
+---
+
+### 1.1. Создание нового теста
+
+**Что проверяем:** автор может создать тест с нуля.
+
+**Как проверять:**
+1. Откройте [https://edullm.pirogov.ai/](https://edullm.pirogov.ai/) и войдите.
+2. Нажмите в шапке иконку **«Тесты»** (список) → попадаете в каталог.
+3. Нажмите кнопку **«Создать тест»**.
+4. В появившемся окне заполните **Название** (например, «Тест A»),
+   при желании — Описание.
+5. Нажмите **«Создать»**.
+
+**Что должно произойти:**
+- Открывается экран редактора нового теста.
+- В поле «Название» — то, что вы ввели.
+- Список вопросов пуст, счётчик «Вопросы (0)».
+- Внизу — кнопка **«Сохранить»** и чекбокс **«Цепочка активна»** (по
+  умолчанию включён).
+
+**Если что-то не так — баг:**
+- Окно «Создать тест» не открывается.
+- После «Создать» никуда не перенаправило.
+- В поле «Название» в редакторе пусто, хотя ввели текст.
+- Список тестов в каталоге не обновился (не появилась новая карточка).
+
+---
+
+### 1.2. Правка теста до прохождений (версия не растёт)
+
+**Что проверяем:** пока никто не проходил тест, автор может править его
+сколько угодно — это всё одна и та же версия.
+
+**Как проверять:**
+1. Откройте только что созданный «Тест A» (если уже не открыт): шапка → **«Тесты»** → нажмите на карточку теста.
+2. Нажмите **«Добавить вопрос»** — появится карточка вопроса.
+3. Введите текст вопроса.
+4. Заполните 3–4 варианта ответа в поле «Вариант ответа», у одного из них поставьте чекбокс «Правильный» (квадратик слева от текста).
+5. Добавьте ещё один-два вопроса тем же способом.
+6. Нажмите **«Сохранить»** в нижней панели.
+
+**Что должно произойти:**
+- Под шапкой появляется надпись **«Сохранено.»** (без слов про новую версию).
+- Если перезагрузить страницу — все вопросы и варианты на месте.
+
+**Повторите правку:**
+1. На том же экране **измените** текст одного вопроса, **добавьте** ещё один вариант к другому, **удалите** третий вопрос (кнопка «корзина» справа в карточке вопроса).
+2. Нажмите **«Сохранить»**.
+
+**Что должно произойти:**
+- Снова надпись **«Сохранено.»**.
+- Никаких слов «создана новая версия».
+- Перезагрузка страницы — изменения сохранились.
+
+**Если что-то не так — баг:**
+- Появляется сообщение про «новую версию» (его быть не должно — попыток ещё нет).
+- Изменения не сохранились после перезагрузки страницы.
+- Сообщение «Сохранено.» не появилось вовсе.
+
+---
+
+### 1.3. Правка после прохождений (создаётся v2)
+
+> ⏳ **Сейчас недоступно для проверки.**
+>
+> На сайте пока нет страницы для прохождения теста сотрудником, поэтому
+> тестировщик не может «накопить» попытки и проверить эту логику через UI.
+> Сценарий вернётся в инструкцию вместе со следующим спринтом, когда
+> появится страница прохождения.
+
+---
+
+### 1.4. Каталог показывает только активные тесты
+
+**Что проверяем:** в каталоге нет неактивных/скрытых тестов.
+
+**Как проверять:**
+1. На экране редактора любого теста снимите внизу чекбокс
+   **«Цепочка активна»** и нажмите **«Сохранить»**.
+2. Перейдите в шапке на **«Тесты»** (каталог).
+
+**Что должно произойти:**
+- Карточки этого теста в основном списке нет.
+- Внизу страницы каталога есть раскрывающийся блок **«Скрытые вами цепочки (N)»**. Раскройте его — там видно ваш тест.
+- Нажмите **«Открыть»** рядом с тестом — снова попадаете в редактор.
+- Поставьте обратно галку **«Цепочка активна»** → **«Сохранить»**.
+- Снова перейдите в **«Тесты»** — тест опять в основном списке каталога.
+
+**Если что-то не так — баг:**
+- После снятия галки тест остаётся в обычном каталоге.
+- Тест полностью пропал и его не видно нигде, даже в «Скрытых».
+- После возврата галки тест не вернулся в основной каталог.
+
+---
+
+### 1.5. Ручное переключение активной версии
+
+> ⏳ **Сейчас недоступно для проверки.**
+>
+> Страница с историей версий теста (где можно нажать «сделать активной»)
+> ещё не сделана. Появится в следующем спринте.
+
+---
+
+### 1.6. История прохождений после правок
+
+> ⏳ **Сейчас недоступно для проверки** — см. 1.3 и 1.5.
+
+---
+
+## Часть 2. AI-функции в редакторе теста
+
+### Как проверять, что AI вообще работает
+
+**Что проверяем:** ключ к AI задан и сервис отвечает.
+
+**Как проверять:**
+1. В шапке нажмите иконку **«Настройки»** (шестерёнка).
+2. Посмотрите блок «Подключение к LLM»:
+   - **Статус ключа** — должно быть зелёное **«Задан»**.
+   - **Провайдер** и **Модель** — заполнены.
+3. Нажмите кнопку **«Проверить подключение»**.
+
+**Что должно произойти:**
+- В течение 1–10 секунд под кнопкой появляется **зелёный** блок
+  с текстом вида **«OK · deepseek / deepseek-chat · 1234 мс»**.
+
+**Если что-то не так:**
+- Если статус **«Не задан»** (красный) — сообщите разработчику, не задан ключ. Тестировать AI-функции в этом режиме не нужно, кроме одного сценария ниже (2.7).
+- Если кнопка отдала **красный** блок «Ошибка» при заданном ключе — это баг, прикладывайте текст ошибки к тикету.
+
+---
+
+### 2.1. Сгенерировать тест по названию
+
+**Простыми словами:** автор пишет только тему, AI сам придумывает вопросы.
+
+**Как проверять:**
+1. **«Тесты»** → **«Создать тест»** → название, например, **«Гигиена рук»**, описание можно оставить пустым → **«Создать»**.
+2. В редакторе нажмите кнопку **«По названию»** (фиолетовая, в блоке «AI-помощник» → «Создать вопросы»).
+3. На вопрос «Сколько вопросов сгенерировать?» введите, например, `8` → **OK**.
+4. На вопрос «Сколько вариантов в каждом вопросе?» введите, например, `4` → **OK**.
+5. Подождите 5–20 секунд.
+6. Появится подтверждение «Готово: «…», вопросов — N. Применить как черновик? Текущие вопросы будут заменены». Нажмите **OK**.
+
+**Что должно произойти:**
+- В списке появилось примерно 8 вопросов на тему гигиены рук, в каждом примерно 4 варианта ответа на русском языке.
+- В каждом вопросе хотя бы один вариант помечен как «Правильный» (галка слева от текста варианта).
+- Внизу можно нажать **«Сохранить»** — тест сохраняется.
+
+**Дополнительно (что блокировка названия работает):**
+1. Создайте ещё один тест, в редакторе **очистите поле «Название»**.
+2. Нажмите **«По названию»**.
+3. Должен появиться алерт **«Сначала заполните название теста.»**, курсор перейдёт в поле «Название». Никакой генерации не происходит.
+
+**Если что-то не так — баг:**
+- Кнопка **«По названию»** работает при пустом названии (без алерта).
+- Сгенерированные вопросы — не на русском или не по теме названия.
+- В вопросе нет ни одного правильного варианта.
+- Подтверждение «Применить?» не появилось — вопросы заменились молча.
+- Отказ в подтверждении (Cancel) всё равно заменил вопросы.
+
+---
+
+### 2.2. Сгенерировать тест по сетке
+
+**Простыми словами:** автор сам задаёт «скелет» — сколько вопросов и
+сколько вариантов; AI заполняет вопросы по этому скелету.
+
+**Как проверять:**
+1. Создайте новый тест с названием **«Тест по сетке»**.
+2. Нажмите **«Добавить вопрос»** пять раз — получится 5 пустых карточек.
+3. В **третьей и пятой** карточках поставьте галку **«Несколько правильных ответов»**.
+4. В каждом вопросе по умолчанию 0 вариантов — нажмите **«Добавить вариант»** в каждом вопросе по 3 раза, чтобы стало по 3 варианта.
+5. Нажмите кнопку **«По текущей сетке»** в блоке «AI-помощник».
+
+**Что должно произойти:**
+- В списке снова 5 вопросов (не больше, не меньше).
+- В каждом — по 3 варианта.
+- В третьем и пятом вопросах несколько вариантов помечены правильными;
+  в остальных — ровно один.
+- Тексты — на русском, по теме названия.
+
+**Если что-то не так — баг:**
+- Стало другое число вопросов или вариантов (не 5×3).
+- В третьем/пятом вопросе только один правильный ответ, а в остальных — несколько.
+- Пришла ошибка типа **«AI: ошибка»** без понятного объяснения.
+
+---
+
+### 2.3. Проверить тест
+
+**Простыми словами:** AI читает весь тест и пишет, что в нём не так.
+
+**Как проверять:**
+1. Откройте любой тест с 3+ вопросами (например, «Гигиена рук» из 2.1).
+2. Желательно специально испортить пару вопросов: переписать
+   формулировку расплывчато («что-то про что-то»), сделать варианты
+   ответа очень похожими друг на друга или явно дурацкими.
+3. Нажмите **«Сохранить»**.
+4. Нажмите кнопку **«Проверить»** в блоке «AI-помощник» → «Улучшить существующее».
+
+**Что должно произойти:**
+- Открывается окно «Проверка теста».
+- Сверху — цветная плашка с одним из вердиктов: **«Годен»** (зелёный),
+  **«Есть замечания»** (жёлтый) или **«Серьёзные проблемы»** (красный)
+  + одно-два предложения резюме.
+- Ниже — список разделов: «Чёткость формулировок», «Качество дистракторов»,
+  «Охват темы», «Сбалансированность сложности». Под каждым — конкретные
+  пункты, что улучшить.
+- Закрытие крестиком сверху или кнопкой «Закрыть» внизу — работает.
+- В тесте при этом **ничего не меняется**, AI только советует.
+
+**Если что-то не так — баг:**
+- Окно пустое или текст не на русском.
+- Все вопросы AI признал хорошими, хотя вы их специально испортили.
+- После закрытия окна в тесте появились/исчезли вопросы.
+
+---
+
+### 2.4. Улучшить весь тест
+
+**Простыми словами:** AI предлагает улучшенные формулировки и варианты;
+автор отмечает галками, что применить.
+
+**Как проверять:**
+1. Откройте тест из 2.3 (с теми же намеренно слабыми вопросами).
+2. Нажмите **«Сохранить»** на всякий случай.
+3. Нажмите кнопку **«Улучшить»**.
+
+**Что должно произойти:**
+- Открывается окно «Улучшение теста».
+- Сверху подпись «Отметьте вопросы… N из M» (M — всего вопросов, N — где AI предложил изменения).
+- Каждый изменённый вопрос — отдельный блок:
+  - Чекбокс **«Вопрос #N»** (по умолчанию **отмечен**).
+  - Слева — «Было» (старый текст и варианты, изменённые куски зачёркнуты).
+  - Справа — «Стало» (новые формулировки, выделены).
+  - Правильные варианты помечены галочкой **✓**.
+- Внизу — две кнопки: **«Отмена»** и **«Применить выбранное»**.
+
+**Проверьте применение по выбору:**
+1. Снимите галки у двух вопросов из списка.
+2. Нажмите **«Применить выбранное»**.
+
+**Что должно произойти:**
+- Окно закрывается.
+- В редакторе **только** отмеченные вопросы заменены на улучшенные;
+  два вопроса, у которых вы сняли галки, остались в прежнем виде.
+- Появляется подсказка «Изменения применены. Не забудьте сохранить.»
+- После **«Сохранить»** — обычное «Сохранено.»
+
+**Если что-то не так — баг:**
+- Поменялось **число** вопросов или вариантов в каких-то вопросах
+  (должно остаться как было).
+- В вопросе изменилось значение «Несколько правильных ответов» (галка
+  переключилась сама).
+- Изменились вопросы, у которых вы сняли галку.
+- Кнопка «Отмена» всё равно применила изменения.
+- В колонках «Было» и «Стало» одинаковый текст (нет смысла предлагать).
+
+---
+
+### 2.5. AI: вопрос/переформулировать
+
+**Простыми словами:** работа с одним вопросом. Если поле пустое — AI его
+придумает; если уже заполнено — переформулирует красивее, варианты не трогает.
+
+**Как проверять (новый вопрос):**
+1. В любом тесте нажмите **«Добавить вопрос»** — появилась пустая карточка.
+2. **Не трогайте** поле «Формулировка вопроса».
+3. Нажмите **«Добавить вариант»** 4 раза — должно стать 4 пустых варианта.
+4. Нажмите кнопку **«AI: вопрос/переформулировать»** в этой карточке.
+
+**Что должно произойти:**
+- Поле «Формулировка вопроса» заполнено осмысленным текстом по теме теста.
+- Все 4 варианта заполнены.
+- Ровно один помечен как правильный.
+- Внизу появляется строка статуса **«AI: вопрос сгенерирован.»**
+
+**Как проверять (переформулировать существующий):**
+1. Возьмите готовый вопрос с уже заполненной формулировкой.
+2. Нажмите **«AI: вопрос/переформулировать»** в его карточке.
+
+**Что должно произойти:**
+- Меняется **только текст вопроса** — варианты ответа остаются прежними,
+  правильные варианты те же.
+- Статус **«AI: формулировка обновлена.»**
+
+**Если что-то не так — баг:**
+- На пустом вопросе AI ничего не сгенерировал.
+- На заполненном вопросе AI поменял варианты ответа или правильность —
+  должен трогать только формулировку.
+- Получилось 0 или 1 правильных вариантов в новом вопросе (надо ровно 1
+  для одиночного выбора).
+
+---
+
+### 2.6. Импорт документа
+
+**Простыми словами:** автор загружает PDF/Word/текст со статьёй —
+AI читает файл и сам предлагает черновик теста.
+
+**Подготовьте файл:** возьмите PDF или DOCX на 1–3 страницы со связным
+русским текстом (например, любую методичку или статью). Лимит — 16 МБ.
+
+**Как проверять:**
+1. В редакторе любого нового теста (можно пустого) → блок «AI-помощник»
+   → **«Импортировать»** → нажмите большую кнопку **«Загрузить документ (PDF, DOCX, TXT, MD)»** → выберите файл.
+2. Подождите 5–30 секунд.
+
+**Что должно произойти:**
+- Появляется подтверждение «Сгенерировано: «…», вопросов: N. Применить как новый черновик? Текущие вопросы будут заменены». Нажмите **OK**.
+- Тест заполнен вопросами по содержанию загруженного документа.
+- Можно сохранить кнопкой **«Сохранить»**.
+
+**Дополнительно — отказ:**
+1. Повторите загрузку, но в подтверждении нажмите **«Отмена»**.
+2. Тест должен остаться **в прежнем виде**, ничего не подменилось.
+
+**Дополнительно — большой файл:**
+1. Возьмите файл больше 16 МБ.
+2. Загрузите его.
+
+**Что должно произойти:** ошибка о слишком большом файле; вопросы не
+подменились.
+
+**Дополнительно — неподдерживаемый тип:**
+1. Возьмите файл `.xlsx` или картинку `.png`.
+2. Попробуйте загрузить.
+
+**Что должно произойти:** алерт «Неподдерживаемый формат…»; вопросы не
+подменились.
+
+**Если что-то не так — баг:**
+- Подтверждение не появилось — вопросы заменились молча.
+- Отказ в подтверждении всё равно подменил вопросы.
+- Большой файл не вызвал ошибку, а как-то «прошёл».
+- Файл не на русском дал тест с непонятной кашей вместо вопросов.
+
+---
+
+### 2.7. Поведение, если ключа AI нет
+
+> Этот сценарий обычно проверять не нужно — он сработает автоматически, если разработчик уберёт ключ.
+> Но если в каталоге AI вообще не работает, то проверьте именно это, чтобы понять — это баг или просто ключ не настроен.
+
+**Как проверять:**
+1. **«Настройки»** → если статус **«Не задан»** (красный) — это и есть тестируемая ситуация.
+2. Откройте любой тест и нажмите по очереди:
+   - **«По названию»**
+   - **«По текущей сетке»**
+   - **«Проверить»**
+   - **«Улучшить»**
+   - **«AI: вопрос/переформулировать»** в любой карточке
+   - **«Загрузить документ»**
+
+**Что должно произойти:** в каждом случае появляется понятное сообщение,
+что AI не настроен, **и предложение открыть «Настройки»**. После согласия
+— открывается страница `/settings`. Никакого «AI: ошибка» без объяснений.
+
+**Если что-то не так — баг:**
+- Сообщение об ошибке без слов «Настройки».
+- Ссылка/кнопка «Открыть Настройки» не ведёт на нужную страницу.
+- Сайт молча ничего не делает после нажатия AI-кнопки.
+
+---
+
+## Памятка: общий алгоритм отчёта о баге
+
+Если что-то идёт не так, к тикету приложите:
+
+1. **URL страницы**, на которой воспроизвели баг (полностью, из адресной
+   строки).
+2. **Шаги** — что именно нажимали по порядку (1-2-3).
+3. **Что увидели** против **что ожидали увидеть** (по описанию выше).
+4. **Скриншот** экрана с проблемой (для модалок — со всем содержимым окна).
+5. Если ошибка — **точный текст** сообщения.
+6. **Учётная запись**, под которой воспроизвели (логин, без пароля).
+
+Этого достаточно — лезть в консоль/код/базу не нужно и не надо.

docs/UX_аудит_и_новая_IA_—_страница_теста.md

@@ -0,0 +1,340 @@
+# UX-аудит страницы теста и предложение новой информационной архитектуры
+
+**Продукт:** HR system — модуль тестирования
+**Платформа:** Цифровые сервисы клиники им. Е. Н. Оленевой
+**Объект анализа:** страница `/tests/{id}` — создание/редактирование теста
+**Дата:** 29 апреля 2026
+
+---
+
+## Краткая сводка
+
+Текущая страница `/tests/{id}` совмещает три разные пользовательские задачи в одном экране:
+
+1. **Авторскую** — придумать и оформить тест (название, описание, вопросы, варианты).
+2. **Управленческую** — назначить тест 1–N сотрудникам.
+3. **Аналитическую** — посмотреть, кто из сотрудников и какие версии проходил.
+
+Эти задачи различаются по ролям, частоте, объёму данных и контексту. Сейчас они смешаны в одном длинном аккордеоне, что приводит к ряду проблем — от потери изменений до невозможности масштабировать список аудитории за пределы 100–200 человек.
+
+Документ состоит из двух частей:
+
+- **Часть 1** — аудит текущей страницы с приоритизированными проблемами (critical / major / minor) и ссылками на скриншоты.
+- **Часть 2** — предложение новой IA с раздельными разделами «Тесты», «Назначения», «Отчёты», ролевой моделью и описанием жизненного цикла версии теста.
+
+---
+
+# Часть 1. Аудит текущей страницы
+
+Все скриншоты сделаны 29.04.2026 на странице `https://edullm.pirogov.ai/tests/298a64af-...` под ролью `employee` (см. п. M-3).
+
+## 1.1. Шапка, заголовок и баннер версионирования
+
+![Шапка и баннер](screens/01_header_intro.jpg)
+
+Что мы видим: глобальная шапка «Тестирование», подпись пользователя `Разорвин А. М. · employee`, кнопка «Выйти». Ниже — хлебная крошка «← к списку», название теста, автор, дата обновления, **жёлтый баннер «При сохранении будет создана новая версия теста.»** и схлопнутый аккордеон «О тесте».
+
+Замечания:
+
+- **C-1 [critical] Баннер о новой версии показывается ВСЕГДА**, независимо от того, изменил ли пользователь хоть что-то. Это сбивает с толку: автор открывает существующий тест, ничего не трогает — и думает, что версия уже создана. Должен показываться только при наличии несохранённых изменений (dirty state).
+- **m-2 [minor] Роль `employee` написана по-английски** в шапке. В русском интерфейсе должно быть «сотрудник» / «автор» / другое (см. ролевую модель в Части 2).
+- **m-3 [minor] Опечатка** в `<title>` вкладки: «Система тестирования» (нет «и»). Влияет на закладки, историю, поиск.
+
+---
+
+## 1.2. Секция «О тесте»
+
+![О тесте раскрытый](screens/02_about_test.jpg)
+
+Замечания:
+
+- **M-1 [major] Аккордеон по умолчанию схлопнут.** Чтобы начать редактировать главный объект страницы (вопросы), нужно сделать лишний клик. На странице редактирования теста раздел «Вопросы» (а возможно, и «О тесте») должен быть открыт по умолчанию.
+- **M-2 [major] Поле «Порог зачёта, %» не имеет валидации min/max.** Что произойдёт при вводе 0, 100, 150, –5, 70.5, или вообще буквы? Минимум: подсказка «от 1 до 100», атрибуты `min/max/step` на input, инлайн-ошибка при некорректном вводе.
+
+---
+
+## 1.3. Раздел «Вопросы» — генерация и Вопрос 1
+
+![Генерация и Вопрос 1](screens/03_questions_top.jpg)
+
+Что мы видим: блок **«Генерация сетки вопросов (ИИ)»** с полями «Тема», «Вопросов: 7», «Вариантов: 3» и кнопкой «Сгенерировать тест (ИИ)». Ниже — Вопрос 1 с собственной кнопкой «Сгенерировать вопрос (ИИ)» в правом верхнем углу, чекбоксом «Несколько верных ответов», тремя вариантами с радиокнопками и крестиками «удалить».
+
+Замечания:
+
+- **C-2 [critical] ИИ-генерация без подтверждения и без отображения хода работы.** Кнопка «Сгенерировать тест (ИИ)» одной нажатием перезаписывает существующие вопросы — а они уже могут быть наполовину написаны вручную. То же касается кнопки «Сгенерировать вопрос (ИИ)» рядом с уже заполненным вопросом.
+  - Нужно: confirm-диалог «Заменить текущие N вопросов?», индикатор прогресса генерации, возможность откатить (undo) последний результат генерации.
+- **M-3 [major] Чекбокс «Несколько верных ответов» меняет семантику варианта без явного намёка.** Когда выкл — радиокнопки (один верный), когда вкл — должны стать чекбоксами (несколько). Лучше переписать подпись в зависимости от состояния: «один верный» / «несколько верных», и/или показать рядом подсказку, как изменится контрол.
+
+---
+
+## 1.4. Вопросы 3–5
+
+![Вопросы 3-5](screens/04_questions_mid.jpg)
+
+Замечания:
+
+- **M-4 [major] Нет нумерации/перетаскивания вопросов.** «Вопрос 1, 2, 3…» — порядок фиксирован тем, в каком порядке добавляли. Для длинных тестов нужен drag-handle или хотя бы стрелки «вверх / вниз».
+- **M-5 [major] «Удалить вопрос» без подтверждения.** Случайный клик уничтожит написанный вопрос. Минимум — confirm-диалог; лучше — undo-toast «Вопрос удалён · Отменить».
+- **m-4 [minor] Маленькая видимая «вода» между вопросами.** Карточки вопросов мало отделены друг от друга визуально, при пролистывании они сливаются в стену форм. Стоит увеличить вертикальный отступ между карточками или добавить разделитель.
+
+---
+
+## 1.5. Вопрос 7 — обрыв длинного варианта
+
+![Q7 с обрезанным вариантом + загрузка файла](screens/05_questions_bottom.jpg)
+
+Это один из самых наглядных багов:
+
+- **M-6 [major] Длинный текст варианта обрезается.** В Q7 первый вариант отображается как «Максимальное количество токенов, которое модель может о…» — текст уходит за правый край однострочного `<input>`. Для содержательных тестов (особенно медицинских) ответы часто длинные. Нужно: либо `<textarea>` с автовысотой, либо горизонтальный скролл с tooltip всего текста на ховере.
+- **m-5 [minor] Загрузка файла «Документ в вопросы» — без drag-and-drop, без ограничений по размеру/формату на UI, без обратной связи.** Подсказка «PDF, Word или текст — вставьте в черновик вопросов» — хорошая по-человечески, но не объясняет, что произойдёт после загрузки: заменит ли существующие вопросы, добавит ли в конец, есть ли превью результата.
+
+---
+
+## 1.6. Кнопка «Сохранить черновик» в середине + История
+
+![Сохранить + История](screens/06_save_history.jpg)
+
+Здесь главная архитектурная проблема страницы:
+
+- **C-3 [critical] Кнопка «Сохранить черновик» расположена в середине страницы.** Сразу после неё ниже идут ещё две большие секции — «История» и «Показ в каталоге». Пользователь, открывший «Показ в каталоге» и поменявший там аудиторию, психологически ищет «Сохранить» внизу страницы — но там его нет. Очень высокий риск потерять изменения.
+  - Решения, любое или все: (а) sticky-панель сохранения внизу страницы; (б) дубль кнопки после последней секции; (в) автосохранение черновика; (г) предупреждение перед уходом со страницы при наличии несохранённых изменений.
+- **M-7 [major] Раздел «Прохождения» показывает сырые ENUM-значения.** Видно `v1 · in_progress` — это техническое значение, а не пользовательский текст. Должно быть «в процессе» / «пройдено» / «не пройдено», лучше с цветной плашкой-индикатором.
+- **M-8 [major] Дубль кнопки «К списку».** Хлебная крошка «← к списку» наверху + кнопка «К списку» рядом с «Сохранить черновик» — две точки выхода с разным визуальным весом. Кнопка справа от primary-кнопки создаёт ложное ощущение симметричности с действием. Оставить либо крошку, либо превратить вторую кнопку в текстовую ссылку «Отмена».
+
+---
+
+## 1.7. «Показ в каталоге» — Видимость и фильтры
+
+![Видимость](screens/07_catalog_visibility.jpg)
+
+- **M-9 [major] Контрол «Видимость» неясен по текущему состоянию.** Кнопка «Скрыть из списка» — это сейчас действие или текущее состояние? Если тест уже скрыт — кнопка должна называться «Показать в списке». Лучше — переключатель (toggle/switch) с подписью «Тест виден в каталоге», чтобы текущее состояние читалось без действий.
+- **m-6 [minor] Поле поиска и два селекта** «Все отделы» / «Все» расположены без подписей — что делает второй селект, без раскрытия не понятно. Нужны явные label или persistent placeholder.
+
+---
+
+## 1.8. Список «Кому выдать» — 147 сотрудников
+
+![Список сотрудников](screens/08_catalog_employees.jpg)
+
+Этот блок — корень главной IA-проблемы (см. Часть 2):
+
+- **C-4 [critical] Назначение тестов не должно жить на странице теста.** Это управленческая задача отдельной роли (HR-менеджер, руководитель отделения), а не авторская. Подробно — в Часть 2.
+- **M-10 [major] Список из 147 человек без виртуализации и счётчика выбранных.** Нужно как минимум: счётчик «выбрано N из 147», фильтр «только выбранные», сохранение выбранного при изменении фильтра, виртуальный скролл (на 1000+ сотрудников страница встанет колом).
+- **M-11 [major] «Назначить выбранных» внутри контейнера списка.** Кнопка стоит на нижней границе скролл-контейнера — её очень легко не заметить. И непонятно: «Назначить» — это отдельное действие или часть общего «Сохранить черновик» наверху?
+- **m-7 [minor] Подпись «нет учётки (создадим при назначении)»** — хорошая идея (ленивая выдача учёток), но требует пояснения: что значит «при назначении», что получит сотрудник после, как ему придёт первый пароль.
+
+---
+
+## 1.9. Сводная таблица замечаний
+
+| ID | Приоритет | Что | Место |
+|---|---|---|---|
+| C-1 | critical | Баннер «новая версия» виден всегда, не только при изменениях | 1.1 |
+| C-2 | critical | ИИ-генерация без confirm и без прогресса | 1.3 |
+| C-3 | critical | Кнопка «Сохранить» в середине страницы | 1.6 |
+| C-4 | critical | Назначение сотрудников не должно жить на странице теста | 1.8 |
+| M-1 | major | Аккордеоны схлопнуты по умолчанию, включая «Вопросы» | 1.2 |
+| M-2 | major | «Порог зачёта» без валидации min/max | 1.2 |
+| M-3 | major | Чекбокс «Несколько верных» меняет семантику без подсказки | 1.3 |
+| M-4 | major | Нет переупорядочивания вопросов | 1.4 |
+| M-5 | major | «Удалить вопрос» без подтверждения и undo | 1.4 |
+| M-6 | major | Длинный текст варианта ответа обрезается | 1.5 |
+| M-7 | major | Сырые ENUM-значения в статусах прохождений | 1.6 |
+| M-8 | major | Дубль точек выхода («← к списку» + «К списку») | 1.6 |
+| M-9 | major | Контрол «Видимость» неясен по состоянию | 1.7 |
+| M-10 | major | Список 147 сотрудников без виртуализации/счётчиков | 1.8 |
+| M-11 | major | «Назначить выбранных» теряется внутри контейнера | 1.8 |
+| m-1 | minor | Логотип на странице логина обрезан | вне скрина |
+| m-2 | minor | Роль `employee` латиницей в шапке | 1.1 |
+| m-3 | minor | Опечатка «тестирования» в `<title>` | 1.1 |
+| m-4 | minor | Карточки вопросов слабо отделены друг от друга | 1.4 |
+| m-5 | minor | Загрузка файла без drag-and-drop и описания результата | 1.5 |
+| m-6 | minor | Селекты в фильтрах без явных label | 1.7 |
+| m-7 | minor | «Нет учётки (создадим при назначении)» — нужно пояснение | 1.8 |
+
+Не проверено и стоит протестировать отдельно: валидация при сохранении пустого вопроса/вариантов, мобильная вёрстка, клавиатурная навигация и focus ring, контрастность по WCAG 2.2, поведение под другими ролями (руководитель, HR, директор).
+
+---
+
+# Часть 2. Предлагаемая новая IA
+
+## 2.1. Что не так с текущей IA
+
+Сейчас одна страница `/tests/{id}` решает три разные задачи разных ролей:
+
+| Задача | Кто делает | Как часто | Какие данные |
+|---|---|---|---|
+| Сочинить тест | автор / методолог | один раз при создании, далее редко | вопросы, варианты, порог |
+| Назначить кому проходить | автор (иногда) или HR / руководитель | каждый раз для нового сотрудника или потока | список из 100–10 000 сотрудников, фильтры |
+| Посмотреть кто прошёл | руководитель / HR / директор | регулярно | результаты, динамика, агрегаты |
+
+Это три разных пользовательских ритма, три разных набора фильтров, три разных уровня доступа. Складывать их в один аккордеон — экономия на маршрутизации и проигрыш во всём остальном (см. C-3, C-4, M-9, M-10, M-11).
+
+## 2.2. Карта разделов после редизайна
+
+```
+HR system (модуль «Тестирование»)
+│
+├── Главная / Дашборд
+│       сводка: «назначено N тестов, X% прошли, Y просрочены»
+│       (вид зависит от роли — см. 2.4)
+│
+├── Тесты
+│   ├── Каталог тестов            ← список, поиск, фильтры
+│   ├── Создать тест              ← минимальный wizard: название → пустой черновик
+│   └── /tests/{id}               ← страница теста
+│       ├── Просмотр              ← все, у кого есть доступ
+│       │     краткая сводка прохождений (89 / 147, средний 6.2/7)
+│       │     кнопка «Назначить» (открывает модалку из 2.3)
+│       │     кнопка «Редактировать» (если есть права)
+│       └── Редактирование        ← только автор / методолог
+│           ├── О тесте
+│           ├── Вопросы
+│           └── Версии теста      ← (вместо «История» — только версии)
+│
+├── Назначения                    ← новый раздел
+│   ├── Список назначений         ← таблица «тест × сотрудник × срок × статус»
+│   ├── Создать назначение        ← массовый wizard (см. 2.3)
+│   └── /assignments/{id}         ← страница назначения, где можно отозвать,
+│                                   продлить срок, посмотреть прогресс
+│
+├── Отчёты                        ← новый раздел
+│   ├── По тесту                  ← кто прошёл, средний балл, кривые
+│   ├── По сотруднику             ← все тесты сотрудника, история
+│   └── По отделу                 ← агрегаты для руководителей
+│
+├── Сотрудники                    ← справочник, синхронизация с кадрами
+│
+└── Настройки                     ← роли, подразделения, шаблоны уведомлений
+```
+
+## 2.3. Сценарий «Назначить тест» через модалку
+
+Поскольку автор иногда сам назначает тест, а иногда передаёт это HR/руководителю, кнопка «Назначить» нужна **в двух местах**:
+
+- На странице теста (для автора, который сразу выдаёт тест).
+- В разделе «Назначения → Создать» (для HR/руководителя, который отбирает аудиторию массово).
+
+Обе точки открывают **одну и ту же модалку / визард** с шагами:
+
+1. **Кому.** Сначала фильтры по отделу/должности → одной кнопкой «Все из отделения хирургии (38)» или вручную чекбоксами. Сохранение выбранного при смене фильтра. Виртуализированный список.
+2. **Когда.** Дедлайн, опционально дата старта (например, новый сотрудник получает тест на 3-й рабочий день).
+3. **Параметры.** Сколько попыток допустимо, нужен ли пересдача после неуспеха, кому уведомления о результате.
+4. **Подтверждение.** «Назначить тест „Введение про LLM v1“ 38 сотрудникам отделения хирургии до 15 мая 2026 — назначить?»
+
+После назначения автор/HR попадает на страницу созданного назначения, где видит прогресс: кто открыл, кто проходит, кто завершил.
+
+## 2.4. Ролевая модель и матрица доступа
+
+Четыре роли из ваших пояснений: **сотрудник**, **руководитель подразделения**, **HR-менеджер**, **директор**. Плюс отдельно — **методолог/автор**, которая может присваиваться поверх любой из роли (директор, HR или руководитель могут также быть авторами).
+
+| Раздел / действие | Сотрудник | Рук. подр. | HR | Директор | Автор |
+|---|---|---|---|---|---|
+| Главная | свои назначения | свой отдел | вся клиника | вся клиника | свои тесты |
+| Каталог тестов — просмотр | да (только видимые) | да | да | да | да |
+| Создать тест | — | — | да | да | да |
+| Редактировать тест | — | — | (свои) | да | свои |
+| Опубликовать новую версию | — | — | (свои) | да | свои |
+| Удалить/архивировать тест | — | — | (свои) | да | свои |
+| Назначить тест | — | свой отдел | вся клиника | вся клиника | (если сам назначает) |
+| Отозвать назначение | — | свои | свои + HR-уровня | все | свои |
+| Отчёты по сотруднику | свои | подчинённые | все | все | свои тесты |
+| Отчёты по отделу | — | свой отдел | все | все | — |
+| Настройки ролей | — | — | да | да | — |
+
+«—» — действие не доступно. Точные границы (например, может ли HR редактировать чужой тест) уточняются на этапе требований.
+
+## 2.5. Жизненный цикл версии теста и поведение при активных прохождениях
+
+Версионирование уже сделано правильно — оно фиксирует, какую именно версию проходил сотрудник, и не ломает прошлые результаты. Но в UI нужно явно показать состояния и поведение при апдейте.
+
+```
+                  ┌──────────┐
+                  │ Черновик │ ← автор может править свободно,
+                  └────┬─────┘   назначения нельзя выдать
+                       │
+              «Опубликовать как v2»
+                       │
+                       ▼
+                  ┌──────────┐
+                  │ Активная │ ← новые назначения идут на эту версию;
+                  └────┬─────┘   уже идущие прохождения остаются на старой
+                       │
+            «Опубликовать как v3»
+                       │
+                       ▼
+                  ┌──────────┐
+                  │  Архив   │ ← новые назначения нельзя; старые
+                  └──────────┘   прохождения видны в отчётах
+```
+
+Что должно быть видно в UI:
+
+- **Бейдж версии** рядом с названием теста: `Введение про LLM · v2 (активна)`.
+- **На странице редактирования** — явно: «Редактируется черновик v3 на основе активной v2».
+- **При публикации новой версии** — диалог: «Сейчас тест проходят 12 сотрудников на v2. Они закончат на v2; новые назначения пойдут на v3. Опубликовать v3?»
+- **В отчётах** — фильтр по версии теста.
+- **В назначении** — версия зафиксирована: «Назначен на тесте Введение про LLM v2».
+
+## 2.6. Состояние «черновик» страницы теста
+
+Сейчас единственная кнопка — «Сохранить черновик». Лучше добавить два глагола:
+
+- **«Сохранить черновик»** — сохранить промежуточно, не публиковать. Не создаёт новой версии.
+- **«Опубликовать как новую версию»** — фиксирует версию, делает её активной, открывает диалог из 2.5.
+
+Тогда жёлтый баннер из C-1 превращается в осмысленную подсказку: он показывается **только при наличии несохранённых изменений** и говорит «Чтобы изменения попали в назначения — опубликуйте новую версию».
+
+---
+
+# Часть 3. Чеклист изменений
+
+Разбит на три волны по приоритету и независимости работ.
+
+## Волна 1 — быстрые правки на текущей странице (1–2 спринта)
+
+Не требуют структурных изменений, можно делать параллельно с разработкой новой IA:
+
+- [ ] **C-1** Скрыть баннер версионирования при отсутствии изменений (dirty state).
+- [ ] **C-2** Confirm-диалог + прогресс для ИИ-генерации, undo последнего результата.
+- [ ] **C-3** Sticky-панель «Сохранить» внизу + предупреждение `beforeunload` при unsaved changes.
+- [ ] **M-1** Аккордеон «Вопросы» открыт по умолчанию.
+- [ ] **M-2** Валидация порога зачёта (1–100, целое число).
+- [ ] **M-3** Поясняющий текст для «Несколько верных ответов».
+- [ ] **M-5** Confirm + undo для «Удалить вопрос».
+- [ ] **M-6** Длинные варианты — `textarea` с автовысотой.
+- [ ] **M-7** Перевод ENUM-значений статусов прохождения.
+- [ ] **M-9** Toggle-switch для «Видимость» вместо одной кнопки.
+- [ ] **m-1, m-2, m-3** Косметика: логотип логина, роль, опечатка title.
+
+## Волна 2 — выделение разделов (новая IA)
+
+- [ ] Выделить раздел «Назначения» с собственной таблицей и фильтрами.
+- [ ] Перенести «Кому выдать» со страницы теста в модалку «Назначить» из 2.3.
+- [ ] Выделить раздел «Отчёты» из секции «История», расширить фильтрами и агрегатами.
+- [ ] Реализовать ролевую модель из 2.4 (RBAC): меню, разделы и действия зависят от роли.
+- [ ] Реализовать жизненный цикл версии (2.5) и явную публикацию.
+
+## Волна 3 — масштабирование и качество
+
+- [ ] Виртуализация списков сотрудников (поддержка 5 000+).
+- [ ] Drag-and-drop для перестановки вопросов (M-4).
+- [ ] Drag-and-drop загрузка файла с превью результата (m-5).
+- [ ] Аудит доступности (WCAG 2.2 AA): клавиатурная навигация, focus-ring, контрастность.
+- [ ] Адаптивная вёрстка для мобильных и планшетов.
+- [ ] Уведомления (e-mail, в системе) для назначений, дедлайнов, результатов.
+- [ ] Связка с курсами/треками (когда появятся).
+
+---
+
+# Что дальше
+
+После согласования этого документа имеет смысл:
+
+1. Сделать кликабельный прототип в Figma на 2 ключевых сценария: «автор создаёт и сразу назначает тест», «HR назначает существующий тест 200 сотрудникам». Это покажет, как именно ложится новая IA на реальные действия и где остались дыры.
+2. Прогнать прототип на 2–3 пользователях каждой роли (автор, HR, руководитель) — модерируемое юзабилити-тестирование на 30–40 минут. По итогам — финальные правки до старта разработки.
+3. Параллельно запустить Волну 1 — она независима от IA и сразу снимает большую часть пользовательской боли.
+
+---
+
+*Если по какому-то пункту нужно больше деталей или хочется, чтобы я подготовил визард-сценарий «Назначить» в виде последовательных макетов — скажите.*

docs/bugfix/SPRINTS_BUGFIX_TESTS_NAV_AI.md

@@ -0,0 +1,220 @@
+# Спринты по bugfix-задачам (Тесты / Доступ / Генерация)
+
+Дата: 2026-04-30  
+Контур: `flask_app` (UI + API + сервисы генерации)
+
+## Цели пакета
+
+1. Дать доступ всем авторизованным пользователям ко всем активным тестам (без назначений).
+2. Привести поведение шаблона генерации теста к ожидаемому (кол-во вопросов/вариантов/правильных ответов).
+3. Добавить массовые настройки «несколько вариантов ответа».
+4. Улучшить поток работы с подсказками и прозрачность прогресса генерации.
+
+---
+
+## Спринт 1 — Доступ всем авторизованным (без назначений)
+
+### Объём
+
+- Убрать зависимость прохождения теста от назначений (`TestAssignment*`).
+- Разрешить доступ к активным тестам для любого авторизованного пользователя.
+- Проверить, что каталог и старт попытки работают консистентно с новой политикой.
+
+### Задачи
+
+1. **Политика доступа**
+   - В `user_has_test_access` вернуть `ok=True` для любого активного теста, если тест существует и пользователь авторизован.
+   - Оставить проверки авторства только там, где они нужны для редактора/версий/админских действий.
+
+2. **Проверка API прохождения**
+   - `start_attempt`, `play`, `submit`, `review` не должны требовать назначения на пользователя.
+   - Ошибка «Доступ запрещён» не возникает для обычного авторизованного сотрудника при прохождении активного теста.
+
+### Критерии приёмки
+
+- Любой авторизованный пользователь может открыть и пройти любой активный тест, даже без назначения.
+- При этом операции автора (редактор, версии, массовые действия) остаются ограничены автором.
+
+### Оценка
+
+- 0.5 дня.
+
+---
+
+## Спринт 2 — Шаблон генерации: контракт и предсказуемость
+
+### Проблема
+
+Сейчас пользователь создаёт шаблон (например, 12×4), затем генерирует из документа и получает иной результат (например, 10×3). Ожидания и фактический контракт не совпадают.
+
+### Объём
+
+- Зафиксировать единый контракт: какие параметры шаблона обязательны для генератора.
+- Принудительно соблюдать:
+  - количество вопросов,
+  - количество вариантов в вопросе,
+  - границы количества правильных ответов.
+- Добавить валидацию и пост-проверку результата генерации.
+
+### Задачи
+
+1. **Формальный контракт шаблона**
+   - Явно определить обязательные поля shape:
+     - `questions_count`
+     - `options_per_question`
+     - `multiple_answers_default`
+     - `correct_answers_min/max`
+   - Хранить shape вместе с тестом/версией как источник истины.
+
+2. **Генерация по документу с shape**
+   - Передавать shape в генератор при `generate from document`.
+   - После генерации валидировать фактическую структуру.
+   - При расхождении:
+     - либо автоматически нормализовать (добить/сжать до нужного формата),
+     - либо показать понятную ошибку и не сохранять черновик.
+
+3. **Пользовательская обратная связь**
+   - На экране до запуска показывать «Будет сгенерировано: 12 вопросов, 4 варианта».
+   - После завершения показывать фактический итог и предупреждение, если пришлось авто-нормализовать.
+
+### Критерии приёмки
+
+- Для шаблона 12×4 итоговый тест всегда 12 вопросов по 4 варианта.
+- Несоответствие не проходит «тихо»: либо авто-исправление с уведомлением, либо явная ошибка.
+
+### Оценка
+
+- 1.5–2.5 дня.
+
+---
+
+## Спринт 3 — Массовый контроль «Несколько вариантов ответа»
+
+### Объём
+
+- Добавить глобальный чекбокс «Несколько вариантов ответа» (для всех вопросов).
+- В шаблоне добавить диапазон правильных ответов: `от _ до _`.
+- При отключении мультивыбора на конкретном вопросе нижняя граница «от» фиксируется в `1`.
+
+### Задачи
+
+1. **UI шаблона**
+   - Глобальный switch/checkbox: «Несколько вариантов ответа для всех вопросов».
+   - Поля диапазона:
+     - `Мин. правильных` (от),
+     - `Макс. правильных` (до),
+     - валидация `1 <= min <= max <= options_per_question`.
+
+2. **Применение к вопросам**
+   - При включении глобального флага обновлять все вопросы:
+     - `hasMultipleAnswers=true`.
+   - При выключении:
+     - `hasMultipleAnswers=false`,
+     - `minCorrect=1`, `maxCorrect=1`.
+   - На уровне отдельного вопроса разрешить override.
+
+3. **Правило «заморозки min=1»**
+   - Если на вопросе `hasMultipleAnswers=false`, то:
+     - `minCorrect` автоматически = `1`,
+     - поле `minCorrect` read-only/disabled.
+
+4. **Серверная валидация**
+   - API сохраняет/проверяет тот же инвариант.
+   - Невалидные комбинации отклоняются с понятным сообщением.
+
+### Критерии приёмки
+
+- Глобальный флаг влияет на все вопросы.
+- Локальное отключение мультивыбора фиксирует `min=1`.
+- Генератор и редактор работают в одинаковой логике, без рассинхрона.
+
+### Оценка
+
+- 1.5–2 дня.
+
+---
+
+## Спринт 4 — Подсказки и прогресс генерации
+
+### Объём
+
+- В параметрах теста при включённых подсказках показать действие «Сгенерировать подсказки».
+- Генерация подсказок работает только по заполненным вопросам.
+- Если тест генерируется с нуля и подсказки уже включены — подсказки генерируются в том же пайплайне.
+- Добавить прогресс по этапам генерации + локальные индикаторы загрузки в соответствующих блоках UI.
+
+### Задачи
+
+1. **Кнопка/ссылка «Сгенерировать подсказки»**
+   - Показ только при `hintsEnabled=true`.
+   - Показ количества: `N без подсказок`.
+   - Запуск только по вопросам, где есть текст + варианты.
+
+2. **Пайплайн генерации «с нуля»**
+   - Если `hintsEnabled=true`, после генерации вопросов автоматически запускать генерацию подсказок.
+   - Ошибки подсказок не должны ломать весь тест: частичный результат допустим с отчётом.
+
+3. **Прогресс и статусы**
+   - Этапы:
+     - подготовка документа,
+     - извлечение текста,
+     - генерация структуры,
+     - генерация вопросов,
+     - генерация подсказок,
+     - финализация.
+   - В UI показывать текущий этап и процент/счётчик.
+   - Спиннеры показывать только у активного блока (не глобально на всю форму).
+
+4. **Наблюдаемость**
+   - Логи этапов и длительности.
+   - В ответ API возвращать breakdown по шагам/ошибкам.
+
+### Критерии приёмки
+
+- Пользователь видит, что именно сейчас генерируется.
+- Подсказки отдельно запускаются и генерируются только для валидных вопросов.
+- При генерации «с нуля» с включёнными подсказками подсказки появляются автоматически.
+
+### Оценка
+
+- 2–3 дня.
+
+---
+
+## Спринт 5 — Регрессия, UX-полировка, выпуск
+
+### Объём
+
+- Сквозное тестирование сценариев.
+- Документация для пользователей и команды.
+- Подготовка релиз-нота.
+
+### Тест-кейсы (минимум)
+
+1. Неавторизованный пользователь открывает приватные URL → редирект на логин.
+2. Каталог тестов: есть переход «На главную».
+3. Шаблон 12×4 + генерация из PDF → на выходе 12×4.
+4. Глобальный мультивыбор + локальное выключение на 1 вопросе → `min=1` на этом вопросе.
+5. Включены подсказки:
+   - кнопка «Сгенерировать подсказки» доступна,
+   - генерируются только по заполненным вопросам.
+6. Генерация с нуля + подсказки включены → подсказки сгенерированы в том же запуске.
+7. Прогресс этапов отображается корректно, загрузка локальная.
+
+### Оценка
+
+- 1–1.5 дня.
+
+---
+
+## Приоритеты
+
+- **P0:** Спринт 1 (доступ всем авторизованным), критичный функциональный bugfix.
+- **P1:** Спринт 2 (контракт шаблона), устранение основного функционального несоответствия.
+- **P1:** Спринт 3 (массовый мультивыбор), важная продуктовая логика.
+- **P2:** Спринт 4 (подсказки + прогресс), прозрачность и удобство.
+- **P2:** Спринт 5 (регрессия + выпуск).
+
+## Суммарная оценка
+
+Ориентир: **6.5–10 рабочих дней** (в зависимости от объёма автотестов и глубины рефакторинга генератора).

docs/migration-final-inventory.md

@@ -151,7 +151,7 @@
 Используется один тонкий клиент `frontend/src/api.js`: `fetch` с `credentials: 'include'`, базовый путь — пустой (т.е. **`/api/...` относительно текущего origin**, что в dev резолвит Vite-proxy, а в prod — Nginx). Это значит:
 
 - **Менять фронтенд при смене бэкенда не нужно**, если новый сервис отвечает по тем же путям.
-- В dev сейчас `vite.config.js` проксирует `/api` на Express (`localhost:3001`). После переноса — заменить адрес/порт на Flask (см. `flask_app/run.py`, по умолчанию `3108`).
+- В dev сейчас `vite.config.js` проксирует `/api` на Express (`localhost:3001`). После переноса — заменить адрес/порт на Flask (см. `flask_app/run.py`, по умолчанию `3107`).
 
 Список путей (отсортирован по убыванию использований):
 

docs/migration-final.md

@@ -39,7 +39,7 @@
 | `/health` | `flask_app/app/__init__.py` |
 | Пустой `index.html` | `flask_app/app/templates/index.html` |
 | Зависимости | `flask_app/requirements.txt` (Flask, python-dotenv, waitress) |
-| Docker-сервис на порту 3108 | `flask_app/Dockerfile`, корневой `docker-compose.dev.yml` (сервис `testing-flask`) |
+| Docker Flask (порт 3107) | `flask_app/Dockerfile`, `docker-compose.dev.yml` (сервис `testing-flask`) |
 
 Всё остальное — **писать**.
 

docs/performance-flask-mini-app.md

@@ -19,7 +19,7 @@
 | Контур | Путь в репозитории | Назначение |
 |--------|-------------------|------------|
 | **Основной веб-кабинет HR** | `HR_TG_Bot/tgFlaskForm/` | Flask-приложение: авторизация, кабинет, разделы в т.ч. **тестирование сотрудников**. Именно сюда чаще всего относят жалобы «мини-приложение / кабинет на Flask». |
-| **Отдельный Flask-скелет под тестирование** | `TestingWebApp/flask_app/` | Упрощённое приложение того же стека (переходный контур, Docker-сервис `testing-flask`, порт **3108** в `TestingWebApp/docker-compose.dev.yml`). Может быть медленным по тем же причинам (БД, шаблоны, отсутствие кэша статики), но **это не обязательно тот же инстанс**, что видят пользователи в проде. |
+| **Отдельный Flask-скелет под тестирование** | `TestingWebApp/flask_app/` | Упрощённое приложение того же стека (переходный контур, Docker `testing-flask`, порт **3107**). Может быть медленным по тем же причинам (БД, шаблоны, отсутствие кэша статики), но **это не обязательно тот же инстанс**, что видят пользователи в проде. |
 
 Связанные по смыслу документы (миграция данных, две БД):
 
@@ -30,7 +30,7 @@
 
 1. **Веб-кабинет в браузере** (`tgFlaskForm`, типичный порт локально **3104** в `web_run.py`).
 2. **Встроенный WebView в мини-приложении** (Telegram MAX и т.п.) — тот же HTML с того же хоста, но **другая сеть, кэш, DNS, TLS**; воспроизведение обязательно на целевом клиенте.
-3. **Переходный контур** `TestingWebApp` на **3108** — проверять отдельно, если пользователи реально ходят туда.
+3. **Переходный контур** `TestingWebApp` на **3107** — проверять отдельно, если пользователи реально ходят туда.
 
 Перед оптимизацией **уточнить URL/контур** у тех, кто жалуется.
 
@@ -114,7 +114,7 @@
 
 ### Фаза 0 — уточнение (полдня максимум)
 
-- [ ] Точный **URL/продукт** (кабинет HR vs TestingWebApp:3108 vs мини-app WebView).
+- [ ] Точный **URL/продукт** (кабинет HR vs TestingWebApp:3107 vs мини-app WebView).
 - [ ] **Роль пользователя** и сценарий (первый заход, каждый клик, только раздел тестирования).
 - [ ] Есть ли **nginx / CDN** перед приложением.
 
@@ -175,7 +175,7 @@
 | Авторизация и gate | `HR_TG_Bot/tgFlaskForm/webApp/auth.py` |
 | Шаблоны | `HR_TG_Bot/tgFlaskForm/webApp/templates/` |
 | Переходный Flask + waitress | `TestingWebApp/flask_app/run.py`, `TestingWebApp/flask_app/app/` |
-| Docker dev (пример порта 3108) | `TestingWebApp/docker-compose.dev.yml` |
+| Docker dev (по умолчанию 3107 legacy) | `TestingWebApp/docker-compose.dev.yml` |
 | Docker dev кабинета | `HR_TG_Bot/docker-compose.dev.yml` |
 
 ---

docs/Рекомендации UX по экранам теста.md

@@ -0,0 +1,72 @@
+# Рекомендации UX по экранам редактирования теста
+
+*Основание: скриншоты в `docs/screens`, словарь `docs/Словарь UX-UI-IA терминов.md`. Дата фиксации: 29.04.2026.*
+
+---
+
+## Навигация и IA
+
+- **Хлебные крошки.** Сейчас только «← к списку». Имеет смысл добавить полную цепочку вроде «Тесты → Введение про LLM → Редактирование», чтобы снизить когнитивную нагрузку и отразить иерархию сущностей (Тест → Версия).
+- **Якоря по длинной странице.** Блоки «О тесте», «Вопросы», «История», «Показ в каталоге» образуют длинную вертикаль. Полезны боковое оглавление или «прыжки» по разделам / закреплённая поднавигация внутри страницы теста, чтобы не терять контекст при работе с нижними вопросами и назначением.
+
+---
+
+## Состояния интерфейса и обратная связь
+
+- **ИИ-кнопки.** Для «Сгенерировать тест (ИИ)» и «Сгенерировать вопрос (ИИ)» нужны явные состояния: загрузка (спиннер, disabled), успех/ошибка, при необходимости — отмена длительной операции (видимость статуса системы).
+- **Черновик и риск потери данных.** Уже есть заметный «Сохранить черновик» и жёлтый баннер про новую версию — хорошо. Дополнительно: предупреждение при уходе со страницы с несохранёнными изменениями; для длинной формы — **закреплённая панель** с сохранением (или дублирование primary-действия после блока вопросов), чтобы не скроллить вниз каждый раз.
+
+---
+
+## Редактор вопросов (UI и логика)
+
+- **Один vs несколько верных ответов.** При включённом «Несколько верных ответов» визуально должны быть **чекбоксы**, а не радиокнопки — соответствие метафоре, ожиданиям пользователя и доступности (скринридер, множественный выбор).
+- **Разделение действий.** «+ вариант» и «Удалить вопрос» сейчас визуально близки по весу — риск ошибочного клика. Деструктивное действие: вторичный стиль, отступ, по желанию подтверждение или «Удалить» в меню «⋯».
+- **Иерархия ИИ vs ручное редактирование.** Блок «Генерация сетки (ИИ)» логично оформить как сворачиваемый «продвинутый» блок или визуально отделить (заголовок, граница), чтобы отличать массовую генерацию от точечной «Сгенерировать вопрос» у карточки.
+- **Длинные варианты ответа.** Обрезка текста в однострочном поле мешает автору. Варианты: многострочное поле с авто-ростом по высоте или предпросмотр полной строки при фокусе/hover.
+
+---
+
+## Локализация и терминология
+
+- В истории статус **`in_progress` на английском** при русском интерфейсе — заменить на «В процессе» или единый глоссарий статусов прохождения.
+- В шапке роль **`employee`** — унифицировать с русскими названиями ролей из словаря проекта (сотрудник, HR и т.д.).
+
+---
+
+## «Показ в каталоге» и список сотрудников
+
+- **Кнопка «Назначить выбранных».** Сейчас выглядит как вторичная; это главное действие сценария выдачи теста. Имеет смысл сделать её **заполненной primary** при наличии выбора и **disabled с подсказкой**, если никто не выбран.
+- **Повтор строки «нет учётки (создадим при назначении)».** На каждой строке создаётся шум. Лучше: один информационный блок над списком; в строке — компактный бейдж/иконка только где уместно.
+- **Крайний случай: много сотрудников.** При сотнях/тысячах записей — виртуализация, пагинация или «выбрать всех по фильтру» с явным числом «будет назначено N человек».
+
+---
+
+## История и версии
+
+- При росте списка карточки версий и прохождений превращаются в длинную простыню — предусмотреть **свёрнутый список**, пагинацию или табы «Версии» / «Прохождения» с фильтром по версии и статусу.
+
+---
+
+## Доступность и плотность
+
+- Мелкий серый текст в списке сотрудников — проверить контраст (WCAG).
+- Чекбоксы и переключатели: достаточная зона клика, связь подписи с полем, логичный порядок табуляции.
+
+---
+
+## Пустые состояния
+
+- Пустая история, нет вопросов, поиск «никого не нашёл» — короткий текст **почему пусто** и **следующий шаг** («Добавьте вопрос», «Измените фильтр»).
+
+---
+
+## Приоритизация внедрения
+
+1. **Высокий эффект / низкий риск:** локализация статусов и ролей; визуальное различие «Удалить вопрос» vs «+ вариант»; primary для «Назначить выбранных»; убрать повтор длинного текста про учётку в каждой строке.
+2. **Средний:** чекбоксы при нескольких верных ответах; многострочные варианты; состояния загрузки для ИИ; закреплённое сохранение.
+3. **Стратегический:** хлебные крошки и внутренняя навигация по разделу; масштабирование списка назначений; пустые состояния; продуктовая аналитика (например, доходят ли авторы до «Показ в каталоге»).
+
+---
+
+*Документ можно дополнять по мере внедрения и новых скринов.*

docs/Словарь UX-UI-IA терминов.md

@@ -0,0 +1,298 @@
+# Словарь терминов проектирования
+
+**UX · UI · IA и смежные понятия**
+
+*Контекст: HR system / Платформа Цифровых Сервисов клиники им. Е. Н. Оленевой*
+
+---
+
+Короткий справочник, чтобы команда говорила на одном языке. Для каждого термина: русское название, английский эквивалент, короткое определение и пример из вашего продукта, чтобы было понятно, как термин применяется в реальной работе.
+
+Файл живой: добавляйте сюда термины, которые регулярно всплывают в обсуждениях.
+
+---
+
+## 1. Три основных слоя проектирования
+
+Три понятия, которые часто путают друг с другом. Это не синонимы и не одно и то же — это три разных профессиональных взгляда на один и тот же продукт.
+
+### UX (User Experience) — *опыт взаимодействия / пользовательский опыт*
+
+Совокупность ощущений пользователя от взаимодействия с продуктом: насколько просто понять, как достичь цели, насколько быстро это получается, насколько мало раздражения по дороге. UX — это про задачу пользователя, а не про конкретный экран.
+
+> *Пример из HR system:* HR-менеджер хочет назначить тест 50 сотрудникам отделения. Хороший UX — он делает это в три клика через фильтр по отделу. Плохой UX — он скроллит список из 147 человек и отмечает чекбоксами вручную.
+
+### UI (User Interface) — *пользовательский интерфейс*
+
+Видимая и кликабельная часть продукта: кнопки, поля, цвета, иконки, типографика, состояния (наведение, фокус, ошибка). UI — это про то, как продукт выглядит и как откликается на действия.
+
+> *Пример из HR system:* Кнопка «Сохранить черновик» на странице теста — её цвет, размер, скруглённые углы, текст внутри, реакция на наведение курсора — это всё UI.
+
+### IA (Information Architecture) — *информационная архитектура*
+
+Структура продукта на уровне «что где лежит и как связано»: какие есть разделы, какие сущности живут внутри, по какой логике пользователь переходит с одной страницы на другую. IA — это скелет, на который потом натягиваются UX и UI.
+
+> *Пример из HR system:* Решение «авторская работа над тестом, назначение и отчётность — это три разных раздела меню, а не один длинный аккордеон» — это IA-решение.
+
+---
+
+## 2. Исследования и работа с пользователем
+
+### Целевая аудитория — *target audience*
+
+Группы людей, для которых проектируется продукт. У каждой группы своя задача и контекст использования.
+
+> *Пример из HR system:* В вашей системе четыре аудитории: сотрудник, руководитель подразделения, HR-менеджер, директор. У них разные потребности и разные роли в системе.
+
+### Персона — *persona*
+
+Собирательный образ типичного представителя аудитории: имя, должность, цели, ограничения, частые сценарии. Помогает команде договориться, для кого мы решаем задачу.
+
+> *Пример из HR system:* «Ольга, HR-менеджер, 35 лет. Раз в квартал назначает массовое обучение 200 сотрудникам. Не любит интерфейсы, где надо кликать каждого по отдельности. Открывает систему с рабочего ноутбука и иногда с телефона на ходу.»
+
+### Сценарий использования — *user scenario / use case*
+
+История: пользователь приходит с какой-то задачей и проходит шаги, чтобы её решить. Сценарий описывает, что он делает и какие ожидания у него есть.
+
+> *Пример из HR system:* «Руководитель отделения хочет, чтобы все его подчинённые прошли тест по пожарной безопасности до конца квартала. Он входит в систему, выбирает свой отдел, выбирает тест, ставит дедлайн, отправляет.»
+
+### Пользовательский путь / CJM — *Customer Journey Map*
+
+Развёрнутая визуализация пути пользователя: шаги, точки контакта, эмоции на каждом этапе, где возникают проблемы (pain points) и где можно улучшить.
+
+> *Пример из HR system:* CJM сотрудника: получил уведомление → открыл письмо → перешёл по ссылке → ввёл логин → увидел список назначенных тестов → выбрал → прошёл → получил результат. На каждом шаге — что ему легко, а что мешает.
+
+### JTBD (Jobs To Be Done) — *работы, которые нужно выполнить*
+
+Подход: люди не «пользуются продуктом», они «нанимают» его, чтобы сделать конкретную работу. Помогает увидеть истинную мотивацию, а не поверхностный запрос.
+
+> *Пример из HR system:* HR не «нанимает» вашу систему, чтобы кликать по чекбоксам. Он нанимает её, чтобы доказать аудиту, что 100% персонала прошли инструктаж в срок.
+
+### Pain point — *болевая точка*
+
+Конкретное место, где пользователю плохо: непонятно, медленно, страшно, обидно. Pain points — главные кандидаты на улучшение.
+
+> *Пример из HR system:* На странице теста пользователь не понимает, где кнопка «Сохранить», и боится потерять изменения — это pain point.
+
+---
+
+## 3. Информационная архитектура и навигация
+
+### Карта сайта / структура продукта — *sitemap*
+
+Иерархическое описание всех экранов и разделов продукта. Показывает, что есть в продукте и в каких отношениях разделы стоят друг к другу.
+
+> *Пример из HR system:* Главная → Тесты → [страница теста] → Назначения → Отчёты → Сотрудники → Настройки.
+
+### Навигация — *navigation*
+
+Способ перемещаться по продукту: главное меню, хлебные крошки, ссылки, табы, кнопки «назад». Навигация бывает первичной (основной), вторичной и контекстной.
+
+> *Пример из HR system:* Шапка с логотипом «Тестирование», меню справа («Тесты», «Назначения», «Отчёты»), ссылка «← к списку» наверху страницы — всё это элементы навигации.
+
+### Хлебные крошки — *breadcrumbs*
+
+Цепочка ссылок, показывающая, где пользователь находится в иерархии и куда можно вернуться: «Тесты / Введение про LLM / Редактирование».
+
+> *Пример из HR system:* Сейчас на странице теста есть только «← к списку». Полные крошки помогли бы быстрее ориентироваться.
+
+### Таксономия — *taxonomy*
+
+Набор категорий и тегов, по которым классифицируются объекты. Хорошая таксономия позволяет быстро находить нужное и не плодит дубликаты.
+
+> *Пример из HR system:* Тест может иметь категории: «обязательные», «рекомендованные», «по специальности», «обучающие». Это таксономия.
+
+### Сущность / объект предметной области — *entity / domain object*
+
+Главные «существительные» вашей системы: Тест, Версия теста, Вопрос, Вариант, Сотрудник, Назначение, Прохождение, Отчёт. Дизайн начинается с понимания, какие сущности есть и как они связаны.
+
+> *Пример из HR system:* Связь «Тест → Версия → Прохождение» позволяет фиксировать результаты конкретной версии, даже если автор потом изменил вопросы.
+
+---
+
+## 4. Проектирование интерфейса
+
+### Вайрфрейм — *wireframe*
+
+Скелетный набросок экрана без цвета и стилей: просто блоки, поля, кнопки, чтобы показать структуру и иерархию. Используется на ранних этапах для быстрого обсуждения.
+
+> *Пример из HR system:* Перед прорисовкой страницы создания теста — простой набросок: «слева 70% — форма, справа 30% — превью теста».
+
+### Макет — *mockup*
+
+Визуально проработанный вариант экрана: с реальными цветами, шрифтами, иконками, но обычно статичный (не кликается).
+
+> *Пример из HR system:* Готовый Figma-макет страницы теста, согласованный с вашим зелёным брендом и шрифтом.
+
+### Прототип — *prototype*
+
+Кликабельная модель продукта: можно жать на кнопки, переходить между экранами, увидеть переходы. Прототип бывает разной степени проработанности — от карандашных набросков до почти-настоящего продукта.
+
+> *Пример из HR system:* Кликабельный прототип в Figma, на котором можно «пройти» сценарий «создал тест → назначил отделению → получил уведомление о результате».
+
+### Состояния интерфейса — *states*
+
+Один и тот же элемент или экран в разных ситуациях: пустой, загрузка, ошибка, успех, наведение, фокус, отключённый. Хорошие проекты прорисовывают все состояния, а не только «всё хорошо».
+
+> *Пример из HR system:* Кнопка «Назначить выбранных» имеет состояния: disabled (никто не выбран), normal, hover, loading (отправка идёт), success (готово).
+
+### Empty state — *пустое состояние*
+
+Что пользователь видит, когда данных нет: список пуст, поиск ничего не нашёл, ещё ничего не назначено. Хороший empty state объясняет, почему пусто, и предлагает следующий шаг.
+
+> *Пример из HR system:* Сотрудник заходит и видит пустой список «Мои тесты». Empty state: «Сейчас вам ничего не назначено. Когда руководитель добавит тест — он появится здесь.»
+
+### Edge case — *крайний случай*
+
+Редкая, но возможная ситуация: ноль элементов, тысяча элементов, очень длинный текст, обрыв сети. Игнорирование edge cases ломает интерфейс именно тогда, когда пользователь меньше всего этого ожидает.
+
+> *Пример из HR system:* Что если в клинике 5000 сотрудников, а не 147? Список «Кому выдать» сегодня этого не выдержит — это edge case, который нужно учесть.
+
+### Happy path — *счастливый сценарий*
+
+Идеальное прохождение сценария без ошибок и непредвиденных ситуаций. Полезно как стартовая точка, но проектирование только под happy path — частая ошибка.
+
+> *Пример из HR system:* «Автор создаёт тест, заполняет 7 вопросов, сохраняет, назначает отделу, все проходят» — это happy path. А что если у автора оборвался интернет на полпути?
+
+---
+
+## 5. Дизайн-система и компоненты
+
+### Дизайн-система — *design system*
+
+Набор готовых правил, компонентов и токенов (цветов, отступов, шрифтов), которыми пользуется вся команда. Цель — единообразие и скорость: не изобретать каждый раз кнопку с нуля.
+
+> *Пример из HR system:* Внутри Платформы Цифровых Сервисов клиники должна быть единая дизайн-система: HR system, регистратура, эндовидеоплатформа выглядят как продукты одной семьи.
+
+### UI-кит — *UI kit*
+
+Библиотека готовых интерфейсных элементов (кнопки, поля, модалки, таблицы) в Figma или коде, которой пользуются дизайнеры и разработчики.
+
+> *Пример из HR system:* Если у вас есть UI-кит, новая страница «Назначения» собирается из готовых компонентов за день, а не за неделю.
+
+### Компонент — *component*
+
+Самостоятельный кусочек интерфейса с понятным API: входные параметры, состояния, поведение. Кнопка, поле ввода, аккордеон, модалка — всё это компоненты.
+
+> *Пример из HR system:* Аккордеон «О тесте» / «Вопросы» / «История» / «Показ в каталоге» — четыре экземпляра одного и того же компонента «аккордеон».
+
+### Токен дизайна — *design token*
+
+Атомарная переменная стиля: цвет, отступ, размер шрифта, радиус скругления. Токены позволяют менять оформление всего продукта централизованно.
+
+> *Пример из HR system:* Цвет `primary-green = #2E7D5B` — токен. Если решите перейти на другой оттенок зелёного, меняете в одном месте, и все кнопки обновляются.
+
+### Паттерн — *pattern*
+
+Типовое решение типовой задачи: «как реализовать поиск с фильтрами», «как показать длинный список». Паттерны — это коллективная мудрость комьюнити.
+
+> *Пример из HR system:* Паттерн «master-detail»: слева список тестов, справа детали выбранного. Хорошо ложится на ваш будущий раздел «Назначения».
+
+---
+
+## 6. Качество и проверка дизайна
+
+### Юзабилити — *usability*
+
+Свойство интерфейса быть простым и эффективным в использовании. Измеряется через эффективность (получилось ли), скорость и количество ошибок.
+
+> *Пример из HR system:* Если сотрудник не может с первого раза найти, как пройти тест — у интерфейса проблема с юзабилити.
+
+### Доступность — *accessibility / a11y*
+
+Возможность использовать продукт людям с особенностями: слабовидящим, незрячим (через скринридеры), людям с моторными ограничениями (только клавиатура), дальтоникам. Стандарт — WCAG.
+
+> *Пример из HR system:* Радиокнопки выбора правильного варианта должны быть доступны с клавиатуры (Tab + Space) и понятны скринридеру («Вариант 1 из 3, выбран»).
+
+### Юзабилити-тестирование — *usability testing*
+
+Метод исследования: реальный пользователь выполняет задание, исследователь наблюдает, где он спотыкается. Дешёвый способ найти большую часть проблем.
+
+> *Пример из HR system:* Дать HR-менеджеру задание «назначь этот тест всему отделению хирургии до 1 мая» и записать, где он зависнет.
+
+### Эвристическая оценка — *heuristic evaluation*
+
+Эксперт сверяет интерфейс с набором эвристик (правил хорошего дизайна, например, эвристиками Нильсена) и фиксирует нарушения. Быстрее теста с пользователями, но менее точно.
+
+> *Пример из HR system:* Анализ страницы теста, который мы делаем сейчас — это, по сути, эвристическая оценка.
+
+### A/B-тест — *A/B testing*
+
+Сравнение двух вариантов интерфейса на реальной аудитории: половина видит вариант A, половина — B; измеряем, какой работает лучше.
+
+> *Пример из HR system:* Сравнить две формулировки кнопки: «Сохранить черновик» vs «Сохранить и назначить» — что чаще ведёт к завершению задачи.
+
+### Аналитика продукта — *product analytics*
+
+Сбор и анализ данных о том, как пользователи реально пользуются продуктом: где кликают, где бросают, сколько времени проводят. Подсказывает, где искать проблемы.
+
+> *Пример из HR system:* Если в аналитике видно, что 40% авторов не доходят до раздела «Показ в каталоге» — это сигнал, что его упускают.
+
+---
+
+## 7. Технические понятия, нужные дизайнеру
+
+### Респонсив / адаптивность — *responsive design*
+
+Способность интерфейса корректно работать на разных размерах экрана: от телефона до большого монитора. Не путать с «мобильной версией».
+
+> *Пример из HR system:* Список «Кому выдать» должен оставаться удобным на 13-дюймовом ноутбуке руководителя и на телефоне HR-менеджера в дороге.
+
+### Брейкпойнт — *breakpoint*
+
+Ширина экрана, на которой меняется раскладка интерфейса. Типовые: 360, 768, 1024, 1440 px.
+
+> *Пример из HR system:* На брейкпойнте 768 px (планшет) две колонки на странице теста схлопываются в одну.
+
+### RBAC — *Role-Based Access Control / ролевая модель доступа*
+
+Правила, что какая роль видит и может делать в системе. Дизайн интерфейса должен учитывать роль: один и тот же экран показывается по-разному сотруднику, руководителю, HR и директору.
+
+> *Пример из HR system:* Сотрудник видит только «Мои тесты». Руководитель — ещё «Мой отдел». HR — все назначения. Директор — сводный отчёт.
+
+### Версионирование — *versioning*
+
+Подход, при котором у объекта (теста, документа) есть несколько версий, и история фиксируется. Полезно для аудита и неизменности результатов.
+
+> *Пример из HR system:* В вашей системе тест имеет версии v1, v2 и т.д. Прохождение всегда привязано к конкретной версии — изменения автора не «переписывают» прошлые результаты.
+
+### Состояние черновика — *draft state*
+
+Промежуточное состояние объекта: ещё не опубликован/не активирован, можно безопасно править.
+
+> *Пример из HR system:* Кнопка «Сохранить черновик» означает: тест сохранён, но пока не выдан сотрудникам. Можно ещё дорабатывать.
+
+### Уведомление — *notification*
+
+Сообщение системы пользователю: всплывающее (toast), баннер на странице, push, e-mail. Каждый канал имеет свои правила использования.
+
+> *Пример из HR system:* Тост «Тест сохранён» после нажатия кнопки. E-mail сотруднику с дедлайном по назначенному тесту.
+
+---
+
+## 8. Терминология этого проекта
+
+Чтобы команда не путалась, фиксируем основные сущности HR system явно.
+
+- **Тест** — учебный материал, состоящий из вопросов с вариантами ответов. Один тест может иметь несколько версий.
+- **Версия теста** — снимок содержимого теста на момент сохранения. Прохождение всегда привязано к конкретной версии.
+- **Вопрос** — отдельный пункт теста с формулировкой и набором вариантов. Может допускать один или несколько верных ответов.
+- **Вариант ответа** — один из предложенных ответов на вопрос. Помечается как верный или нет.
+- **Назначение** — связь «тест × сотрудник × срок». Формирует у сотрудника обязательство пройти этот тест.
+- **Прохождение** — попытка сотрудника пройти конкретную версию теста. Имеет статус (в процессе, пройдено, не пройдено) и результат (X из Y).
+- **Порог зачёта** — процент правильных ответов, начиная с которого прохождение засчитывается.
+- **Каталог** — общий список тестов, видимый сотрудникам с правами.
+- **Роль** — профиль доступа: сотрудник, руководитель подразделения, HR-менеджер, директор.
+
+---
+
+## Полезные ссылки и стандарты
+
+- **Эвристики Якоба Нильсена** — 10 базовых правил юзабилити: [nngroup.com](https://www.nngroup.com/articles/ten-usability-heuristics/)
+- **WCAG 2.2** — стандарт доступности: [w3.org/TR/WCAG22](https://www.w3.org/TR/WCAG22/)
+- **Material Design** — [m3.material.io](https://m3.material.io/) и **Apple HIG** — [developer.apple.com/design](https://developer.apple.com/design/human-interface-guidelines/) — два больших источника готовых паттернов и принципов.
+- **Refactoring UI** (Adam Wathan, Steve Schoger) — настольная книга по практическому UI-дизайну.
+
+---
+
+*— Справочник можно дополнять по мере появления новых терминов —*

flask_app/.env.example

@@ -1,6 +1,6 @@
 # ─── HTTP сервер ─────────────────────────────────────────────────
-# Порт (не пересекать с :3107 текущего docker-compose.dev.yml)
+# Порт как в docker-compose (:3107).
-PORT=3108
+PORT=3107
 FLASK_DEBUG=1
 # В Docker задайте WEB_USE_WAITRESS=1 (см. docker-compose.dev.yml)
 # WEB_USE_WAITRESS=1
@@ -23,3 +23,8 @@ DATABASE_URL=postgresql://hr_bot_user:hrbot123@localhost:5432/clinic_tests
 # (Werkzeug-хеш в public.users.password по web_login = username).
 # HR_AUTH=1
 # HR_DATABASE_URL=postgresql://hr_bot_user:hrbot123@localhost:5432/hr_bot_test
+
+# ─── Редактирование тестов (до внедрения RBAC) ───────────────────
+# По умолчанию любой залогиненный пользователь может править любой тест.
+# Чтобы снова ограничить сохранение/ИИ/версии только автором цепочки:
+# CLINIC_TESTS_RESTRICT_EDIT_TO_AUTHOR=1

flask_app/Dockerfile

@@ -4,7 +4,7 @@ FROM python:3.11-slim
 ENV PYTHONDONTWRITEBYTECODE=1 \
     PYTHONUNBUFFERED=1 \
     PIP_DISABLE_PIP_VERSION_CHECK=1 \
-    PORT=3108 \
+    PORT=3107 \
     WEB_USE_WAITRESS=1 \
     FLASK_DEBUG=0
 
@@ -15,7 +15,9 @@ RUN pip install --no-cache-dir -r requirements.txt
 
 COPY run.py .
 COPY app ./app
+COPY alembic.ini .
+COPY alembic ./alembic
 
-EXPOSE 3108
+EXPOSE 3107
 
 CMD ["python", "run.py"]

flask_app/README.md

@@ -1,27 +1,26 @@
-# Flask-контур тестирования (тот же стек, отдельный деплой)
+# Flask-контур тестирования (целевой стек)
 
-Здесь — **новое** приложение на **Python / Flask** в духе `HR_TG_Bot/tgFlaskForm` (шаблоны + серверный рендер, без React). Старый стек (`backend/` + `frontend/`) пока не удаляется: оба контура могут существовать параллельно, пока не зафиксирована политика «один источник записи» и cutover.
+Приложение на **Python 3.11 / Flask 3 / Jinja2** в духе
+`HR_TG_Bot/tgFlaskForm` (серверный рендер, без React). На этом контуре
+работает прод **[edullm.pirogov.ai](https://edullm.pirogov.ai/)**.
+
+Старый стек (`backend/` + `frontend/`) пока не удаляется: оба контура
+существуют параллельно до закрытия паритета (спринты **E1.4–E1.6** в
+[`docs/migration-final.md`](../docs/migration-final.md)).
 
 ## Запуск в Docker (рекомендуется)
 
-Из **корня** репозитория TestingWebApp. Сервис **не** зависит от `testing-backend` и **не** требует внешней сети Postgres для старта (только внутренняя сеть compose).
+Из **корня** репозитория TestingWebApp. `docker-compose.dev.yml` уже
-
+подключён к сети `postgres` (`hr_postgres_dev_net`) и пробрасывает
-```bash
+`DATABASE_URL`, `HR_AUTH`, `HR_DATABASE_URL`, `DEEPSEEK_API_KEY` /
-docker compose -f docker-compose.dev.yml up -d --build testing-flask
+`OPENAI_API_KEY` / `LLM_BASE_URL` / `LLM_MODEL` из корневого `.env`.
-```
-
-Когда подключите БД из контейнера к `hr_postgres_dev` / `clinic_tests`, в `docker-compose.dev.yml` у сервиса `testing-flask` добавьте сеть `postgres` (как у `testing-backend`).
-
-- **URL:** http://localhost:3108  
-- **Проверка:** http://localhost:3108/health  
-
-Вместе со старым UI и API:
 
 ```bash
 docker compose -f docker-compose.dev.yml up -d --build
 ```
 
-Тогда Node-интерфейс остаётся на **http://localhost:3107**, Flask — на **3108**.
+- **URL:** http://localhost:3107  
+- **Проверка:** http://localhost:3107/health  
 
 ## Запуск локально (без Docker)
 
@@ -34,7 +33,7 @@ cp .env.example .env      # при необходимости поправьте
 python run.py
 ```
 
-По умолчанию: **http://127.0.0.1:3108** , проверка: **http://127.0.0.1:3108/health**  
+По умолчанию (без `PORT` в `.env`): **http://127.0.0.1:3107** , проверка: **http://127.0.0.1:3107/health**  
 Для режима как в Docker (waitress): в `.env` задайте `WEB_USE_WAITRESS=1`.
 
 ## Зачем отдельная папка
@@ -42,16 +41,28 @@ python run.py
 - Один **стек** с кабинетом / мини-приложением — проще переносить экраны и запросы из `HR_TG_Bot/tgFlaskForm/webApp/interfaces/testing/`.
 - **Отдельный** процесс и порт — без риска сломать текущий `docker-compose.dev.yml` с Node до готовности.
 
-## Дальнейшие шаги (код)
+## Состояние спринтов
 
-Этот каталог — место разработки **Этапа 1** ([migration-final.md](../docs/migration-final.md)).
+Этот каталог — место разработки **Этапа 1**
+([migration-final.md](../docs/migration-final.md)).
 
-1. Подключить БД **`clinic_tests`** (схема не меняется), psycopg2-пул в стиле `tgFlaskForm/db/`.
+| Спринт | Что входит | Статус |
-2. Перенести 22 эндпоинта Express из `backend/` в blueprint'ы Flask, ориентируясь на чек-лист в [migration-final-inventory.md](../docs/migration-final-inventory.md).
+|---|---|---|
-3. Перенести экраны React (`frontend/src/pages/*`) в Jinja-шаблоны `app/templates/`, повторяя мобильный UX [Спринта 3](../docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md).
+| E1.0 | База Flask-приложения, БД-пул, сессии, `base.html`. | ✅ |
-4. Когда паритет закрыт — `docker-compose.dev.yml` указывает на этот сервис как основной, `backend/` и `frontend/` уходят.
+| E1.1 | Auth + `/api/me` (bcrypt + Werkzeug, опц. `HR_AUTH`). | ✅ |
+| E1.2 | Каталог тестов и редактор (функциональный минимум). | ✅ |
+| E1.3 | Импорт документов (PDF / DOCX / TXT / MD). | ✅ |
+| E1.4 | Назначения и прохождение тестов. | ⬜ |
+| E1.5 | Трекер попыток + страница настроек цепочки. | ⬜ |
+| E1.6 | Cutover: удаление `backend/` и `frontend/`. | ⬜ |
+| E1.7 | UX-полировка: 4 аккордеона + drag-n-drop. | ⬜ |
+| E1.8 | AI-функции v2 (`/settings`, generate / check / improve). | ✅ |
 
-ETL `clinic_tests → hr_bot_test` и слияние с `tgFlaskForm` — это **Этап 2**, на будущее ([migration-to-tgflaskform.md](../docs/migration-to-tgflaskform.md)).
+Чек-лист эндпоинтов и gap-analysis с `tgFlaskForm` —
+[`migration-final-inventory.md`](../docs/migration-final-inventory.md).
+ETL `clinic_tests → hr_bot_test` и слияние с `tgFlaskForm` — это
+**Этап 2**, на будущее
+([migration-to-tgflaskform.md](../docs/migration-to-tgflaskform.md)).
 
 ## Связанные документы
 

flask_app/alembic.ini

@@ -0,0 +1,43 @@
+[alembic]
+script_location = alembic
+prepend_sys_path = .
+version_path_separator = os
+
+# URL задаётся динамически в env.py через get_database_url()
+sqlalchemy.url =
+
+[post_write_hooks]
+
+[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

flask_app/alembic/env.py

@@ -0,0 +1,58 @@
+"""Alembic environment — подключает модели и настраивает миграции."""
+from __future__ import annotations
+
+import os
+import sys
+from logging.config import fileConfig
+
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+# Добавляем flask_app в sys.path, чтобы `from app...` работало.
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
+
+from app.db import get_database_url
+from app.models import Base  # noqa: E402 — импорт после sys.path
+
+config = context.config
+config.set_main_option('sqlalchemy.url', get_database_url())
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+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"},
+        compare_type=True,
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    connectable = engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix='sqlalchemy.',
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(
+            connection=connection,
+            target_metadata=target_metadata,
+            compare_type=True,
+        )
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

flask_app/alembic/script.py.mako

@@ -0,0 +1,27 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from __future__ import annotations
+
+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"}

flask_app/alembic/versions/0001_baseline.py

@@ -0,0 +1,30 @@
+"""Baseline — existing schema recognised by ORM.
+
+Revision ID: 0001_baseline
+Revises:
+Create Date: 2026-04-29
+
+Эта ревизия не создаёт таблиц: схема существует. Она фиксирует текущее
+состояние как отправную точку для будущих автогенерированных миграций.
+
+Чтобы применить при первом запуске:
+    alembic stamp 0001_baseline   # если схема уже есть
+    # или:
+    alembic upgrade head           # если схема пустая
+"""
+from __future__ import annotations
+
+from typing import Sequence, Union
+
+revision: str = "0001_baseline"
+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:
+    pass  # схема уже создана SQL-скриптами / Docker entrypoint
+
+
+def downgrade() -> None:
+    pass

flask_app/alembic/versions/0002_tests_hints_result_mode.py

@@ -0,0 +1,38 @@
+"""Добавление hints_enabled и result_mode в tests.
+
+Revision ID: 0002_tests_hints_result_mode
+Revises: 0001_baseline
+Create Date: 2026-04-29
+
+Совместимо с БД, где колонки уже есть: используется ADD COLUMN IF NOT EXISTS (PostgreSQL).
+"""
+from __future__ import annotations
+
+from typing import Sequence, Union
+
+from alembic import op
+
+revision: str = "0002_tests_hints_result_mode"
+down_revision: Union[str, None] = "0001_baseline"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.execute(
+        """
+        ALTER TABLE tests
+          ADD COLUMN IF NOT EXISTS hints_enabled BOOLEAN NOT NULL DEFAULT false;
+        ALTER TABLE tests
+          ADD COLUMN IF NOT EXISTS result_mode VARCHAR(16) NOT NULL DEFAULT 'end';
+        """
+    )
+
+
+def downgrade() -> None:
+    op.execute(
+        """
+        ALTER TABLE tests DROP COLUMN IF EXISTS hints_enabled;
+        ALTER TABLE tests DROP COLUMN IF EXISTS result_mode;
+        """
+    )

flask_app/alembic/versions/0003_question_ai_hint.py

@@ -0,0 +1,35 @@
+"""Добавление ai_hint в questions.
+
+Revision ID: 0003_question_ai_hint
+Revises: 0002_tests_hints_result_mode
+Create Date: 2026-04-29
+
+Колонка опциональная (TEXT NULL), как в ORM Question.ai_hint.
+"""
+from __future__ import annotations
+
+from typing import Sequence, Union
+
+from alembic import op
+
+revision: str = "0003_question_ai_hint"
+down_revision: Union[str, None] = "0002_tests_hints_result_mode"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.execute(
+        """
+        ALTER TABLE questions
+          ADD COLUMN IF NOT EXISTS ai_hint TEXT NULL;
+        """
+    )
+
+
+def downgrade() -> None:
+    op.execute(
+        """
+        ALTER TABLE questions DROP COLUMN IF EXISTS ai_hint;
+        """
+    )

flask_app/app/__init__.py

@@ -11,6 +11,32 @@ import secrets
 from datetime import timedelta
 
 from flask import Flask, jsonify, render_template, request
+from werkzeug.exceptions import RequestEntityTooLarge
+
+
+_ROLE_LABELS = {
+    'employee': 'Сотрудник',
+    'manager': 'Руководитель',
+    'hr': 'HR',
+}
+
+
+def _format_role(role: str | None) -> str:
+    return _ROLE_LABELS.get((role or '').strip().lower(), '')
+
+
+def _format_surname_with_initials(full_name: str | None, fallback: str | None = None) -> str:
+    name = (full_name or '').strip()
+    if not name:
+        return (fallback or '—').strip() or '—'
+    parts = [p for p in name.replace('\xa0', ' ').split(' ') if p]
+    if len(parts) < 2:
+        return name
+    surname = parts[0]
+    initials = []
+    for p in parts[1:3]:
+        initials.append(f'{p[0].upper()}.')
+    return f"{surname} {' '.join(initials)}".strip()
 
 
 def create_app() -> Flask:
@@ -44,6 +70,12 @@ def create_app() -> Flask:
     app.register_blueprint(tests_bp)
     app.register_blueprint(settings_bp)
 
+    from . import db as _db
+
+    @app.teardown_appcontext
+    def _shutdown_session(exc):  # noqa: ARG001
+        _db.remove_session()
+
     from .config import is_assignment_feature_enabled, is_dev_ui, is_hr_auth_enabled
     from .auth.decorators import current_user as _current_user
 
@@ -54,8 +86,16 @@ def create_app() -> Flask:
             'hr_auth_enabled': is_hr_auth_enabled(),
             'dev_ui': is_dev_ui(),
             'assignment_ui': is_assignment_feature_enabled(),
+            'format_name_short': _format_surname_with_initials,
+            'format_role': _format_role,
         }
 
+    @app.errorhandler(RequestEntityTooLarge)
+    def _payload_too_large(_e):
+        if _is_api_path():
+            return jsonify(error='Файл слишком большой (лимит загрузки на сервере).'), 413
+        return ('Файл слишком большой.', 413, {'Content-Type': 'text/plain; charset=utf-8'})
+
     @app.errorhandler(404)
     def _not_found(_e):
         if _is_api_path():

flask_app/app/auth/routes.py

@@ -14,7 +14,7 @@ from flask import (
     url_for,
 )
 
-from ..config import is_assignment_feature_enabled, is_dev_ui
+from ..config import get_dev_fio_password, is_assignment_feature_enabled, is_dev_ui, is_hr_auth_enabled
 from ..messages import RU
 from .decorators import login_required, current_user
 from .services import AuthError, authenticate_credentials
@@ -46,7 +46,12 @@ def _do_login(login: str, password: str):
 def login_page():
     if current_user() is not None:
         return redirect(_safe_next('/'))
-    return render_template('auth/login.html', next=_safe_next('/'))
+    return render_template(
+        'auth/login.html',
+        next=_safe_next('/'),
+        dev_fio_enabled=bool(get_dev_fio_password()),
+        hr_auth_enabled=is_hr_auth_enabled(),
+    )
 
 
 @auth_bp.route('/login', methods=['POST'])
@@ -57,11 +62,23 @@ def login_submit():
         _do_login(login, password)
     except AuthError as e:
         flash(e.message, 'error')
-        return render_template('auth/login.html', next=_safe_next('/'), login=login), e.status
+        return render_template(
+            'auth/login.html',
+            next=_safe_next('/'),
+            login=login,
+            dev_fio_enabled=bool(get_dev_fio_password()),
+            hr_auth_enabled=is_hr_auth_enabled(),
+        ), e.status
     except Exception:
         log.exception('login_submit failed')
         flash(RU['loginFailed'], 'error')
-        return render_template('auth/login.html', next=_safe_next('/'), login=login), 500
+        return render_template(
+            'auth/login.html',
+            next=_safe_next('/'),
+            login=login,
+            dev_fio_enabled=bool(get_dev_fio_password()),
+            hr_auth_enabled=is_hr_auth_enabled(),
+        ), 500
     return redirect(_safe_next('/'))
 
 
@@ -96,6 +113,56 @@ def api_logout():
     return jsonify(message=RU['loggedOut'])
 
 
+@auth_bp.route('/api/auth/dev/assignment-directory', methods=['GET'])
+@login_required
+def api_assignment_directory():
+    """Список сотрудников для назначения теста с поиском по имени/логину и фильтром отдела."""
+    from ..db import get_session
+    from ..models import Department, User as UserModel
+
+    q_str = (request.args.get('q') or '').strip()
+    dept_filter = (request.args.get('department') or '').strip()
+    clinic_filter = (request.args.get('clinic') or 'all').strip()
+
+    session = get_session()
+
+    dept_rows = session.query(Department).order_by(Department.name).all()
+    dept_by_name = {d.name: d.id for d in dept_rows}
+    departments = [d.name for d in dept_rows]
+
+    query = (
+        session.query(UserModel)
+        .filter(UserModel.is_active.is_(True))
+    )
+    if q_str:
+        like = f'%{q_str}%'
+        query = query.filter(
+            UserModel.full_name.ilike(like) | UserModel.login.ilike(like)
+        )
+    if dept_filter and dept_filter in dept_by_name:
+        query = query.filter(UserModel.department_id == dept_by_name[dept_filter])
+    if clinic_filter == 'with':
+        query = query.filter(UserModel.staff_id.isnot(None))
+    elif clinic_filter == 'without':
+        query = query.filter(UserModel.staff_id.is_(None))
+
+    users = query.order_by(UserModel.full_name).limit(200).all()
+
+    dept_name_by_id = {d.id: d.name for d in dept_rows}
+    people = [
+        {
+            'staffId': str(u.id),
+            'fio': u.full_name,
+            'webLogin': u.login,
+            'role': u.role,
+            'department': dept_name_by_id.get(u.department_id) if u.department_id else None,
+            'clinicUserId': u.staff_id,
+        }
+        for u in users
+    ]
+    return jsonify(people=people, departments=departments)
+
+
 @auth_bp.route('/api/auth/me', methods=['GET'])
 @login_required
 def api_me():

flask_app/app/auth/services.py

@@ -1,16 +1,13 @@
-"""Бизнес-логика логина — порт `backend/src/routes/auth.js` + `utils/auth.js`.
+"""Бизнес-логика логина (ORM-версия).
 
 Поддерживает оба режима:
-- Локальный (по умолчанию): bcrypt в `clinic_tests.users.password_hash`.
+- Локальный (по умолчанию): bcrypt / Werkzeug в `clinic_tests.users.password_hash`.
-- HR_AUTH=1: пароль проверяется в `hr_bot_test.users` (Werkzeug scrypt/pbkdf2),
+- HR_AUTH=1: пароль проверяется в `hr_bot_test.users` (raw SQL, внешняя схема),
-  затем находим запись `staff_members` по `web_login` и UPSERT-им в
+  затем UPSERT в `clinic_tests.users` по `staff_id`.
-  `clinic_tests.users` по `staff_id`.
-
-Werkzeug-хеши проверяются через `werkzeug.security.check_password_hash`,
-bcrypt-хеши — через пакет `bcrypt`.
 """
 from __future__ import annotations
 
+import re
 from dataclasses import dataclass
 from typing import Optional
 
@@ -20,16 +17,18 @@ from werkzeug.security import check_password_hash as _werkzeug_check
 
 from ..config import (
     HR_MANAGED_PASSWORD_PLACEHOLDER,
+    get_dev_fio_password,
     is_hr_auth_enabled,
 )
-from ..db import get_engine, get_hr_engine
+from ..db import get_engine, get_session
 from ..messages import RU
+from ..models import User
 from .hr_role import map_hr_role_to_app
 
 
 @dataclass
 class AuthUser:
-    id: str  # UUID в виде строки
+    id: str
     login: str
     full_name: str | None
     role: str
@@ -37,20 +36,17 @@ class AuthUser:
     staff_id: Optional[int]
 
     def to_public_dict(self) -> dict:
-        out = {
+        return {
             'id': str(self.id),
             'login': self.login,
             'fullName': self.full_name,
             'role': self.role,
-            'departmentId': self.department_id,
+            'departmentId': str(self.department_id) if self.department_id else None,
+            'staffId': self.staff_id,
         }
-        out['staffId'] = self.staff_id
-        return out
 
 
 class AuthError(Exception):
-    """Ошибка авторизации с HTTP-кодом и сообщением для пользователя."""
-
     def __init__(self, status: int, message: str) -> None:
         super().__init__(message)
         self.status = status
@@ -58,7 +54,6 @@ class AuthError(Exception):
 
 
 def _verify_password(plain: str, hashed: str | None) -> bool:
-    """Универсальная проверка пароля: bcrypt + Werkzeug (scrypt/pbkdf2)."""
     if not hashed:
         return False
     if hashed == HR_MANAGED_PASSWORD_PLACEHOLDER:
@@ -79,139 +74,235 @@ def _verify_password(plain: str, hashed: str | None) -> bool:
         return False
 
 
+def _user_to_auth(user: User) -> AuthUser:
+    return AuthUser(
+        id=str(user.id),
+        login=user.login,
+        full_name=user.full_name,
+        role=user.role,
+        department_id=str(user.department_id) if user.department_id else None,
+        staff_id=user.staff_id,
+    )
+
+
+def _normalize_fio(s: str) -> str:
+    """Приводим ФИО к одному виду: trim, пробелы, неразрывный пробел, много переводов строк."""
+    t = str(s or '')
+    t = t.replace('\u00a0', ' ')
+    return re.sub(r'\s+', ' ', t).strip()
+
+
+_FIO_STAFF_SQL = text(
+    """
+    SELECT id, fio, web_login
+    FROM staff_members
+    WHERE fio IS NOT NULL
+      AND lower(
+            regexp_replace(
+              trim(replace(replace(coalesce(fio, ''), chr(160), ' '), E'\\t', ' ')),
+              '[[:space:]]+', ' ', 'g'
+            )
+          ) = :needle
+    """
+)
+
+
+def _staff_rows_by_normalized_fio(hr_conn, fio_raw: str) -> list:
+    """Строки staff_members с тем же ФИО, что и ввод, после нормализации (регистр не важен)."""
+    fio_needle = _normalize_fio(fio_raw)
+    if not fio_needle:
+        return []
+    needle = fio_needle.lower()
+    return list(hr_conn.execute(_FIO_STAFF_SQL, {'needle': needle}).mappings().all())
+
+
+def _single_web_login_from_fio(hr_conn, fio_raw: str) -> str | None:
+    """Если по ФИО найден ровно один сотрудник — его web_login для входа в HR; иначе None."""
+    rows = _staff_rows_by_normalized_fio(hr_conn, fio_raw)
+    if len(rows) != 1:
+        return None
+    wl = (rows[0]['web_login'] or '').strip()
+    return wl or None
+
+
 def authenticate_credentials(login: str, password: str) -> AuthUser:
-    """Главная точка входа. Возвращает AuthUser или поднимает AuthError."""
     login = (login or '').strip()
     password = password or ''
     if not login or not password:
         raise AuthError(400, RU['loginAndPasswordRequired'])
 
+    # Dev-режим: вход по ФИО из HR с общим паролем
+    dev_pw = get_dev_fio_password()
+    if dev_pw and password.strip() == dev_pw.strip():
+        try:
+            return _authenticate_dev_fio(login)
+        except AuthError:
+            pass  # если ФИО не найдено — продолжаем обычную проверку
+
     if is_hr_auth_enabled():
         return _authenticate_via_hr(login, password)
     return _authenticate_local(login, password)
 
 
-# ─── локальный режим ────────────────────────────────────────────────
+def _authenticate_dev_fio(fio_raw: str) -> AuthUser:
-
+    """Dev-режим: найти сотрудника по ФИО в HR-системе и создать/обновить локального пользователя."""
-def _authenticate_local(login: str, password: str) -> AuthUser:
+    from ..db import get_hr_engine
-    eng = get_engine()
-    with eng.connect() as conn:
-        row = conn.execute(
-            text(
-                'SELECT id, login, password_hash, full_name, role, department_id, staff_id '
-                'FROM users WHERE login = :login AND is_active = true'
-            ),
-            {'login': login},
-        ).mappings().first()
-
-    if not row:
-        raise AuthError(401, RU['invalidCredentials'])
-
-    if row['password_hash'] == HR_MANAGED_PASSWORD_PLACEHOLDER:
-        raise AuthError(401, RU['useHrLogin'])
-
-    if not _verify_password(password, row['password_hash']):
-        raise AuthError(401, RU['invalidCredentials'])
-
-    return AuthUser(
-        id=str(row['id']),
-        login=row['login'],
-        full_name=row['full_name'],
-        role=row['role'],
-        department_id=row['department_id'],
-        staff_id=row['staff_id'],
-    )
-
-
-# ─── HR_AUTH=1 ──────────────────────────────────────────────────────
-
-def _authenticate_via_hr(login: str, password: str) -> AuthUser:
     hr_eng = get_hr_engine()
     if hr_eng is None:
         raise AuthError(500, RU['hrDatabaseUrlMissing'])
 
+    fio_needle = _normalize_fio(fio_raw)
+    if not fio_needle:
+        raise AuthError(401, RU['invalidCredentials'])
+
     with hr_eng.connect() as hr_conn:
-        u = hr_conn.execute(
+        rows = _staff_rows_by_normalized_fio(hr_conn, fio_raw)
-            text(
+        if len(rows) != 1:
-                'SELECT id, username, password_hash, role FROM users '
+            raise AuthError(401, RU['invalidCredentials'])
-                'WHERE LOWER(TRIM(username)) = LOWER(TRIM(:login))'
+        s = rows[0]
-            ),
+
-            {'login': login},
+        web_login = (s['web_login'] or '').strip() or f'fio_{s["id"]}'
-        ).mappings().first()
+
+    staff_id = int(s['id'])
+    full_name = s['fio'] or fio_raw
+
+    session = get_session()
+
+    user = session.query(User).filter(User.staff_id == staff_id).first()
+    if not user:
+        # Не переиспользовать строку другого человека только по совпадению логина HR
+        occupied = session.query(User).filter(User.login == web_login).first()
+        login_val = web_login
+        if occupied and occupied.staff_id != staff_id:
+            login_val = f'hr_staff_{staff_id}'
+        user = User(
+            login=login_val,
+            password_hash=HR_MANAGED_PASSWORD_PLACEHOLDER,
+            full_name=full_name,
+            role='employee',
+            is_active=True,
+            staff_id=staff_id,
+        )
+        session.add(user)
+    else:
+        user.full_name = full_name
+        user.password_hash = HR_MANAGED_PASSWORD_PLACEHOLDER
+        user.is_active = True
+        # Обновить логин с HR только если конфликта нет
+        if web_login != user.login:
+            taken = session.query(User).filter(
+                User.login == web_login,
+                User.id != user.id,
+            ).first()
+            if not taken:
+                user.login = web_login
+
+    session.commit()
+    session.refresh(user)
+    return _user_to_auth(user)
+
+
+def _authenticate_local(login: str, password: str) -> AuthUser:
+    session = get_session()
+    user = (
+        session.query(User)
+        .filter(User.login == login, User.is_active.is_(True))
+        .first()
+    )
+    if not user:
+        raise AuthError(401, RU['invalidCredentials'])
+    if user.password_hash == HR_MANAGED_PASSWORD_PLACEHOLDER:
+        raise AuthError(401, RU['useHrLogin'])
+    if not _verify_password(password, user.password_hash):
+        raise AuthError(401, RU['invalidCredentials'])
+    return _user_to_auth(user)
+
+
+def _authenticate_via_hr(login: str, password: str) -> AuthUser:
+    from ..db import get_hr_engine
+    hr_eng = get_hr_engine()
+    if hr_eng is None:
+        raise AuthError(500, RU['hrDatabaseUrlMissing'])
+
+    user_row_sql = text(
+        'SELECT id, username, password_hash, role FROM users '
+        'WHERE LOWER(TRIM(username)) = LOWER(TRIM(:login))'
+    )
+
+    with hr_eng.connect() as hr_conn:
+        u = hr_conn.execute(user_row_sql, {'login': login}).mappings().first()
+        if not u:
+            wl = _single_web_login_from_fio(hr_conn, login)
+            if wl:
+                u = hr_conn.execute(user_row_sql, {'login': wl}).mappings().first()
+
         if not u or not u['password_hash']:
             raise AuthError(401, RU['invalidCredentials'])
         if not _verify_password(password, u['password_hash']):
             raise AuthError(401, RU['invalidCredentials'])
 
+        hr_username = (u['username'] or '').strip()
+        if not hr_username:
+            raise AuthError(401, RU['invalidCredentials'])
+
         s = hr_conn.execute(
             text(
                 'SELECT id, fio FROM staff_members '
                 "WHERE LOWER(TRIM(COALESCE(web_login, ''))) = LOWER(TRIM(:login))"
             ),
-            {'login': login},
+            {'login': hr_username},
         ).mappings().first()
         if not s:
             raise AuthError(403, RU['noStaffForLogin'])
 
     staff_id = int(s['id'])
-    fio = s['fio'] or login
+    fio = s['fio'] or hr_username
     app_role = map_hr_role_to_app(u['role'])
+    canonical_login = hr_username
 
-    eng = get_engine()
+    # UPSERT через ORM: ищем по staff_id, затем по логину HR, затем по вводу (ФИО/старый логин)
-    with eng.begin() as conn:
+    session = get_session()
-        row = conn.execute(
+    user = session.query(User).filter(User.staff_id == staff_id).first()
-            text(
+    if not user:
-                """
+        user = session.query(User).filter(User.login == canonical_login).first()
-                INSERT INTO users (login, password_hash, full_name, role,
+    if not user:
-                                   department_id, is_active, staff_id)
+        user = session.query(User).filter(User.login == login).first()
-                VALUES (:login, :ph, :fn, :role, NULL, true, :staff_id)
+    if user:
-                ON CONFLICT (staff_id) DO UPDATE SET
+        user.login = canonical_login
-                  login = EXCLUDED.login,
+        user.full_name = fio
-                  full_name = EXCLUDED.full_name,
+        user.role = app_role
-                  role = EXCLUDED.role,
+        user.password_hash = HR_MANAGED_PASSWORD_PLACEHOLDER
-                  password_hash = EXCLUDED.password_hash
+        user.staff_id = staff_id
-                RETURNING id, login, full_name, role, department_id, staff_id
+        user.is_active = True
-                """
+    else:
-            ),
+        user = User(
-            {
+            login=canonical_login,
-                'login': login,
+            password_hash=HR_MANAGED_PASSWORD_PLACEHOLDER,
-                'ph': HR_MANAGED_PASSWORD_PLACEHOLDER,
+            full_name=fio,
-                'fn': fio,
+            role=app_role,
-                'role': app_role,
+            is_active=True,
-                'staff_id': staff_id,
+            staff_id=staff_id,
-            },
+        )
-        ).mappings().first()
+        session.add(user)
-
+    session.commit()
-    return AuthUser(
+    session.refresh(user)
-        id=str(row['id']),
+    return _user_to_auth(user)
-        login=row['login'],
-        full_name=row['full_name'],
-        role=row['role'],
-        department_id=row['department_id'],
-        staff_id=row['staff_id'],
-    )
 
 
 def load_user_by_id(user_id: str) -> Optional[AuthUser]:
-    """Догружает пользователя из `clinic_tests.users` (используется при каждом запросе)."""
     if not user_id:
         return None
-    eng = get_engine()
+    session = get_session()
-    with eng.connect() as conn:
+    try:
-        row = conn.execute(
+        import uuid as _uuid
-            text(
+        uid = _uuid.UUID(user_id)
-                'SELECT id, login, full_name, role, department_id, staff_id '
+    except (ValueError, AttributeError):
-                'FROM users WHERE id = :id AND is_active = true'
-            ),
-            {'id': user_id},
-        ).mappings().first()
-    if not row:
         return None
-    return AuthUser(
+    user = (
-        id=str(row['id']),
+        session.query(User)
-        login=row['login'],
+        .filter(User.id == uid, User.is_active.is_(True))
-        full_name=row['full_name'],
+        .first()
-        role=row['role'],
-        department_id=row['department_id'],
-        staff_id=row['staff_id'],
     )
+    if not user:
+        return None
+    return _user_to_auth(user)

flask_app/app/blueprints/main.py

@@ -1,18 +1,117 @@
-"""Главный blueprint — посадочная страница и health-чек.
+"""Главный blueprint — посадочная страница, статистика и health-чек."""
-
-В E1.0 здесь нет бизнес-логики; страницы и эндпоинты добавляются в следующих
-спринтах (E1.1 — auth, E1.2 — тесты, и т.д.).
-"""
 from __future__ import annotations
 
 from flask import Blueprint, jsonify, render_template
 
 from .. import db as app_db
 from ..auth.decorators import login_required
+from ..auth.decorators import current_user as get_current_user
 
 main_bp = Blueprint('main', __name__)
 
 
+def _get_stats() -> dict:
+    """Собирает статистику прохождений для дашборда."""
+    from sqlalchemy import func, case
+    from ..db import get_session
+    from ..models import Department, User, Test, TestAttempt
+
+    session = get_session()
+    try:
+        total_tests = session.query(func.count(Test.id)).scalar() or 0
+        active_tests = session.query(func.count(Test.id)).filter(Test.is_active.is_(True)).scalar() or 0
+
+        total_completed = (
+            session.query(func.count(TestAttempt.id))
+            .filter(TestAttempt.status == 'completed')
+            .scalar() or 0
+        )
+        total_passed = (
+            session.query(func.count(TestAttempt.id))
+            .filter(TestAttempt.status == 'completed', TestAttempt.passed.is_(True))
+            .scalar() or 0
+        )
+        total_users = session.query(func.count(User.id)).filter(User.is_active.is_(True)).scalar() or 0
+
+        # Статистика по отделам
+        dept_rows = (
+            session.query(
+                Department.name,
+                func.count(TestAttempt.id).label('total'),
+                func.sum(
+                    case((TestAttempt.passed.is_(True), 1), else_=0)
+                ).label('passed_count'),
+            )
+            .join(User, User.department_id == Department.id)
+            .join(TestAttempt, TestAttempt.user_id == User.id)
+            .filter(TestAttempt.status == 'completed')
+            .group_by(Department.id, Department.name)
+            .order_by(Department.name)
+            .all()
+        )
+
+        from ..models import TestVersion
+        recent_rows = (
+            session.query(
+                TestAttempt.started_at,
+                TestAttempt.completed_at,
+                TestAttempt.passed,
+                TestAttempt.correct_count,
+                TestAttempt.total_questions,
+                User.full_name,
+                User.login,
+                Test.title.label('test_title'),
+            )
+            .join(User, User.id == TestAttempt.user_id)
+            .join(TestVersion, TestVersion.id == TestAttempt.test_version_id)
+            .join(Test, Test.id == TestVersion.test_id)
+            .filter(TestAttempt.status == 'completed')
+            .order_by(TestAttempt.completed_at.desc())
+            .limit(10)
+            .all()
+        )
+
+        dept_stats = [
+            {
+                'name': r.name,
+                'total': r.total,
+                'passed': int(r.passed_count or 0),
+                'rate': round(100 * int(r.passed_count or 0) / r.total) if r.total else 0,
+            }
+            for r in dept_rows
+        ]
+
+        recent_list = [
+            {
+                'user': r.full_name or r.login,
+                'test': r.test_title,
+                'passed': r.passed,
+                'score': f'{r.correct_count}/{r.total_questions}' if r.correct_count is not None else '—',
+                'at': r.completed_at.strftime('%d.%m %H:%M') if r.completed_at else '—',
+            }
+            for r in recent_rows
+        ]
+
+        pass_rate = round(100 * total_passed / total_completed) if total_completed else 0
+
+        return {
+            'total_tests': total_tests,
+            'active_tests': active_tests,
+            'total_completed': total_completed,
+            'total_passed': total_passed,
+            'total_users': total_users,
+            'pass_rate': pass_rate,
+            'dept_stats': dept_stats,
+            'recent': recent_list,
+        }
+    except Exception:
+        return {
+            'total_tests': 0, 'active_tests': 0, 'total_completed': 0,
+            'total_passed': 0, 'total_users': 0, 'pass_rate': 0,
+            'dept_stats': [], 'recent': [],
+        }
+
+
 @main_bp.route('/health')
 def health():
     """Smoke-проверка приложения и подключений к БД (без авторизации)."""
@@ -29,3 +128,29 @@ def health():
 @login_required
 def index():
     return render_template('index.html')
+
+
+@main_bp.route('/stats')
+@login_required
+def stats_page():
+    return render_template('stats.html', stats=_get_stats())
+
+
+@main_bp.route('/assignments')
+@login_required
+def assignments_page():
+    from ..db import get_session
+    from ..models import Test, TestVersion
+    from sqlalchemy.orm import selectinload
+    session = get_session()
+    tests = (
+        session.query(Test)
+        .join(TestVersion, (TestVersion.test_id == Test.id) & TestVersion.is_active.is_(True))
+        .filter(Test.is_active.is_(True))
+        .order_by(Test.title)
+        .all()
+    )
+    return render_template('assignments.html', tests=[
+        {'id': str(t.id), 'title': t.title or '(без названия)'}
+        for t in tests
+    ])

flask_app/app/blueprints/settings.py

@@ -1,15 +1,11 @@
-"""Страница настроек: статус LLM-ключа и проверка подключения (E1.8).
+"""Настройки: LLM-статус, пинг и редактор промптов."""
-
-Ключ — общий, читается из ENV (`DEEPSEEK_API_KEY` / `OPENAI_API_KEY`). Здесь —
-только просмотр статуса и smoke-проверка. Изменение ключа — через `.env` и
-рестарт процесса.
-"""
 from __future__ import annotations
 
-from flask import Blueprint, jsonify, render_template
+from flask import Blueprint, jsonify, render_template, request
 
 from ..auth.decorators import login_required
 from ..services.llm_client import get_llm_config, ping_llm
+from ..services import prompt_store
 
 settings_bp = Blueprint('settings', __name__)
 
@@ -27,7 +23,34 @@ def settings_page():
     )
 
 
+@settings_bp.route('/settings/prompts', methods=['GET'])
+@login_required
+def prompts_page():
+    return render_template('settings_prompts.html', prompts=prompt_store.get_all())
+
+
 @settings_bp.route('/api/llm/ping', methods=['POST', 'GET'])
 @login_required
 def api_llm_ping():
     return jsonify(ping_llm())
+
+
+@settings_bp.route('/api/ai/prompts', methods=['GET'])
+@login_required
+def api_get_prompts():
+    return jsonify(prompts=prompt_store.get_all())
+
+
+@settings_bp.route('/api/ai/prompts/<prompt_id>', methods=['PUT'])
+@login_required
+def api_save_prompt(prompt_id: str):
+    body = request.get_json(silent=True) or {}
+    system = str(body.get('system') or '').strip()
+    user = str(body.get('user') or '').strip()
+    try:
+        prompt_store.save_prompt(prompt_id, system, user)
+    except KeyError as e:
+        return jsonify(ok=False, error=str(e)), 404
+    except Exception as e:
+        return jsonify(ok=False, error=str(e)), 500
+    return jsonify(ok=True)

flask_app/app/config.py

@@ -37,3 +37,8 @@ def is_dev_ui() -> bool:
     if (os.environ.get('FLASK_ENV') or '').lower() == 'development':
         return True
     return (os.environ.get('FLASK_DEBUG') or '').strip() == '1'
+
+
+def get_dev_fio_password() -> str | None:
+    """Общий пароль для dev-входа по ФИО. Задаётся в DEV_FIO_PASSWORD."""
+    return os.environ.get('DEV_FIO_PASSWORD') or None

flask_app/app/data/prompts.json

@@ -0,0 +1,111 @@
+{
+  "generate_question_full": {
+    "label": "Генерация вопроса (новый)",
+    "description": "AI создаёт вопрос с вариантами ответа по теме теста.",
+    "system": "Ты составитель тестов. Отвечай ТОЛЬКО JSON: {\"text\", \"hasMultipleAnswers\", \"options\": [{ \"text\", \"isCorrect\" }]}. Все на русском.",
+    "user": "Тема теста: {topic}\n\nСформулируй ОДИН вопрос по этой теме с ровно {optionsCount} вариантами ответа. hasMultipleAnswers = {multiClause}",
+    "user_hint_label": "Акцент / дополнение",
+    "user_hint_placeholder": "Например: сделай акцент на противопожарных нормах",
+    "vars": {
+      "topic": "Название + описание теста",
+      "optionsCount": "Количество вариантов ответа",
+      "multiClause": "Пояснение о типе ответа"
+    }
+  },
+  "rephrase_question": {
+    "label": "Улучшение вопроса",
+    "description": "AI переформулирует черновик вопроса, сохраняя смысл.",
+    "system": "Ты редактор учебных материалов. Отвечай ТОЛЬКО JSON: {\"text\": string} — чёткая формулировка вопроса на русском, 1–3 полных предложения в зависимости от сложности исходного черновика, без вариантов ответа.",
+    "user": "Тема теста: {topic}\n\nИсходный черновик вопроса (улучши формулировку, не меняй смысл без нужды):\n{questionText}",
+    "user_hint_label": "Акцент / дополнение",
+    "user_hint_placeholder": "Например: сделай формулировку короче и чётче",
+    "vars": {
+      "topic": "Название + описание теста",
+      "questionText": "Исходный текст вопроса"
+    }
+  },
+  "generate_distractors": {
+    "label": "Генерация дистракторов",
+    "description": "AI заполняет пустые варианты ответа правдоподобными, но неверными.",
+    "system": "Ты составитель учебных тестов. Отвечай ТОЛЬКО JSON: {\"options\": [{\"text\": string, \"isCorrect\": false}, ...]} — ровно {emptyCount} объекта в массиве. Все тексты на русском, без нумерации, без кавычек.",
+    "user": "Тема теста: {topic}\n\nВопрос: {questionText}\n\nУже заполненные варианты:\n{filledOptions}\n\nПридумай ровно {emptyCount} правдоподобных, но НЕВЕРНЫХ дистракторов (isCorrect: false), которые не повторяют уже существующие варианты и выглядят похоже на реальные ответы.",
+    "user_hint_label": "Акцент / дополнение",
+    "user_hint_placeholder": "Например: дистракторы должны быть из той же категории",
+    "vars": {
+      "topic": "Название + описание теста",
+      "questionText": "Текст вопроса",
+      "filledOptions": "Список уже заполненных вариантов",
+      "emptyCount": "Количество пустых слотов"
+    }
+  },
+  "generate_test_by_title": {
+    "label": "Генерация теста по теме",
+    "description": "AI генерирует весь тест (структуру + вопросы) по названию.",
+    "system": "Ты опытный методист, составляешь учебные тесты. Отвечай ТОЛЬКО одним JSON-объектом на русском. Схема: {\"title\", \"description\", \"questions\": [{\"text\", \"hasMultipleAnswers\": boolean, \"options\": [{\"text\", \"isCorrect\"}]}]}. Минимум 2 варианта, отметь хотя бы один isCorrect: true.",
+    "user": "Составь учебный тест по этой теме.\n\nНазвание теста: {title}\nОписание/контекст: {desc}\n\nПодсказка по сетке: примерно {nQ} вопросов, в каждом по {nOpt} вариантов ответа. Покрой ключевые подтемы. Дистракторы делай правдоподобными, не очевидно неверными. Текст — короткий, понятный.",
+    "user_hint_label": "Акцент / дополнение",
+    "user_hint_placeholder": "Например: сделай акцент на правилах безопасности, избегай теоретических вопросов",
+    "vars": {
+      "title": "Название теста",
+      "desc": "Описание/контекст темы",
+      "nQ": "Желаемое количество вопросов",
+      "nOpt": "Желаемое количество вариантов"
+    }
+  },
+  "generate_test_from_doc": {
+    "label": "Генерация теста из документа",
+    "description": "AI создаёт тест на основе загруженного текста документа.",
+    "system": "Ты помощник для составления тестов. Отвечай ТОЛЬКО одним JSON-объектом без пояснений. Схема: {\"title\": string, \"description\"?: string, \"questions\": array}. Каждый вопрос: {\"text\", \"hasMultipleAnswers\": boolean, \"options\": [{\"text\", \"isCorrect\": boolean}, ...]}. Минимум 2 варианта. Для одиночного выбора ровно один isCorrect: true. Текст и формулировки — на русском, по содержанию входного материала.",
+    "user": "Составь тест с вопросами с одним или несколькими правильными ответами на основе текста:\n\n{documentText}",
+    "user_hint_label": "На что сделать акцент",
+    "user_hint_placeholder": "Например: сделай акцент на разделе 3, избегай вопросов про даты",
+    "vars": {
+      "documentText": "Извлечённый текст документа"
+    }
+  },
+  "check_test_quality": {
+    "label": "Проверка качества теста",
+    "description": "AI анализирует тест и выдаёт рекомендации по улучшению.",
+    "system": "Ты ревьюер учебных тестов. Отвечай ТОЛЬКО JSON: {\"verdict\": \"ok\"|\"warn\"|\"bad\", \"summary\": string, \"sections\": [{\"title\": string, \"items\": [string, ...]}]}. Разделы рекомендаций: «Чёткость формулировок», «Качество дистракторов», «Охват темы», «Сбалансированность сложности». Пропусти раздел, если претензий нет. Вердикт: ok — годен; warn — есть замечания; bad — серьёзные проблемы. Все тексты — на русском, короткие и предметные.",
+    "user": "Проверь качество теста и дай рекомендации:\n\n{testDump}",
+    "user_hint_label": "Акцент / дополнение",
+    "user_hint_placeholder": "Например: обрати особое внимание на дистракторы",
+    "vars": {
+      "testDump": "JSON-дамп теста (заголовок + вопросы)"
+    }
+  },
+  "improve_test_full": {
+    "label": "Улучшение всего теста",
+    "description": "AI предлагает улучшенные формулировки для всех вопросов и ответов.",
+    "system": "Ты редактор учебных тестов. Получаешь массив вопросов и предлагаешь улучшения: чёткие формулировки, лучшие дистракторы, корректную разметку isCorrect. Сохраняй исходную сетку: число вопросов, число вариантов и значение hasMultipleAnswers НЕ меняй — иначе клиент отклонит ответ. Отвечай ТОЛЬКО JSON: {\"questions\": [{\"text\", \"hasMultipleAnswers\", \"options\": [{\"text\", \"isCorrect\"}]}, ...]}. Тексты — на русском, короткие.",
+    "user": "Улучши тест без изменения сетки:\n\n{testDump}",
+    "user_hint_label": "Акцент / дополнение",
+    "user_hint_placeholder": "Например: сделай дистракторы правдоподобнее",
+    "vars": {
+      "testDump": "JSON-дамп теста (заголовок + вопросы)"
+    }
+  },
+  "question_hint": {
+    "label": "Подсказка к вопросу",
+    "description": "AI объясняет правильный ответ (показывается при прохождении теста).",
+    "system": "Ты опытный преподаватель. Отвечай по-русски, кратко (2–4 предложения), без markdown и без вступлений. Объясни почему правильный вариант — правильный.",
+    "user": "Вопрос: {questionText}\nВарианты: {allOptions}\nПравильный ответ: {correctOptions}\n\nДай краткое объяснение для подсказки во всплывающем окне.",
+    "vars": {
+      "questionText": "Текст вопроса",
+      "allOptions": "Все варианты ответа",
+      "correctOptions": "Правильные варианты ответа"
+    }
+  },
+  "explain_answer": {
+    "label": "Объяснение ответа",
+    "description": "AI объясняет результат ответа пользователя (после прохождения).",
+    "system": "Ты опытный преподаватель. Отвечай по-русски, кратко (2–4 предложения). Объясни почему правильный ответ именно такой, без лишней воды и без markdown.",
+    "user": "Вопрос: {questionText}\nПравильный ответ: {correctOptions}\nОтвет ученика ({verdict}): {selectedOptions}\n\nДай краткое объяснение для подсказки во всплывающем окне.",
+    "vars": {
+      "questionText": "Текст вопроса",
+      "correctOptions": "Правильные варианты",
+      "verdict": "Результат (верно/неверно)",
+      "selectedOptions": "Выбранные пользователем варианты"
+    }
+  }
+}

flask_app/app/db.py

@@ -1,7 +1,7 @@
-"""Подключение к PostgreSQL — тот же паттерн, что в HR_TG_Bot/tgFlaskForm/db/session.py.
+"""Подключение к PostgreSQL и ORM-сессии.
 
-В Этапе 1 работаем с БД `clinic_tests` (схема не меняется). Опционально доступна
+Основная БД — `clinic_tests`.
-вторая БД `hr_bot_test` для HR-аутентификации (см. .env.example, флаг HR_AUTH).
+Опциональная вторая БД — `hr_bot_test` (когда HR_AUTH=1).
 """
 from __future__ import annotations
 
@@ -11,76 +11,85 @@ from typing import Optional
 
 from sqlalchemy import create_engine
 from sqlalchemy.engine import Engine
-from sqlalchemy.orm import sessionmaker
+from sqlalchemy.orm import Session, scoped_session, sessionmaker
 from sqlalchemy.pool import QueuePool
 
-_lock = threading.Lock()
+_engine_lock = threading.Lock()
-_engine: Optional[Engine] = None
+_session_lock = threading.Lock()
-_session_local: Optional[sessionmaker] = None
+_hr_engine_lock = threading.Lock()
-_hr_engine: Optional[Engine] = None
-_hr_session_local: Optional[sessionmaker] = None
 
+_engine: Optional[Engine] = None
+_session_factory: Optional[scoped_session] = None
+_hr_engine: Optional[Engine] = None
+
+
+# ─── URL helpers ─────────────────────────────────────────────────────────────
 
 def get_database_url() -> str:
-    """URL основной БД (`clinic_tests`).
-
-    Приоритет: DATABASE_URL → отдельные DB_*-переменные.
-    """
     if db_url := os.environ.get('DATABASE_URL'):
         return db_url.strip()
-
+    host = os.environ.get('DB_HOST', 'localhost')
-    db_host = os.environ.get('DB_HOST', 'localhost')
+    port = os.environ.get('DB_PORT', '5432')
-    db_port = os.environ.get('DB_PORT', '5432')
+    name = os.environ.get('DB_NAME', 'clinic_tests')
-    db_name = os.environ.get('DB_NAME', 'clinic_tests')
+    user = os.environ.get('DB_USER', 'hr_bot_user')
-    db_user = os.environ.get('DB_USER', 'hr_bot_user')
+    password = os.environ.get('DB_PASSWORD', 'hrbot123')
-    db_password = os.environ.get('DB_PASSWORD', 'hrbot123')
+    return f'postgresql+psycopg2://{user}:{password}@{host}:{port}/{name}'
-    return f'postgresql://{db_user}:{db_password}@{db_host}:{db_port}/{db_name}'
-
-
-def get_hr_database_url() -> Optional[str]:
-    """URL БД HR (`hr_bot_test`) — только если включён HR_AUTH."""
-    if not _hr_auth_enabled():
-        return None
-    if url := os.environ.get('HR_DATABASE_URL'):
-        return url.strip()
-    return None
 
 
 def _hr_auth_enabled() -> bool:
-    val = (os.environ.get('HR_AUTH') or '').strip().lower()
+    return (os.environ.get('HR_AUTH') or '').strip().lower() in ('1', 'true', 'yes', 'on')
-    return val in ('1', 'true', 'yes', 'on')
 
 
+def get_hr_database_url() -> Optional[str]:
+    if not _hr_auth_enabled():
+        return None
+    url = (os.environ.get('HR_DATABASE_URL') or '').strip()
+    return url or None
+
+
+# ─── Main engine ─────────────────────────────────────────────────────────────
+
 def get_engine() -> Engine:
-    """Возвращает общий engine основной БД (singleton на процесс)."""
     global _engine
     if _engine is not None:
         return _engine
-    with _lock:
+    with _engine_lock:
-        if _engine is not None:
+        if _engine is None:
-            return _engine
+            _engine = create_engine(
-        _engine = create_engine(
+                get_database_url(),
-            get_database_url(),
+                poolclass=QueuePool,
-            poolclass=QueuePool,
+                pool_size=5,
-            pool_size=5,
+                max_overflow=10,
-            max_overflow=10,
+                pool_pre_ping=True,
-            pool_pre_ping=True,
+            )
-        )
     return _engine
 
 
-def get_session():
+# ─── Scoped session ──────────────────────────────────────────────────────────
-    """Создаёт новую ORM-сессию поверх общего engine."""
-    global _session_local
-    if _session_local is None:
-        with _lock:
-            if _session_local is None:
-                _session_local = sessionmaker(bind=get_engine())
-    return _session_local()
 
+def get_session() -> Session:
+    """Возвращает ORM-сессию для текущего потока (scoped_session)."""
+    global _session_factory
+    if _session_factory is None:
+        with _session_lock:
+            if _session_factory is None:
+                # Инициализируем engine до захвата session_lock, чтобы не было вложенных блокировок
+                engine = get_engine()
+                _session_factory = scoped_session(
+                    sessionmaker(bind=engine, autoflush=True, autocommit=False)
+                )
+    return _session_factory  # type: ignore[return-value]
+
+
+def remove_session() -> None:
+    """Освобождает сессию для текущего потока. Вызывается в teardown_appcontext."""
+    if _session_factory is not None:
+        _session_factory.remove()
+
+
+# ─── HR engine (raw SQL only) ────────────────────────────────────────────────
 
 def get_hr_engine() -> Optional[Engine]:
-    """Engine для HR-БД. Возвращает None, если HR_AUTH не включён."""
     if not _hr_auth_enabled():
         return None
     global _hr_engine
@@ -89,34 +98,21 @@ def get_hr_engine() -> Optional[Engine]:
     url = get_hr_database_url()
     if not url:
         return None
-    with _lock:
+    with _hr_engine_lock:
-        if _hr_engine is not None:
+        if _hr_engine is None:
-            return _hr_engine
+            _hr_engine = create_engine(
-        _hr_engine = create_engine(
+                url,
-            url,
+                poolclass=QueuePool,
-            poolclass=QueuePool,
+                pool_size=3,
-            pool_size=3,
+                max_overflow=5,
-            max_overflow=5,
+                pool_pre_ping=True,
-            pool_pre_ping=True,
+            )
-        )
     return _hr_engine
 
 
-def get_hr_session():
+# ─── Smoke check ─────────────────────────────────────────────────────────────
-    """Сессия для HR-БД (или None при выключенном HR_AUTH)."""
-    eng = get_hr_engine()
-    if eng is None:
-        return None
-    global _hr_session_local
-    if _hr_session_local is None:
-        with _lock:
-            if _hr_session_local is None:
-                _hr_session_local = sessionmaker(bind=eng)
-    return _hr_session_local()
-
 
 def ping() -> dict:
-    """Smoke-проверка подключения к БД (используется в /health)."""
     out: dict = {'main': 'unknown'}
     try:
         with get_engine().connect() as conn:

flask_app/app/models.py

@@ -0,0 +1,315 @@
+"""SQLAlchemy ORM-модели для БД clinic_tests.
+
+Таблицы: departments, users, tests, test_versions, questions, answer_options,
+         test_assignments, test_assignment_targets, test_attempts, user_answers.
+
+Enum-типы (`user_role`, `target_type`, `attempt_status`) соответствуют PostgreSQL-перечислениям
+из 001_initial.sql — создаются через `create_constraint=False` (тип уже есть в БД).
+"""
+from __future__ import annotations
+
+import uuid
+from datetime import date, datetime
+from typing import List, Optional
+
+from sqlalchemy import (
+    ARRAY,
+    Boolean,
+    Date,
+    DateTime,
+    Enum,
+    ForeignKey,
+    Index,
+    Integer,
+    String,
+    Text,
+    UniqueConstraint,
+    func,
+)
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, relationship
+
+
+# ─── Base ────────────────────────────────────────────────────────────────────
+
+class Base(DeclarativeBase):
+    pass
+
+
+# ─── Enum types ───────────────────────────────────────────────────────────────
+
+user_role_enum = Enum(
+    "hr", "manager", "employee",
+    name="user_role",
+    create_constraint=False,  # тип уже существует в БД
+)
+
+target_type_enum = Enum(
+    "department", "user",
+    name="target_type",
+    create_constraint=False,
+)
+
+attempt_status_enum = Enum(
+    "in_progress", "completed", "expired",
+    name="attempt_status",
+    create_constraint=False,
+)
+
+
+# ─── Models ───────────────────────────────────────────────────────────────────
+
+class Department(Base):
+    __tablename__ = "departments"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    name: Mapped[str] = mapped_column(String(255), nullable=False)
+    created_at: Mapped[Optional[datetime]] = mapped_column(
+        DateTime, server_default=func.now()
+    )
+    updated_at: Mapped[Optional[datetime]] = mapped_column(
+        DateTime, server_default=func.now(), onupdate=func.now()
+    )
+
+    users: Mapped[List["User"]] = relationship(back_populates="department")
+
+
+class User(Base):
+    __tablename__ = "users"
+    __table_args__ = (
+        Index("idx_users_login", "login"),
+        Index("idx_users_department", "department_id"),
+        Index(
+            "idx_users_staff_id", "staff_id",
+            postgresql_where="staff_id IS NOT NULL",
+        ),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    login: Mapped[str] = mapped_column(String(100), unique=True, nullable=False)
+    password_hash: Mapped[str] = mapped_column(String(255), nullable=False)
+    full_name: Mapped[str] = mapped_column(String(255), nullable=False)
+    role: Mapped[str] = mapped_column(user_role_enum, nullable=False, server_default="employee")
+    department_id: Mapped[Optional[uuid.UUID]] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("departments.id"), nullable=True
+    )
+    is_active: Mapped[bool] = mapped_column(Boolean, server_default="true")
+    created_at: Mapped[Optional[datetime]] = mapped_column(
+        DateTime, server_default=func.now()
+    )
+    updated_at: Mapped[Optional[datetime]] = mapped_column(
+        DateTime, server_default=func.now(), onupdate=func.now()
+    )
+    staff_id: Mapped[Optional[int]] = mapped_column(Integer, unique=True, nullable=True)
+
+    department: Mapped[Optional["Department"]] = relationship(back_populates="users")
+    tests: Mapped[List["Test"]] = relationship(back_populates="author", foreign_keys="Test.created_by")
+    attempts: Mapped[List["TestAttempt"]] = relationship(back_populates="user")
+
+
+class Test(Base):
+    __tablename__ = "tests"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    title: Mapped[str] = mapped_column(String(255), nullable=False)
+    description: Mapped[Optional[str]] = mapped_column(Text)
+    passing_threshold: Mapped[Optional[int]] = mapped_column(Integer, server_default="70")
+    time_limit: Mapped[Optional[int]] = mapped_column(Integer)
+    allow_back: Mapped[bool] = mapped_column(Boolean, server_default="true")
+    is_active: Mapped[bool] = mapped_column(Boolean, server_default="true")
+    is_versioned: Mapped[bool] = mapped_column(Boolean, server_default="false")
+    hints_enabled: Mapped[bool] = mapped_column(Boolean, server_default="false")
+    result_mode: Mapped[str] = mapped_column(String(16), server_default="end")
+    created_by: Mapped[Optional[uuid.UUID]] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("users.id"), nullable=True
+    )
+    created_at: Mapped[Optional[datetime]] = mapped_column(
+        DateTime, server_default=func.now()
+    )
+    updated_at: Mapped[Optional[datetime]] = mapped_column(
+        DateTime, server_default=func.now(), onupdate=func.now()
+    )
+
+    author: Mapped[Optional["User"]] = relationship(
+        back_populates="tests", foreign_keys=[created_by]
+    )
+    versions: Mapped[List["TestVersion"]] = relationship(
+        back_populates="test", cascade="all, delete-orphan"
+    )
+
+
+class TestVersion(Base):
+    __tablename__ = "test_versions"
+    __table_args__ = (
+        UniqueConstraint("test_id", "version", name="test_versions_test_id_version_key"),
+        Index("idx_test_versions_parent_id", "parent_id"),
+        Index(
+            "uq_test_versions_one_active_per_test", "test_id",
+            unique=True,
+            postgresql_where="is_active = true",
+        ),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    test_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("tests.id", ondelete="CASCADE"), nullable=False
+    )
+    version: Mapped[int] = mapped_column(Integer, nullable=False, server_default="1")
+    is_active: Mapped[bool] = mapped_column(Boolean, server_default="false")
+    parent_id: Mapped[Optional[uuid.UUID]] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("test_versions.id", ondelete="RESTRICT"),
+        nullable=True,
+    )
+    created_at: Mapped[Optional[datetime]] = mapped_column(
+        DateTime, server_default=func.now()
+    )
+
+    test: Mapped["Test"] = relationship(back_populates="versions")
+    questions: Mapped[List["Question"]] = relationship(
+        back_populates="version", cascade="all, delete-orphan", order_by="Question.question_order"
+    )
+    attempts: Mapped[List["TestAttempt"]] = relationship(back_populates="test_version")
+    assignments: Mapped[List["TestAssignment"]] = relationship(back_populates="test_version")
+    parent: Mapped[Optional["TestVersion"]] = relationship(
+        remote_side="TestVersion.id", foreign_keys=[parent_id]
+    )
+
+
+class Question(Base):
+    __tablename__ = "questions"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    test_version_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("test_versions.id", ondelete="CASCADE"), nullable=False
+    )
+    text: Mapped[str] = mapped_column(Text, nullable=False)
+    question_order: Mapped[int] = mapped_column(Integer, nullable=False)
+    has_multiple_answers: Mapped[bool] = mapped_column(Boolean, server_default="false")
+    ai_hint: Mapped[Optional[str]] = mapped_column(Text)
+
+    version: Mapped["TestVersion"] = relationship(back_populates="questions")
+    options: Mapped[List["AnswerOption"]] = relationship(
+        back_populates="question", cascade="all, delete-orphan", order_by="AnswerOption.option_order"
+    )
+    user_answers: Mapped[List["UserAnswer"]] = relationship(back_populates="question")
+
+
+class AnswerOption(Base):
+    __tablename__ = "answer_options"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    question_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("questions.id", ondelete="CASCADE"), nullable=False
+    )
+    text: Mapped[str] = mapped_column(Text, nullable=False)
+    is_correct: Mapped[bool] = mapped_column(Boolean, server_default="false")
+    option_order: Mapped[int] = mapped_column(Integer, nullable=False)
+
+    question: Mapped["Question"] = relationship(back_populates="options")
+
+
+class TestAssignment(Base):
+    __tablename__ = "test_assignments"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    test_version_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("test_versions.id", ondelete="CASCADE"), nullable=False
+    )
+    assigned_by: Mapped[Optional[uuid.UUID]] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("users.id"), nullable=True
+    )
+    deadline: Mapped[Optional[date]] = mapped_column(Date)
+    max_attempts: Mapped[Optional[int]] = mapped_column(Integer, server_default="1")
+    created_at: Mapped[Optional[datetime]] = mapped_column(
+        DateTime, server_default=func.now()
+    )
+
+    test_version: Mapped["TestVersion"] = relationship(back_populates="assignments")
+    targets: Mapped[List["TestAssignmentTarget"]] = relationship(
+        back_populates="assignment", cascade="all, delete-orphan"
+    )
+
+
+class TestAssignmentTarget(Base):
+    __tablename__ = "test_assignment_targets"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    assignment_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("test_assignments.id", ondelete="CASCADE"), nullable=False
+    )
+    target_type: Mapped[str] = mapped_column(target_type_enum, nullable=False)
+    target_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), nullable=False)
+
+    assignment: Mapped["TestAssignment"] = relationship(back_populates="targets")
+
+
+class TestAttempt(Base):
+    __tablename__ = "test_attempts"
+    __table_args__ = (
+        UniqueConstraint(
+            "test_version_id", "user_id", "attempt_number",
+            name="test_attempts_test_version_id_user_id_attempt_number_key",
+        ),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    test_version_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("test_versions.id", ondelete="CASCADE"), nullable=False
+    )
+    user_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("users.id"), nullable=False
+    )
+    attempt_number: Mapped[int] = mapped_column(Integer, server_default="1")
+    status: Mapped[str] = mapped_column(attempt_status_enum, server_default="in_progress")
+    started_at: Mapped[Optional[datetime]] = mapped_column(
+        DateTime, server_default=func.now()
+    )
+    completed_at: Mapped[Optional[datetime]] = mapped_column(DateTime)
+    correct_count: Mapped[Optional[int]] = mapped_column(Integer)
+    total_questions: Mapped[Optional[int]] = mapped_column(Integer)
+    passed: Mapped[Optional[bool]] = mapped_column(Boolean)
+
+    test_version: Mapped["TestVersion"] = relationship(back_populates="attempts")
+    user: Mapped["User"] = relationship(back_populates="attempts")
+    user_answers: Mapped[List["UserAnswer"]] = relationship(
+        back_populates="attempt", cascade="all, delete-orphan"
+    )
+
+
+class UserAnswer(Base):
+    __tablename__ = "user_answers"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    attempt_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("test_attempts.id", ondelete="CASCADE"), nullable=False
+    )
+    question_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("questions.id", ondelete="CASCADE"), nullable=False
+    )
+    selected_options: Mapped[Optional[List[uuid.UUID]]] = mapped_column(
+        ARRAY(UUID(as_uuid=True)), server_default="{}"
+    )
+
+    attempt: Mapped["TestAttempt"] = relationship(back_populates="user_answers")
+    question: Mapped["Question"] = relationship(back_populates="user_answers")

flask_app/app/services/ai_editor.py

@@ -6,6 +6,7 @@ from typing import Any
 from .draft_validator import (
     assert_draft_matches_shape,
     parse_json_from_llm_text,
+    shuffle_options_in_questions,
     validate_and_normalize_draft,
 )
 from .llm_client import LlmError, chat_completion_text_content, get_llm_config
@@ -33,7 +34,30 @@ def parse_and_validate_shape(s: Any) -> list[dict]:
             raise HttpError(400, f'shape[{i}]: optionsCount от 2 до 12.')
         if n < 2 or n > 12:
             raise HttpError(400, f'shape[{i}]: optionsCount от 2 до 12.')
-        out.append({'optionsCount': n, 'hasMultipleAnswers': bool(row.get('hasMultipleAnswers'))})
+        has_multi = bool(row.get('hasMultipleAnswers'))
+        raw_min = row.get('minCorrect', 1)
+        raw_max = row.get('maxCorrect', n if has_multi else 1)
+        try:
+            min_c = int(float(raw_min))
+            max_c = int(float(raw_max))
+        except (TypeError, ValueError):
+            raise HttpError(400, f'shape[{i}]: minCorrect/maxCorrect должны быть числами.')
+        if not has_multi:
+            min_c = 1
+            max_c = 1
+        if min_c < 1 or max_c < 1 or min_c > max_c or max_c > n:
+            raise HttpError(
+                400,
+                f'shape[{i}]: корректный диапазон правильных ответов — от 1 до {n}, min<=max.',
+            )
+        out.append(
+            {
+                'optionsCount': n,
+                'hasMultipleAnswers': has_multi,
+                'minCorrect': min_c,
+                'maxCorrect': max_c,
+            }
+        )
     return out
 
 
@@ -51,7 +75,10 @@ def generate_full_test_by_shape(test_title: str, test_description: str, shape: l
     lines = []
     for i, sh in enumerate(shape):
         if sh['hasMultipleAnswers']:
-            tail = 'несколько вариантов помечены как верные (hasMultipleAnswers: true).'
+            tail = (
+                'несколько вариантов помечены как верные (hasMultipleAnswers: true), '
+                f'число правильных от {sh["minCorrect"]} до {sh["maxCorrect"]}.'
+            )
         else:
             tail = 'ровно один верный вариант (hasMultipleAnswers: false).'
         lines.append(f'Вопрос {i + 1}: ровно {sh["optionsCount"]} вариантов ответа; {tail}')
@@ -77,6 +104,7 @@ def generate_full_test_by_shape(test_title: str, test_description: str, shape: l
     parsed = parse_json_from_llm_text(raw)
     draft = validate_and_normalize_draft(parsed)
     assert_draft_matches_shape({'questions': draft['questions']}, shape)
+    shuffle_options_in_questions(draft['questions'])
     return {
         'title': draft['title'],
         'description': draft['description'],
@@ -127,6 +155,7 @@ def generate_test_by_title(
     raw = chat_completion_text_content(cfg, system, user, 0.45)
     parsed = parse_json_from_llm_text(raw)
     draft = validate_and_normalize_draft(parsed)
+    shuffle_options_in_questions(draft['questions'])
     return {
         'title': draft['title'],
         'description': draft['description'],
@@ -196,11 +225,64 @@ def check_test_quality(test_title: str, test_description: str, questions: list[d
     return {'verdict': verdict, 'summary': summary, 'sections': sections}
 
 
-def improve_test_full(test_title: str, test_description: str, questions: list[dict]) -> dict:
+def _merge_suggested_by_focus(
+    focus: str,
+    orig: dict,
+    sug: dict,
+) -> dict:
+    """Сужает предложение модели под выбранную область правки."""
+    orig_opts = [
+        {'text': str(o.get('text', '')).strip(), 'isCorrect': bool(o.get('isCorrect'))}
+        for o in (orig.get('options') or [])
+    ]
+    sug_opts = sug.get('options') or []
+    hm = bool(orig.get('hasMultipleAnswers'))
+    ot = str(orig.get('text', '')).strip()
+
+    if focus == 'questions':
+        return {
+            'text': str(sug.get('text', '')).strip(),
+            'hasMultipleAnswers': hm,
+            'options': [dict(o) for o in orig_opts],
+        }
+    if focus == 'distractors':
+        merged = []
+        for j, oo in enumerate(orig_opts):
+            so = sug_opts[j] if j < len(sug_opts) else oo
+            if oo['isCorrect']:
+                merged.append(dict(oo))
+            else:
+                merged.append(
+                    {'text': str(so.get('text', '')).strip(), 'isCorrect': False}
+                )
+        return {'text': ot, 'hasMultipleAnswers': hm, 'options': merged}
+    if focus == 'options':
+        merged = []
+        for j, oo in enumerate(orig_opts):
+            so = sug_opts[j] if j < len(sug_opts) else oo
+            merged.append(
+                {
+                    'text': str(so.get('text', '')).strip(),
+                    'isCorrect': oo['isCorrect'],
+                }
+            )
+        return {'text': ot, 'hasMultipleAnswers': hm, 'options': merged}
+    return {
+        'text': str(sug.get('text', '')).strip(),
+        'hasMultipleAnswers': bool(sug.get('hasMultipleAnswers')),
+        'options': [
+            {'text': str(o.get('text', '')).strip(), 'isCorrect': bool(o.get('isCorrect'))}
+            for o in sug_opts
+        ],
+    }
+
+
+def improve_test_full(
+    test_title: str, test_description: str, questions: list[dict], focus: str = 'all'
+) -> dict:
     """AI-улучшение всего теста. Возвращает 'было → стало' для каждого вопроса.
 
-    Для каждого вопроса: original + suggested, флаги textChanged/optionsChanged.
+    focus: all | questions | distractors | options
-    UI решает, что применить (чекбоксы).
     """
     cfg = _require_cfg()
     title = (test_title or '').strip() or 'Тест'
@@ -209,14 +291,43 @@ def improve_test_full(test_title: str, test_description: str, questions: list[di
     if not qs:
         raise HttpError(400, 'В тесте нет вопросов — нечего улучшать.')
 
-    system = (
+    focus = (focus or 'all').strip().lower()
-        'Ты редактор учебных тестов. Получаешь массив вопросов и предлагаешь '
+    if focus not in ('all', 'questions', 'distractors', 'options'):
-        'улучшения: чёткие формулировки, лучшие дистракторы, корректную разметку '
+        focus = 'all'
-        'isCorrect. Сохраняй исходную сетку: число вопросов, число вариантов и '
+
-        'значение hasMultipleAnswers НЕ меняй — иначе клиент отклонит ответ. '
+    system_by_focus = {
-        'Отвечай ТОЛЬКО JSON: {"questions": [{"text", "hasMultipleAnswers", '
+        'all': (
-        '"options": [{"text", "isCorrect"}]}, ...]}. Тексты — на русском, короткие.'
+            'Ты редактор учебных тестов. Получаешь массив вопросов и предлагаешь '
-    )
+            'улучшения: чёткие формулировки, лучшие дистракторы, корректную разметку '
+            'isCorrect. Сохраняй исходную сетку: число вопросов, число вариантов и '
+            'значение hasMultipleAnswers НЕ меняй — иначе клиент отклонит ответ. '
+            'Отвечай ТОЛЬКО JSON: {"questions": [{"text", "hasMultipleAnswers", '
+            '"options": [{"text", "isCorrect"}]}, ...]}. Тексты — на русском, короткие.'
+        ),
+        'questions': (
+            'Ты редактор учебных тестов. Улучши ТОЛЬКО формулировки вопросов (поле text). '
+            'В ответе для каждого вопроса верни options ДОСЛОВНО как во входе '
+            '(те же тексты и те же isCorrect), без правок. '
+            'Сетку не меняй. Отвечай ТОЛЬКО JSON: {"questions": [{"text", "hasMultipleAnswers", '
+            '"options": [{"text", "isCorrect"}]}, ...]}.'
+        ),
+        'distractors': (
+            'Ты редактор учебных тестов. Улучши ТОЛЬКО неверные варианты (дистракторы), '
+            'где isCorrect: false. Верные варианты (isCorrect: true) верни ДОСЛОВНО как во входе. '
+            'Текст вопроса (text) не меняй — верни как во входе. hasMultipleAnswers не меняй. '
+            'Отвечай ТОЛЬКО JSON: {"questions": [{"text", "hasMultipleAnswers", '
+            '"options": [{"text", "isCorrect"}]}, ...]}.'
+        ),
+        'options': (
+            'Ты редактор учебных тестов. Улучши формулировки всех вариантов ответа; '
+            'какой вариант верный, не меняй — isCorrect копируй из входа для каждого индекса. '
+            'Текст вопроса не меняй — верни как во входе. hasMultipleAnswers не меняй. '
+            'Отвечай ТОЛЬКО JSON: {"questions": [{"text", "hasMultipleAnswers", '
+            '"options": [{"text", "isCorrect"}]}, ...]}.'
+        ),
+    }
+    system = system_by_focus[focus]
+
     test_dump = {
         'title': title,
         'description': desc,
@@ -251,7 +362,9 @@ def improve_test_full(test_title: str, test_description: str, questions: list[di
     draft = validate_and_normalize_draft(
         {'title': title, 'questions': parsed.get('questions') or []}
     )
-    suggested_qs = draft['questions']
+    raw_suggested = draft['questions']
+
+    suggested_qs = [_merge_suggested_by_focus(focus, o, s) for o, s in zip(qs, raw_suggested)]
 
     items = []
     for i, (orig, sug) in enumerate(zip(qs, suggested_qs)):
@@ -287,7 +400,116 @@ def improve_test_full(test_title: str, test_description: str, questions: list[di
             }
         )
 
-    return {'items': items}
+    return {'items': items, 'focus': focus}
+
+
+def improve_single_option_text(
+    test_title: str,
+    test_description: str,
+    question_text: str,
+    options: list[dict],
+    option_index: int,
+) -> dict:
+    """Улучшает формулировку одного варианта ответа, не меняя роль (верный/неверный)."""
+    cfg = _require_cfg()
+    opts = options or []
+    try:
+        idx = int(option_index)
+    except (TypeError, ValueError):
+        raise HttpError(400, 'Укажите целочисленный optionIndex.')
+    if idx < 0 or idx >= len(opts):
+        raise HttpError(400, 'Некорректный индекс варианта.')
+
+    topic = (((test_title or '').strip() or 'Тест') + '. ' + (test_description or '').strip()).strip()
+    qt = (question_text or '').strip()
+    lines = []
+    for j, o in enumerate(opts):
+        mark = ' ← улучшить этот вариант' if j == idx else ''
+        oc = 'верный' if o.get('isCorrect') else 'неверный'
+        lines.append(f'{j + 1}. ({oc}) {o.get("text", "")}{mark}')
+
+    system = (
+        'Ты редактор учебных тестов. Отвечай ТОЛЬКО JSON: {"text": string} — '
+        'улучшенная формулировка ОДНОГО варианта ответа. Не меняй статус верности: '
+        'если вариант был верным, формулировка остаётся верным ответом по смыслу; '
+        'если неверным — остаётся неверным дистрактором. Без лишних слов.'
+    )
+    user = (
+        f'Тема теста: {topic}\n\n'
+        f'Вопрос: {qt or "—"}\n\n'
+        'Варианты:\n'
+        + '\n'.join(lines)
+        + f'\n\nПерепиши только вариант №{idx + 1}, короче и яснее, на русском.'
+    )
+    raw = chat_completion_text_content(cfg, system, user, 0.25)
+    parsed = parse_json_from_llm_text(raw)
+    text = str((parsed or {}).get('text') or '').strip()
+    if not text:
+        raise LlmError('Пустой text в ответе модели.', code='llm_shape')
+    return {'optionIndex': idx, 'text': text}
+
+
+def generate_question_hint(
+    *,
+    question_text: str,
+    options: list[dict],
+) -> str:
+    """Универсальная подсказка к вопросу: 2–4 предложения, объясняет правильный ответ."""
+    cfg = get_llm_config()
+    if cfg is None:
+        return ''
+    correct_list = '; '.join(o['text'] for o in options if o.get('isCorrect'))
+    all_list = '; '.join(o['text'] for o in options)
+    system = (
+        'Ты опытный преподаватель. Отвечай по-русски, кратко (2–4 предложения), '
+        'без markdown и без вступлений. Объясни почему правильный вариант — правильный.'
+    )
+    user = (
+        f'Вопрос: {question_text}\n'
+        f'Варианты: {all_list}\n'
+        f'Правильный ответ: {correct_list or "—"}\n\n'
+        'Дай краткое объяснение для подсказки во всплывающем окне.'
+    )
+    try:
+        raw = chat_completion_text_content(cfg, system, user, 0.3, as_json=False)
+        return (raw or '').strip()
+    except Exception as e:
+        import logging
+        logging.getLogger(__name__).warning('generate_question_hint failed: %s', e)
+        return ''
+
+
+def explain_answer(
+    *,
+    question_text: str,
+    options: list[dict],
+    selected_texts: list[str],
+    is_correct: bool,
+) -> str:
+    """Генерирует короткое объяснение результата ответа на вопрос (для попапа подсказки)."""
+    cfg = get_llm_config()
+    if cfg is None:
+        return ''
+    correct_list = '; '.join(o['text'] for o in options if o.get('isCorrect'))
+    sel_list = '; '.join(selected_texts) if selected_texts else '(ничего не выбрано)'
+    verdict = 'верно' if is_correct else 'неверно'
+    system = (
+        'Ты опытный преподаватель. Отвечай по-русски, кратко (2–4 предложения). '
+        'Объясни почему правильный ответ именно такой, без лишней воды и без markdown.'
+    )
+    user = (
+        f'Вопрос: {question_text}\n'
+        f'Правильный ответ: {correct_list or "—"}\n'
+        f'Ответ ученика ({verdict}): {sel_list}\n\n'
+        'Дай краткое объяснение для подсказки во всплывающем окне.'
+    )
+    try:
+        raw = chat_completion_text_content(cfg, system, user, 0.3, as_json=False)
+        return (raw or '').strip()
+    except Exception as e:
+        import logging
+        logging.getLogger(__name__).warning('explain_answer failed: %s', e)
+        return ''
 
 
 def generate_or_rephrase_question(
@@ -296,7 +518,11 @@ def generate_or_rephrase_question(
     question_text: str,
     options_count: Any,
     has_multiple_answers: bool,
+    mode: str | None = None,
+    existing_options: list[dict] | None = None,
 ) -> dict:
+    import json as _json
+
     cfg = _require_cfg()
     try:
         n = int(float(options_count))
@@ -307,8 +533,80 @@ def generate_or_rephrase_question(
 
     topic = (((test_title or '').strip() or 'Тест') + '. ' + (test_description or '').strip()).strip()
     qt = (question_text or '').strip()
+    mode = (mode or '').strip() if mode else ''
 
-    if qt:
+    # ── Режим дистракторов: есть вопрос + часть вариантов пуста ─────────────
+    if qt and mode == 'distractors' and existing_options:
+        filled = [o for o in existing_options if (o.get('text') or '').strip()]
+        empty_count = len([o for o in existing_options if not (o.get('text') or '').strip()])
+        if empty_count <= 0:
+            raise HttpError(400, 'Нет пустых полей для дистракторов — добавьте пустые варианты или выберите другой режим.')
+        filled_lines = '\n'.join(
+            f'- {"✓" if o.get("isCorrect") else "✗"} {o["text"]}'
+            for o in filled
+        ) or '(нет)'
+        system = (
+            'Ты составитель учебных тестов. Отвечай ТОЛЬКО JSON: '
+            f'{{"options": [{{"text": string, "isCorrect": false}}, ...]}} — '
+            f'ровно {empty_count} объекта в массиве. '
+            'Все тексты на русском, без нумерации, без кавычек.'
+        )
+        user = (
+            f'Тема теста: {topic}\n\n'
+            f'Вопрос: {qt}\n\n'
+            f'Уже заполненные варианты:\n{filled_lines}\n\n'
+            f'Придумай ровно {empty_count} правдоподобных, но НЕВЕРНЫХ дистракторов '
+            f'(isCorrect: false), которые не повторяют уже существующие варианты '
+            f'и выглядят похоже на реальные ответы.'
+        )
+        raw = chat_completion_text_content(cfg, system, user, 0.45)
+        parsed = parse_json_from_llm_text(raw)
+        opts = []
+        if isinstance(parsed, dict):
+            opts = parsed.get('options') or []
+        elif isinstance(parsed, list):
+            opts = parsed
+        opts = [
+            {'text': str(o.get('text') or '').strip(), 'isCorrect': False}
+            for o in opts if (o.get('text') or '').strip()
+        ][:empty_count]
+        return {'mode': 'distractors', 'text': qt, 'options': opts}
+
+    # ── Улучшить только формулировки вариантов (без смены верности) ──────────
+    if qt and mode == 'improve_options' and existing_options:
+        n_opts = len(existing_options)
+        if n_opts < 2:
+            raise HttpError(400, 'Нужно минимум два варианта ответа.')
+        dump_opts = [
+            {'text': str(o.get('text', '')), 'isCorrect': bool(o.get('isCorrect'))}
+            for o in existing_options
+        ]
+        system = (
+            'Ты редактор учебных тестов. Отвечай ТОЛЬКО JSON: '
+            '{"options": [{"text": string, "isCorrect": boolean}, ...]}. '
+            'Число элементов и значение isCorrect на каждом индексе должны совпадать с входом; '
+            'улучши только формулировки text — короче и яснее, на русском.'
+        )
+        user = (
+            f'Тема теста: {topic}\n\n'
+            f'Вопрос:\n{qt}\n\n'
+            f'Варианты (улучши только тексты, isCorrect не меняй):\n{_json.dumps(dump_opts, ensure_ascii=False)}'
+        )
+        raw = chat_completion_text_content(cfg, system, user, 0.3)
+        parsed = parse_json_from_llm_text(raw)
+        raw_list = parsed.get('options') if isinstance(parsed, dict) else None
+        if not isinstance(raw_list, list) or len(raw_list) != n_opts:
+            raise LlmError('Неверный формат: ожидается options той же длины.', code='llm_shape')
+        out_opts = []
+        for i in range(n_opts):
+            ro = raw_list[i] if i < len(raw_list) else {}
+            orig_t = dump_opts[i]['text'].strip()
+            t = str((ro or {}).get('text') or '').strip() or orig_t
+            out_opts.append({'text': t, 'isCorrect': dump_opts[i]['isCorrect']})
+        return {'mode': 'improve_options', 'text': qt, 'options': out_opts}
+
+    # ── Только переформулировать текст вопроса ────────────────────────────────
+    if qt and mode == 'rephrase':
         system = (
             'Ты редактор учебных материалов. Отвечай ТОЛЬКО JSON: {"text": string} — '
             'чёткая формулировка вопроса на русском, 1–3 полных предложения в зависимости '
@@ -325,6 +623,13 @@ def generate_or_rephrase_question(
             raise LlmError('Пустой text в ответе модели.', code='llm_shape')
         return {'mode': 'rephrase', 'text': text}
 
+    if qt:
+        raise HttpError(
+            400,
+            'Укажите режим: distractors, improve_options или rephrase — или очистите текст вопроса для полной генерации.',
+        )
+
+    # ── Полная генерация: вопрос пуст ────────────────────────────────────────
     system = (
         'Ты составитель тестов. Отвечай ТОЛЬКО JSON: {"text", "hasMultipleAnswers", '
         '"options": [{ "text", "isCorrect" }]}. Все на русском.'
@@ -344,9 +649,11 @@ def generate_or_rephrase_question(
     shape = [{'optionsCount': n, 'hasMultipleAnswers': bool(has_multiple_answers)}]
     assert_draft_matches_shape({'questions': [parsed]}, shape)
     draft = validate_and_normalize_draft({'title': 'временно', 'questions': [parsed]})
+    q0 = draft['questions'][0]
+    shuffle_options_in_questions([q0])
     return {
         'mode': 'full',
-        'text': draft['questions'][0]['text'],
+        'text': q0['text'],
-        'hasMultipleAnswers': draft['questions'][0]['hasMultipleAnswers'],
+        'hasMultipleAnswers': q0['hasMultipleAnswers'],
-        'options': draft['questions'][0]['options'],
+        'options': q0['options'],
     }

flask_app/app/services/document_extract.py

@@ -27,7 +27,9 @@ SUPPORTED_EXT = {
 
 
 def resolve_document_kind(mimetype: str | None, original_name: str | None = '') -> Optional[str]:
-    m = (mimetype or '').lower()
+    # Браузеры часто шлют «text/plain; charset=utf-8» — без отсечения параметров ключ не совпадает.
+    raw = (mimetype or '').strip()
+    m = raw.split(';', 1)[0].strip().lower()
     n = (original_name or '').lower()
     if m in SUPPORTED_MIME:
         return SUPPORTED_MIME[m]

flask_app/app/services/document_gen.py

@@ -2,7 +2,9 @@
 from __future__ import annotations
 
 from .draft_validator import (
+    normalize_draft_to_shape,
     parse_json_from_llm_text,
+    shuffle_options_in_questions,
     validate_and_normalize_draft,
 )
 from .llm_client import LlmError, chat_completion_text_content, get_llm_config
@@ -11,7 +13,7 @@ from .llm_client import LlmError, chat_completion_text_content, get_llm_config
 MAX_EXTRACT_CHARS = 14000
 
 
-def generation_for_import_document(extracted_text: str) -> dict:
+def generation_for_import_document(extracted_text: str, user_hint: str = '', shape: list[dict] | None = None) -> dict:
     text = (extracted_text or '').strip()
     if not text:
         return {
@@ -41,13 +43,29 @@ def generation_for_import_document(extracted_text: str) -> dict:
             'Для одиночного выбора ровно один isCorrect: true. '
             'Текст и формулировки — на русском, по содержанию входного материала.'
         )
+        hint_block = f'\n\nДополнительные инструкции от автора теста:\n{user_hint.strip()}' if user_hint and user_hint.strip() else ''
+        shape_block = ''
+        if shape:
+            rows = []
+            for i, sh in enumerate(shape):
+                if sh.get('hasMultipleAnswers'):
+                    rows.append(
+                        f'- Вопрос {i + 1}: ровно {sh["optionsCount"]} вариантов, '
+                        f'правильных от {sh.get("minCorrect", 1)} до {sh.get("maxCorrect", sh["optionsCount"])}.'
+                    )
+                else:
+                    rows.append(f'- Вопрос {i + 1}: ровно {sh["optionsCount"]} вариантов, ровно 1 правильный.')
+            shape_block = '\n\nСтрого соблюди шаблон:\n' + '\n'.join(rows)
         user = (
             'Составь тест с вопросами с одним или несколькими правильными ответами '
-            'на основе текста:\n\n' + slice_
+            'на основе текста:\n\n' + slice_ + hint_block + shape_block
         )
         raw = chat_completion_text_content(cfg, system, user, 0.25)
         parsed = parse_json_from_llm_text(raw)
         draft = validate_and_normalize_draft(parsed)
+        if shape:
+            draft = normalize_draft_to_shape(draft, shape)
+        shuffle_options_in_questions(draft['questions'])
         return {
             'available': True,
             'message': (

flask_app/app/services/draft_validator.py

@@ -2,6 +2,7 @@
 from __future__ import annotations
 
 import json as _json
+import random
 import re
 from typing import Any
 
@@ -79,6 +80,18 @@ def validate_and_normalize_draft(o: Any) -> dict:
     return {'title': title, 'description': description, 'questions': questions}
 
 
+def shuffle_options_in_questions(questions: list[dict] | None) -> None:
+    """Случайный порядок вариантов в каждом вопросе; isCorrect остаётся у соответствующего текста."""
+    if not questions:
+        return
+    for q in questions:
+        if not isinstance(q, dict):
+            continue
+        opts = q.get('options')
+        if isinstance(opts, list) and len(opts) >= 2:
+            random.shuffle(opts)
+
+
 def assert_draft_matches_shape(o: dict, shape: list[dict]) -> None:
     """Проверяет, что число вопросов и вариантов = ровно как в shape."""
     qs = o.get('questions') if isinstance(o, dict) else None
@@ -103,3 +116,65 @@ def assert_draft_matches_shape(o: dict, shape: list[dict]) -> None:
                 f'Вопрос {i + 1}: hasMultipleAnswers должен быть {sh["hasMultipleAnswers"]}.',
                 code='llm_shape',
             )
+        min_c = int(sh.get('minCorrect', 1))
+        max_c = int(sh.get('maxCorrect', sh['optionsCount']))
+        correct_n = sum(1 for op in opts if bool(op.get('isCorrect')))
+        if correct_n < min_c or correct_n > max_c:
+            raise LlmError(
+                f'Вопрос {i + 1}: правильных ответов должно быть от {min_c} до {max_c}, в ответе: {correct_n}.',
+                code='llm_shape',
+            )
+
+
+def normalize_draft_to_shape(draft: dict, shape: list[dict]) -> dict:
+    """Приводит draft к shape: число вопросов/вариантов/мульти и диапазон correct."""
+    qs = list((draft or {}).get('questions') or [])
+    out_qs = []
+
+    def _mk_option(i: int) -> dict:
+        return {'text': f'Вариант {i + 1}', 'isCorrect': False}
+
+    for i, sh in enumerate(shape):
+        src = qs[i] if i < len(qs) and isinstance(qs[i], dict) else {}
+        text = str(src.get('text') or '').strip() or f'Вопрос {i + 1}'
+        has_multi = bool(sh.get('hasMultipleAnswers'))
+        min_c = int(sh.get('minCorrect', 1))
+        max_c = int(sh.get('maxCorrect', sh['optionsCount']))
+        if not has_multi:
+            min_c = 1
+            max_c = 1
+
+        raw_opts = src.get('options') if isinstance(src.get('options'), list) else []
+        opts = []
+        for j in range(sh['optionsCount']):
+            if j < len(raw_opts) and isinstance(raw_opts[j], dict):
+                t = str(raw_opts[j].get('text') or '').strip() or f'Вариант {j + 1}'
+                opts.append({'text': t, 'isCorrect': bool(raw_opts[j].get('isCorrect'))})
+            else:
+                opts.append(_mk_option(j))
+
+        true_idx = [idx for idx, op in enumerate(opts) if op['isCorrect']]
+        if not has_multi:
+            keep = true_idx[0] if true_idx else 0
+            for idx, op in enumerate(opts):
+                op['isCorrect'] = (idx == keep)
+        else:
+            if len(true_idx) < min_c:
+                for idx in range(len(opts)):
+                    if idx not in true_idx:
+                        opts[idx]['isCorrect'] = True
+                        true_idx.append(idx)
+                    if len(true_idx) >= min_c:
+                        break
+            if len(true_idx) > max_c:
+                keep = set(true_idx[:max_c])
+                for idx, op in enumerate(opts):
+                    op['isCorrect'] = idx in keep
+
+        out_qs.append({'text': text, 'hasMultipleAnswers': has_multi, 'options': opts})
+
+    return {
+        'title': str((draft or {}).get('title') or '').strip() or 'Тест',
+        'description': (draft or {}).get('description'),
+        'questions': out_qs,
+    }

flask_app/app/services/editor_content.py

@@ -1,15 +1,16 @@
-"""Контент редактора: тест + активная версия + дерево вопросов с правильными вариантами.
+"""Контент редактора: тест + активная версия + дерево вопросов с правильными вариантами."""
-
-Порт `getEditorContent` + `loadQuestionsForVersion` (только includeCorrect=true вариант)
-из `services/testAttemptService.js`.
-"""
 from __future__ import annotations
 
-from sqlalchemy import text
+import uuid as _uuid
 
-from ..db import get_engine
+from sqlalchemy import func
+from sqlalchemy.orm import selectinload
+
+from ..db import get_session
 from ..messages import RU
-from .test_access import is_test_author
+from ..models import AnswerOption, Question, Test, TestVersion
+from .test_access import is_test_author, is_test_edit_open
+from .test_chain import has_any_attempt_for_test
 
 
 class HttpError(Exception):
@@ -19,77 +20,86 @@ class HttpError(Exception):
         self.message = message
 
 
-def load_questions_for_version(conn, test_version_id, *, include_correct: bool) -> list[dict]:
+def load_questions_for_version(session, test_version_id, *, include_correct: bool) -> list[dict]:
-    qrows = conn.execute(
+    if not isinstance(test_version_id, _uuid.UUID):
-        text(
+        try:
-            'SELECT id, text, question_order, has_multiple_answers '
+            test_version_id = _uuid.UUID(str(test_version_id))
-            'FROM questions WHERE test_version_id = :v ORDER BY question_order'
+        except (ValueError, AttributeError):
-        ),
+            return []
-        {'v': test_version_id},
+
-    ).mappings().all()
+    questions = (
+        session.query(Question)
+        .options(selectinload(Question.options))
+        .filter(Question.test_version_id == test_version_id)
+        .order_by(Question.question_order)
+        .all()
+    )
     out = []
-    for r in qrows:
+    for q in questions:
-        orows = conn.execute(
-            text(
-                'SELECT id, text, is_correct, option_order '
-                'FROM answer_options WHERE question_id = :q ORDER BY option_order'
-            ),
-            {'q': r['id']},
-        ).mappings().all()
         options = []
-        for o in orows:
+        for o in sorted(q.options, key=lambda x: x.option_order):
             base = {
-                'id': str(o['id']),
+                'id': str(o.id),
-                'text': o['text'],
+                'text': o.text,
-                'optionOrder': o['option_order'],
+                'optionOrder': o.option_order,
             }
             if include_correct:
-                base['isCorrect'] = bool(o['is_correct'])
+                base['isCorrect'] = bool(o.is_correct)
             options.append(base)
-        out.append(
+        out.append({
-            {
+            'id': str(q.id),
-                'id': str(r['id']),
+            'text': q.text,
-                'text': r['text'],
+            'questionOrder': q.question_order,
-                'questionOrder': r['question_order'],
+            'hasMultipleAnswers': bool(q.has_multiple_answers),
-                'hasMultipleAnswers': bool(r['has_multiple_answers']),
+            'aiHint': (q.ai_hint or '').strip() or None,
-                'options': options,
+            'options': options,
-            }
+        })
-        )
     return out
 
 
 def get_editor_content(user_id: str, test_id: str) -> dict:
-    eng = get_engine()
+    session = get_session()
-    with eng.connect() as conn:
+    try:
-        tr = conn.execute(
+        tid = _uuid.UUID(test_id)
-            text(
+    except (ValueError, AttributeError):
-                'SELECT id, title, description, passing_threshold, created_by '
+        raise HttpError(404, 'Тест не найден.')
-                'FROM tests WHERE id = :id'
+
-            ),
+    test = session.get(Test, tid)
-            {'id': test_id},
+    if not test:
-        ).mappings().first()
+        raise HttpError(404, 'Тест не найден.')
-        if not tr:
+    if not is_test_author(test.created_by, user_id) and not is_test_edit_open():
-            raise HttpError(404, 'Тест не найден.')
+        raise HttpError(403, 'Доступ запрещён.')
-        if not is_test_author(tr['created_by'], user_id):
+
-            raise HttpError(403, 'Доступ запрещён.')
+    active_version = (
-        tv = conn.execute(
+        session.query(TestVersion)
-            text(
+        .filter(TestVersion.test_id == tid, TestVersion.is_active.is_(True))
-                'SELECT id FROM test_versions WHERE test_id = :id AND is_active = true LIMIT 1'
+        .first()
-            ),
+    )
-            {'id': test_id},
+    if not active_version:
-        ).mappings().first()
+        raise HttpError(400, 'Нет активной версии теста.')
-        if not tv:
+
-            raise HttpError(400, 'Нет активной версии теста.')
+    version_count = (
-        version_id = tv['id']
+        session.query(func.count(TestVersion.id))
-        questions = load_questions_for_version(conn, version_id, include_correct=True)
+        .filter(TestVersion.test_id == tid)
+        .scalar() or 0
+    )
+
+    questions = load_questions_for_version(session, active_version.id, include_correct=True)
+    has_attempts = has_any_attempt_for_test(session, tid)
 
     return {
         'test': {
-            'id': str(tr['id']),
+            'id': str(test.id),
-            'title': tr['title'],
+            'title': test.title,
-            'description': tr['description'],
+            'description': test.description,
-            'passingThreshold': tr['passing_threshold'],
+            'passingThreshold': test.passing_threshold,
+            'timeLimit': test.time_limit,
+            'hintsEnabled': bool(test.hints_enabled),
+            'resultMode': test.result_mode or 'end',
+            'hasAttempts': bool(has_attempts),
+            'versionCount': version_count,
+            'hasForkRisk': bool(has_attempts) or version_count > 1,
         },
-        'activeVersionId': str(version_id),
+        'activeVersionId': str(active_version.id),
         'questions': questions,
     }

flask_app/app/services/llm_client.py

@@ -51,8 +51,13 @@ def chat_completion_text_content(
     user: str,
     temperature: float = 0.25,
     timeout: int = 120,
+    as_json: bool = True,
 ) -> str:
-    """Возвращает `assistant.message.content` (строку)."""
+    """Возвращает `assistant.message.content` (строку).
+
+    `as_json=True` (по умолчанию) включает `response_format: json_object`. Для свободного
+    текста (например, объяснения к вопросу) передайте `as_json=False`.
+    """
     body: dict = {
         'model': cfg.model,
         'messages': [
@@ -61,7 +66,7 @@ def chat_completion_text_content(
         ],
         'temperature': temperature,
     }
-    if (os.environ.get('LLM_NO_JSON') or '').strip() != '1':
+    if as_json and (os.environ.get('LLM_NO_JSON') or '').strip() != '1':
         body['response_format'] = {'type': 'json_object'}
 
     req = urllib.request.Request(

flask_app/app/services/prompt_store.py

@@ -0,0 +1,79 @@
+"""Хранилище редактируемых промптов для AI-функций.
+
+Промпты хранятся в app/data/prompts.json и загружаются при старте.
+Если файл не существует или повреждён — используются встроенные defaults.
+"""
+from __future__ import annotations
+
+import json
+import logging
+import os
+import threading
+from pathlib import Path
+from typing import Any
+
+_log = logging.getLogger(__name__)
+_lock = threading.Lock()
+
+_DATA_FILE = Path(__file__).parent.parent / 'data' / 'prompts.json'
+
+_store: dict[str, dict] | None = None
+
+
+def _load() -> dict[str, dict]:
+    if _DATA_FILE.exists():
+        try:
+            with _DATA_FILE.open('r', encoding='utf-8') as f:
+                data = json.load(f)
+            if isinstance(data, dict):
+                return data
+        except Exception as e:
+            _log.warning('prompt_store: не удалось загрузить %s: %s', _DATA_FILE, e)
+    return {}
+
+
+def _get_store() -> dict[str, dict]:
+    global _store
+    if _store is None:
+        with _lock:
+            if _store is None:
+                _store = _load()
+    return _store
+
+
+def get_all() -> dict[str, dict]:
+    """Вернуть все промпты (id → {label, description, system, user, vars})."""
+    return dict(_get_store())
+
+
+def get_prompt(prompt_id: str) -> dict[str, Any] | None:
+    return _get_store().get(prompt_id)
+
+
+def get_system(prompt_id: str, default: str = '') -> str:
+    p = get_prompt(prompt_id)
+    return p.get('system', default) if p else default
+
+
+def get_user(prompt_id: str, default: str = '') -> str:
+    p = get_prompt(prompt_id)
+    return p.get('user', default) if p else default
+
+
+def save_all(data: dict[str, dict]) -> None:
+    """Сохранить все промпты в JSON-файл и обновить кеш."""
+    global _store
+    _DATA_FILE.parent.mkdir(parents=True, exist_ok=True)
+    with _lock:
+        with _DATA_FILE.open('w', encoding='utf-8') as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+        _store = data
+
+
+def save_prompt(prompt_id: str, system: str, user: str) -> None:
+    """Обновить system/user для одного промпта."""
+    store = dict(_get_store())
+    if prompt_id not in store:
+        raise KeyError(f'Промпт {prompt_id!r} не найден.')
+    store[prompt_id] = {**store[prompt_id], 'system': system, 'user': user}
+    save_all(store)

flask_app/app/services/test_access.py

@@ -1,15 +1,29 @@
-"""Кто видит тест: автор + назначенные пользователи (порт `services/testAccessService.js`)."""
+"""Кто видит тест: автор + назначенные пользователи."""
 from __future__ import annotations
 
+import os
 from dataclasses import dataclass
 
-from sqlalchemy import text
+from sqlalchemy import exists, func
 
-from ..db import get_engine
+from ..db import get_session
+from ..models import Question, Test, TestAssignment, TestAssignmentTarget, TestAttempt, TestVersion, User
+
+
+def _truthy_env(val: str | None) -> bool:
+    return (val or '').strip().lower() in ('1', 'true', 'yes', 'on')
+
+
+def is_test_edit_open() -> bool:
+    """Пока без RBAC: любой залогиненный пользователь может править любой тест.
+
+    Задайте ``CLINIC_TESTS_RESTRICT_EDIT_TO_AUTHOR=1``, чтобы снова требовать роль автора
+    для редактирования, подсказок, списка попыток и разбора чужих попыток.
+    """
+    return not _truthy_env(os.environ.get('CLINIC_TESTS_RESTRICT_EDIT_TO_AUTHOR'))
 
 
 def is_test_author(created_by, user_id) -> bool:
-    """`tests.created_by` — UUID. Сравниваем по строковому представлению."""
     if created_by is None or user_id is None:
         return False
     return str(created_by) == str(user_id)
@@ -23,86 +37,152 @@ class AccessResult:
 
 
 def user_has_test_access(user_id: str, test_id: str) -> AccessResult:
-    eng = get_engine()
+    import uuid as _uuid
-    with eng.connect() as conn:
+    session = get_session()
-        row = conn.execute(
+    try:
-            text('SELECT created_by FROM tests WHERE id = :id'),
+        tid = _uuid.UUID(test_id)
-            {'id': test_id},
+        uid = _uuid.UUID(user_id)
-        ).mappings().first()
+    except (ValueError, AttributeError):
-        if not row:
+        return AccessResult(ok=False, is_author=False, not_found=True)
-            return AccessResult(ok=False, is_author=False, not_found=True)
+
-        if is_test_author(row['created_by'], user_id):
+    test = session.get(Test, tid)
-            return AccessResult(ok=True, is_author=True, not_found=False)
+    if not test:
-        ar = conn.execute(
+        return AccessResult(ok=False, is_author=False, not_found=True)
-            text(
+
-                """
+    if is_test_author(test.created_by, uid):
-                SELECT 1
+        return AccessResult(ok=True, is_author=True, not_found=False)
-                  FROM test_assignments ta
+
-                  INNER JOIN test_versions tv_a ON tv_a.id = ta.test_version_id
+    # Глобальная политика доступа: любой активный тест доступен всем сотрудникам.
-                  INNER JOIN test_assignment_targets tat ON tat.assignment_id = ta.id
+    if bool(test.is_active):
-                 WHERE tv_a.test_id = :test_id
+        return AccessResult(ok=True, is_author=False, not_found=False)
-                   AND tat.target_type = 'user'
+
-                   AND tat.target_id = :user_id
+    assigned = session.query(
-                 LIMIT 1
+        exists().where(
-                """
+            TestAssignmentTarget.target_type == 'user',
-            ),
+            TestAssignmentTarget.target_id == uid,
-            {'test_id': test_id, 'user_id': user_id},
+            TestAssignmentTarget.assignment_id == TestAssignment.id,
-        ).first()
+            TestAssignment.test_version_id == TestVersion.id,
-    return AccessResult(ok=ar is not None, is_author=False, not_found=False)
+            TestVersion.test_id == tid,
+        )
+    ).scalar()
+
+    return AccessResult(ok=bool(assigned), is_author=False, not_found=False)
 
 
 def list_visible_tests(user_id: str) -> list[dict]:
-    """Каталог: только активная цепочка + (автор OR назначен)."""
+    """В dev-режиме возвращает все активные тесты независимо от назначения."""
-    eng = get_engine()
+    import uuid as _uuid
-    with eng.connect() as conn:
+    session = get_session()
-        rows = conn.execute(
+    try:
-            text(
+        uid = _uuid.UUID(user_id)
-                """
+    except (ValueError, AttributeError):
-                SELECT DISTINCT t.id, t.title, t.description, t.is_active AS chain_active,
+        uid = None
-                       t.created_at, t.updated_at,
+
-                       tv.id AS active_version_id, tv.version,
+    qcount_sq = (
-                       t.created_by, u.full_name AS author_full_name
+        session.query(
-                  FROM tests t
+            Question.test_version_id.label('tv_id'),
-                  INNER JOIN test_versions tv ON tv.test_id = t.id AND tv.is_active = true
+            func.count(Question.id).label('qc'),
-                  INNER JOIN users u ON u.id = t.created_by
+        )
-                 WHERE t.is_active = true
+        .group_by(Question.test_version_id)
-                   AND (
+        .subquery()
-                     t.created_by = :uid
+    )
-                     OR EXISTS (
+
-                       SELECT 1
+    rows = (
-                         FROM test_assignments ta
+        session.query(Test, TestVersion, User, qcount_sq.c.qc)
-                         INNER JOIN test_versions tv2 ON tv2.id = ta.test_version_id
+        .join(TestVersion, (TestVersion.test_id == Test.id) & TestVersion.is_active.is_(True))
-                         INNER JOIN test_assignment_targets tat ON tat.assignment_id = ta.id
+        .outerjoin(User, User.id == Test.created_by)
-                        WHERE tv2.test_id = t.id
+        .outerjoin(qcount_sq, qcount_sq.c.tv_id == TestVersion.id)
-                          AND tat.target_type = 'user'
+        .filter(Test.is_active.is_(True))
-                          AND tat.target_id = :uid
+        .order_by(Test.updated_at.desc().nullslast(), Test.created_at.desc())
-                     )
+        .all()
-                   )
+    )
-                 ORDER BY t.updated_at DESC NULLS LAST, t.created_at DESC
+
-                """
+    return [
+        {
+            'id': str(t.id),
+            'title': t.title,
+            'description': t.description,
+            'chain_active': t.is_active,
+            'created_at': t.created_at,
+            'updated_at': t.updated_at,
+            'active_version_id': str(tv.id),
+            'version': tv.version,
+            'created_by': str(t.created_by) if t.created_by else None,
+            'author_full_name': u.full_name if u else '—',
+            'passing_threshold': int(t.passing_threshold or 0),
+            'time_limit': t.time_limit,
+            'result_mode': (t.result_mode or 'end'),
+            'hints_enabled': bool(t.hints_enabled),
+            'questions_count': int(qc or 0),
+            'has_in_progress_attempt': bool(
+                uid and session.query(
+                    exists().where(
+                        TestAttempt.user_id == uid,
+                        TestAttempt.status == 'in_progress',
+                        TestAttempt.test_version_id == TestVersion.id,
+                        TestVersion.test_id == t.id,
+                    )
+                ).scalar()
             ),
-            {'uid': user_id},
+        }
-        ).mappings().all()
+        for t, tv, u, qc in rows
-    return [dict(r) for r in rows]
+    ]
 
 
 def list_hidden_by_author(user_id: str) -> list[dict]:
-    """Скрытые автором цепочки (`is_active = false`) — видны только автору."""
+    import uuid as _uuid
-    eng = get_engine()
+    session = get_session()
-    with eng.connect() as conn:
+    try:
-        rows = conn.execute(
+        uid = _uuid.UUID(user_id)
-            text(
+    except (ValueError, AttributeError):
-                """
+        return []
-                SELECT t.id, t.title, t.description, t.is_active AS chain_active,
+
-                       t.created_at, t.updated_at, tv.id AS active_version_id, tv.version,
+    qcount_sq = (
-                       t.created_by, u.full_name AS author_full_name
+        session.query(
-                  FROM tests t
+            Question.test_version_id.label('tv_id'),
-                  INNER JOIN test_versions tv ON tv.test_id = t.id AND tv.is_active = true
+            func.count(Question.id).label('qc'),
-                  INNER JOIN users u ON u.id = t.created_by
+        )
-                 WHERE t.is_active = false AND t.created_by = :uid
+        .group_by(Question.test_version_id)
-                 ORDER BY t.updated_at DESC NULLS LAST, t.created_at DESC
+        .subquery()
-                """
+    )
+
+    rows = (
+        session.query(Test, TestVersion, User, qcount_sq.c.qc)
+        .join(TestVersion, (TestVersion.test_id == Test.id) & TestVersion.is_active.is_(True))
+        .join(User, User.id == Test.created_by)
+        .outerjoin(qcount_sq, qcount_sq.c.tv_id == TestVersion.id)
+        .filter(Test.is_active.is_(False), Test.created_by == uid)
+        .order_by(Test.updated_at.desc().nullslast(), Test.created_at.desc())
+        .all()
+    )
+
+    return [
+        {
+            'id': str(t.id),
+            'title': t.title,
+            'description': t.description,
+            'chain_active': t.is_active,
+            'created_at': t.created_at,
+            'updated_at': t.updated_at,
+            'active_version_id': str(tv.id),
+            'version': tv.version,
+            'created_by': str(t.created_by),
+            'author_full_name': u.full_name,
+            'passing_threshold': int(t.passing_threshold or 0),
+            'time_limit': t.time_limit,
+            'result_mode': (t.result_mode or 'end'),
+            'hints_enabled': bool(t.hints_enabled),
+            'questions_count': int(qc or 0),
+            'has_in_progress_attempt': bool(
+                session.query(
+                    exists().where(
+                        TestAttempt.user_id == uid,
+                        TestAttempt.status == 'in_progress',
+                        TestAttempt.test_version_id == TestVersion.id,
+                        TestVersion.test_id == t.id,
+                    )
+                ).scalar()
             ),
-            {'uid': user_id},
+        }
-        ).mappings().all()
+        for t, tv, u, qc in rows
-    return [dict(r) for r in rows]
+    ]

flask_app/app/services/test_attempt.py

@@ -0,0 +1,619 @@
+"""Сервис прохождения теста."""
+from __future__ import annotations
+
+import uuid as _uuid
+from datetime import datetime, timezone
+
+from sqlalchemy import func
+from sqlalchemy.orm import Session, selectinload
+
+from ..db import get_session
+from ..models import (
+    AnswerOption,
+    Question,
+    Test,
+    TestAttempt,
+    TestVersion,
+    User,
+    UserAnswer,
+)
+from .test_access import is_test_author, is_test_edit_open, user_has_test_access
+
+
+class HttpError(Exception):
+    def __init__(self, status: int, message: str):
+        super().__init__(message)
+        self.status = status
+        self.message = message
+
+
+def _sort_uuid_strings(items) -> list[str]:
+    return sorted({str(x) for x in (items or []) if x is not None})
+
+
+def _same_selection(selected, correct_ids) -> bool:
+    return _sort_uuid_strings(selected) == _sort_uuid_strings(correct_ids)
+
+
+def _to_uuid(val) -> _uuid.UUID | None:
+    if isinstance(val, _uuid.UUID):
+        return val
+    try:
+        return _uuid.UUID(str(val))
+    except (ValueError, AttributeError):
+        return None
+
+
+# ─── load questions (shared) ─────────────────────────────────────────────────
+
+def load_questions_for_version(
+    session: Session,
+    test_version_id,
+    *,
+    include_correct: bool,
+    include_hints: bool = False,
+) -> list[dict]:
+    vid = _to_uuid(test_version_id)
+    if vid is None:
+        return []
+    questions = (
+        session.query(Question)
+        .options(selectinload(Question.options))
+        .filter(Question.test_version_id == vid)
+        .order_by(Question.question_order)
+        .all()
+    )
+    out = []
+    for q in questions:
+        options = []
+        for o in sorted(q.options, key=lambda x: x.option_order):
+            base = {'id': str(o.id), 'text': o.text, 'optionOrder': o.option_order}
+            if include_correct:
+                base['isCorrect'] = bool(o.is_correct)
+            options.append(base)
+        item = {
+            'id': str(q.id),
+            'text': q.text,
+            'questionOrder': q.question_order,
+            'hasMultipleAnswers': bool(q.has_multiple_answers),
+            'options': options,
+        }
+        if include_hints:
+            hint = (q.ai_hint or '').strip()
+            item['aiHint'] = hint or None
+        out.append(item)
+    return out
+
+
+# ─── start ───────────────────────────────────────────────────────────────────
+
+def start_attempt(session_or_eng, user_id: str, test_id: str) -> dict:
+    """Принимает engine (legacy) или session — для обратной совместимости."""
+    acc = user_has_test_access(user_id, test_id)
+    if not acc.ok:
+        raise HttpError(404, 'Тест не найден.')
+
+    session = get_session()
+    tid = _to_uuid(test_id)
+    uid = _to_uuid(user_id)
+
+    active_version = (
+        session.query(TestVersion)
+        .filter(TestVersion.test_id == tid, TestVersion.is_active.is_(True))
+        .first()
+    )
+    if not active_version:
+        raise HttpError(404, 'Нет активной версии теста.')
+
+    max_n = (
+        session.query(func.coalesce(func.max(TestAttempt.attempt_number), 0))
+        .filter(
+            TestAttempt.test_version_id == active_version.id,
+            TestAttempt.user_id == uid,
+        )
+        .scalar() or 0
+    )
+    attempt = TestAttempt(
+        test_version_id=active_version.id,
+        user_id=uid,
+        attempt_number=int(max_n) + 1,
+        status='in_progress',
+    )
+    session.add(attempt)
+    session.commit()
+    session.refresh(attempt)
+    return {
+        'attempt': {
+            'id': str(attempt.id),
+            'test_version_id': str(attempt.test_version_id),
+            'user_id': str(attempt.user_id),
+            'attempt_number': attempt.attempt_number,
+            'status': attempt.status,
+            'started_at': attempt.started_at.isoformat() if attempt.started_at else None,
+        }
+    }
+
+
+# ─── play ────────────────────────────────────────────────────────────────────
+
+def get_play_content(session_or_eng, user_id: str, test_id: str, attempt_id: str) -> dict:
+    session = get_session()
+    aid = _to_uuid(attempt_id)
+    uid = _to_uuid(user_id)
+    tid = _to_uuid(test_id)
+
+    attempt = (
+        session.query(TestAttempt)
+        .options(
+            selectinload(TestAttempt.test_version).selectinload(TestVersion.test)
+        )
+        .filter(TestAttempt.id == aid)
+        .first()
+    )
+    if not attempt:
+        raise HttpError(404, 'Попытка не найдена.')
+    if attempt.test_version.test_id != tid:
+        raise HttpError(404, 'Попытка не найдена.')
+    if attempt.user_id != uid:
+        raise HttpError(403, 'Доступ запрещён.')
+    if attempt.status != 'in_progress':
+        raise HttpError(400, 'Попытка уже завершена.')
+
+    test = attempt.test_version.test
+    qs = load_questions_for_version(session, attempt.test_version_id, include_correct=False)
+    return {
+        'testTitle': test.title,
+        'passingThreshold': test.passing_threshold,
+        'timeLimit': test.time_limit,
+        'hintsEnabled': bool(test.hints_enabled),
+        'resultMode': test.result_mode or 'end',
+        'attemptId': str(attempt.id),
+        'questions': qs,
+    }
+
+
+# ─── submit ──────────────────────────────────────────────────────────────────
+
+def submit_attempt(session_or_eng, user_id: str, test_id: str, attempt_id: str,
+                   raw_answers: dict | None) -> dict:
+    answers = raw_answers if isinstance(raw_answers, dict) else {}
+    session = get_session()
+    aid = _to_uuid(attempt_id)
+    uid = _to_uuid(user_id)
+    tid = _to_uuid(test_id)
+
+    attempt = (
+        session.query(TestAttempt)
+        .options(selectinload(TestAttempt.test_version).selectinload(TestVersion.test))
+        .filter(TestAttempt.id == aid)
+        .with_for_update()
+        .first()
+    )
+    if not attempt:
+        raise HttpError(404, 'Попытка не найдена.')
+    if attempt.test_version.test_id != tid:
+        raise HttpError(404, 'Попытка не найдена.')
+    if attempt.user_id != uid:
+        raise HttpError(403, 'Доступ запрещён.')
+    if attempt.status != 'in_progress':
+        raise HttpError(400, 'Попытка уже завершена.')
+
+    test = attempt.test_version.test
+    questions = (
+        session.query(Question)
+        .options(selectinload(Question.options))
+        .filter(Question.test_version_id == attempt.test_version_id)
+        .all()
+    )
+    if not questions:
+        raise HttpError(400, 'В тесте нет вопросов.')
+
+    by_q: dict[str, dict] = {}
+    for q in questions:
+        qid = str(q.id)
+        by_q[qid] = {'all': {str(o.id) for o in q.options}, 'correct': [str(o.id) for o in q.options if o.is_correct]}
+
+    correct_count = 0
+    for q in questions:
+        qid = str(q.id)
+        selected = answers.get(qid, [])
+        if not isinstance(selected, list):
+            selected = [str(selected)]
+        selected = [str(x) for x in selected]
+        g = by_q[qid]
+        for sid in selected:
+            if sid not in g['all']:
+                raise HttpError(400, 'Некорректный вариант ответа.')
+        if _same_selection(selected, g['correct']):
+            correct_count += 1
+
+    total = len(questions)
+    percent = (correct_count / total) * 100 if total else 0
+    threshold = int(test.passing_threshold or 0)
+    passed = percent + 1e-9 >= threshold
+
+    # удаляем старые ответы и записываем новые
+    session.query(UserAnswer).filter(UserAnswer.attempt_id == aid).delete(synchronize_session='fetch')
+    for q in questions:
+        qid = str(q.id)
+        selected = answers.get(qid, [])
+        if not isinstance(selected, list):
+            selected = [str(selected)]
+        selected_uuids = [_to_uuid(x) for x in selected if _to_uuid(x) is not None]
+        session.add(UserAnswer(
+            attempt_id=aid,
+            question_id=q.id,
+            selected_options=selected_uuids,
+        ))
+
+    attempt.status = 'completed'
+    attempt.completed_at = datetime.now(timezone.utc)
+    attempt.correct_count = correct_count
+    attempt.total_questions = total
+    attempt.passed = passed
+    session.commit()
+
+    review = build_review_from_db(session, attempt_id)
+    return {
+        'attemptId': attempt_id,
+        'correctCount': correct_count,
+        'totalQuestions': total,
+        'percent': round(percent, 1),
+        'passed': passed,
+        'passingThreshold': threshold,
+        'review': review,
+    }
+
+
+# ─── review ──────────────────────────────────────────────────────────────────
+
+def build_review_from_db(session: Session, attempt_id: str) -> dict:
+    aid = _to_uuid(attempt_id)
+    attempt = (
+        session.query(TestAttempt)
+        .options(
+            selectinload(TestAttempt.test_version).selectinload(TestVersion.test),
+            selectinload(TestAttempt.user),
+            selectinload(TestAttempt.user_answers),
+        )
+        .filter(TestAttempt.id == aid)
+        .first()
+    )
+    if not attempt:
+        raise HttpError(404, 'Попытка не найдена.')
+    if attempt.status != 'completed':
+        raise HttpError(400, 'Попытка не завершена.')
+
+    test = attempt.test_version.test
+    questions = load_questions_for_version(
+        session, attempt.test_version_id, include_correct=True, include_hints=True
+    )
+
+    sel_by_q: dict[str, list[str]] = {
+        str(ua.question_id): [str(x) for x in (ua.selected_options or [])]
+        for ua in attempt.user_answers
+    }
+
+    total = int(attempt.total_questions or len(questions))
+    percent = round(((attempt.correct_count or 0) / total) * 100, 1) if total else 0
+
+    q_out = []
+    for q in questions:
+        selected = _sort_uuid_strings(sel_by_q.get(q['id'], []))
+        correct = _sort_uuid_strings([o['id'] for o in q['options'] if o.get('isCorrect')])
+        selected_set = set(selected)
+        q_out.append({
+            'id': q['id'],
+            'text': q['text'],
+            'hasMultipleAnswers': q['hasMultipleAnswers'],
+            'aiHint': q.get('aiHint'),
+            'isUserCorrect': _same_selection(selected, correct),
+            'options': [
+                {
+                    'id': o['id'],
+                    'text': o['text'],
+                    'isCorrect': o.get('isCorrect', False),
+                    'selected': o['id'] in selected_set,
+                }
+                for o in q['options']
+            ],
+        })
+
+    return {
+        'attemptId': str(attempt.id),
+        'testId': str(test.id),
+        'testTitle': test.title,
+        'passingThreshold': int(test.passing_threshold or 0),
+        'timeLimit': test.time_limit,
+        'resultMode': test.result_mode or 'end',
+        'hintsEnabled': bool(test.hints_enabled),
+        'correctCount': int(attempt.correct_count or 0),
+        'totalQuestions': total,
+        'percent': percent,
+        'passed': bool(attempt.passed),
+        'startedAt': attempt.started_at.isoformat() if attempt.started_at else None,
+        'completedAt': attempt.completed_at.isoformat() if attempt.completed_at else None,
+        'attempterUserId': str(attempt.user_id),
+        'attempterName': attempt.user.full_name,
+        'attempterLogin': attempt.user.login,
+        'questions': q_out,
+    }
+
+
+def get_attempt_review_for_user(session_or_eng, current_user_id: str, test_id: str,
+                                 attempt_id: str) -> dict:
+    session = get_session()
+    aid = _to_uuid(attempt_id)
+    tid = _to_uuid(test_id)
+
+    attempt = (
+        session.query(TestAttempt)
+        .options(selectinload(TestAttempt.test_version).selectinload(TestVersion.test))
+        .filter(TestAttempt.id == aid)
+        .first()
+    )
+    if not attempt:
+        raise HttpError(404, 'Попытка не найдена.')
+    if attempt.test_version.test_id != tid:
+        raise HttpError(404, 'Попытка не найдена.')
+
+    is_owner = str(attempt.user_id) == str(current_user_id)
+    is_author = is_test_author(attempt.test_version.test.created_by, current_user_id)
+    if not is_owner and not is_author and not is_test_edit_open():
+        raise HttpError(403, 'Доступ запрещён.')
+    return build_review_from_db(session, attempt_id)
+
+
+# ─── hints ───────────────────────────────────────────────────────────────────
+
+def count_missing_hints(session_or_eng, test_id: str) -> dict:
+    session = get_session()
+    tid = _to_uuid(test_id)
+    if tid is None:
+        return {'total': 0, 'missing': 0}
+
+    active_version = (
+        session.query(TestVersion)
+        .filter(TestVersion.test_id == tid, TestVersion.is_active.is_(True))
+        .first()
+    )
+    if not active_version:
+        return {'total': 0, 'missing': 0}
+
+    all_qs = session.query(Question).options(selectinload(Question.options)).filter(
+        Question.test_version_id == active_version.id
+    ).all()
+    filled_qs = []
+    for q in all_qs:
+        if not (q.text or '').strip():
+            continue
+        if len([o for o in q.options if (o.text or '').strip()]) < 2:
+            continue
+        filled_qs.append(q)
+    total = len(filled_qs)
+    missing = sum(1 for q in filled_qs if not q.ai_hint)
+    return {'total': total, 'missing': missing}
+
+
+def generate_missing_hints_for_test(session_or_eng, author_id: str, test_id: str) -> dict:
+    from .ai_editor import generate_question_hint
+    session = get_session()
+    tid = _to_uuid(test_id)
+
+    test = session.get(Test, tid)
+    if not test:
+        raise HttpError(404, 'Тест не найден.')
+    if not is_test_author(test.created_by, author_id) and not is_test_edit_open():
+        raise HttpError(403, 'Доступ запрещён.')
+
+    active_version = (
+        session.query(TestVersion)
+        .filter(TestVersion.test_id == tid, TestVersion.is_active.is_(True))
+        .first()
+    )
+    if not active_version:
+        return {'generated': 0, 'failed': 0, 'total': 0}
+
+    missing_qs = (
+        session.query(Question)
+        .options(selectinload(Question.options))
+        .filter(
+            Question.test_version_id == active_version.id,
+            (Question.ai_hint == None) | (Question.ai_hint == ''),  # noqa: E711
+        )
+        .order_by(Question.question_order)
+        .all()
+    )
+
+    generated = failed = skipped = 0
+    for q in missing_qs:
+        # Подсказку строим только по заполненному вопросу (есть текст и >=2 непустых варианта).
+        if not (q.text or '').strip():
+            skipped += 1
+            continue
+        valid_opts = [o for o in q.options if (o.text or '').strip()]
+        if len(valid_opts) < 2:
+            skipped += 1
+            continue
+        opt_payload = [{'text': o.text, 'isCorrect': bool(o.is_correct)} for o in q.options]
+        hint = generate_question_hint(question_text=q.text, options=opt_payload)
+        if hint:
+            q.ai_hint = hint
+            generated += 1
+        else:
+            failed += 1
+    session.commit()
+    return {'generated': generated, 'failed': failed, 'skipped': skipped, 'total': len(missing_qs)}
+
+
+def generate_next_missing_hint_for_test(session_or_eng, author_id: str, test_id: str) -> dict:
+    """Генерирует одну недостающую подсказку (для отображения прогресса в UI)."""
+    from .ai_editor import generate_question_hint
+
+    session = get_session()
+    tid = _to_uuid(test_id)
+
+    test = session.get(Test, tid)
+    if not test:
+        raise HttpError(404, 'Тест не найден.')
+    if not is_test_author(test.created_by, author_id) and not is_test_edit_open():
+        raise HttpError(403, 'Доступ запрещён.')
+
+    active_version = (
+        session.query(TestVersion)
+        .filter(TestVersion.test_id == tid, TestVersion.is_active.is_(True))
+        .first()
+    )
+    if not active_version:
+        return {'generated': 0, 'remaining': 0, 'done': True, 'totalMissing': 0}
+
+    before = count_missing_hints(None, test_id).get('missing') or 0
+
+    missing_qs = (
+        session.query(Question)
+        .options(selectinload(Question.options))
+        .filter(
+            Question.test_version_id == active_version.id,
+            (Question.ai_hint == None) | (Question.ai_hint == ''),  # noqa: E711
+        )
+        .order_by(Question.question_order)
+        .all()
+    )
+
+    for q in missing_qs:
+        if not (q.text or '').strip():
+            continue
+        valid_opts = [o for o in q.options if (o.text or '').strip()]
+        if len(valid_opts) < 2:
+            continue
+        opt_payload = [{'text': o.text, 'isCorrect': bool(o.is_correct)} for o in q.options]
+        hint = generate_question_hint(question_text=q.text, options=opt_payload)
+        if hint:
+            q.ai_hint = hint
+            session.commit()
+            after = count_missing_hints(None, test_id).get('missing') or 0
+            return {
+                'generated': 1,
+                'remaining': after,
+                'done': after == 0,
+                'totalMissing': before,
+                'failed': 0,
+            }
+
+    after = count_missing_hints(None, test_id).get('missing') or 0
+    return {
+        'generated': 0,
+        'remaining': after,
+        'done': after == 0,
+        'totalMissing': before,
+        'failed': 0,
+    }
+
+
+def check_question_for_attempt(session_or_eng, user_id: str, test_id: str, attempt_id: str,
+                                question_id: str, selected_option_ids: list[str]) -> dict:
+    session = get_session()
+    aid = _to_uuid(attempt_id)
+    uid = _to_uuid(user_id)
+    tid = _to_uuid(test_id)
+    qid = _to_uuid(question_id)
+
+    attempt = (
+        session.query(TestAttempt)
+        .options(
+            selectinload(TestAttempt.test_version).selectinload(TestVersion.test)
+        )
+        .filter(TestAttempt.id == aid)
+        .first()
+    )
+    if not attempt:
+        raise HttpError(404, 'Попытка не найдена.')
+    if attempt.test_version.test_id != tid:
+        raise HttpError(404, 'Попытка не найдена.')
+    if attempt.user_id != uid:
+        raise HttpError(403, 'Доступ запрещён.')
+    if attempt.status != 'in_progress':
+        raise HttpError(400, 'Попытка уже завершена.')
+
+    question = (
+        session.query(Question)
+        .options(selectinload(Question.options))
+        .filter(
+            Question.id == qid,
+            Question.test_version_id == attempt.test_version_id,
+        )
+        .first()
+    )
+    if not question:
+        raise HttpError(404, 'Вопрос не найден.')
+
+    correct_ids = [str(o.id) for o in question.options if o.is_correct]
+    is_correct = _same_selection(selected_option_ids, correct_ids)
+
+    selected_set = {str(x) for x in (selected_option_ids or [])}
+    selected_texts = [o.text for o in question.options if str(o.id) in selected_set]
+    correct_texts = [o.text for o in question.options if o.is_correct]
+
+    test = attempt.test_version.test
+    explanation = ''
+    if test.hints_enabled:
+        if question.ai_hint:
+            explanation = question.ai_hint
+        else:
+            try:
+                from .ai_editor import explain_answer
+                explanation = explain_answer(
+                    question_text=question.text,
+                    options=[{'text': o.text, 'isCorrect': bool(o.is_correct)} for o in question.options],
+                    selected_texts=selected_texts,
+                    is_correct=is_correct,
+                )
+            except Exception:
+                explanation = ''
+
+    return {
+        'questionId': str(question.id),
+        'isCorrect': is_correct,
+        'correctOptionIds': correct_ids,
+        'correctOptionTexts': correct_texts,
+        'explanation': explanation,
+    }
+
+
+def list_test_attempts_for_author(session_or_eng, author_id: str, test_id: str) -> list[dict]:
+    session = get_session()
+    tid = _to_uuid(test_id)
+
+    test = session.get(Test, tid)
+    if not test:
+        raise HttpError(404, 'Тест не найден.')
+    if not is_test_author(test.created_by, author_id) and not is_test_edit_open():
+        raise HttpError(403, 'Доступ запрещён.')
+
+    rows = (
+        session.query(TestAttempt, TestVersion, User)
+        .join(TestVersion, TestAttempt.test_version_id == TestVersion.id)
+        .join(User, TestAttempt.user_id == User.id)
+        .filter(TestVersion.test_id == tid)
+        .order_by(TestAttempt.started_at.desc().nullslast())
+        .limit(200)
+        .all()
+    )
+
+    return [
+        {
+            'id': str(a.id),
+            'user_id': str(a.user_id),
+            'status': a.status,
+            'attempt_number': a.attempt_number,
+            'started_at': a.started_at,
+            'completed_at': a.completed_at,
+            'correct_count': a.correct_count,
+            'total_questions': a.total_questions,
+            'passed': a.passed,
+            'test_version': tv.version,
+            'attempter_name': u.full_name,
+            'attempter_login': u.login,
+        }
+        for a, tv, u in rows
+    ]

flask_app/app/services/test_chain.py

@@ -1,22 +1,23 @@
 """Утилиты по цепочке теста (попытки/версии)."""
 from __future__ import annotations
 
-from sqlalchemy import text
+from sqlalchemy.orm import Session
+
+from ..models import TestAttempt, TestVersion
 
 
-def has_any_attempt_for_test(conn, test_id: str) -> bool:
+def has_any_attempt_for_test(session: Session, test_id) -> bool:
-    """`conn` может быть Connection или Engine — обе поддерживают .execute()."""
+    """Возвращает True, если для теста есть хотя бы одна попытка."""
-    row = conn.execute(
+    import uuid as _uuid
-        text(
+    if not isinstance(test_id, _uuid.UUID):
-            """
+        try:
-            SELECT EXISTS (
+            test_id = _uuid.UUID(str(test_id))
-                SELECT 1
+        except (ValueError, AttributeError):
-                  FROM test_attempts ta
+            return False
-                  INNER JOIN test_versions tv ON ta.test_version_id = tv.id
+
-                 WHERE tv.test_id = :test_id
+    return session.query(
-            ) AS has_any
+        session.query(TestAttempt)
-            """
+        .join(TestVersion, TestAttempt.test_version_id == TestVersion.id)
-        ),
+        .filter(TestVersion.test_id == test_id)
-        {'test_id': test_id},
+        .exists()
-    ).first()
+    ).scalar()
-    return bool(row[0])

flask_app/app/services/test_draft.py

@@ -1,13 +1,16 @@
-"""Создание/правка теста, fork версии при наличии попыток (порт `testDraftService.js`)."""
+"""Создание/правка теста, fork версии при наличии попыток."""
 from __future__ import annotations
 
+import uuid as _uuid
 from typing import Any
 
-from sqlalchemy import text
+from sqlalchemy import func
+from sqlalchemy.orm import Session
 
-from ..db import get_engine
+from ..db import get_session
 from ..messages import RU
-from .test_access import is_test_author
+from ..models import AnswerOption, Question, Test, TestVersion
+from .test_access import is_test_author, is_test_edit_open
 from .test_chain import has_any_attempt_for_test
 
 
@@ -19,216 +22,182 @@ class HttpError(Exception):
 
 
 def create_test_with_version(author_id: str, *, title: str, description: str | None) -> dict:
-    eng = get_engine()
+    session = get_session()
-    with eng.begin() as conn:
+    try:
-        t = conn.execute(
+        uid = _uuid.UUID(author_id)
-            text(
+    except (ValueError, AttributeError):
-                """
+        raise HttpError(400, 'Некорректный user_id.')
-                INSERT INTO tests (title, description, created_by, is_active, is_versioned)
+
-                VALUES (:title, :desc, :uid, true, true) RETURNING id
+    test = Test(
-                """
+        title=title,
-            ),
+        description=description or None,
-            {'title': title, 'desc': description or None, 'uid': author_id},
+        created_by=uid,
-        ).mappings().first()
+        is_active=True,
-        test_id = t['id']
+        is_versioned=True,
-        v = conn.execute(
+    )
-            text(
+    session.add(test)
-                """
+    session.flush()  # получаем test.id
-                INSERT INTO test_versions (test_id, version, is_active, parent_id)
+
-                VALUES (:tid, 1, true, NULL) RETURNING id
+    version = TestVersion(test_id=test.id, version=1, is_active=True, parent_id=None)
-                """
+    session.add(version)
-            ),
+    session.commit()
-            {'tid': test_id},
+    return {'testId': str(test.id), 'versionId': str(version.id)}
-        ).mappings().first()
-    return {'testId': str(test_id), 'versionId': str(v['id'])}
 
 
-def _get_active_version_row(conn, test_id: str) -> dict | None:
+def _get_active_version(session: Session, test_id: _uuid.UUID) -> TestVersion | None:
-    row = conn.execute(
+    return (
-        text(
+        session.query(TestVersion)
-            'SELECT * FROM test_versions WHERE test_id = :id AND is_active = true LIMIT 1'
+        .filter(TestVersion.test_id == test_id, TestVersion.is_active.is_(True))
-        ),
+        .first()
-        {'id': test_id},
+    )
-    ).mappings().first()
-    return dict(row) if row else None
 
 
-def _copy_question_tree(conn, from_version_id, to_version_id) -> None:
+def _copy_question_tree(session: Session, from_version_id, to_version_id) -> None:
-    questions = conn.execute(
+    questions = (
-        text(
+        session.query(Question)
-            'SELECT id, text, question_order, has_multiple_answers '
+        .filter(Question.test_version_id == from_version_id)
-            'FROM questions WHERE test_version_id = :v ORDER BY question_order'
+        .order_by(Question.question_order)
-        ),
+        .all()
-        {'v': from_version_id},
+    )
-    ).mappings().all()
     for q in questions:
-        new_q = conn.execute(
+        new_q = Question(
-            text(
+            test_version_id=to_version_id,
-                """
+            text=q.text,
-                INSERT INTO questions (test_version_id, text, question_order, has_multiple_answers)
+            question_order=q.question_order,
-                VALUES (:v, :text, :ord, :multi) RETURNING id
+            has_multiple_answers=q.has_multiple_answers,
-                """
+            ai_hint=q.ai_hint,
-            ),
+        )
-            {
+        session.add(new_q)
-                'v': to_version_id,
+        session.flush()
-                'text': q['text'],
+        for o in sorted(q.options, key=lambda x: x.option_order):
-                'ord': q['question_order'],
+            session.add(AnswerOption(
-                'multi': q['has_multiple_answers'],
+                question_id=new_q.id,
-            },
+                text=o.text,
-        ).mappings().first()
+                is_correct=o.is_correct,
-        nqid = new_q['id']
+                option_order=o.option_order,
-        opts = conn.execute(
+            ))
-            text(
-                'SELECT text, is_correct, option_order FROM answer_options '
-                'WHERE question_id = :q ORDER BY option_order'
-            ),
-            {'q': q['id']},
-        ).mappings().all()
-        for o in opts:
-            conn.execute(
-                text(
-                    """
-                    INSERT INTO answer_options (question_id, text, is_correct, option_order)
-                    VALUES (:q, :text, :ic, :ord)
-                    """
-                ),
-                {'q': nqid, 'text': o['text'], 'ic': o['is_correct'], 'ord': o['option_order']},
-            )
 
 
-def _replace_version_content(conn, test_version_id, payload: dict) -> None:
+def _fork_new_version(session: Session, test_id: _uuid.UUID) -> TestVersion:
-    conn.execute(
+    av = _get_active_version(session, test_id)
-        text(
-            """
-            DELETE FROM answer_options WHERE question_id IN (
-              SELECT id FROM questions WHERE test_version_id = :v
-            )
-            """
-        ),
-        {'v': test_version_id},
-    )
-    conn.execute(
-        text('DELETE FROM questions WHERE test_version_id = :v'),
-        {'v': test_version_id},
-    )
-    questions = payload.get('questions') or []
-    for i, q in enumerate(questions):
-        ins_q = conn.execute(
-            text(
-                """
-                INSERT INTO questions (test_version_id, text, question_order, has_multiple_answers)
-                VALUES (:v, :text, :ord, :multi) RETURNING id
-                """
-            ),
-            {
-                'v': test_version_id,
-                'text': q.get('text'),
-                'ord': q.get('question_order') or (i + 1),
-                'multi': bool(q.get('hasMultipleAnswers')),
-            },
-        ).mappings().first()
-        qid = ins_q['id']
-        opts = q.get('options') or []
-        for j, o in enumerate(opts):
-            conn.execute(
-                text(
-                    """
-                    INSERT INTO answer_options (question_id, text, is_correct, option_order)
-                    VALUES (:q, :text, :ic, :ord)
-                    """
-                ),
-                {
-                    'q': qid,
-                    'text': o.get('text'),
-                    'ic': bool(o.get('isCorrect')),
-                    'ord': o.get('option_order') or (j + 1),
-                },
-            )
-
-
-def _fork_new_version(conn, test_id: str) -> dict:
-    av = _get_active_version_row(conn, test_id)
     if not av:
-        raise HttpError(500, RU['internal'])  # invariant: должна быть активная версия
+        raise HttpError(500, RU['internal'] if 'internal' in RU else 'Внутренняя ошибка.')
-    mx = conn.execute(
+
-        text(
+    max_ver = (
-            'SELECT COALESCE(MAX(version), 0) AS v FROM test_versions WHERE test_id = :t'
+        session.query(func.coalesce(func.max(TestVersion.version), 0))
-        ),
+        .filter(TestVersion.test_id == test_id)
-        {'t': test_id},
+        .scalar() or 0
-    ).mappings().first()
-    next_v = (mx['v'] or 0) + 1
-    conn.execute(
-        text('UPDATE test_versions SET is_active = false WHERE test_id = :t'),
-        {'t': test_id},
     )
-    nv = conn.execute(
+    next_v = int(max_ver) + 1
-        text(
+
-            """
+    # деактивируем все версии
-            INSERT INTO test_versions (test_id, version, is_active, parent_id)
+    session.query(TestVersion).filter(TestVersion.test_id == test_id).update(
-            VALUES (:t, :ver, true, :parent) RETURNING *
+        {TestVersion.is_active: False}, synchronize_session='fetch'
-            """
+    )
-        ),
+
-        {'t': test_id, 'ver': next_v, 'parent': av['id']},
+    new_version = TestVersion(
-    ).mappings().first()
+        test_id=test_id,
-    _copy_question_tree(conn, av['id'], nv['id'])
+        version=next_v,
-    return dict(nv)
+        is_active=True,
+        parent_id=av.id,
+    )
+    session.add(new_version)
+    session.flush()
+    _copy_question_tree(session, av.id, new_version.id)
+    return new_version
+
+
+def _replace_version_content(session: Session, version: TestVersion, payload: dict) -> None:
+    # Снимок ai_hint по тексту вопроса перед удалением
+    old_hints: dict[str, str] = {}
+    for q in version.questions:
+        if q.ai_hint and q.text not in old_hints:
+            old_hints[q.text] = q.ai_hint
+
+    # удаляем через cascade (answer_options удалятся каскадно через ORM)
+    for q in list(version.questions):
+        session.delete(q)
+    session.flush()
+
+    questions_payload = payload.get('questions') or []
+    for i, qp in enumerate(questions_payload):
+        q_text = (qp.get('text') or '').strip()
+        hint_in = qp.get('aiHint')
+        if hint_in is not None:
+            hint_val = (str(hint_in).strip() or None)
+        else:
+            hint_val = old_hints.get(q_text)
+        new_q = Question(
+            test_version_id=version.id,
+            text=q_text,
+            question_order=qp.get('question_order') or (i + 1),
+            has_multiple_answers=bool(qp.get('hasMultipleAnswers')),
+            ai_hint=hint_val,
+        )
+        session.add(new_q)
+        session.flush()
+        for j, op in enumerate(qp.get('options') or []):
+            session.add(AnswerOption(
+                question_id=new_q.id,
+                text=(op.get('text') or '').strip(),
+                is_correct=bool(op.get('isCorrect')),
+                option_order=op.get('option_order') or (j + 1),
+            ))
 
 
 def save_test_draft(author_id: str, test_id: str, payload: dict) -> dict:
     if not isinstance(payload, dict):
         payload = {}
-    eng = get_engine()
+    session = get_session()
-    with eng.begin() as conn:
+    try:
-        t = conn.execute(
+        tid = _uuid.UUID(test_id)
-            text('SELECT id, created_by FROM tests WHERE id = :id'),
+    except (ValueError, AttributeError):
-            {'id': test_id},
+        raise HttpError(404, 'Тест не найден.')
-        ).mappings().first()
-        if not t:
-            raise HttpError(404, RU['testNotFound'] if 'testNotFound' in RU else 'Тест не найден.')
-        if not is_test_author(t['created_by'], author_id):
-            raise HttpError(403, 'Доступ запрещён.')
 
-        if payload.get('title') is not None or payload.get('description') is not None:
+    test = session.get(Test, tid)
-            conn.execute(
+    if not test:
-                text(
+        raise HttpError(404, 'Тест не найден.')
-                    """
+    if not is_test_author(test.created_by, author_id) and not is_test_edit_open():
-                    UPDATE tests
+        raise HttpError(403, 'Доступ запрещён.')
-                       SET title = COALESCE(:title, title),
-                           description = COALESCE(:desc, description),
-                           updated_at = CURRENT_TIMESTAMP
-                     WHERE id = :id
-                    """
-                ),
-                {
-                    'title': payload.get('title'),
-                    'desc': payload.get('description'),
-                    'id': test_id,
-                },
-            )
-        if payload.get('passingThreshold') is not None:
-            try:
-                raw = float(payload['passingThreshold'])
-                pt = max(0, min(100, round(raw)))
-                conn.execute(
-                    text(
-                        'UPDATE tests SET passing_threshold = :pt, updated_at = CURRENT_TIMESTAMP WHERE id = :id'
-                    ),
-                    {'pt': pt, 'id': test_id},
-                )
-            except (TypeError, ValueError):
-                pass
 
-        has_attempts = has_any_attempt_for_test(conn, test_id)
+    if payload.get('title') is not None:
-        version_row = _get_active_version_row(conn, test_id)
+        test.title = payload['title']
-        if not version_row:
+    if payload.get('description') is not None:
-            raise HttpError(500, 'Нет активной версии теста.')
+        test.description = payload['description'] or None
 
-        forked = False
+    if payload.get('passingThreshold') is not None:
-        if has_attempts and 'questions' in payload and payload.get('questions') is not None:
+        try:
-            version_row = _fork_new_version(conn, test_id)
+            test.passing_threshold = max(0, min(100, round(float(payload['passingThreshold']))))
-            forked = True
+        except (TypeError, ValueError):
+            pass
 
-        if payload.get('questions') is not None:
+    if 'timeLimit' in payload:
-            _replace_version_content(conn, version_row['id'], payload)
+        tl = payload.get('timeLimit')
+        try:
+            test.time_limit = None if tl in (None, '', 0) else max(0, int(tl))
+        except (TypeError, ValueError):
+            pass
 
-    return {'testId': test_id, 'versionId': str(version_row['id']), 'forked': forked}
+    if 'hintsEnabled' in payload:
+        test.hints_enabled = bool(payload['hintsEnabled'])
+
+    if 'resultMode' in payload:
+        rm = (payload.get('resultMode') or '').strip().lower()
+        if rm in ('immediate', 'end'):
+            test.result_mode = rm
+
+    has_attempts = has_any_attempt_for_test(session, tid)
+    active_version = _get_active_version(session, tid)
+    if not active_version:
+        raise HttpError(500, 'Нет активной версии теста.')
+
+    forked = False
+    if has_attempts and 'questions' in payload and payload.get('questions') is not None:
+        active_version = _fork_new_version(session, tid)
+        forked = True
+
+    if payload.get('questions') is not None:
+        _replace_version_content(session, active_version, payload)
+
+    session.commit()
+    return {'testId': test_id, 'versionId': str(active_version.id), 'forked': forked}

flask_app/app/static/js/attempt.js

@@ -0,0 +1,405 @@
+/**
+ * Прохождение теста: один вопрос на экран, прогресс сверху.
+ */
+(() => {
+  const root = document.getElementById('attempt-root');
+  if (!root) return;
+
+  const testId = root.dataset.testId;
+  const attemptId = root.dataset.attemptId;
+
+  const flowEl = document.getElementById('attempt-flow');
+  const titleEl = document.getElementById('attempt-title');
+  const subEl = document.getElementById('attempt-subtitle');
+  const timerEl = document.getElementById('attempt-timer');
+  const errEl = document.getElementById('attempt-error');
+  const stageEl = document.getElementById('attempt-stage');
+  const progressLabel = document.getElementById('attempt-progress-label');
+  const progressFill = document.getElementById('attempt-progress-fill');
+  const progressTrack = document.querySelector('.attempt-progress-track');
+  const btnPrev = document.getElementById('attempt-prev');
+  const btnNext = document.getElementById('attempt-next');
+  const btnFinish = document.getElementById('attempt-finish');
+  const resultEl = document.getElementById('attempt-result');
+
+  let playData = null;
+  const selections = {};
+  const checked = {};
+  let timerHandle = null;
+  let deadlineMs = null;
+  let currentIdx = 0;
+
+  function esc(s) {
+    return String(s ?? '').replace(/[&<>"']/g, (m) => ({
+      '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;',
+    }[m]));
+  }
+
+  /** Доля круга 0..1 от верха по часовой; путь для stroke с round caps (viewBox 120). */
+  function attemptResultArcD(cx, cy, r, t0, t1) {
+    if (t1 <= t0 + 1e-9) return '';
+    if (t1 - t0 > 0.5 + 1e-6) {
+      const a = attemptResultArcD(cx, cy, r, t0, t0 + 0.5);
+      const b = attemptResultArcD(cx, cy, r, t0 + 0.5, t1);
+      return `${a} ${b.replace(/^M [\d.]+\s+[\d.]+\s+/, '')}`;
+    }
+    const angle = (t) => (-Math.PI / 2) + 2 * Math.PI * t;
+    const x0 = cx + r * Math.cos(angle(t0));
+    const y0 = cy + r * Math.sin(angle(t0));
+    const x1 = cx + r * Math.cos(angle(t1));
+    const y1 = cy + r * Math.sin(angle(t1));
+    const spanDeg = (t1 - t0) * 360;
+    const largeArc = spanDeg > 180 ? 1 : 0;
+    return `M ${x0.toFixed(2)} ${y0.toFixed(2)} A ${r} ${r} 0 ${largeArc} 1 ${x1.toFixed(2)} ${y1.toFixed(2)}`;
+  }
+
+  function setErr(msg) {
+    errEl.textContent = msg || 'Ошибка.';
+    errEl.style.display = msg ? 'block' : 'none';
+  }
+
+  function isSelected(qid, oid) {
+    return (selections[String(qid)] || []).includes(String(oid));
+  }
+
+  function toggle(qid, oid, multi) {
+    const k = String(qid);
+    const cur = selections[k] || [];
+    const id = String(oid);
+    if (multi) {
+      selections[k] = cur.includes(id) ? cur.filter((x) => x !== id) : [...cur, id];
+      return;
+    }
+    selections[k] = [id];
+  }
+
+  function isImmediate() {
+    return playData && playData.resultMode === 'immediate';
+  }
+
+  function formatAttemptMeta(d) {
+    const qs = d.questions || [];
+    const n = qs.length;
+    const tl = d.timeLimit;
+    const timestr = !tl || Number(tl) <= 0 ? 'без ограничения' : `${tl} мин`;
+    const res = d.resultMode === 'immediate' ? 'сразу' : 'в конце';
+    const hint = d.resultMode !== 'immediate'
+      ? 'недоступны'
+      : (d.hintsEnabled ? 'вкл' : 'выкл');
+    const th = d.passingThreshold ?? 0;
+    return `Порог: ${th}% · Вопросов: ${n} · Время: ${timestr} · Результат: ${res} · Подсказки: ${hint}`;
+  }
+
+  function renderFeedbackPanel(data) {
+    const wrap = document.createElement('div');
+    wrap.className = 'attempt-feedback-panel';
+    const ok = data.isCorrect;
+    const verdict = document.createElement('p');
+    verdict.className = `attempt-feedback-verdict ${ok ? 'attempt-feedback-verdict--ok' : 'attempt-feedback-verdict--bad'}`;
+    verdict.textContent = ok ? 'Верно!' : 'Неверно.';
+    wrap.appendChild(verdict);
+    const correct = (data.correctOptionTexts || []).join('; ');
+    if (correct) {
+      const p = document.createElement('p');
+      p.className = 'attempt-feedback-correct';
+      p.textContent = `Правильный ответ: ${correct}`;
+      wrap.appendChild(p);
+    }
+    const exp = document.createElement('p');
+    exp.className = 'attempt-feedback-explanation';
+    exp.textContent = data.explanation || 'Объяснение недоступно.';
+    wrap.appendChild(exp);
+    return wrap;
+  }
+
+  function stepAnswered(q) {
+    const k = String(q.id);
+    if (isImmediate()) return !!checked[k];
+    return (selections[k] || []).length > 0;
+  }
+
+  function allAnswered() {
+    return (playData.questions || []).every((q) => stepAnswered(q));
+  }
+
+  function updateProgress() {
+    const qs = playData.questions || [];
+    const total = qs.length;
+    const n = Math.min(currentIdx + 1, Math.max(total, 1));
+    if (progressLabel) progressLabel.textContent = `${n} из ${total}`;
+    const pct = total <= 1 ? 100 : ((currentIdx + 1) / total) * 100;
+    if (progressFill) progressFill.style.width = `${pct}%`;
+    if (progressTrack) {
+      progressTrack.setAttribute('aria-valuenow', String(n));
+      progressTrack.setAttribute('aria-valuemax', String(total));
+    }
+  }
+
+  function renderStep() {
+    const qs = playData.questions || [];
+    const total = qs.length;
+    const q = qs[currentIdx];
+    stageEl.innerHTML = '';
+    if (!q) return;
+
+    updateProgress();
+
+    const card = document.createElement('article');
+    card.className = 'attempt-q-card surface-card';
+    card.dataset.qid = String(q.id);
+
+    const qid = String(q.id);
+    const isChk = !!checked[qid];
+
+    const meta = document.createElement('div');
+    meta.className = 'attempt-q-card__meta';
+    meta.innerHTML = `<span class="attempt-q-num">Вопрос ${currentIdx + 1}</span>`;
+    card.appendChild(meta);
+
+    const textP = document.createElement('div');
+    textP.className = 'attempt-q-text';
+    let badge = '';
+    if (isChk) {
+      const ok = checked[qid].isCorrect;
+      badge = `<span class="attempt-q-badge ${ok ? 'attempt-q-badge--ok' : 'attempt-q-badge--bad'}">${ok ? '✓ верно' : '✗ неверно'}</span>`;
+    }
+    textP.innerHTML = esc(q.text) + badge;
+    card.appendChild(textP);
+
+    const ul = document.createElement('ul');
+    ul.className = 'attempt-q-options';
+    const correctSet = new Set((checked[qid] && checked[qid].correctOptionIds) || []);
+
+    for (const o of (q.options || [])) {
+      const oid = String(o.id);
+      const row = document.createElement('li');
+      row.className = 'attempt-opt-row';
+      const type = q.hasMultipleAnswers ? 'checkbox' : 'radio';
+      const name = `q-${q.id}`;
+      let mark = '';
+      if (isChk) {
+        if (correctSet.has(oid)) mark = ' <span class="attempt-mark attempt-mark--ok">верно</span>';
+        else if (isSelected(q.id, o.id)) mark = ' <span class="attempt-mark attempt-mark--bad">ваш ответ</span>';
+      }
+      row.innerHTML =
+        `<label class="attempt-opt-label ${isChk ? 'attempt-opt-label--locked' : ''}">`
+        + `<input type="${type}" ${q.hasMultipleAnswers ? '' : `name="${esc(name)}"`} class="attempt-opt-input" />`
+        + `<span class="attempt-opt-text">${esc(o.text)}${mark}</span>`
+        + '</label>';
+      const input = row.querySelector('input');
+      if (isSelected(q.id, o.id)) input.checked = true;
+      if (isChk) input.disabled = true;
+      input.addEventListener('change', () => {
+        if (checked[qid]) return;
+        toggle(q.id, o.id, q.hasMultipleAnswers);
+        renderStep();
+      });
+      ul.appendChild(row);
+    }
+    card.appendChild(ul);
+
+    if (isChk && isImmediate() && playData.hintsEnabled) {
+      card.appendChild(renderFeedbackPanel(checked[qid]));
+    }
+
+    if (isImmediate() && !isChk) {
+      const wrap = document.createElement('div');
+      wrap.className = 'attempt-answer-actions';
+      const btn = document.createElement('button');
+      btn.type = 'button';
+      btn.className = 'btn btn-primary attempt-reply-btn';
+      btn.textContent = 'Ответить';
+      const sel = selections[qid] || [];
+      btn.disabled = sel.length === 0;
+      btn.addEventListener('click', () => checkOne(q.id));
+      wrap.appendChild(btn);
+      card.appendChild(wrap);
+    }
+
+    stageEl.appendChild(card);
+    updateNav();
+  }
+
+  function updateNav() {
+    const qs = playData.questions || [];
+    const total = qs.length;
+    const q = qs[currentIdx];
+    if (!q) return;
+    const ok = stepAnswered(q);
+
+    btnPrev.disabled = currentIdx <= 0;
+    btnPrev.toggleAttribute('hidden', currentIdx <= 0);
+
+    const last = currentIdx >= total - 1;
+    btnNext.style.display = last ? 'none' : '';
+    btnFinish.style.display = last ? '' : 'none';
+
+    if (last) {
+      btnFinish.disabled = !allAnswered();
+    } else {
+      btnNext.disabled = !ok;
+    }
+  }
+
+  async function checkOne(qid) {
+    const k = String(qid);
+    const sel = selections[k] || [];
+    if (!sel.length) return;
+    try {
+      const r = await fetch(`/api/tests/${testId}/attempts/${attemptId}/check`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ questionId: qid, selectedOptionIds: sel }),
+      });
+      const data = await r.json().catch(() => ({}));
+      if (!r.ok) throw new Error(data.error || 'Не удалось проверить ответ.');
+      checked[k] = data;
+      renderStep();
+    } catch (e) {
+      setErr(e.message);
+    }
+  }
+
+  btnPrev.addEventListener('click', () => {
+    if (currentIdx <= 0) return;
+    currentIdx -= 1;
+    renderStep();
+  });
+
+  btnNext.addEventListener('click', () => {
+    const total = (playData.questions || []).length;
+    if (currentIdx >= total - 1) return;
+    currentIdx += 1;
+    renderStep();
+  });
+
+  btnFinish.addEventListener('click', () => submit(false));
+
+  function startTimer(minutes) {
+    if (!timerEl) return;
+    timerEl.style.display = '';
+    if (!minutes || minutes <= 0) {
+      deadlineMs = null;
+      timerEl.textContent = 'без ограничения';
+      return;
+    }
+    deadlineMs = Date.now() + minutes * 60 * 1000;
+    const tick = () => {
+      const left = Math.max(0, deadlineMs - Date.now());
+      const m = Math.floor(left / 60000);
+      const s = Math.floor((left % 60000) / 1000);
+      timerEl.textContent = `Осталось ${m}:${String(s).padStart(2, '0')}`;
+      if (left <= 0) {
+        clearInterval(timerHandle);
+        submit(true);
+      }
+    };
+    tick();
+    timerHandle = setInterval(tick, 500);
+  }
+
+  async function load() {
+    try {
+      const r = await fetch(`/api/tests/${testId}/attempts/${attemptId}/play`);
+      const data = await r.json().catch(() => ({}));
+      if (!r.ok) throw new Error(data.error || 'Не удалось открыть попытку.');
+      playData = data;
+      titleEl.textContent = data.testTitle || 'Прохождение теста';
+      subEl.textContent = formatAttemptMeta(data);
+      if (!Array.isArray(data.questions) || !data.questions.length) {
+        setErr('В активной версии нет вопросов.');
+        btnNext.disabled = true;
+        btnFinish.disabled = true;
+        return;
+      }
+      currentIdx = 0;
+      renderStep();
+      startTimer(Number(data.timeLimit));
+    } catch (e) {
+      setErr(e.message);
+      btnFinish.disabled = true;
+    }
+  }
+
+  async function submit(auto) {
+    btnFinish.disabled = true;
+    btnNext.disabled = true;
+    btnPrev.disabled = true;
+    const label = auto ? 'Время вышло…' : 'Отправка…';
+    btnFinish.textContent = label;
+    try {
+      const r = await fetch(`/api/tests/${testId}/attempts/${attemptId}/submit`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ answers: selections }),
+      });
+      const data = await r.json().catch(() => ({}));
+      if (!r.ok) throw new Error(data.error || 'Не удалось завершить попытку.');
+      if (timerHandle) clearInterval(timerHandle);
+      timerEl.style.display = 'none';
+      if (flowEl) flowEl.style.display = 'none';
+      resultEl.style.display = '';
+      const pct = Math.min(100, Math.max(0, Number(data.percent) || 0));
+      const thr = Math.min(100, Math.max(0, Number(data.passingThreshold) || 0));
+      const passed = !!data.passed;
+      const thrArc = passed ? pct : Math.min(100, Math.max(pct, thr));
+      const centerIcon = passed ? 'check' : 'close';
+      const verdictLabel = passed ? 'Зачёт' : 'Незачёт';
+      const ariaRing = passed
+        ? `Зачёт: ${pct} процентов верных ответов`
+        : `Незачёт: ${pct} процентов, порог ${thr} процентов`;
+      const CX = 60;
+      const CY = 60;
+      const RAD = 48;
+      const tScore = pct / 100;
+      const tThr = thrArc / 100;
+      const trackCircle = `<circle class="attempt-result-svg__track" cx="${CX}" cy="${CY}" r="${RAD}" fill="none" />`;
+      let arcPaths = '';
+      if (passed) {
+        const dPass = attemptResultArcD(CX, CY, RAD, 0, tScore);
+        if (dPass) {
+          arcPaths += `<path class="attempt-result-svg__pass" d="${esc(dPass)}" fill="none" />`;
+        }
+      } else {
+        const dGap = tThr > tScore + 1e-9 ? attemptResultArcD(CX, CY, RAD, tScore, tThr) : '';
+        const dScore = tScore > 1e-9 ? attemptResultArcD(CX, CY, RAD, 0, tScore) : '';
+        if (dGap) arcPaths += `<path class="attempt-result-svg__fail-gap" d="${esc(dGap)}" fill="none" />`;
+        if (dScore) arcPaths += `<path class="attempt-result-svg__fail-score" d="${esc(dScore)}" fill="none" />`;
+      }
+      const donutSvg = `<svg class="attempt-result-donut__svg" viewBox="0 0 120 120" aria-hidden="true">${trackCircle}${arcPaths}</svg>`;
+      resultEl.innerHTML = `
+        <div class="attempt-result-card__inner">
+          <h3 class="attempt-result-title font-headline">Результат</h3>
+          <div class="attempt-result-visual" aria-label="${ariaRing.replace(/"/g, '&quot;')}">
+            <div class="attempt-result-donut">
+              ${donutSvg}
+              <div class="attempt-result-donut__disk" aria-hidden="true"></div>
+              <div class="attempt-result-donut__center" data-passed="${passed ? '1' : '0'}">
+                <span class="material-symbols-outlined attempt-result-donut__icon" aria-hidden="true">${centerIcon}</span>
+              </div>
+            </div>
+            <p class="attempt-result-verdict" data-passed="${passed ? '1' : '0'}">
+              <span class="attempt-result-verdict__label">${verdictLabel}</span>
+            </p>
+          </div>
+          <ul class="attempt-result-stats">
+            <li><span class="attempt-result-stats__k">Верно</span> <strong>${data.correctCount}</strong> из ${data.totalQuestions} (${pct}%)</li>
+            <li><span class="attempt-result-stats__k">Порог зачёта</span> <strong>${thr}%</strong></li>
+          </ul>
+          <p class="attempt-result-actions">
+            <a class="btn btn-primary attempt-result-review-link"
+               href="/tests/${testId}/attempts/${data.attemptId}/review">Разбор попытки</a>
+          </p>
+        </div>`;
+    } catch (e) {
+      setErr(e.message);
+      btnFinish.disabled = false;
+      btnFinish.textContent = 'Завершить тест';
+      btnPrev.disabled = false;
+      btnNext.disabled = false;
+      if (playData) updateNav();
+    }
+  }
+
+  load();
+})();

flask_app/app/templates/assignments.html

@@ -0,0 +1,169 @@
+{% extends "base.html" %}
+{% block title %}Назначения — Тестирование персонала{% endblock %}
+
+{% block content %}
+<div class="space-y-4 sm:space-y-5 pb-10">
+
+  <div class="flex items-center justify-between gap-3">
+    <h1 class="text-xl font-semibold text-ink-900">Назначения</h1>
+    <a href="{{ url_for('main.index') }}" class="link-back text-sm">← Главная</a>
+  </div>
+
+  {# Выбор теста #}
+  <div class="cabinet-brick">
+    <h2 class="font-semibold text-sm text-ink-700 mb-3">Тест</h2>
+    <select id="assign-test-select" class="form-input">
+      <option value="">— Выберите тест —</option>
+      {% for t in tests %}
+      <option value="{{ t.id }}">{{ t.title }}</option>
+      {% endfor %}
+    </select>
+  </div>
+
+  {# Панель назначения (скрыта пока не выбран тест) #}
+  <div id="assign-panel" class="cabinet-brick hidden">
+    <h2 class="font-semibold text-sm text-ink-700 mb-3">Кому выдать</h2>
+    <p class="test-detail-hint">Список с учётом поиска и фильтров; можно отметить всех на экране.</p>
+    <div class="assign-toolbar mt-3">
+      <input id="assign-search" class="form-input assign-toolbar__search" type="text" placeholder="Поиск: ФИО, логин" />
+      <select id="assign-dept" class="form-input"><option value="__all__">Все отделы</option></select>
+      <select id="assign-clinic" class="form-input">
+        <option value="all">Все сотрудники</option>
+        <option value="with">Уже есть в системе</option>
+        <option value="without">Ещё не в системе</option>
+      </select>
+      <button id="assign-select-all" class="btn btn-ghost btn--sm" type="button">Выбрать всех</button>
+    </div>
+    <div id="assign-list" class="assign-list mt-3"></div>
+    <div class="inline-actions mt-3">
+      <button id="assign-submit" class="btn btn-primary" type="button">Назначить выбранным</button>
+      <span id="assign-status" class="muted"></span>
+    </div>
+  </div>
+
+</div>
+{% endblock %}
+
+{% block scripts %}
+<script>
+(function () {
+  const $ = (s) => document.querySelector(s);
+  const testSelect = $('#assign-test-select');
+  const assignPanel = $('#assign-panel');
+  const assignSearchEl = $('#assign-search');
+  const assignDeptEl = $('#assign-dept');
+  const assignClinicEl = $('#assign-clinic');
+  const assignListEl = $('#assign-list');
+  const assignSelectAllBtn = $('#assign-select-all');
+  const assignSubmitBtn = $('#assign-submit');
+  const assignStatusEl = $('#assign-status');
+
+  let currentTestId = null;
+  let assignPeople = [];
+  let assignSelected = new Set();
+
+  function escHtml(s) {
+    return String(s || '').replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+  }
+
+  function renderAssignList() {
+    assignListEl.innerHTML = '';
+    assignPeople.forEach((p) => {
+      const row = document.createElement('label');
+      row.className = `assign-row${assignSelected.has(String(p.staffId)) ? ' assign-row--selected' : ''}`;
+      row.innerHTML = `
+        <input type="checkbox" ${assignSelected.has(String(p.staffId)) ? 'checked' : ''} />
+        <span class="assign-row__text">
+          <span class="assign-row__fio">${escHtml(p.fio || '—')}</span>
+          ${p.webLogin ? `<span class="assign-row__login">${escHtml(p.webLogin)}</span>` : ''}
+          <span class="assign-row__meta">${escHtml(p.department || '—')}</span>
+        </span>`;
+      const cb = row.querySelector('input');
+      cb.addEventListener('change', () => {
+        const k = String(p.staffId);
+        if (cb.checked) assignSelected.add(k); else assignSelected.delete(k);
+        row.classList.toggle('assign-row--selected', cb.checked);
+      });
+      assignListEl.appendChild(row);
+    });
+    if (!assignPeople.length) assignListEl.innerHTML = '<p class="muted" style="padding:.75rem;">Никого не найдено.</p>';
+  }
+
+  async function loadDirectory() {
+    if (!currentTestId) return;
+    assignStatusEl.textContent = 'Загружаем…';
+    try {
+      const params = new URLSearchParams();
+      if (assignSearchEl.value.trim()) params.set('q', assignSearchEl.value.trim());
+      if (assignDeptEl.value && assignDeptEl.value !== '__all__') params.set('department', assignDeptEl.value);
+      params.set('clinic', assignClinicEl.value || 'all');
+      const r = await fetch(`/api/auth/dev/assignment-directory?${params.toString()}`);
+      const data = await r.json();
+      if (!r.ok) throw new Error(data.error || 'Не удалось загрузить сотрудников');
+      assignPeople = data.people || [];
+      const depts = data.departments || [];
+      if (assignDeptEl.options.length <= 1) {
+        depts.forEach((d) => {
+          const o = document.createElement('option');
+          o.value = d; o.textContent = d;
+          assignDeptEl.appendChild(o);
+        });
+      }
+      assignSelected = new Set();
+      renderAssignList();
+      assignStatusEl.textContent = '';
+    } catch (e) {
+      assignStatusEl.textContent = e.message || 'Ошибка загрузки';
+    }
+  }
+
+  testSelect.addEventListener('change', () => {
+    currentTestId = testSelect.value || null;
+    if (currentTestId) {
+      assignPanel.classList.remove('hidden');
+      // Сброс фильтров
+      assignDeptEl.innerHTML = '<option value="__all__">Все отделы</option>';
+      assignSearchEl.value = '';
+      loadDirectory();
+    } else {
+      assignPanel.classList.add('hidden');
+    }
+  });
+
+  let t = null;
+  assignSearchEl.addEventListener('input', () => { clearTimeout(t); t = setTimeout(loadDirectory, 350); });
+  assignDeptEl.addEventListener('change', loadDirectory);
+  assignClinicEl.addEventListener('change', loadDirectory);
+
+  assignSelectAllBtn.addEventListener('click', () => {
+    assignPeople.forEach((p) => assignSelected.add(String(p.staffId)));
+    renderAssignList();
+  });
+
+  assignSubmitBtn.addEventListener('click', async () => {
+    if (!currentTestId) return;
+    const selectedRows = assignPeople.filter((p) => assignSelected.has(String(p.staffId)));
+    if (!selectedRows.length) { assignStatusEl.textContent = 'Никто не выбран'; return; }
+    assignStatusEl.textContent = 'Назначаем…';
+    try {
+      const payload = selectedRows.map((p) => ({
+        staffId: p.staffId,
+        webLogin: p.webLogin || null,
+        fio: p.fio || null,
+        department: p.department || null,
+      }));
+      const r = await fetch(`/api/tests/${currentTestId}/assign`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ targets: payload }),
+      });
+      const data = await r.json();
+      if (!r.ok) throw new Error(data.error || 'Ошибка назначения');
+      assignStatusEl.textContent = `Назначено: ${data.count ?? selectedRows.length}`;
+    } catch (e) {
+      assignStatusEl.textContent = e.message || 'Ошибка назначения';
+    }
+  });
+})();
+</script>
+{% endblock %}

flask_app/app/templates/auth/login.html

@@ -2,57 +2,56 @@
 {% block title %}Вход — Тестирование{% endblock %}
 
 {% block content %}
-<section class="mx-auto max-w-md mt-8">
+{% set fio_as_login = dev_fio_enabled or hr_auth_enabled %}
-  <div class="rounded-2xl bg-white shadow-sm border border-ink-300/60 p-6">
+<div class="login-page">
-    <div class="flex items-center gap-2">
+  <div class="login-shell">
-      <span class="material-symbols-outlined text-brand-600">login</span>
+    <div class="login-logo">
-      <h1 class="text-xl font-semibold">Вход в систему</h1>
+      <img src="{{ url_for('static', filename='img/clinic-logo.png') }}"
+           alt="Логотип клиники" class="login-logo__img" />
+      <h1 class="font-headline">Тестирование</h1>
     </div>
-    <p class="mt-1 text-sm text-ink-500">
-      Используйте логин и пароль.
-      {% if hr_auth_enabled %}
-        Учётка кадровой системы (HR).
-      {% endif %}
-    </p>
 
     {% with messages = get_flashed_messages(with_categories=true) %}
       {% if messages %}
-        <div class="mt-4 space-y-2">
+        <div class="callout callout--error" style="margin-bottom: 1rem;">
           {% for category, msg in messages %}
-            <div class="px-3 py-2 rounded-lg text-sm
+            {% if category == 'error' %}{{ msg }}{% endif %}
-                        {% if category == 'error' %}bg-red-50 text-red-700 border border-red-200
-                        {% else %}bg-brand-50 text-brand-700 border border-brand-100{% endif %}">
-              {{ msg }}
-            </div>
           {% endfor %}
         </div>
       {% endif %}
     {% endwith %}
 
-    <form method="post" action="{{ url_for('auth.login_submit') }}" class="mt-5 space-y-4" novalidate>
+    <div class="login-card">
-      <input type="hidden" name="next" value="{{ next or '/' }}">
+      {% if dev_fio_enabled %}
+        <p style="font-size:0.8rem; color:#4b7b78; margin-bottom:0.75rem; line-height:1.4;">
+          Введите <b>ФИО</b> из кадровой системы и общий dev-пароль — или обычный логин/пароль.
+        </p>
+      {% elif hr_auth_enabled %}
+        <p style="font-size:0.8rem; color:#4b7b78; margin-bottom:0.75rem; line-height:1.4;">
+          Можно ввести <b>логин</b> из HR или <b>ФИО</b> (как в кадровой системе), если совпадение одно, и пароль учётной записи HR.
+        </p>
+      {% endif %}
+      <form method="post" action="{{ url_for('auth.login_submit') }}" novalidate>
+        <input type="hidden" name="next" value="{{ next or '/' }}">
 
-      <label class="block">
+        <div class="form-field">
-        <span class="text-sm font-medium text-ink-700">Логин</span>
+          <label class="form-label" for="login-username">
-        <input type="text" name="login" value="{{ login or '' }}" required autofocus autocomplete="username"
+            {% if fio_as_login %}ФИО или логин{% else %}Логин{% endif %}
-               class="mt-1 w-full rounded-lg border border-ink-300 bg-white px-3 py-2 text-ink-900
+          </label>
-                      focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20" />
+          <input id="login-username" class="form-input" type="text" name="login"
-      </label>
+                 value="{{ login or '' }}" required autofocus autocomplete="username"
+                 placeholder="{% if fio_as_login %}Иванов Иван Иванович{% endif %}" />
+        </div>
 
-      <label class="block">
+        <div class="form-field">
-        <span class="text-sm font-medium text-ink-700">Пароль</span>
+          <label class="form-label" for="login-password">Пароль</label>
-        <input type="password" name="password" required autocomplete="current-password"
+          <input id="login-password" class="form-input" type="password" name="password"
-               class="mt-1 w-full rounded-lg border border-ink-300 bg-white px-3 py-2 text-ink-900
+                 required autocomplete="current-password" />
-                      focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20" />
+        </div>
-      </label>
 
-      <button type="submit"
+        <button type="submit" class="btn btn-primary">Войти</button>
-              class="w-full inline-flex items-center justify-center gap-2 rounded-lg
+      </form>
-                     bg-brand-600 hover:bg-brand-700 text-white font-medium px-4 py-2 transition">
+    </div>
-        <span class="material-symbols-outlined text-base">login</span>
-        Войти
-      </button>
-    </form>
   </div>
-</section>
+</div>
 {% endblock %}

flask_app/app/templates/base.html

@@ -8,7 +8,7 @@
   {# Tailwind CDN — на E1.0 этого достаточно. В Этапе 2/CI можно заменить на сборку. #}
   <script src="https://cdn.tailwindcss.com"></script>
   <script>
-    // Минимальная палитра в стиле кабинета HR. Без зависимостей от HR-репо.
+    // Палитра/типографика в стиле webapp-nginx (cabinet-theme).
     tailwind.config = {
       theme: {
         extend: {
@@ -17,18 +17,19 @@
           },
           colors: {
             brand: {
-              50:  '#eef2ff',
+              50:  '#ecf7f6',
-              100: '#e0e7ff',
+              100: '#d9efec',
-              500: '#6366f1',
+              300: '#9bd7d0',
-              600: '#4f46e5',
+              500: '#007168',
-              700: '#4338ca',
+              600: '#00645b',
+              700: '#00574f',
             },
             ink: {
-              900: '#0f172a',
+              900: '#0d1b1d',
-              700: '#334155',
+              700: '#3d5357',
-              500: '#64748b',
+              500: '#506965',
-              300: '#cbd5e1',
+              300: '#b9bc94',
-              100: '#f1f5f9',
+              100: '#f3f8f9',
             },
           },
         },
@@ -39,7 +40,7 @@
   <link rel="preconnect" href="https://fonts.googleapis.com" />
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
   <link
-    href="https://fonts.googleapis.com/css2?family=Manrope:wght@400;500;600;700&display=swap"
+    href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=Manrope:wght@600;700;800&display=swap"
     rel="stylesheet"
   />
   <link
@@ -50,61 +51,36 @@
   <link rel="stylesheet" href="{{ url_for('static', filename='css/app.css') }}" />
   {% block head %}{% endblock %}
 </head>
-<body class="min-h-screen bg-ink-100 text-ink-900 font-sans antialiased">
+<body class="min-h-screen bg-ink-100 text-ink-900 font-sans antialiased ui-legacy">
-  <header class="sticky top-0 z-30 bg-white/90 backdrop-blur border-b border-ink-300/60">
+  <div class="cabinet-app">
-    <div class="mx-auto max-w-6xl px-4 h-14 flex items-center justify-between">
+    <header class="cabinet-header">
-      <a href="{{ url_for('main.index') }}" class="flex items-center gap-2 font-semibold text-ink-900">
+      <div class="cabinet-header__inner">
-        <span class="material-symbols-outlined text-brand-600">quiz</span>
+        <a href="{{ url_for('tests.tests_list_page') }}" class="cabinet-brand">
-        <span>Тестирование</span>
+          <img src="{{ url_for('static', filename='img/clinic-logo.png') }}"
-      </a>
+               alt="Логотип клиники" class="cabinet-brand__logo" />
-      <nav class="flex items-center gap-2 text-sm">
+          <div>
-        {% if current_user %}
+            <div class="cabinet-brand__title">Тестирование</div>
-          <a href="{{ url_for('tests.tests_list_page') }}"
+          </div>
-             class="hidden sm:inline-flex items-center gap-1 px-2 py-1 rounded-lg
+        </a>
-                    text-ink-700 hover:bg-ink-100">
+        <div class="cabinet-header__actions">
-            <span class="material-symbols-outlined text-base">list_alt</span>
+          {% if current_user %}
-            Тесты
+            <span class="cabinet-user" title="{{ (current_user.full_name or current_user.login) ~ (' · ' ~ format_role(current_user.role) if format_role(current_user.role) else '') }}">
-          </a>
+              {{ format_name_short(current_user.full_name, current_user.login) }}
-          <a href="{{ url_for('settings.settings_page') }}"
+              {% if format_role(current_user.role) %}<span class="cabinet-user__role"> · {{ format_role(current_user.role) }}</span>{% endif %}
-             class="hidden sm:inline-flex items-center gap-1 px-2 py-1 rounded-lg
+            </span>
-                    text-ink-700 hover:bg-ink-100">
+            <form method="post" action="{{ url_for('auth.logout') }}" class="inline">
-            <span class="material-symbols-outlined text-base">settings</span>
+              <button type="submit" class="btn btn-ghost">Выйти</button>
-            Настройки
+            </form>
-          </a>
+          {% else %}
-        {% endif %}
+            <a href="{{ url_for('auth.login_page') }}" class="btn btn-ghost">Войти</a>
-        {% if current_user %}
+          {% endif %}
-          <span class="hidden sm:inline text-ink-500">
+        </div>
-            {{ current_user.full_name or current_user.login }}
+      </div>
-            <span class="text-ink-300">·</span>
+    </header>
-            <span class="text-brand-700">{{ current_user.role }}</span>
+    <main class="cabinet-main">
-          </span>
+      {% block content scoped %}{% endblock %}
-          <form method="post" action="{{ url_for('auth.logout') }}" class="inline">
+    </main>
-            <button type="submit"
+  </div>
-                    class="inline-flex items-center gap-1 px-2 py-1 rounded-lg
-                           text-ink-700 hover:bg-ink-100 transition">
-              <span class="material-symbols-outlined text-base">logout</span>
-              <span class="hidden sm:inline">Выйти</span>
-            </button>
-          </form>
-        {% else %}
-          <a href="{{ url_for('auth.login_page') }}"
-             class="inline-flex items-center gap-1 px-2 py-1 rounded-lg
-                    text-brand-700 hover:bg-brand-50 transition">
-            <span class="material-symbols-outlined text-base">login</span>
-            Войти
-          </a>
-        {% endif %}
-      </nav>
-    </div>
-  </header>
-
-  <main class="mx-auto max-w-6xl px-4 py-6">
-    {% block content %}{% endblock %}
-  </main>
-
-  <footer class="mx-auto max-w-6xl px-4 py-8 text-xs text-ink-500">
-    {% block footer %}testing-flask-app · Этап 1{% endblock %}
-  </footer>
 
   {% block scripts %}{% endblock %}
 </body>

flask_app/app/templates/index.html

@@ -1,45 +1,66 @@
 {% extends "base.html" %}
-{% block title %}Тестирование — главная{% endblock %}
+{% block title %}Главная — Тестирование персонала{% endblock %}
 
 {% block content %}
-  <section class="rounded-2xl bg-white shadow-sm border border-ink-300/60 p-6">
+<h1 class="text-2xl font-semibold text-ink-900 mb-5">Тестирование персонала</h1>
-    <h1 class="text-2xl font-semibold text-ink-900">Сервис тестирования персонала</h1>
-    <p class="mt-2 text-ink-500">
-      Этап 1 миграции: переход на единый стек (Flask + Jinja). Бизнес-функции
-      переносятся последовательно — авторизация, каталог тестов, редактор,
-      назначения, прохождение, импорт/AI.
-    </p>
 
-    <div class="mt-5 flex flex-wrap gap-2 text-sm">
+<div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4">
-      <a href="{{ url_for('tests.tests_list_page') }}"
+
-         class="inline-flex items-center gap-2 px-3 py-1.5 rounded-lg bg-brand-600 hover:bg-brand-700 text-white transition">
+  {# Статистика #}
-        <span class="material-symbols-outlined text-base">list_alt</span>
+  <a href="{{ url_for('main.stats_page') }}"
-        Каталог тестов
+     class="rounded-2xl bg-white border border-ink-300/50 shadow-sm p-5 flex flex-col gap-3
-      </a>
+            hover:shadow-md hover:border-brand-300 transition-all group">
-      <a href="{{ url_for('main.health') }}"
+    <div class="flex items-center gap-3">
-         class="inline-flex items-center gap-2 px-3 py-1.5 rounded-lg bg-brand-50 text-brand-700 hover:bg-brand-100 transition">
+      <span class="material-symbols-outlined text-brand-500 text-2xl">bar_chart</span>
-        <span class="material-symbols-outlined text-base">monitoring</span>
+      <h2 class="font-semibold text-ink-900">Статистика</h2>
-        Health-check
-      </a>
     </div>
-  </section>
+    <p class="text-sm text-ink-500 flex-1">Прохождения по отделам, общая динамика и последняя активность.</p>
+    <span class="inline-flex items-center gap-1 text-xs font-medium text-brand-600 group-hover:underline">
+      Открыть <span class="material-symbols-outlined text-sm">arrow_forward</span>
+    </span>
+  </a>
 
-  <section class="grid gap-3 sm:grid-cols-2 lg:grid-cols-3 mt-4">
+  {# Тесты #}
-    {% for title, descr, icon in [
+  <a href="{{ url_for('tests.tests_list_page') }}"
-        ('Авторизация', 'E1.1 — логин по HR/локальному пользователю.', 'login'),
+     class="rounded-2xl bg-white border border-ink-300/50 shadow-sm p-5 flex flex-col gap-3
-        ('Тесты', 'E1.2 — каталог, фильтры, карточки.', 'list_alt'),
+            hover:shadow-md hover:border-brand-300 transition-all group">
-        ('Редактор', 'E1.3 — создание/правка теста, AI-помощник.', 'edit_note'),
+    <div class="flex items-center gap-3">
-        ('Назначения', 'E1.4 — назначить сотрудникам, отслеживать.', 'assignment'),
+      <span class="material-symbols-outlined text-brand-500 text-2xl">list_alt</span>
-        ('Прохождение', 'E1.5 — UI прохождения теста сотрудником.', 'fact_check'),
+      <h2 class="font-semibold text-ink-900">Тесты</h2>
-        ('Импорт/AI', 'E1.6 — генерация черновиков из документов.', 'auto_awesome'),
+    </div>
-      ] %}
+    <p class="text-sm text-ink-500 flex-1">Каталог тестов, создание, редактирование и прохождение.</p>
-      <article class="rounded-xl bg-white border border-ink-300/60 p-4">
+    <span class="inline-flex items-center gap-1 text-xs font-medium text-brand-600 group-hover:underline">
-        <div class="flex items-center gap-2">
+      Открыть <span class="material-symbols-outlined text-sm">arrow_forward</span>
-          <span class="material-symbols-outlined text-brand-600">{{ icon }}</span>
+    </span>
-          <h3 class="font-semibold">{{ title }}</h3>
+  </a>
-        </div>
+
-        <p class="mt-1 text-sm text-ink-500">{{ descr }}</p>
+  {# Назначения #}
-      </article>
+  <a href="{{ url_for('main.assignments_page') }}"
-    {% endfor %}
+     class="rounded-2xl bg-white border border-ink-300/50 shadow-sm p-5 flex flex-col gap-3
-  </section>
+            hover:shadow-md hover:border-brand-300 transition-all group">
+    <div class="flex items-center gap-3">
+      <span class="material-symbols-outlined text-brand-500 text-2xl">assignment_ind</span>
+      <h2 class="font-semibold text-ink-900">Назначения</h2>
+    </div>
+    <p class="text-sm text-ink-500 flex-1">Выдача тестов сотрудникам и отделам.</p>
+    <span class="inline-flex items-center gap-1 text-xs font-medium text-brand-600 group-hover:underline">
+      Открыть <span class="material-symbols-outlined text-sm">arrow_forward</span>
+    </span>
+  </a>
+
+  {# Настройки ИИ #}
+  <a href="{{ url_for('settings.prompts_page') }}"
+     class="rounded-2xl bg-white border border-ink-300/50 shadow-sm p-5 flex flex-col gap-3
+            hover:shadow-md hover:border-brand-300 transition-all group">
+    <div class="flex items-center gap-3">
+      <span class="material-symbols-outlined text-brand-500 text-2xl">psychology</span>
+      <h2 class="font-semibold text-ink-900">Настройки ИИ</h2>
+    </div>
+    <p class="text-sm text-ink-500 flex-1">Редактор промптов — генерация вопросов, дистракторы, улучшение теста.</p>
+    <span class="inline-flex items-center gap-1 text-xs font-medium text-brand-600 group-hover:underline">
+      Открыть <span class="material-symbols-outlined text-sm">arrow_forward</span>
+    </span>
+  </a>
+
+</div>
 {% endblock %}

flask_app/app/templates/settings.html

@@ -2,13 +2,13 @@
 {% block title %}Настройки — LLM{% endblock %}
 
 {% block content %}
-<section class="rounded-2xl bg-white shadow-sm border border-ink-300/60 p-6 max-w-2xl">
+<section class="surface-card p-6 max-w-2xl">
   <div class="flex items-center gap-2">
     <span class="material-symbols-outlined text-brand-600">settings</span>
     <h1 class="text-2xl font-semibold">Настройки</h1>
   </div>
 
-  <h2 class="mt-5 font-semibold">Подключение к LLM</h2>
+  <h2 class="mt-5 font-semibold font-headline">Подключение к LLM</h2>
   <p class="mt-1 text-sm text-ink-500">
     Ключ задаётся в <code class="px-1 py-0.5 rounded bg-ink-100">.env</code> сервера
     (общий, не на пользователя). Поддерживаются DeepSeek и OpenAI-совместимые API.
@@ -53,8 +53,7 @@ OPENAI_API_KEY=sk-...
 
   <div class="mt-5 flex items-center gap-3">
     <button id="btn-ping"
-            class="inline-flex items-center gap-2 px-4 py-2 rounded-lg
+            class="btn btn-primary">
-                   bg-brand-600 hover:bg-brand-700 text-white text-sm">
       <span class="material-symbols-outlined text-base">cable</span>
       Проверить подключение
     </button>

flask_app/app/templates/settings_prompts.html

@@ -0,0 +1,433 @@
+{% extends "base.html" %}
+{% block title %}Настройки ИИ — промпты{% endblock %}
+
+{% block head %}
+<style>
+.pe-wrap {
+  border: 1px solid #d1d5db;
+  border-radius: 0.625rem;
+  background: #fff;
+  transition: border-color 0.15s, box-shadow 0.15s;
+}
+.pe-wrap:focus-within {
+  border-color: #00645b;
+  box-shadow: 0 0 0 3px rgba(0,100,91,0.12);
+}
+.pe-field {
+  min-height: 72px;
+  padding: 10px 12px;
+  font-family: 'Inter', system-ui, sans-serif;
+  font-size: 13.5px;
+  line-height: 1.7;
+  white-space: pre-wrap;
+  word-break: break-word;
+  outline: none;
+  cursor: text;
+}
+.pe-chip {
+  display: inline-flex;
+  align-items: center;
+  padding: 1px 9px 1px 7px;
+  height: 20px;
+  border-radius: 99px;
+  background: #d9efec;
+  color: #00574f;
+  font-size: 12px;
+  font-weight: 600;
+  border: 1px solid #9bd7d0;
+  cursor: grab;
+  user-select: none;
+  vertical-align: middle;
+  line-height: 1;
+  white-space: nowrap;
+  transition: background 0.12s, opacity 0.12s;
+}
+.pe-chip:hover { background: #bfe8e3; }
+.pe-chip.is-dragging { opacity: 0.3; cursor: grabbing; }
+.pe-caret {
+  display: inline-block;
+  width: 2px;
+  height: 1.1em;
+  background: #00645b;
+  border-radius: 1px;
+  vertical-align: middle;
+  pointer-events: none;
+  animation: pe-blink 0.7s steps(1) infinite;
+}
+@keyframes pe-blink { 50% { opacity: 0; } }
+.pc {
+  border: 1px solid #e5e7eb;
+  border-radius: 1rem;
+  background: #fff;
+  overflow: hidden;
+}
+.pc-head {
+  display: flex; align-items: center; gap: 10px;
+  padding: 13px 16px;
+  cursor: pointer;
+  user-select: none;
+  background: #f9fafb;
+  border-bottom: 1px solid transparent;
+}
+.pc.open .pc-head { border-bottom-color: #e5e7eb; }
+.pc-chevron { font-size: 18px; color: #6b7280; transition: transform 0.2s; }
+.pc.open .pc-chevron { transform: rotate(90deg); }
+.pc-body { display: none; padding: 16px; gap: 14px; flex-direction: column; }
+.pc.open .pc-body { display: flex; }
+.pe-label {
+  display: block;
+  font-size: 11px; font-weight: 700; letter-spacing: .06em;
+  text-transform: uppercase; color: #9ca3af;
+  margin-bottom: 5px;
+}
+.pe-palette {
+  display: flex; flex-wrap: wrap; gap: 5px;
+  padding: 7px 10px;
+  background: #f3f8f9;
+  border-top: 1px solid #e5e7eb;
+  border-radius: 0 0 0.625rem 0.625rem;
+}
+.pe-palette-chip {
+  display: inline-flex; align-items: center; gap: 3px;
+  padding: 2px 10px;
+  border-radius: 99px;
+  background: #ecfdf5;
+  color: #065f46;
+  font-size: 12px;
+  border: 1px dashed #6ee7b7;
+  cursor: pointer;
+  transition: background 0.1s;
+}
+.pe-palette-chip:hover { background: #d1fae5; }
+.pc-badge { font-size: 11px; padding: 2px 8px; border-radius: 99px; }
+.pc-badge--ok  { background: #dcfce7; color: #166534; }
+.pc-badge--err { background: #fee2e2; color: #991b1b; }
+</style>
+{% endblock %}
+
+{% block content %}
+{# Inject prompt data safely as JSON into JS scope #}
+<script>
+const PROMPTS_DATA = {{ prompts | tojson }};
+</script>
+
+<div class="flex items-center justify-between mb-5 gap-3 flex-wrap">
+  <div class="flex items-center gap-2">
+    <span class="material-symbols-outlined text-brand-500 text-2xl">psychology</span>
+    <h1 class="text-2xl font-semibold text-ink-900">Настройки ИИ</h1>
+  </div>
+  <a href="{{ url_for('main.index') }}"
+     class="inline-flex items-center gap-1 text-sm text-ink-500 hover:text-ink-800 transition">
+    <span class="material-symbols-outlined text-base">arrow_back</span>
+    Главная
+  </a>
+</div>
+
+<p class="text-sm text-ink-500 mb-5">
+  Переменные отображаются как
+  <span class="pe-chip" style="cursor:default; pointer-events:none;">Название теста</span>
+  — перетащите их в нужное место или нажмите «+&nbsp;переменная» внизу редактора для вставки.
+</p>
+
+<div id="pc-list" class="flex flex-col gap-3">
+{% for pid, p in prompts.items() %}
+<div class="pc" data-pid="{{ pid }}">
+  <div class="pc-head" onclick="this.closest('.pc').classList.toggle('open')">
+    <span class="material-symbols-outlined pc-chevron">chevron_right</span>
+    <div class="flex-1 min-w-0">
+      <div class="text-sm font-semibold text-ink-900">{{ p.label }}</div>
+      {% if p.description %}
+      <div class="text-xs text-ink-400 mt-0.5">{{ p.description }}</div>
+      {% endif %}
+    </div>
+    <span class="pc-save-status pc-badge"></span>
+  </div>
+
+  <div class="pc-body">
+    {# System #}
+    <div>
+      <span class="pe-label">System</span>
+      <div class="pe-wrap">
+        <div class="pe-field" contenteditable="true" spellcheck="false"
+             data-pid="{{ pid }}" data-field="system"></div>
+        <div class="pe-palette" data-pid="{{ pid }}" data-field="system"></div>
+      </div>
+    </div>
+    {# User #}
+    <div>
+      <span class="pe-label">User</span>
+      <div class="pe-wrap">
+        <div class="pe-field" contenteditable="true" spellcheck="false"
+             data-pid="{{ pid }}" data-field="user"></div>
+        <div class="pe-palette" data-pid="{{ pid }}" data-field="user"></div>
+      </div>
+    </div>
+    <div class="flex items-center gap-3 pt-1">
+      <button type="button"
+              class="inline-flex items-center gap-1.5 px-4 py-2 rounded-lg bg-brand-600 hover:bg-brand-700 text-white text-sm font-medium transition"
+              onclick="savePrompt(this.closest('.pc'))">
+        <span class="material-symbols-outlined text-base">save</span>Сохранить
+      </button>
+      <button type="button"
+              class="inline-flex items-center gap-1.5 px-4 py-2 rounded-lg bg-white border border-ink-300 hover:bg-ink-100 text-ink-700 text-sm transition"
+              onclick="resetPrompt(this.closest('.pc'))">
+        <span class="material-symbols-outlined text-base">restart_alt</span>Сбросить
+      </button>
+    </div>
+  </div>
+</div>
+{% endfor %}
+</div>
+{% endblock %}
+
+{% block scripts %}
+<script>
+(() => {
+'use strict';
+
+// ── DnD state ─────────────────────────────────────────────────────────
+let _drag = null;
+let _caret = null;
+
+// ── Chip ──────────────────────────────────────────────────────────────
+function makeChip(varName, label) {
+  const s = document.createElement('span');
+  s.className = 'pe-chip';
+  s.setAttribute('contenteditable', 'false');
+  s.setAttribute('draggable', 'true');
+  s.dataset.var = varName;
+  s.textContent = label;
+  bindChipDnD(s);
+  return s;
+}
+
+function bindChipDnD(chip) {
+  chip.addEventListener('dragstart', e => {
+    _drag = chip;
+    e.dataTransfer.effectAllowed = 'move';
+    e.dataTransfer.setData('text/plain', '');
+    requestAnimationFrame(() => chip.classList.add('is-dragging'));
+  });
+  chip.addEventListener('dragend', () => {
+    chip.classList.remove('is-dragging');
+    removeCaret();
+    _drag = null;
+  });
+}
+
+// ── Render / serialize ────────────────────────────────────────────────
+function renderText(el, text, vars) {
+  el.innerHTML = '';
+  const parts = text.split(/(\{[a-zA-Z_]+\})/g);
+  parts.forEach(part => {
+    const m = part.match(/^\{([a-zA-Z_]+)\}$/);
+    if (m && vars[m[1]] !== undefined) {
+      el.appendChild(makeChip(m[1], vars[m[1]]));
+    } else {
+      el.appendChild(document.createTextNode(part));
+    }
+  });
+}
+
+function serialize(el) {
+  let out = '';
+  el.childNodes.forEach(n => {
+    if (n.nodeType === Node.TEXT_NODE) out += n.textContent;
+    else if (n.dataset && n.dataset.var) out += '{' + n.dataset.var + '}';
+  });
+  return out;
+}
+
+// ── Editor DnD ────────────────────────────────────────────────────────
+function removeCaret() {
+  if (_caret && _caret.parentNode) _caret.parentNode.removeChild(_caret);
+  _caret = null;
+}
+
+function caretAt(x, y) {
+  if (document.caretRangeFromPoint) {
+    const r = document.caretRangeFromPoint(x, y);
+    if (r) return [r.startContainer, r.startOffset];
+  }
+  if (document.caretPositionFromPoint) {
+    const p = document.caretPositionFromPoint(x, y);
+    if (p) return [p.offsetNode, p.offset];
+  }
+  return [null, 0];
+}
+
+function bindEditorDrop(el) {
+  el.addEventListener('dragover', e => {
+    if (!_drag) return;
+    e.preventDefault();
+    e.dataTransfer.dropEffect = 'move';
+    removeCaret();
+    const [node, off] = caretAt(e.clientX, e.clientY);
+    if (!node) return;
+    const c = document.createElement('span');
+    c.className = 'pe-caret';
+    _caret = c;
+    try {
+      const r = document.createRange();
+      r.setStart(node, Math.min(off, node.nodeType === Node.TEXT_NODE ? node.length : node.childNodes.length));
+      r.collapse(true);
+      r.insertNode(c);
+    } catch {}
+  });
+
+  el.addEventListener('dragleave', e => {
+    if (!el.contains(e.relatedTarget)) removeCaret();
+  });
+
+  el.addEventListener('drop', e => {
+    e.preventDefault();
+    removeCaret();
+    if (!_drag) return;
+    const [node, off] = caretAt(e.clientX, e.clientY);
+    if (_drag.parentNode) _drag.parentNode.removeChild(_drag);
+    if (node && el.contains(node)) {
+      try {
+        const r = document.createRange();
+        r.setStart(node, Math.min(off, node.nodeType === Node.TEXT_NODE ? node.length : node.childNodes.length));
+        r.collapse(true);
+        r.insertNode(_drag);
+      } catch { el.appendChild(_drag); }
+    } else {
+      el.appendChild(_drag);
+    }
+    bindChipDnD(_drag);
+  });
+}
+
+// ── Block deletion of chips ───────────────────────────────────────────
+function bindEditorKeys(el) {
+  el.addEventListener('keydown', e => {
+    if (e.key !== 'Backspace' && e.key !== 'Delete') return;
+    const sel = window.getSelection();
+    if (!sel || !sel.rangeCount) return;
+    const range = sel.getRangeAt(0);
+    if (!range.collapsed && range.cloneContents().querySelector('.pe-chip')) {
+      e.preventDefault(); return;
+    }
+    if (range.collapsed) {
+      const siblings = (container, offset, dir) => {
+        if (container.nodeType === Node.TEXT_NODE) {
+          if (dir === 'prev' && offset > 0) return null;
+          if (dir === 'next' && offset < container.length) return null;
+          const arr = Array.from(container.parentNode.childNodes);
+          const i = arr.indexOf(container);
+          return dir === 'prev' ? arr[i - 1] : arr[i + 1];
+        }
+        return dir === 'prev' ? container.childNodes[offset - 1] : container.childNodes[offset];
+      };
+      const check = e.key === 'Backspace'
+        ? siblings(range.startContainer, range.startOffset, 'prev')
+        : siblings(range.startContainer, range.startOffset, 'next');
+      if (check && check.classList && check.classList.contains('pe-chip')) {
+        e.preventDefault();
+      }
+    }
+  });
+}
+
+// ── Init from PROMPTS_DATA ────────────────────────────────────────────
+function initEditor(el) {
+  const pid = el.dataset.pid;
+  const field = el.dataset.field;
+  const prompt = PROMPTS_DATA[pid];
+  if (!prompt) return;
+  const text = prompt[field] || '';
+  const vars = prompt.vars || {};
+  renderText(el, text, vars);
+  bindEditorDrop(el);
+  bindEditorKeys(el);
+}
+
+function initPalette(palette) {
+  const pid = palette.dataset.pid;
+  const field = palette.dataset.field;
+  const vars = (PROMPTS_DATA[pid] || {}).vars || {};
+  palette.innerHTML = '';
+  Object.entries(vars).forEach(([varName, label]) => {
+    const chip = document.createElement('span');
+    chip.className = 'pe-palette-chip';
+    chip.textContent = '+ ' + label;
+    chip.title = 'вставить переменную «' + label + '»';
+    chip.addEventListener('click', () => insertVar(pid, field, varName, label));
+    palette.appendChild(chip);
+  });
+}
+
+function insertVar(pid, field, varName, label) {
+  const el = document.querySelector(`.pe-field[data-pid="${pid}"][data-field="${field}"]`);
+  if (!el) return;
+  el.focus();
+  const sel = window.getSelection();
+  let range;
+  if (sel && sel.rangeCount && el.contains(sel.getRangeAt(0).commonAncestorContainer)) {
+    range = sel.getRangeAt(0);
+    range.deleteContents();
+  } else {
+    range = document.createRange();
+    range.selectNodeContents(el);
+    range.collapse(false);
+  }
+  const chip = makeChip(varName, label);
+  range.insertNode(chip);
+  range.setStartAfter(chip);
+  range.collapse(true);
+  sel.removeAllRanges();
+  sel.addRange(range);
+}
+
+document.querySelectorAll('.pe-field').forEach(initEditor);
+document.querySelectorAll('.pe-palette').forEach(initPalette);
+
+// ── Save ──────────────────────────────────────────────────────────────
+window.savePrompt = async function(card) {
+  const pid = card.dataset.pid;
+  const sysEl = card.querySelector('.pe-field[data-field="system"]');
+  const usrEl = card.querySelector('.pe-field[data-field="user"]');
+  const badge = card.querySelector('.pc-save-status');
+  badge.textContent = '';
+  badge.className = 'pc-save-status pc-badge';
+  try {
+    const r = await fetch('/api/ai/prompts/' + pid, {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ system: serialize(sysEl), user: serialize(usrEl) }),
+    });
+    const d = await r.json();
+    if (!r.ok) throw new Error(d.error || 'Ошибка');
+    // Update in-memory data
+    PROMPTS_DATA[pid].system = serialize(sysEl);
+    PROMPTS_DATA[pid].user = serialize(usrEl);
+    badge.textContent = '✓ Сохранено';
+    badge.className = 'pc-save-status pc-badge pc-badge--ok';
+    setTimeout(() => { badge.textContent = ''; badge.className = 'pc-save-status pc-badge'; }, 3000);
+  } catch (e) {
+    badge.textContent = e.message;
+    badge.className = 'pc-save-status pc-badge pc-badge--err';
+  }
+};
+
+// ── Reset ─────────────────────────────────────────────────────────────
+window.resetPrompt = async function(card) {
+  if (!confirm('Сбросить к последней сохранённой версии?')) return;
+  const pid = card.dataset.pid;
+  try {
+    const r = await fetch('/api/ai/prompts');
+    const d = await r.json();
+    const p = d.prompts?.[pid];
+    if (!p) return;
+    PROMPTS_DATA[pid] = p;
+    const sysEl = card.querySelector('.pe-field[data-field="system"]');
+    const usrEl = card.querySelector('.pe-field[data-field="user"]');
+    renderText(sysEl, p.system || '', p.vars || {});
+    renderText(usrEl, p.user || '', p.vars || {});
+  } catch (e) { alert(e.message); }
+};
+
+})();
+</script>
+{% endblock %}

flask_app/app/templates/stats.html

@@ -0,0 +1,103 @@
+{% extends "base.html" %}
+{% block title %}Статистика прохождений{% endblock %}
+
+{% block content %}
+<div class="flex items-center justify-between mb-6 gap-3 flex-wrap">
+  <div class="flex items-center gap-2">
+    <span class="material-symbols-outlined text-brand-500 text-2xl">bar_chart</span>
+    <h1 class="text-2xl font-semibold text-ink-900">Статистика</h1>
+  </div>
+  <a href="{{ url_for('main.index') }}"
+     class="inline-flex items-center gap-1 text-sm text-ink-500 hover:text-ink-800 transition">
+    <span class="material-symbols-outlined text-base">arrow_back</span>
+    Главная
+  </a>
+</div>
+
+{# Сводные метрики #}
+<div class="grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-5 gap-3 mb-6">
+  {% for icon, label, value in [
+    ('quiz',         'Тестов всего',   stats.total_tests),
+    ('people',       'Пользователей',  stats.total_users),
+    ('fact_check',   'Прохождений',    stats.total_completed),
+    ('check_circle', 'Сдали',          stats.total_passed),
+    ('percent',      'Успешность',     stats.pass_rate | string + '\u2009%'),
+  ] %}
+  <div class="rounded-2xl bg-white border border-ink-300/50 shadow-sm p-4 flex flex-col gap-1">
+    <span class="material-symbols-outlined text-brand-500 text-xl">{{ icon }}</span>
+    <div class="text-2xl font-bold text-ink-900 leading-tight">{{ value }}</div>
+    <div class="text-xs text-ink-500">{{ label }}</div>
+  </div>
+  {% endfor %}
+</div>
+
+{# По отделам + последние прохождения #}
+<div class="grid grid-cols-1 lg:grid-cols-2 gap-4">
+
+  <section class="rounded-2xl bg-white border border-ink-300/50 shadow-sm overflow-hidden">
+    <div class="px-4 py-3 border-b border-ink-100 flex items-center gap-2">
+      <span class="material-symbols-outlined text-brand-500 text-base">corporate_fare</span>
+      <h2 class="font-semibold text-sm text-ink-900">По отделам</h2>
+    </div>
+    {% if stats.dept_stats %}
+    <div class="overflow-x-auto">
+      <table class="w-full text-sm">
+        <thead>
+          <tr class="border-b border-ink-100 text-xs text-ink-500 uppercase tracking-wide">
+            <th class="px-4 py-2 text-left font-medium">Отдел</th>
+            <th class="px-4 py-2 text-right font-medium">Прошли</th>
+            <th class="px-4 py-2 text-right font-medium">Сдали</th>
+            <th class="px-4 py-2 text-right font-medium">%</th>
+          </tr>
+        </thead>
+        <tbody class="divide-y divide-ink-100/60">
+          {% for d in stats.dept_stats %}
+          <tr class="hover:bg-ink-100/40 transition-colors">
+            <td class="px-4 py-2.5 text-ink-800 max-w-[180px] truncate">{{ d.name }}</td>
+            <td class="px-4 py-2.5 text-right text-ink-700">{{ d.total }}</td>
+            <td class="px-4 py-2.5 text-right text-ink-700">{{ d.passed }}</td>
+            <td class="px-4 py-2.5 text-right">
+              <span class="inline-block min-w-[38px] text-center rounded-full px-2 py-0.5 text-xs font-semibold
+                {% if d.rate >= 80 %}bg-green-50 text-green-700
+                {% elif d.rate >= 50 %}bg-yellow-50 text-yellow-700
+                {% else %}bg-red-50 text-red-700{% endif %}">
+                {{ d.rate }}%
+              </span>
+            </td>
+          </tr>
+          {% endfor %}
+        </tbody>
+      </table>
+    </div>
+    {% else %}
+    <p class="px-4 py-8 text-sm text-ink-500 text-center">Прохождений ещё нет.</p>
+    {% endif %}
+  </section>
+
+  <section class="rounded-2xl bg-white border border-ink-300/50 shadow-sm overflow-hidden">
+    <div class="px-4 py-3 border-b border-ink-100 flex items-center gap-2">
+      <span class="material-symbols-outlined text-brand-500 text-base">history</span>
+      <h2 class="font-semibold text-sm text-ink-900">Последние прохождения</h2>
+    </div>
+    {% if stats.recent %}
+    <ul class="divide-y divide-ink-100/60">
+      {% for r in stats.recent %}
+      <li class="px-4 py-2.5 flex items-start gap-3 hover:bg-ink-100/30 transition-colors">
+        <span class="material-symbols-outlined text-base mt-0.5
+          {% if r.passed == true %}text-green-500{% elif r.passed is none %}text-ink-300{% else %}text-red-400{% endif %}">
+          {% if r.passed == true %}check_circle{% elif r.passed is none %}radio_button_unchecked{% else %}cancel{% endif %}
+        </span>
+        <div class="flex-1 min-w-0">
+          <div class="text-sm text-ink-800 truncate font-medium">{{ r.test }}</div>
+          <div class="text-xs text-ink-500 truncate">{{ r.user }} · {{ r.score }} · {{ r.at }}</div>
+        </div>
+      </li>
+      {% endfor %}
+    </ul>
+    {% else %}
+    <p class="px-4 py-8 text-sm text-ink-500 text-center">Прохождений ещё нет.</p>
+    {% endif %}
+  </section>
+
+</div>
+{% endblock %}

flask_app/app/templates/tests/attempt.html

@@ -0,0 +1,47 @@
+{% extends "base.html" %}
+{% block title %}Прохождение теста{% endblock %}
+
+{% block content %}
+<div class="attempt-root test-detail-page" id="attempt-root" data-test-id="{{ test_id }}" data-attempt-id="{{ attempt_id }}">
+
+  <a href="{{ url_for('tests.tests_list_page') }}" class="link-back attempt-back-link">← К тестам</a>
+
+  <div id="attempt-flow" class="attempt-flow">
+    <header class="attempt-progress-head">
+      <div class="attempt-progress-row">
+        <span id="attempt-progress-label" class="attempt-progress-label" aria-live="polite">—</span>
+        <span id="attempt-timer" class="attempt-timer" style="display:none;" aria-live="polite"></span>
+      </div>
+      <div class="attempt-progress-track"
+           role="progressbar"
+           aria-valuemin="1"
+           aria-valuenow="1"
+           aria-valuemax="1"
+           aria-label="Прогресс прохождения">
+        <div id="attempt-progress-fill" class="attempt-progress-fill"></div>
+      </div>
+      <h1 class="attempt-title font-headline" id="attempt-title">Загрузка…</h1>
+      <p class="attempt-subtitle muted text-sm" id="attempt-subtitle"></p>
+    </header>
+
+    <div id="attempt-stage" class="attempt-stage"></div>
+
+    <footer class="attempt-footer-bar" aria-label="Навигация по вопросам">
+      <div class="attempt-footer-inner">
+        <button type="button" class="btn btn-ghost attempt-footer-btn" id="attempt-prev" hidden>Назад</button>
+        <div class="attempt-footer-spacer"></div>
+        <button type="button" class="btn btn-primary attempt-footer-btn" id="attempt-next">Далее</button>
+        <button type="button" class="btn btn-primary attempt-footer-btn" id="attempt-finish" style="display:none;">Завершить тест</button>
+      </div>
+    </footer>
+  </div>
+
+  <p id="attempt-error" class="callout callout--error attempt-error-box" style="display:none;"></p>
+
+  <div id="attempt-result" class="surface-card attempt-result-card" style="display:none;"></div>
+</div>
+{% endblock %}
+
+{% block scripts %}
+<script src="{{ url_for('static', filename='js/attempt.js') }}" defer></script>
+{% endblock %}

flask_app/app/templates/tests/attempt_review.html

@@ -0,0 +1,62 @@
+{% extends "base.html" %}
+{% block title %}Разбор попытки{% endblock %}
+
+{% block content %}
+<div class="test-detail-page attempt-review-page">
+  <header class="attempt-review-page__header">
+    <p class="link-back attempt-review-page__back"><a href="/tests">← к списку тестов</a></p>
+    <h1 class="attempt-review-page__title font-headline">Разбор: {{ review.testTitle }}</h1>
+    {% set tl = review.timeLimit %}
+    {% set timestr = 'без ограничения' if tl is none or tl == 0 else (tl|string ~ ' мин') %}
+    {% set rm = review.resultMode or 'end' %}
+    {% set res = 'сразу' if rm == 'immediate' else 'в конце' %}
+    {% set hint = 'недоступны' if rm != 'immediate' else ('вкл' if review.hintsEnabled else 'выкл') %}
+    <p class="attempt-review-page__params text-muted text-sm">
+      Порог: {{ review.passingThreshold }}% · Вопросов: {{ review.totalQuestions }} · Время: {{ timestr }} · Результат: {{ res }} · Подсказки: {{ hint }}
+    </p>
+    <div class="attempt-review-score {% if review.passed %}attempt-review-score--pass{% else %}attempt-review-score--fail{% endif %}">
+      <div class="attempt-review-score__main">
+        <span class="attempt-review-score__label">Итог</span>
+        <p class="attempt-review-score__value">
+          Правильно <strong>{{ review.correctCount }}</strong> из {{ review.totalQuestions }}
+          <span class="attempt-review-score__percent">({{ review.percent }}%)</span>
+        </p>
+        <p class="attempt-review-score__threshold">Порог зачёта: {{ review.passingThreshold }}%</p>
+      </div>
+      <span class="attempt-review-score__verdict">{% if review.passed %}Зачёт{% else %}Незачёт{% endif %}</span>
+    </div>
+  </header>
+
+  <div class="attempt-review-page__list">
+    {% for q in review.questions %}
+      <article class="attempt-card attempt-review-card">
+        <div class="attempt-review-card__head">
+          <span class="attempt-review-card__num">{{ loop.index }}</span>
+          <span class="attempt-review-card__badge {% if q.isUserCorrect %}attempt-review-card__badge--ok{% else %}attempt-review-card__badge--bad{% endif %}">
+            {{ 'Верно' if q.isUserCorrect else 'Ошибка' }}
+          </span>
+        </div>
+        <p class="attempt-review-card__question">{{ q.text }}</p>
+        {% if q.aiHint %}
+          <div class="attempt-review-hint">
+            <span class="attempt-review-hint__label">Подсказка</span>
+            <p class="attempt-review-hint__text">{{ q.aiHint }}</p>
+          </div>
+        {% endif %}
+        <ul class="attempt-review-options" role="list">
+          {% for o in q.options %}
+            <li class="attempt-review-option
+                       {% if o.isCorrect %}attempt-review-option--correct{% endif %}
+                       {% if o.selected and not o.isCorrect %}attempt-review-option--wrong{% endif %}">
+              <span class="attempt-review-option__text">
+                <span class="attempt-review-option__mark" aria-hidden="true">{% if o.selected %}☑{% else %}☐{% endif %}</span>
+                <span class="attempt-review-option__body">{{ o.text }}{% if o.isCorrect %}<span class="attempt-review-option__tag">верный ответ</span>{% endif %}</span>
+              </span>
+            </li>
+          {% endfor %}
+        </ul>
+      </article>
+    {% endfor %}
+  </div>
+</div>
+{% endblock %}

flask_app/app/templates/tests/editor.html

@@ -3,187 +3,529 @@
 
 {% block content %}
 <div id="editor-root"
+     class="space-y-4 sm:space-y-5 pb-24 test-detail-page test-detail-page--with-fixed-actions"
      data-test-id="{{ test_id }}"
      data-initial='{{ content | tojson | safe }}'>
-  <!-- Шапка: название/описание/проходной балл -->
+
-  <section class="rounded-2xl bg-white shadow-sm border border-ink-300/60 p-5">
+  <div id="editor-gen-toast" class="editor-gen-toast" role="status" aria-live="polite" hidden></div>
-    <div class="flex items-start justify-between gap-3 flex-wrap">
+
-      <div class="flex-1 min-w-[260px]">
+  <section class="cabinet-brick cabinet-brick--hero hero-brick">
-        <label class="block">
+    <a href="{{ url_for('tests.tests_list_page') }}" class="link-back">← К тестам</a>
-          <span class="text-xs font-medium text-ink-500 uppercase">Название</span>
+    <textarea id="test-title" maxlength="200" rows="1" placeholder="Название теста"
-          <input id="test-title" type="text" maxlength="200"
+              class="hero-brick__title font-headline"></textarea>
-                 class="mt-1 w-full rounded-lg border border-ink-300 px-3 py-2 text-lg font-semibold
+
-                        focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20" />
+    <textarea id="test-description" rows="2" placeholder="Краткое описание (необязательно)"
-        </label>
+              class="hero-brick__desc"></textarea>
-        <label class="block mt-3">
+
-          <span class="text-xs font-medium text-ink-500 uppercase">Описание</span>
+    <div class="hero-brick__meta-row">
-          <textarea id="test-description" rows="2"
+      <span>Автор: <b id="intro-author">Вы</b></span>
-                    class="mt-1 w-full rounded-lg border border-ink-300 px-3 py-2
+      <span class="hero-brick__sep">·</span>
-                           focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20"></textarea>
+      <span>Обновлён: <span id="intro-updated">—</span></span>
-        </label>
+      <span class="hero-brick__sep">·</span>
-      </div>
+      <span>Версия <span id="intro-version">—</span></span>
-      <div class="w-44">
-        <label class="block">
-          <span class="text-xs font-medium text-ink-500 uppercase">Проходной балл, %</span>
-          <input id="test-threshold" type="number" min="0" max="100" step="1"
-                 class="mt-1 w-full rounded-lg border border-ink-300 px-3 py-2
-                        focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20" />
-        </label>
-      </div>
     </div>
+
+    <div class="hero-brick__divider"></div>
+
+    <div class="hero-brick__meta-row">
+      <span>Порог зачёта: <b id="threshold-mirror">—</b>%</span>
+      <span class="hero-brick__sep">·</span>
+      <span>Вопросов: <b id="q-count">0</b></span>
+      <span class="hero-brick__sep">·</span>
+      <span>Время: <b id="editor-hero-time-val">—</b></span>
+      <span class="hero-brick__sep">·</span>
+      <span>Результат: <b id="editor-hero-result-val">—</b></span>
+      <span class="hero-brick__sep">·</span>
+      <span>Подсказки: <b id="editor-hero-hints-val">—</b></span>
+      <span class="hero-brick__sep">·</span>
+      <span id="chain-active-display">Активна в каталоге</span>
+    </div>
+
   </section>
 
-  <!-- AI-панель -->
+  {# ── Версии ───────────────────────────────────────────────────── #}
-  <section class="mt-4 rounded-2xl bg-brand-50/60 border border-brand-100 p-4">
+  <details class="cabinet-disclosure cabinet-brick">
-    <div class="flex items-center gap-2">
+    <summary class="cabinet-disclosure__summary">
-      <span class="material-symbols-outlined text-brand-600">auto_awesome</span>
+      <span class="cabinet-disclosure__summary-text">
-      <h2 class="font-semibold text-brand-700">AI-помощник</h2>
+        <span class="cabinet-disclosure__summary-title font-headline">Версии</span>
+        <span class="cabinet-disclosure__summary-sub">История изменений; можно переключить активную версию</span>
+      </span>
+    </summary>
+    <div class="cabinet-disclosure__body">
+      <ul id="versions-list" class="version-card-list"></ul>
     </div>
-    <p class="mt-1 text-sm text-ink-700">
+  </details>
-      Сгенерировать вопросы по текущей сетке (число вопросов и вариантов берётся из таблицы ниже).
+
-    </p>
+  <details class="cabinet-disclosure cabinet-brick">
-    <div class="mt-3 flex flex-wrap gap-2 items-center">
+    <summary class="cabinet-disclosure__summary">
-      <button id="ai-generate-test"
+      <span class="cabinet-disclosure__summary-text">
-              class="inline-flex items-center gap-2 px-3 py-2 rounded-lg
+        <span class="cabinet-disclosure__summary-title font-headline">Параметры теста</span>
-                     bg-brand-600 hover:bg-brand-700 text-white text-sm">
+        <span class="cabinet-disclosure__summary-sub">Порог, таймер, режим результата, подсказки и шаблон структуры вопросов</span>
-        <span class="material-symbols-outlined text-base">stars</span>
+      </span>
-        Сгенерировать по сетке
+    </summary>
-      </button>
+    <div class="cabinet-disclosure__body">
-      <button id="ai-generate-by-title"
+      <div class="settings-grid">
-              class="inline-flex items-center gap-2 px-3 py-2 rounded-lg
+        <label class="settings-row">
-                     bg-white border border-brand-300/60 text-brand-700 hover:bg-brand-50 text-sm">
+          <span class="settings-row__label">Проходной балл, %</span>
-        <span class="material-symbols-outlined text-base">edit_note</span>
+          <input id="test-threshold" type="number" min="0" max="100" step="1" inputmode="numeric"
-        Сгенерировать по названию
+                 class="settings-row__input" />
-      </button>
+        </label>
-      <button id="ai-check"
+
-              class="inline-flex items-center gap-2 px-3 py-2 rounded-lg
+        <label class="settings-row">
-                     bg-white border border-ink-300/60 hover:border-brand-300 text-sm">
+          <span class="settings-row__label">
-        <span class="material-symbols-outlined text-base">fact_check</span>
+            Таймер, минут
-        Проверить тест
+            <span class="settings-row__hint">0 или пусто — без ограничения</span>
-      </button>
+          </span>
-      <button id="ai-improve"
+          <input id="test-time-limit" type="number" min="0" max="600" step="1" inputmode="numeric"
-              class="inline-flex items-center gap-2 px-3 py-2 rounded-lg
+                 class="settings-row__input" placeholder="—" />
-                     bg-white border border-ink-300/60 hover:border-brand-300 text-sm">
+        </label>
-        <span class="material-symbols-outlined text-base">tune</span>
+
-        Улучшить тест
+        <fieldset class="settings-row settings-row--block">
-      </button>
+          <legend class="settings-row__label">Когда показывать результат</legend>
-      <label class="inline-flex items-center gap-2 px-3 py-2 rounded-lg
+          <label class="settings-radio">
-                    bg-white border border-ink-300/60 hover:border-brand-300 text-sm cursor-pointer">
+            <input type="radio" name="result-mode" value="end" />
-        <span class="material-symbols-outlined text-base text-brand-600">upload_file</span>
+            <span>В конце теста</span>
-        <span>Импорт документа</span>
+          </label>
-        <input id="ai-import-file" type="file" accept=".pdf,.docx,.txt,.md" class="hidden" />
+          <label class="settings-radio">
+            <input type="radio" name="result-mode" value="immediate" />
+            <span>Сразу после ответа</span>
+          </label>
+        </fieldset>
+
+        <label class="settings-row settings-row--toggle" id="test-hints-row" style="display:none;">
+          <span class="settings-row__label">
+            Показывать подсказку после ответа
+            <span class="settings-row__hint">Краткое объяснение под вариантами ответа</span>
+          </span>
+          <input id="test-hints-enabled" type="checkbox" />
+        </label>
+
+        <div class="settings-row settings-row--block">
+          <span class="settings-row__label">Шаблон структуры вопросов</span>
+          <p class="settings-row__hint" style="margin-bottom:0.5rem;">
+            Задаёт сетку для автосборки пустых вопросов и для генерации через ИИ. При смене чисел список вопросов пересобирается (с подтверждением, если уже есть текст).
+          </p>
+          <div class="flex flex-wrap items-end gap-3">
+            <label class="block">
+              <span class="form-label">Вопросов</span>
+              <input id="ai-q-count" type="number" min="1" max="30" step="1" value="7"
+                     class="form-input" style="width:90px;" />
+            </label>
+            <label class="block">
+              <span class="form-label">Вариантов</span>
+              <input id="ai-o-count" type="number" min="2" max="8" step="1" value="3"
+                     class="form-input" style="width:90px;" />
+            </label>
+          </div>
+          <div class="template-multi-row mt-3">
+            <label class="inline-flex items-start gap-2 min-h-9 w-full">
+              <input id="template-global-multi" type="checkbox"
+                     class="rounded border-ink-300 text-brand-600 focus:ring-brand-500 mt-0.5 shrink-0" />
+              <span class="text-sm leading-snug">Несколько правильных ответов (все вопросы)</span>
+            </label>
+          </div>
+          <div class="template-correct-range-row mt-2 flex flex-wrap items-end gap-3">
+            <label class="block">
+              <span class="form-label">Правильных: от</span>
+              <input id="template-min-correct" type="number" min="1" max="8" step="1" value="1"
+                     class="form-input" style="width:90px;" />
+            </label>
+            <label class="block">
+              <span class="form-label">до</span>
+              <input id="template-max-correct" type="number" min="1" max="8" step="1" value="1"
+                     class="form-input" style="width:90px;" />
+            </label>
+          </div>
+        </div>
+
+        <div class="settings-row settings-row--block" style="padding-top:0.75rem; border-top:1px solid var(--outline-variant); margin-top:0.25rem;">
+          <span class="settings-row__label">Видимость в каталоге</span>
+          <p class="settings-row__hint" style="margin-bottom:0.5rem;">Скрытые тесты не показываются в общем списке; ссылку по-прежнему можно открыть.</p>
+          <button id="btn-toggle-visibility" class="btn btn-ghost btn--sm" type="button">Скрыть из списка</button>
+        </div>
+      </div>
+    </div>
+  </details>
+
+  <details class="cabinet-disclosure cabinet-brick">
+    <summary class="cabinet-disclosure__summary">
+      <span class="cabinet-disclosure__summary-text">
+        <span class="cabinet-disclosure__summary-title font-headline">Инструменты генерации</span>
+        <span class="cabinet-disclosure__summary-sub">Генерация через ИИ, проверка, улучшение и импорт документа</span>
+      </span>
+    </summary>
+    <div class="cabinet-disclosure__body">
+  <section class="rounded-2xl bg-brand-50/60 border border-brand-100 test-detail-ai-panel editor-generation-panel">
+
+    {# ── Заполнить через ИИ по теме ──────────────────────────── #}
+    <div class="question-editor-block question-editor-block--first">
+      <h3 class="test-detail-subsection__title">Заполнить через ИИ</h3>
+      <label class="block">
+        <span class="form-label">Тема / промпт</span>
+        <textarea id="ai-topic" rows="1" class="form-input"
+                  placeholder="Например: охрана труда на производстве"
+                  style="resize:none; overflow:hidden; font-family:inherit;"></textarea>
       </label>
-      <span id="ai-status" class="text-sm text-ink-500"></span>
+      <label class="mt-2 inline-flex items-start gap-2 text-sm text-ink-700 cursor-pointer select-none">
+        <input type="checkbox" id="ai-keep-title" class="mt-1 rounded border-ink-300 text-brand-600 focus:ring-brand-500" />
+        <span>Не менять название теста в редакторе после генерации (оставить текущее)</span>
+      </label>
+      <div class="mt-2">
+        <button id="ai-generate-test"
+                class="btn btn-ghost" type="button" style="min-height:43px;">
+          Сгенерировать вопросы (ИИ)
+        </button>
+      </div>
+      <ul class="editor-generation-panel__notes mt-2 text-xs text-ink-500 space-y-1 list-disc pl-4 leading-snug">
+        <li>Если в параметрах включены подсказки — после генерации будут созданы и тексты подсказок (черновик сохранится автоматически).</li>
+        <li>Если уже есть версия с заполненным тестом — после «Сгенерировать» и сохранения весь прежний текст останется в старой версии в блоке «Версии».</li>
+      </ul>
     </div>
-    <p class="mt-2 text-xs text-ink-500">
-      Поддерживаются PDF, DOCX, TXT, MD (до 16 МБ). AI извлечёт текст и предложит черновик теста.
-    </p>
-  </section>
 
-  <!-- Список вопросов -->
+    {# ── Проверить и улучшить ─────────────────────────────────── #}
-  <section class="mt-4">
+    <div class="question-editor-block">
-    <div class="flex items-center justify-between gap-2 px-1">
+      <h3 class="test-detail-subsection__title">Проверить и улучшить</h3>
-      <h2 class="font-semibold">Вопросы (<span id="q-count">0</span>)</h2>
+      <p class="text-xs text-ink-500 leading-snug mb-2">
-      <button id="add-question"
+        <span class="font-medium text-ink-600">Проверить тест</span> — ИИ прочитает вопросы и варианты и вернёт краткий вердикт и список замечаний; черновик не меняется.
-              class="inline-flex items-center gap-1 px-3 py-1.5 rounded-lg
+      </p>
-                     bg-white border border-ink-300/60 hover:border-brand-300 text-sm">
+      <p class="text-xs text-ink-500 leading-snug mb-3">
-        <span class="material-symbols-outlined text-base">add</span>
+        <span class="font-medium text-ink-600">Предложить улучшение</span> — ИИ предложит правки по каждому вопросу (было → стало); вы отметите, что применить к черновику.
-        Добавить вопрос
+      </p>
+      <div class="flex flex-col sm:flex-row sm:flex-wrap sm:items-end gap-2">
+        <label class="flex flex-col gap-1 min-w-[12rem] flex-1">
+          <span class="text-xs font-medium text-ink-600">Область улучшения</span>
+          <select id="ai-improve-focus"
+                  class="form-input text-sm py-2 rounded-lg border border-ink-300 bg-white">
+            <option value="all">Всё: вопросы и варианты</option>
+            <option value="questions">Только формулировки вопросов</option>
+            <option value="distractors">Только неверные варианты (дистракторы)</option>
+            <option value="options">Все варианты ответа (без смены верности)</option>
+          </select>
+        </label>
+        <div class="flex flex-wrap gap-2">
+        <button id="ai-check"
+                class="btn btn-ghost" type="button" style="min-height:43px;">
+          <span class="material-symbols-outlined text-base" style="vertical-align:-3px;">fact_check</span>
+          Проверить тест
+        </button>
+        <button id="ai-improve"
+                class="btn btn-ghost" type="button" style="min-height:43px;">
+          <span class="material-symbols-outlined text-base" style="vertical-align:-3px;">auto_fix_high</span>
+          Предложить улучшение
+        </button>
+        </div>
+      </div>
+    </div>
+
+    {# ── Документ в вопросы ──────────────────────────────────── #}
+    <div class="question-editor-block test-detail-subsection test-detail-subsection--import">
+      <h3 class="test-detail-subsection__title">Документ в вопросы</h3>
+      <p class="text-xs text-ink-500 leading-snug mb-2 text-center">
+        <span class="font-medium text-ink-600">Сгенерировать из документа</span> — из файла извлекается текст; ИИ составляет вопросы по содержанию и шаблону из «Параметров» (число вопросов, вариантов, несколько верных и т.д.), с учётом поля «Пожелания», если оно заполнено. Перед заменой откроется предпросмотр: «Применить» подставит черновик вместо текущих вопросов; дальше сохраните тест на сервер — подсказки и версии ведут себя так же, как при генерации по теме.
+      </p>
+      <label id="ai-import-dropzone"
+             class="import-dropzone mt-2 flex flex-col w-full items-center justify-center gap-1
+                    px-4 py-5 rounded-xl bg-white border-2 border-dashed border-ink-300/70
+                    hover:border-brand-400 hover:bg-brand-50/40 cursor-pointer transition-colors">
+        <span class="material-symbols-outlined text-2xl text-brand-400">upload_file</span>
+        <span id="ai-import-dropzone-label" class="text-sm font-medium text-ink-700 text-center block w-full">Перетащите файлы сюда или нажмите</span>
+        <span class="text-xs text-ink-400 text-center block w-full">PDF, DOCX, TXT, MD · до 5 за раз · до 16 МБ · повторный выбор добавляет к уже загруженным; полный сброс — «Сбросить загрузку».</span>
+        <input id="ai-import-file" type="file" accept=".pdf,.docx,.txt,.md" multiple class="hidden" />
+      </label>
+      <div class="mt-2 flex flex-wrap gap-2">
+        <button type="button" id="ai-import-clear" class="btn btn-ghost btn--sm text-sm" style="min-height:36px;">
+          Сбросить загрузку
+        </button>
+      </div>
+      <label class="block mt-3">
+        <span class="form-label">Пожелания по содержанию <span class="text-ink-400 font-normal">(необязательно)</span></span>
+        <textarea id="doc-user-hint" rows="1"
+                  class="form-input mt-1"
+                  placeholder="Например: акцент на разделе 3, не делать вопросы про даты"
+                  style="resize:none; overflow:hidden; font-family:inherit;"></textarea>
+      </label>
+      <button id="doc-generate-btn"
+              class="btn btn-ghost mt-2" type="button" style="min-height:43px;">
+        <span class="material-symbols-outlined text-base" style="vertical-align:-3px;">auto_awesome</span>
+        Сгенерировать из документа
       </button>
     </div>
-    <ol id="questions" class="mt-3 space-y-3"></ol>
+
+    {# ── Модалка результата импорта документа ─────────────────── #}
+    <dialog id="import-modal" class="save-modal import-modal">
+      <div class="save-modal__inner import-modal__inner">
+        <h3 id="import-modal-title" class="import-modal__title font-headline"></h3>
+        <div id="import-modal-body" class="import-modal__body"></div>
+        <div id="import-modal-actions" class="import-modal__actions flex gap-2 justify-end flex-wrap"></div>
+      </div>
+    </dialog>
+
   </section>
 
-  <!-- Footer: сохранение / активность цепочки -->
+    </div>
-  <section class="sticky bottom-0 z-20 mt-6 -mx-4 px-4 py-3
+  </details>
-                  bg-white/90 backdrop-blur border-t border-ink-300/60
+
-                  flex items-center justify-between gap-2 flex-wrap">
+  <details class="cabinet-disclosure cabinet-brick" open>
-    <label class="inline-flex items-center gap-2 text-sm">
+    <summary class="cabinet-disclosure__summary">
-      <input id="chain-active" type="checkbox"
+      <span class="cabinet-disclosure__summary-text">
-             class="rounded border-ink-300 text-brand-600 focus:ring-brand-500" />
+        <span class="cabinet-disclosure__summary-title font-headline">Вопросы</span>
-      <span>Цепочка активна (виден в каталоге)</span>
+        <span class="cabinet-disclosure__summary-sub">Тексты, варианты ответов и подсказки по каждому вопросу</span>
-    </label>
+      </span>
+    </summary>
+    <div class="cabinet-disclosure__body">
+  <section class="mt-1">
     <div class="flex items-center gap-2">
-      <span id="save-status" class="text-sm text-ink-500"></span>
+      <h2 class="font-semibold text-ink-900">Вопросы (<span id="q-count-mirror">0</span>)</h2>
-      <a href="{{ url_for('tests.tests_list_page') }}"
+    </div>
-         class="px-3 py-2 rounded-lg text-ink-700 hover:bg-ink-100 text-sm">К каталогу</a>
+    <ol id="questions" class="mt-3 space-y-4"></ol>
+    <div class="mt-3 flex justify-center flex-wrap gap-2">
+      <button id="add-question"
+              class="inline-flex items-center gap-1 px-3 py-2 rounded-lg
+                     bg-white border border-ink-300/60 hover:border-brand-300 text-sm min-h-10
+                     btn btn-ghost question-editor__add-question">
+        <span class="material-symbols-outlined text-base">add</span>
+        <span>Добавить вопрос</span>
+      </button>
+      <button id="add-question-ai" type="button"
+              class="inline-flex items-center gap-1 px-3 py-2 rounded-lg
+                     bg-brand-50 border border-brand-200 hover:border-brand-400 text-sm min-h-10
+                     btn btn-ghost question-editor__add-question-ai"
+              title="Добавляет пустой блок и вызывает ИИ для одного нового вопроса с вариантами">
+        <span class="material-symbols-outlined text-base">auto_awesome</span>
+        <span>Новый вопрос (ИИ)</span>
+      </button>
+    </div>
+
+  </section>
+    </div>
+  </details>
+
+{# Прохождения перенесены на /stats. Назначения перенесены на /assignments #}
+</div>
+
+{# ── Sticky-footer: «Цепочка активна» + «Сохранить» ────────────── #}
+<div class="fixed bottom-0 inset-x-0 z-30 bg-white/95 backdrop-blur border-t border-ink-300/60
+            pb-[env(safe-area-inset-bottom)]">
+  <div class="mx-auto max-w-2xl px-4 py-3
+              flex items-center justify-between gap-3">
+    <div id="intro-fork-banner" class="callout callout--warning text-xs sm:text-sm"
+         data-fork-risk="{{ '1' if content.test.hasForkRisk else '0' }}"
+         style="display:none; margin:0; padding:0.4rem 0.6rem; flex:1 1 0; min-width:0; white-space:normal; word-break:break-word; line-height:1.25;">
+      При сохранении будет создана новая версия теста.
+    </div>
+    <div class="flex items-center gap-2 ml-auto shrink-0">
+      <button id="btn-cancel"
+         class="inline-flex px-3 py-2 rounded-lg text-ink-700 hover:bg-ink-100 text-sm btn btn-ghost">
+        Отмена
+      </button>
       <button id="save-draft"
-              class="inline-flex items-center gap-2 px-4 py-2 rounded-lg
+              class="inline-flex items-center gap-2 px-4 py-2.5 rounded-lg
-                     bg-brand-600 hover:bg-brand-700 text-white">
+                     bg-brand-600 hover:bg-brand-700 text-white font-medium min-h-11 btn btn-primary">
         <span class="material-symbols-outlined text-base">save</span>
         Сохранить
       </button>
     </div>
-  </section>
+  </div>
+  <p id="save-status" class="mx-auto max-w-2xl px-4 pb-2 text-xs text-ink-500"></p>
 </div>
 
-<!-- Шаблон вопроса -->
+{# ── Шаблон вопроса ─────────────────────────────────────────────── #}
 <template id="tpl-question">
-  <li class="rounded-xl bg-white border border-ink-300/60 p-4 q-item">
+  <li class="relative rounded-xl bg-white border border-ink-300/60 p-4 sm:p-5 q-item" draggable="true">
-    <div class="flex items-start justify-between gap-2">
+
-      <span class="text-xs uppercase tracking-wide text-ink-500 q-num">Вопрос #</span>
+    {# Оверлей загрузки AI #}
-      <div class="flex items-center gap-1">
+    <div class="q-ai-overlay hidden absolute inset-0 rounded-xl z-10
-        <button class="q-up p-1 rounded hover:bg-ink-100" title="Выше">
+                bg-white/80 backdrop-blur-[2px] flex flex-col items-center justify-center gap-2">
+      <span class="q-ai-spinner inline-block w-7 h-7 rounded-full
+                   border-[3px] border-brand-200 border-t-brand-600 animate-spin"></span>
+      <span class="text-xs text-ink-500 font-medium">Генерирую…</span>
+    </div>
+
+    {# Шапка карточки вопроса #}
+    <div class="flex items-center justify-between gap-2">
+      <span class="inline-flex items-center gap-1">
+        <button class="q-drag p-2 rounded hover:bg-ink-100 min-w-10 min-h-10 cursor-grab"
+                title="Перетащить" aria-label="Перетащить" type="button">
+          <span class="material-symbols-outlined text-base">drag_indicator</span>
+        </button>
+        <span class="inline-flex items-center px-2 py-0.5 rounded-md
+                     bg-brand-50 text-brand-700 text-xs font-medium q-num">Вопрос #</span>
+      </span>
+      <div class="flex items-center gap-0.5">
+        <button class="q-clear p-2 rounded hover:bg-ink-100 min-w-10 min-h-10 text-ink-400"
+                title="Очистить вопрос" aria-label="Очистить вопрос" type="button">
+          <span class="material-symbols-outlined text-base">backspace</span>
+        </button>
+        <button class="q-up p-2 rounded hover:bg-ink-100 min-w-10 min-h-10"
+                title="Выше" aria-label="Поднять выше">
           <span class="material-symbols-outlined text-base">arrow_upward</span>
         </button>
-        <button class="q-down p-1 rounded hover:bg-ink-100" title="Ниже">
+        <button class="q-down p-2 rounded hover:bg-ink-100 min-w-10 min-h-10"
+                title="Ниже" aria-label="Опустить ниже">
           <span class="material-symbols-outlined text-base">arrow_downward</span>
         </button>
-        <button class="q-delete p-1 rounded hover:bg-red-50 text-red-600" title="Удалить">
+        <button class="q-delete p-2 rounded hover:bg-red-50 text-red-600 min-w-10 min-h-10"
+                title="Удалить" aria-label="Удалить вопрос">
           <span class="material-symbols-outlined text-base">delete</span>
         </button>
       </div>
     </div>
-    <textarea class="q-text mt-2 w-full rounded-lg border border-ink-300 px-3 py-2
-                     focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20"
-              rows="2" placeholder="Формулировка вопроса"></textarea>
 
-    <div class="mt-2 flex items-center justify-between gap-2 flex-wrap text-sm">
+    <div class="mt-2 relative">
-      <label class="inline-flex items-center gap-2">
+      <textarea class="q-text w-full rounded-lg border border-ink-300 px-3 py-2
-        <input type="checkbox" class="q-multi rounded border-ink-300 text-brand-600 focus:ring-brand-500" />
+                       focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20"
+                rows="1" placeholder="Формулировка вопроса" maxlength="500"
+                style="resize:none; overflow:hidden; font-family:inherit;"></textarea>
+      <span class="q-text-counter absolute bottom-1.5 right-2 text-xs text-ink-400 pointer-events-none select-none"></span>
+    </div>
+
+    <div class="mt-3 flex flex-col sm:flex-row sm:items-center sm:justify-between gap-2 text-sm">
+      <label class="inline-flex items-center gap-2 min-h-9">
+        <input type="checkbox"
+               class="q-multi rounded border-ink-300 text-brand-600 focus:ring-brand-500" />
         <span>Несколько правильных ответов</span>
       </label>
-      <button class="q-ai inline-flex items-center gap-1 px-2 py-1 rounded-lg
+      <button class="q-ai btn btn-ghost btn--sm q-ai-btn" style="font-size:0.75rem; padding:0.3rem 0.7rem;">
-                     bg-brand-50 hover:bg-brand-100 text-brand-700">
+        <span class="material-symbols-outlined q-ai-icon" style="font-size:0.9rem; vertical-align:-2px;">auto_fix_high</span>
-        <span class="material-symbols-outlined text-base">auto_awesome</span>
+        <span class="q-ai-label">Сгенерировать</span>
-        AI: вопрос/переформулировать
       </button>
     </div>
 
-    <ul class="q-options mt-3 space-y-2"></ul>
+    <p class="mt-4 mb-2 text-xs text-ink-400 font-medium">Отметьте правильные варианты</p>
-    <div class="mt-2">
+    <ul class="q-options space-y-2"></ul>
-      <button class="q-add-option inline-flex items-center gap-1 text-sm text-brand-700 hover:underline">
+    <div class="mt-3 flex items-center gap-3">
-        <span class="material-symbols-outlined text-base">add</span> Добавить вариант
+      <button class="q-add-option inline-flex items-center gap-1 px-2 py-2 rounded
+                     text-sm text-brand-700 hover:bg-brand-50 min-h-10 btn btn-ghost btn--sm">
+        <span class="material-symbols-outlined text-base">add</span>
+        <span class="q-add-option-label">Добавить вариант</span>
       </button>
+      <span class="q-options-count text-xs text-ink-400"></span>
+    </div>
+
+    <div class="mt-4 pt-3 border-t border-ink-200/80 q-hint-block">
+      <label class="block">
+        <span class="text-xs text-ink-600 font-medium mb-1 block">Подсказка при прохождении</span>
+        <textarea class="q-hint form-input w-full rounded-lg border border-ink-300 px-3 py-2 text-sm
+                             focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20"
+                  rows="2" maxlength="8000"
+                  placeholder="Краткий текст подсказки (если в параметрах теста включены подсказки и режим «Сразу после ответа»)"
+                  style="resize:none; overflow:hidden; font-family:inherit;"></textarea>
+      </label>
+      <p class="mt-1.5 text-xs text-ink-400 leading-snug">Необязательно. Показывается участнику во всплывающем окне после ответа на вопрос.</p>
     </div>
   </li>
 </template>
 
-<!-- Модалка результата AI-проверки/улучшения -->
+{# ── Шаблон варианта ────────────────────────────────────────────── #}
-<dialog id="ai-modal" class="rounded-2xl p-0 max-w-3xl w-full backdrop:bg-black/40">
-  <div class="p-5">
-    <div class="flex items-center justify-between gap-3">
-      <h3 id="ai-modal-title" class="text-lg font-semibold">AI</h3>
-      <button id="ai-modal-close" class="p-1 rounded hover:bg-ink-100">
-        <span class="material-symbols-outlined">close</span>
-      </button>
-    </div>
-    <div id="ai-modal-body" class="mt-3 max-h-[70vh] overflow-y-auto"></div>
-    <div id="ai-modal-actions" class="mt-4 flex items-center justify-end gap-2"></div>
-  </div>
-</dialog>
-
 <template id="tpl-option">
-  <li class="flex items-center gap-2 opt-item">
+  <li class="flex items-start gap-2 opt-item">
-    <input type="checkbox" class="opt-correct rounded border-ink-300 text-brand-600 focus:ring-brand-500" />
+    {# Чекбокс «Правильный» — выровнен по первой строке textarea #}
-    <input type="text" class="opt-text flex-1 rounded-lg border border-ink-300 px-3 py-1.5
+    <label class="shrink-0 w-10 inline-flex items-center justify-center cursor-pointer
-                              focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20"
+                  rounded hover:bg-ink-100 pt-1.5" style="min-height:2.5rem;" title="Правильный ответ">
-           placeholder="Вариант ответа" />
+      <input type="checkbox"
-    <button class="opt-delete p-1 rounded hover:bg-red-50 text-red-600" title="Удалить">
+             class="opt-correct w-5 h-5 rounded border-ink-300 text-brand-600 focus:ring-brand-500" />
+    </label>
+    <div class="opt-text-wrap relative flex-1 min-w-0 self-start">
+      <textarea rows="1"
+                class="opt-text w-full rounded-lg border border-ink-300 px-3 py-2
+                       focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20"
+                placeholder="Вариант ответа"
+                style="resize:none; overflow:hidden; font-family:inherit; line-height:1.55;"></textarea>
+      <div class="opt-ai-overlay hidden absolute inset-0 rounded-lg z-[5]
+                  bg-white/85 backdrop-blur-[2px] flex flex-col items-center justify-center gap-1
+                  border border-ink-200/80 shadow-sm">
+        <span class="inline-block w-6 h-6 rounded-full
+                     border-[3px] border-brand-200 border-t-brand-600 animate-spin"></span>
+        <span class="text-xs text-ink-600 font-medium px-2 text-center leading-snug">Улучшаю…</span>
+      </div>
+    </div>
+    <button type="button" class="opt-ai shrink-0 inline-flex items-center justify-center
+                   rounded hover:bg-brand-50 text-brand-700 px-1.5 pt-1.5"
+            style="min-height:2.5rem; min-width:2.25rem;"
+            title="Улучшить только этот вариант (ИИ)" aria-label="Улучшить вариант ИИ">
+      <span class="material-symbols-outlined text-base">auto_fix_high</span>
+    </button>
+    <button class="opt-delete shrink-0 w-10 inline-flex items-center justify-center
+                   rounded hover:bg-red-50 text-red-600 pt-1.5"
+            style="min-height:2.5rem;"
+            title="Удалить" aria-label="Удалить вариант">
       <span class="material-symbols-outlined text-base">close</span>
     </button>
   </li>
 </template>
+
+{# ── Модалка успешного сохранения (компактная, сверху) ──────────── #}
+<dialog id="save-modal" class="save-modal">
+  <div class="save-modal__inner">
+    <h3 class="text-base font-semibold mb-1" id="save-modal-title">Сохранено</h3>
+    <p id="save-modal-msg" class="text-sm text-ink-700">Изменения сохранены.</p>
+    <div class="mt-4 flex items-center justify-end gap-2">
+      <button id="save-modal-stay" type="button"
+              class="px-3 py-2 rounded-lg bg-ink-100 hover:bg-ink-200 text-sm btn btn-ghost">
+        К редактору
+      </button>
+      <button id="save-modal-go" type="button"
+              class="px-3 py-2 rounded-lg bg-brand-600 hover:bg-brand-700 text-white text-sm btn btn-primary">
+        К каталогу
+      </button>
+    </div>
+  </div>
+</dialog>
+
+{# ── Выбор режима ИИ для непустого вопроса (улучшить / дистракторы) ── #}
+<dialog id="dlg-q-ai-mode" class="save-modal" style="max-width: 24rem; width: calc(100% - 2rem);">
+  <div class="save-modal__inner">
+    <h3 class="text-base font-semibold text-ink-900 mb-1">Что сделать с вопросом?</h3>
+    <p class="text-xs text-ink-500 mb-3">Выберите, что должен сделать ИИ.</p>
+    <div class="flex flex-col gap-2">
+      <button type="button" id="q-ai-mode-distractors"
+              class="px-3 py-2.5 rounded-lg border border-ink-200 text-left text-sm
+                     hover:bg-brand-50 hover:border-brand-200 transition-colors">
+        <span class="font-medium text-ink-800">Добавить дистракторы</span>
+        <span class="block text-ink-500 text-xs mt-0.5">Заполнить пустые поля вариантов</span>
+      </button>
+      <button type="button" id="q-ai-mode-question"
+              class="px-3 py-2.5 rounded-lg border border-ink-200 text-left text-sm
+                     hover:bg-brand-50 hover:border-brand-200 transition-colors">
+        <span class="font-medium text-ink-800">Улучшить только вопрос</span>
+        <span class="block text-ink-500 text-xs mt-0.5">Переформулировать текст вопроса</span>
+      </button>
+      <button type="button" id="q-ai-mode-options"
+              class="px-3 py-2.5 rounded-lg border border-ink-200 text-left text-sm
+                     hover:bg-brand-50 hover:border-brand-200 transition-colors">
+        <span class="font-medium text-ink-800">Улучшить только варианты</span>
+        <span class="block text-ink-500 text-xs mt-0.5">Тексты ответов, без смены верности</span>
+      </button>
+    </div>
+    <div class="mt-4 flex justify-end">
+      <button type="button" id="q-ai-mode-cancel"
+              class="px-3 py-2 rounded-lg text-ink-600 hover:bg-ink-100 text-sm">
+        Отмена
+      </button>
+    </div>
+  </div>
+</dialog>
+
+{# ── Модалка результата AI-проверки/улучшения (fullscreen на мобиле) ── #}
+<dialog id="ai-modal"
+        class="m-0 p-0 w-full h-full sm:h-auto sm:max-w-3xl sm:w-full sm:max-h-[90vh]
+               sm:rounded-2xl sm:m-auto bg-white backdrop:bg-black/50">
+  <div class="flex flex-col h-full sm:max-h-[90vh]">
+    <div class="flex items-center justify-between gap-3 px-4 sm:px-5 py-3 border-b border-ink-300/60">
+      <h3 id="ai-modal-title" class="text-lg font-semibold truncate">AI</h3>
+      <button id="ai-modal-close"
+              class="p-2 rounded hover:bg-ink-100 min-w-10 min-h-10"
+              aria-label="Закрыть">
+        <span class="material-symbols-outlined">close</span>
+      </button>
+    </div>
+    <div id="ai-modal-body" class="flex-1 overflow-y-auto px-4 sm:px-5 py-4"></div>
+    <div id="ai-modal-actions"
+         class="px-4 sm:px-5 py-3 border-t border-ink-300/60
+                flex items-center justify-end gap-2 flex-wrap
+                pb-[max(env(safe-area-inset-bottom),0.75rem)]"></div>
+  </div>
+</dialog>
 {% endblock %}
 
 {% block scripts %}

flask_app/app/templates/tests/list.html

@@ -1,75 +1,125 @@
 {% extends "base.html" %}
 {% block title %}Тесты — каталог{% endblock %}
 
+{% macro catalog_test_params_line(t) -%}
+{%- set tl = t.time_limit -%}
+{%- set timestr = 'без ограничения' if tl is none or tl == 0 else (tl|string ~ ' мин') -%}
+{%- set rm = t.result_mode or 'end' -%}
+{%- set res = 'сразу' if rm == 'immediate' else 'в конце' -%}
+{%- if rm != 'immediate' -%}
+  {%- set hint = 'недоступны' -%}
+{%- elif t.hints_enabled -%}
+  {%- set hint = 'вкл' -%}
+{%- else -%}
+  {%- set hint = 'выкл' -%}
+{%- endif -%}
+Порог: {{ t.passing_threshold }}% · Вопросов: {{ t.questions_count }} · Время: {{ timestr }} · Результат: {{ res }} · Подсказки: {{ hint }}
+{%- endmacro %}
+
 {% block content %}
-<section class="rounded-2xl bg-white shadow-sm border border-ink-300/60 p-6">
+  <section class="legacy-list-shell">
-  <div class="flex items-center justify-between gap-4 flex-wrap">
+    <h1 class="font-headline legacy-list-title">Тесты</h1>
-    <div>
+    <div class="legacy-list-toolbar legacy-list-toolbar--wrap flex flex-wrap items-center gap-3">
-      <h1 class="text-2xl font-semibold">Каталог тестов</h1>
+      <div class="flex flex-col sm:flex-row flex-1 min-w-0 gap-2 sm:gap-3">
-      <p class="mt-1 text-sm text-ink-500">Активные тесты, к которым у вас есть доступ.</p>
+        <label class="flex flex-col gap-1 flex-1 min-w-[12rem] max-w-md">
+          <span class="text-xs font-medium text-ink-600">Поиск по названию</span>
+          <input id="catalog-search" type="search" autocomplete="off" placeholder="Начните вводить…"
+                 class="rounded-lg border border-ink-300 px-3 py-2 text-sm w-full
+                        focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20" />
+        </label>
+        <label class="flex flex-col gap-1 w-full sm:w-52 shrink-0">
+          <span class="text-xs font-medium text-ink-600">Автор</span>
+          <select id="catalog-author"
+                  class="rounded-lg border border-ink-300 px-3 py-2 text-sm w-full bg-white
+                         focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20">
+            <option value="">Все авторы</option>
+          </select>
+        </label>
+      </div>
+      <button id="btn-create-test" class="btn btn-ghost shrink-0" type="button">
+        Создать
+      </button>
     </div>
-    <button id="btn-create-test"
+    <p id="catalog-filter-empty" class="text-sm text-ink-500 mt-2 hidden" role="status"></p>
-            class="inline-flex items-center gap-2 px-4 py-2 rounded-lg
-                   bg-brand-600 hover:bg-brand-700 text-white font-medium transition">
-      <span class="material-symbols-outlined text-base">add</span>
-      Создать тест
-    </button>
-  </div>
 
-  {% if visible %}
+    {% if visible %}
-    <ul class="mt-5 grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
+      <ul class="list-stack" aria-label="Тесты в общем списке">
-      {% for t in visible %}
+        {% for t in visible %}
-        <li class="rounded-xl border border-ink-300/60 hover:border-brand-300 hover:shadow-sm transition p-4 bg-white">
+          <li class="list-row list-row--split list-row--catalog"
-          <div class="flex items-start justify-between gap-2">
+              data-catalog-row
-            <h3 class="font-semibold text-ink-900 line-clamp-2">{{ t.title }}</h3>
+              data-title-lower="{{ (t.title or '')|lower }}"
-            <span class="text-xs text-ink-500 shrink-0">v{{ t.version }}</span>
+              data-author-id="{{ t.created_by or '' }}"
-          </div>
+              data-author-name="{{ (t.author_full_name or '—')|e }}">
-          {% if t.description %}
+            <div class="list-row__main">
-            <p class="mt-1 text-sm text-ink-500 line-clamp-3">{{ t.description }}</p>
+              <a href="{{ url_for('tests.tests_editor_page', test_id=t.id) }}" class="list-row__link">
-          {% endif %}
+                <span class="list-row__title">{{ t.title }}</span>
-          <p class="mt-2 text-xs text-ink-500">Автор: {{ t.author_full_name or '—' }}</p>
+                <span class="list-row__meta">
-          <div class="mt-3 flex items-center gap-2">
+                  {{ t.author_full_name or '—' }}
-            <a href="{{ url_for('tests.tests_editor_page', test_id=t.id) }}"
+                  <span class="list-row__meta-tail"> · Версия {{ t.version }}</span>
-               class="inline-flex items-center gap-1 text-sm text-brand-700 hover:underline">
+                </span>
-              <span class="material-symbols-outlined text-base">edit_note</span>
+                <span class="list-row__params muted" style="display:block;font-size:0.78rem;margin-top:0.2rem;line-height:1.35;">{{ catalog_test_params_line(t) }}</span>
-              Открыть редактор
+              </a>
-            </a>
+            </div>
-          </div>
+            <div class="list-row__side">
-        </li>
+              <button type="button" class="btn btn-ghost btn-start-pass" data-test-id="{{ t.id }}">
-      {% endfor %}
+                {{ 'Продолжить' if t.has_in_progress_attempt else 'Пройти' }}
-    </ul>
+              </button>
-  {% else %}
+            </div>
-    <p class="mt-5 text-ink-500 text-sm">Доступных тестов пока нет.</p>
-  {% endif %}
-
-  {% if hidden %}
-    <details class="mt-6 rounded-xl border border-ink-300/60 bg-ink-100/50 p-4">
-      <summary class="cursor-pointer font-medium text-ink-700">
-        Скрытые вами цепочки ({{ hidden|length }})
-      </summary>
-      <ul class="mt-3 space-y-2">
-        {% for t in hidden %}
-          <li class="flex items-center justify-between gap-2 text-sm">
-            <span>{{ t.title }} <span class="text-ink-500">· v{{ t.version }}</span></span>
-            <a href="{{ url_for('tests.tests_editor_page', test_id=t.id) }}"
-               class="text-brand-700 hover:underline">Открыть</a>
           </li>
         {% endfor %}
       </ul>
-    </details>
+    {% else %}
-  {% endif %}
+      <p class="text-muted">Нет тестов</p>
-</section>
+    {% endif %}
 
-<dialog id="dlg-create" class="rounded-2xl p-0 backdrop:bg-ink-900/40 max-w-md w-full">
+    {% if hidden %}
-  <form method="dialog" class="bg-white rounded-2xl">
+      <h2 class="font-headline legacy-list-subtitle">Скрытые вами из списка</h2>
-    <div class="p-5 border-b border-ink-300/60">
+      <ul class="list-stack" aria-label="Скрытые тесты автора">
+        {% for t in hidden %}
+          <li class="list-row list-row--split list-row--hidden list-row--catalog"
+              data-catalog-row
+              data-title-lower="{{ (t.title or '')|lower }}"
+              data-author-id="{{ t.created_by or '' }}"
+              data-author-name="{{ (t.author_full_name or '—')|e }}">
+            <div class="list-row__main">
+              <a href="{{ url_for('tests.tests_editor_page', test_id=t.id) }}" class="list-row__link">
+                <span class="list-row__title">{{ t.title }}</span>
+                <span class="list-row__meta">
+                  {{ t.author_full_name or '—' }}
+                  <span class="list-row__meta-tail"> · Версия {{ t.version }} · скрыт</span>
+                </span>
+                <span class="list-row__params muted" style="display:block;font-size:0.78rem;margin-top:0.2rem;line-height:1.35;">{{ catalog_test_params_line(t) }}</span>
+              </a>
+            </div>
+            <div class="list-row__side">
+              <button type="button" class="btn btn-ghost btn-start-pass" data-test-id="{{ t.id }}">
+                {{ 'Продолжить' if t.has_in_progress_attempt else 'Пройти' }}
+              </button>
+            </div>
+          </li>
+        {% endfor %}
+      </ul>
+    {% endif %}
+  </section>
+
+<dialog id="dlg-create"
+class="m-0 p-0 w-full sm:w-full sm:max-w-md
+      h-fit max-h-[calc(100vh-2rem)]
+      rounded-2xl bg-white backdrop:bg-ink-900/50 m-auto">
+  <form method="dialog" class="flex flex-col sm:h-auto bg-white sm:rounded-2xl">
+    <div class="px-4 sm:px-5 py-3 border-b border-ink-300/60 flex items-center justify-between">
       <h2 class="text-lg font-semibold">Новый тест</h2>
+      <button type="button" id="dlg-cancel-x"
+              class="p-2 rounded hover:bg-ink-100 min-w-10 min-h-10"
+              aria-label="Закрыть">
+        <span class="material-symbols-outlined">close</span>
+      </button>
     </div>
-    <div class="p-5 space-y-3">
+    <div class="flex-1 overflow-y-auto px-4 sm:px-5 py-4 space-y-3">
       <label class="block">
         <span class="text-sm font-medium text-ink-700">Название</span>
         <input id="new-test-title" type="text" required maxlength="200"
-               class="mt-1 w-full rounded-lg border border-ink-300 px-3 py-2
+               class="mt-1 w-full rounded-lg border border-ink-300 px-3 py-3
                       focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20" />
       </label>
       <label class="block">
@@ -79,11 +129,13 @@
                          focus:border-brand-500 focus:ring-2 focus:ring-brand-500/20"></textarea>
       </label>
     </div>
-    <div class="p-4 border-t border-ink-300/60 flex justify-end gap-2 bg-ink-100/40 rounded-b-2xl">
+    <div class="px-4 sm:px-5 py-3 border-t border-ink-300/60 flex justify-end gap-2
+                bg-ink-100/40 sm:rounded-b-2xl
+                pb-[max(env(safe-area-inset-bottom),0.75rem)]">
       <button type="button" id="dlg-cancel"
-              class="px-4 py-2 rounded-lg text-ink-700 hover:bg-ink-100">Отмена</button>
+              class="px-4 py-2.5 rounded-lg text-ink-700 hover:bg-ink-100 min-h-11">Отмена</button>
       <button type="button" id="dlg-submit"
-              class="px-4 py-2 rounded-lg bg-brand-600 hover:bg-brand-700 text-white">
+              class="px-4 py-2.5 rounded-lg bg-brand-600 hover:bg-brand-700 text-white min-h-11">
         Создать
       </button>
     </div>
@@ -97,6 +149,58 @@
   const dlg = document.getElementById('dlg-create');
   const titleEl = document.getElementById('new-test-title');
   const descEl = document.getElementById('new-test-desc');
+  const catalogSearch = document.getElementById('catalog-search');
+  const catalogAuthor = document.getElementById('catalog-author');
+  const catalogEmpty = document.getElementById('catalog-filter-empty');
+
+  (function initCatalogFilter() {
+    if (!catalogSearch || !catalogAuthor) return;
+    const rows = Array.from(document.querySelectorAll('[data-catalog-row]'));
+    const byAuthor = new Map();
+    rows.forEach((row) => {
+      const id = (row.dataset.authorId || '').trim();
+      const name = (row.dataset.authorName || '').trim() || '—';
+      if (id && !byAuthor.has(id)) byAuthor.set(id, name);
+    });
+    const sorted = Array.from(byAuthor.entries()).sort((a, b) => a[1].localeCompare(b[1], 'ru'));
+    sorted.forEach(([id, name]) => {
+      const opt = document.createElement('option');
+      opt.value = id;
+      opt.textContent = name;
+      catalogAuthor.appendChild(opt);
+    });
+
+    function applyFilter() {
+      const q = (catalogSearch.value || '').trim().toLowerCase();
+      const author = (catalogAuthor.value || '').trim();
+      let visibleCount = 0;
+      rows.forEach((row) => {
+        const title = row.dataset.titleLower || '';
+        const aid = (row.dataset.authorId || '').trim();
+        const matchQ = !q || title.includes(q);
+        const matchA = !author || aid === author;
+        const show = matchQ && matchA;
+        row.style.display = show ? '' : 'none';
+        if (show) visibleCount += 1;
+      });
+      if (catalogEmpty) {
+        if (rows.length && visibleCount === 0) {
+          catalogEmpty.textContent = 'Ничего не найдено — измените запрос или фильтр.';
+          catalogEmpty.classList.remove('hidden');
+        } else {
+          catalogEmpty.textContent = '';
+          catalogEmpty.classList.add('hidden');
+        }
+      }
+    }
+
+    let t = null;
+    catalogSearch.addEventListener('input', () => {
+      clearTimeout(t);
+      t = setTimeout(applyFilter, 120);
+    });
+    catalogAuthor.addEventListener('change', applyFilter);
+  })();
 
   document.getElementById('btn-create-test').addEventListener('click', () => {
     titleEl.value = '';
@@ -106,6 +210,7 @@
     setTimeout(() => titleEl.focus(), 50);
   });
   document.getElementById('dlg-cancel').addEventListener('click', () => dlg.close());
+  document.getElementById('dlg-cancel-x').addEventListener('click', () => dlg.close());
 
   document.getElementById('dlg-submit').addEventListener('click', async () => {
     const title = titleEl.value.trim();
@@ -123,6 +228,36 @@
       alert(e.message || 'Не удалось создать тест.');
     }
   });
+
+  const passButtons = Array.from(document.querySelectorAll('.btn-start-pass'));
+  passButtons.forEach((btn) => {
+    btn.addEventListener('click', async () => {
+      const testId = btn.dataset.testId;
+      if (!testId) return;
+      btn.disabled = true;
+      const oldText = (btn.textContent || '').trim() || 'Пройти';
+      btn.textContent = `${oldText}…`;
+      try {
+        const r = await fetch(`/api/tests/${testId}/attempts/start`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({}),
+        });
+        let data = {};
+        try { data = await r.json(); } catch (_) {}
+        if (!r.ok || !data.attempt || !data.attempt.id) {
+          // Если нет страницы попытки, уводим в редактор.
+          // Тогда ведём в карточку теста, чтобы пользователь не попадал на not_found.
+          window.location.href = `/tests/${testId}/edit`;
+          return;
+        }
+        window.location.href = `/tests/${testId}/attempt/${data.attempt.id}`;
+      } catch (e) {
+        window.location.href = `/tests/${testId}/edit`;
+        return;
+      }
+    });
+  });
 })();
 </script>
 {% endblock %}

flask_app/app/tests/routes.py

@@ -19,19 +19,23 @@ UI-страницы:
 from __future__ import annotations
 
 import logging
+import uuid as _uuid
 
 from flask import Blueprint, jsonify, render_template, request
-from sqlalchemy import text
+from sqlalchemy import func
+from sqlalchemy.orm import selectinload
 
 from ..auth.decorators import current_user, login_required
-from ..db import get_engine
+from ..db import get_session
 from ..messages import RU
+from ..models import Test, TestVersion, User
 from ..services.ai_editor import (
     HttpError as AiHttpError,
     check_test_quality,
     generate_full_test_by_shape,
     generate_or_rephrase_question,
     generate_test_by_title,
+    improve_single_option_text,
     improve_test_full,
     parse_and_validate_shape,
 )
@@ -42,7 +46,25 @@ from ..services.document_extract import (
 from ..services.document_gen import generation_for_import_document
 from ..services.draft_validator import LlmError
 from ..services.editor_content import HttpError as EditorHttpError, get_editor_content
-from ..services.test_access import is_test_author, list_hidden_by_author, list_visible_tests
+from ..services.test_attempt import (
+    HttpError as AttemptHttpError,
+    check_question_for_attempt,
+    count_missing_hints,
+    generate_missing_hints_for_test,
+    generate_next_missing_hint_for_test,
+    get_attempt_review_for_user,
+    get_play_content,
+    list_test_attempts_for_author,
+    start_attempt,
+    submit_attempt,
+)
+from ..services.test_access import (
+    is_test_author,
+    is_test_edit_open,
+    list_hidden_by_author,
+    list_visible_tests,
+    user_has_test_access,
+)
 from ..services.test_chain import has_any_attempt_for_test
 from ..services.test_draft import (
     HttpError as DraftHttpError,
@@ -55,10 +77,9 @@ log = logging.getLogger(__name__)
 tests_bp = Blueprint('tests', __name__)
 
 
-# ─── helpers ─────────────────────────────────────────────────────────
+# ─── helpers ─────────────────────────────────────────────────────────────────
 
 def _stringify_uuids(d: dict) -> dict:
-    """Преобразует UUID-поля в строки для безопасной JSON-сериализации."""
     out = {}
     for k, v in d.items():
         if hasattr(v, 'hex') and not isinstance(v, (str, bytes)):
@@ -68,26 +89,29 @@ def _stringify_uuids(d: dict) -> dict:
     return out
 
 
-def _check_test_author_or_404(test_id: str, user_id: str) -> dict:
+def _to_uuid(val) -> _uuid.UUID | None:
-    """Загружает {id, created_by}; 404 если нет, 403 если не автор."""
+    if isinstance(val, _uuid.UUID):
-    eng = get_engine()
+        return val
-    with eng.connect() as conn:
+    try:
-        row = conn.execute(
+        return _uuid.UUID(str(val))
-            text('SELECT id, created_by FROM tests WHERE id = :id'),
+    except (ValueError, AttributeError):
-            {'id': test_id},
+        return None
-        ).mappings().first()
+
-    if not row:
+
+def _check_test_author_or_404(test_id: str, user_id: str) -> Test:
+    session = get_session()
+    tid = _to_uuid(test_id)
+    test = session.get(Test, tid) if tid else None
+    if not test:
         from werkzeug.exceptions import NotFound
-
         raise NotFound(RU['notFound'])
-    if not is_test_author(row['created_by'], user_id):
+    if not is_test_author(test.created_by, user_id) and not is_test_edit_open():
         from werkzeug.exceptions import Forbidden
-
         raise Forbidden('Доступ запрещён.')
-    return dict(row)
+    return test
 
 
-# ─── JSON API ────────────────────────────────────────────────────────
+# ─── JSON API ────────────────────────────────────────────────────────────────
 
 @tests_bp.route('/api/tests/', methods=['GET'])
 @tests_bp.route('/api/tests', methods=['GET'])
@@ -119,53 +143,50 @@ def api_create_test():
 @login_required
 def api_test_summary(test_id):
     user = current_user()
-    eng = get_engine()
+    session = get_session()
-    with eng.connect() as conn:
+    tid = _to_uuid(test_id)
-        row = conn.execute(
+    if not tid:
-            text(
-                """
-                SELECT t.id, t.title, t.description, t.passing_threshold, t.is_active AS chain_active,
-                       t.created_by, t.created_at, t.updated_at,
-                       tv.id AS active_version_id, tv.version,
-                       u.full_name AS author_full_name
-                  FROM tests t
-                  LEFT JOIN test_versions tv ON tv.test_id = t.id AND tv.is_active = true
-                  LEFT JOIN users u ON u.id = t.created_by
-                 WHERE t.id = :id
-                """
-            ),
-            {'id': test_id},
-        ).mappings().first()
-    if not row:
         return jsonify(error=RU['notFound']), 404
 
-    is_author = is_test_author(row['created_by'], user.id)
+    test = (
-    if not row['chain_active'] and not is_author:
+        session.query(Test)
+        .options(selectinload(Test.author), selectinload(Test.versions))
+        .filter(Test.id == tid)
+        .first()
+    )
+    if not test:
         return jsonify(error=RU['notFound']), 404
 
-    if not is_author:
+    is_author = is_test_author(test.created_by, user.id)
-        from ..services.test_access import user_has_test_access
+    open_edit = is_test_edit_open()
+    if not test.is_active and not is_author and not open_edit:
+        return jsonify(error=RU['notFound']), 404
 
+    if not is_author and not open_edit:
         acc = user_has_test_access(user.id, test_id)
         if not acc.ok:
             return jsonify(error=RU['notFound']), 404
 
+    active_version = next((v for v in test.versions if v.is_active), None)
+    has_attempts = has_any_attempt_for_test(session, tid)
+
     return jsonify(
         test={
-            'id': str(row['id']),
+            'id': str(test.id),
-            'title': row['title'],
+            'title': test.title,
-            'description': row['description'],
+            'description': test.description,
-            'passingThreshold': row['passing_threshold'],
+            'passingThreshold': test.passing_threshold,
-            'chainActive': row['chain_active'],
+            'chainActive': test.is_active,
-            'activeVersionId': str(row['active_version_id']) if row['active_version_id'] else None,
+            'activeVersionId': str(active_version.id) if active_version else None,
-            'version': row['version'],
+            'version': active_version.version if active_version else None,
-            'createdAt': row['created_at'].isoformat() if row['created_at'] else None,
+            'createdAt': test.created_at.isoformat() if test.created_at else None,
-            'updatedAt': row['updated_at'].isoformat() if row['updated_at'] else None,
+            'updatedAt': test.updated_at.isoformat() if test.updated_at else None,
-            'createdBy': str(row['created_by']) if row['created_by'] else None,
+            'createdBy': str(test.created_by) if test.created_by else None,
-            'authorFullName': row['author_full_name'],
+            'authorFullName': test.author.full_name if test.author else None,
+            'hasAttempts': bool(has_attempts),
         },
         isAuthor=is_author,
-        hasActiveVersion=row['active_version_id'] is not None,
+        hasActiveVersion=active_version is not None,
     )
 
 
@@ -173,54 +194,45 @@ def api_test_summary(test_id):
 @login_required
 def api_test_versions(test_id):
     user = current_user()
-    eng = get_engine()
+    session = get_session()
-    with eng.connect() as conn:
+    tid = _to_uuid(test_id)
-        t = conn.execute(
+    if not tid:
-            text(
+        return jsonify(error=RU['notFound']), 404
-                """
-                SELECT t.id, t.title, t.created_by, t.is_active, t.created_at, t.updated_at,
-                       t.description, u.full_name AS author_full_name
-                  FROM tests t
-                  INNER JOIN users u ON u.id = t.created_by
-                 WHERE t.id = :id
-                """
-            ),
-            {'id': test_id},
-        ).mappings().first()
-        if not t:
-            return jsonify(error=RU['notFound']), 404
-        if not is_test_author(t['created_by'], user.id):
-            return jsonify(error='Доступ запрещён.'), 403
 
-        rows = conn.execute(
+    test = (
-            text(
+        session.query(Test)
-                'SELECT id, version, is_active, parent_id, created_at '
+        .options(selectinload(Test.author), selectinload(Test.versions))
-                'FROM test_versions WHERE test_id = :id ORDER BY version'
+        .filter(Test.id == tid)
-            ),
+        .first()
-            {'id': test_id},
+    )
-        ).mappings().all()
+    if not test:
-        has_attempts = has_any_attempt_for_test(conn, test_id)
+        return jsonify(error=RU['notFound']), 404
+    if not is_test_author(test.created_by, user.id) and not is_test_edit_open():
+        return jsonify(error='Доступ запрещён.'), 403
+
+    has_attempts = has_any_attempt_for_test(session, tid)
+    sorted_versions = sorted(test.versions, key=lambda v: v.version)
 
     return jsonify(
         test={
-            'id': str(t['id']),
+            'id': str(test.id),
-            'title': t['title'],
+            'title': test.title,
-            'description': t['description'],
+            'description': test.description,
-            'chainActive': t['is_active'],
+            'chainActive': test.is_active,
-            'createdAt': t['created_at'].isoformat() if t['created_at'] else None,
+            'createdAt': test.created_at.isoformat() if test.created_at else None,
-            'updatedAt': t['updated_at'].isoformat() if t['updated_at'] else None,
+            'updatedAt': test.updated_at.isoformat() if test.updated_at else None,
-            'createdBy': str(t['created_by']) if t['created_by'] else None,
+            'createdBy': str(test.created_by) if test.created_by else None,
-            'authorFullName': t['author_full_name'],
+            'authorFullName': test.author.full_name if test.author else None,
         },
         versions=[
             {
-                'id': str(r['id']),
+                'id': str(v.id),
-                'version': r['version'],
+                'version': v.version,
-                'is_active': r['is_active'],
+                'is_active': v.is_active,
-                'parent_id': str(r['parent_id']) if r['parent_id'] else None,
+                'parent_id': str(v.parent_id) if v.parent_id else None,
-                'created_at': r['created_at'].isoformat() if r['created_at'] else None,
+                'created_at': v.created_at.isoformat() if v.created_at else None,
             }
-            for r in rows
+            for v in sorted_versions
         ],
         hasAttempts=has_attempts,
     )
@@ -254,22 +266,22 @@ def api_save_draft(test_id):
 def api_activate_version(test_id, version_id):
     user = current_user()
     _check_test_author_or_404(test_id, user.id)
-    eng = get_engine()
+
-    with eng.begin() as conn:
+    session = get_session()
-        v = conn.execute(
+    tid = _to_uuid(test_id)
-            text('SELECT id FROM test_versions WHERE test_id = :t AND id = :v'),
+    vid = _to_uuid(version_id)
-            {'t': test_id, 'v': version_id},
+
-        ).first()
+    version = session.query(TestVersion).filter(
-        if not v:
+        TestVersion.test_id == tid, TestVersion.id == vid
-            return jsonify(error='Версия не найдена.'), 404
+    ).first()
-        conn.execute(
+    if not version:
-            text('UPDATE test_versions SET is_active = false WHERE test_id = :t'),
+        return jsonify(error='Версия не найдена.'), 404
-            {'t': test_id},
+
-        )
+    session.query(TestVersion).filter(TestVersion.test_id == tid).update(
-        conn.execute(
+        {TestVersion.is_active: False}, synchronize_session='fetch'
-            text('UPDATE test_versions SET is_active = true WHERE id = :v'),
+    )
-            {'v': version_id},
+    version.is_active = True
-        )
+    session.commit()
     return jsonify(ok=True, activeVersionId=str(version_id))
 
 
@@ -281,19 +293,135 @@ def api_patch_test(test_id):
     chain = body.get('chainActive', body.get('isActive'))
     if not isinstance(chain, bool):
         return jsonify(error='Передайте chainActive: true/false в теле запроса.'), 400
-    _check_test_author_or_404(test_id, user.id)
+    test = _check_test_author_or_404(test_id, user.id)
-    eng = get_engine()
+    session = get_session()
-    with eng.begin() as conn:
+    test.is_active = chain
-        conn.execute(
+    session.commit()
-            text(
-                'UPDATE tests SET is_active = :v, updated_at = CURRENT_TIMESTAMP WHERE id = :id'
-            ),
-            {'v': chain, 'id': test_id},
-        )
     return jsonify(id=test_id, chainActive=chain)
 
 
-# ─── AI ──────────────────────────────────────────────────────────────
+@tests_bp.route('/api/tests/<test_id>/attempts/start', methods=['POST'])
+@login_required
+def api_start_attempt(test_id):
+    user = current_user()
+    try:
+        out = start_attempt(None, user.id, test_id)
+    except AttemptHttpError as e:
+        return jsonify(error=e.message), e.status
+    return jsonify(out), 201
+
+
+@tests_bp.route('/api/tests/<test_id>/attempts/<attempt_id>/play', methods=['GET'])
+@login_required
+def api_attempt_play(test_id, attempt_id):
+    user = current_user()
+    try:
+        out = get_play_content(None, user.id, test_id, attempt_id)
+    except AttemptHttpError as e:
+        return jsonify(error=e.message), e.status
+    return jsonify(out)
+
+
+@tests_bp.route('/api/tests/<test_id>/attempts/<attempt_id>/submit', methods=['POST'])
+@login_required
+def api_attempt_submit(test_id, attempt_id):
+    user = current_user()
+    body = request.get_json(silent=True) or {}
+    try:
+        out = submit_attempt(None, user.id, test_id, attempt_id, body.get('answers'))
+    except AttemptHttpError as e:
+        return jsonify(error=e.message), e.status
+    return jsonify(out)
+
+
+@tests_bp.route('/api/tests/<test_id>/ai/hints/status', methods=['GET'])
+@login_required
+def api_test_hints_status(test_id):
+    out = count_missing_hints(None, test_id)
+    return jsonify(out)
+
+
+@tests_bp.route('/api/tests/<test_id>/ai/hints/generate', methods=['POST'])
+@login_required
+def api_test_hints_generate(test_id):
+    user = current_user()
+    try:
+        out = generate_missing_hints_for_test(None, user.id, test_id)
+    except AttemptHttpError as e:
+        return jsonify(error=e.message), e.status
+    return jsonify(out)
+
+
+@tests_bp.route('/api/tests/<test_id>/ai/hints/generate-next', methods=['POST'])
+@login_required
+def api_test_hints_generate_next(test_id):
+    user = current_user()
+    try:
+        out = generate_next_missing_hint_for_test(None, user.id, test_id)
+    except AttemptHttpError as e:
+        return jsonify(error=e.message), e.status
+    return jsonify(out)
+
+
+@tests_bp.route('/api/tests/<test_id>/attempts/<attempt_id>/check', methods=['POST'])
+@login_required
+def api_attempt_check_question(test_id, attempt_id):
+    user = current_user()
+    body = request.get_json(silent=True) or {}
+    qid = body.get('questionId')
+    sel = body.get('selectedOptionIds') or []
+    if not qid:
+        return jsonify(error='questionId обязателен.'), 400
+    if not isinstance(sel, list):
+        return jsonify(error='selectedOptionIds должен быть массивом.'), 400
+    try:
+        out = check_question_for_attempt(None, user.id, test_id, attempt_id, qid, sel)
+    except AttemptHttpError as e:
+        return jsonify(error=e.message), e.status
+    return jsonify(out)
+
+
+@tests_bp.route('/api/tests/<test_id>/attempts/<attempt_id>/review', methods=['GET'])
+@login_required
+def api_attempt_review(test_id, attempt_id):
+    user = current_user()
+    try:
+        out = get_attempt_review_for_user(None, user.id, test_id, attempt_id)
+    except AttemptHttpError as e:
+        return jsonify(error=e.message), e.status
+    return jsonify(out)
+
+
+@tests_bp.route('/api/tests/<test_id>/attempts', methods=['GET'])
+@login_required
+def api_attempts_list(test_id):
+    user = current_user()
+    try:
+        rows = list_test_attempts_for_author(None, user.id, test_id)
+    except AttemptHttpError as e:
+        return jsonify(error=e.message), e.status
+    return jsonify(
+        attempts=[
+            {
+                'id': str(r['id']),
+                'userId': str(r['user_id']),
+                'status': r['status'],
+                'attemptNumber': r['attempt_number'],
+                'startedAt': r['started_at'].isoformat() if r['started_at'] else None,
+                'completedAt': r['completed_at'].isoformat() if r['completed_at'] else None,
+                'correctCount': r['correct_count'],
+                'totalQuestions': r['total_questions'],
+                'passed': r['passed'],
+                'testVersion': r['test_version'],
+                'attempterName': r['attempter_name'],
+                'attempterLogin': r['attempter_login'],
+            }
+            for r in rows
+        ]
+    )
+
+
+# ─── AI ──────────────────────────────────────────────────────────────────────
 
 @tests_bp.route('/api/tests/<test_id>/ai/generate-test', methods=['POST'])
 @login_required
@@ -326,16 +454,15 @@ def api_ai_generate_question(test_id):
             body.get('questionText') or '',
             body.get('optionsCount'),
             bool(body.get('hasMultipleAnswers')),
+            mode=body.get('mode'),
+            existing_options=body.get('existingOptions'),
         )
     except (AiHttpError, LlmError) as e:
         return _ai_error_response(e)
     return jsonify(ok=True, **out)
 
 
-# ─── AI v2 (E1.8) ────────────────────────────────────────────────────
-
 def _ai_error_response(e):
-    """Единый JSON-формат ошибки для AI-эндпоинтов."""
     if isinstance(e, AiHttpError):
         return jsonify(error=e.message), e.status
     if isinstance(e, LlmError):
@@ -397,45 +524,99 @@ def api_ai_improve_test(test_id):
             body.get('testTitle') or '',
             body.get('testDescription') or '',
             body.get('questions') or [],
+            focus=body.get('focus') or 'all',
         )
     except (AiHttpError, LlmError) as e:
         return _ai_error_response(e)
     return jsonify(ok=True, **out)
 
 
-# ─── Импорт документа (E1.3) ────────────────────────────────────────
+@tests_bp.route('/api/tests/<test_id>/ai/improve-option', methods=['POST'])
+@login_required
+def api_ai_improve_option(test_id):
+    user = current_user()
+    _check_test_author_or_404(test_id, user.id)
+    body = request.get_json(silent=True) or {}
+    try:
+        out = improve_single_option_text(
+            body.get('testTitle') or '',
+            body.get('testDescription') or '',
+            body.get('questionText') or '',
+            body.get('options') or [],
+            body.get('optionIndex'),
+        )
+    except (AiHttpError, LlmError) as e:
+        return _ai_error_response(e)
+    return jsonify(ok=True, **out)
+
+
+# ─── Импорт документа (E1.3) ─────────────────────────────────────────────────
 
 @tests_bp.route('/api/tests/import/document', methods=['POST'])
 @login_required
 def api_import_document():
-    """PDF/DOCX/TXT/MD → извлечённый текст + AI-черновик (если задан LLM-ключ).
+    """Шаг 1: загрузить один или несколько файлов и извлечь текст. Генерация — отдельным запросом."""
+    files = request.files.getlist('files')
+    if not files:
+        f = request.files.get('file')
+        files = [f] if f is not None and getattr(f, 'filename', None) else []
+    files = [x for x in files if x is not None and getattr(x, 'filename', None)]
+    if not files:
+        return jsonify(error='Прикрепите файл(ы) к полю file или files.'), 400
+    if len(files) > 5:
+        return jsonify(error='Не более 5 файлов за один раз.'), 400
 
-    Ограничения: размер файла — `MAX_CONTENT_LENGTH = 16 МБ` (см. фабрику).
+    parts: list[str] = []
-    """
+    names: list[str] = []
-    f = request.files.get('file')
+    mimes: list[str] = []
-    if f is None or not f.filename:
+    for f in files:
-        return jsonify(error='Прикрепите файл к полю file.'), 400
+        try:
-    try:
+            extracted = extract_text_from_file(f.mimetype, f, f.filename)
-        extracted = extract_text_from_file(f.mimetype, f, f.filename)
+        except DocExtractHttpError as e:
-    except DocExtractHttpError as e:
+            return jsonify(error=e.message), e.status
-        return jsonify(error=e.message), e.status
+        except Exception:
-    except Exception:
+            log.exception('extract_text_from_file failed')
-        log.exception('extract_text_from_file failed')
+            return jsonify(error='Не удалось разобрать файл.'), 500
-        return jsonify(error='Не удалось разобрать файл.'), 500
+        parts.append(extracted)
+        names.append(f.filename or '')
+        mimes.append(f.mimetype or '')
 
-    generation = generation_for_import_document(extracted)
+    combined = '\n\n---\n\n'.join(parts)
+    primary = files[0]
     return jsonify(
         received=True,
-        originalName=f.filename,
+        originalName=primary.filename,
-        mime=f.mimetype,
+        originalNames=names,
-        size=len(extracted.encode('utf-8')),
+        mime=primary.mimetype,
-        extractedText=extracted,
+        mimes=mimes,
-        textLength=len(extracted),
+        size=len(combined.encode('utf-8')),
-        generation=generation,
+        extractedText=combined,
+        textLength=len(combined),
+        fileCount=len(files),
     )
 
 
-# ─── UI (Jinja) ──────────────────────────────────────────────────────
+@tests_bp.route('/api/tests/generate-from-extracted', methods=['POST'])
+@login_required
+def api_generate_from_extracted():
+    """Шаг 2: сгенерировать черновик теста из ранее извлечённого текста + подсказки автора."""
+    body = request.get_json(silent=True) or {}
+    extracted = (body.get('extractedText') or '').strip()
+    user_hint = (body.get('userHint') or '').strip()
+    shape_raw = body.get('shape')
+    if not extracted:
+        return jsonify(error='Нет текста для генерации.'), 400
+    shape = None
+    if shape_raw:
+        try:
+            shape = parse_and_validate_shape(shape_raw)
+        except (AiHttpError, LlmError) as e:
+            return _ai_error_response(e)
+    generation = generation_for_import_document(extracted, user_hint=user_hint, shape=shape)
+    return jsonify(generation=generation)
+
+
+# ─── UI (Jinja) ───────────────────────────────────────────────────────────────
 
 @tests_bp.route('/tests', methods=['GET'])
 @login_required
@@ -463,3 +644,22 @@ def tests_editor_page(test_id):
             return ('Доступ запрещён.', 403)
         return render_template('500.html'), 500
     return render_template('tests/editor.html', content=content, test_id=test_id)
+
+
+@tests_bp.route('/tests/<test_id>/attempt/<attempt_id>', methods=['GET'])
+@login_required
+def tests_attempt_page(test_id, attempt_id):
+    return render_template('tests/attempt.html', test_id=test_id, attempt_id=attempt_id)
+
+
+@tests_bp.route('/tests/<test_id>/attempts/<attempt_id>/review', methods=['GET'])
+@login_required
+def tests_attempt_review_page(test_id, attempt_id):
+    user = current_user()
+    try:
+        review = get_attempt_review_for_user(None, user.id, test_id, attempt_id)
+    except AttemptHttpError as e:
+        if e.status == 404:
+            return render_template('404.html'), 404
+        return (e.message, e.status)
+    return render_template('tests/attempt_review.html', test_id=test_id, review=review)

flask_app/requirements.txt

@@ -6,6 +6,7 @@ waitress>=3.0.0
 # SQLAlchemy + psycopg2 драйвер для PostgreSQL.
 SQLAlchemy>=2.0.0,<3
 psycopg2-binary>=2.9.0,<3
+alembic>=1.13.0,<2
 
 # Этап 1 (E1.1): авторизация. bcrypt — для локальных хешей в clinic_tests.users.
 # Werkzeug-хеши (scrypt/pbkdf2) проверяет встроенный werkzeug.security.

flask_app/run.py

@@ -19,7 +19,7 @@ def _use_waitress() -> bool:
 
 
 if __name__ == '__main__':
-    port = int(os.environ.get('PORT', '3108'))
+    port = int(os.environ.get('PORT', '3107'))
     if _use_waitress():
         from waitress import serve
 

frontend/index.html

@@ -15,7 +15,7 @@
       href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200&display=swap"
       rel="stylesheet"
     />
-    <title>Система тестрования</title>
+    <title>Система тестирования</title>
   </head>
   <body>
     <div id="root"></div>

frontend/src/pages/TestDetail.jsx

@@ -1,4 +1,4 @@
-import { useEffect, useState } from 'react';
+import { useEffect, useMemo, useState } from 'react';
 import { useNavigate, useParams, Link, useOutletContext } from 'react-router-dom';
 import { api } from '../api';
 import { formatTestAuthorLabel } from '../utils/formatUserName';
@@ -70,6 +70,41 @@ function mapEditorToDraftQuestions(ed) {
   }));
 }
 
+function buildDraftSnapshot({ title, description, passing, questions }) {
+  return JSON.stringify({
+    title: title ?? '',
+    description: description ?? '',
+    passing: String(passing ?? ''),
+    questions: (questions || []).map((q) => ({
+      text: q.text ?? '',
+      hasMultipleAnswers: !!q.hasMultipleAnswers,
+      options: (q.options || []).map((o) => ({
+        text: o.text ?? '',
+        isCorrect: !!o.isCorrect,
+      })),
+    })),
+  });
+}
+
+function postDebugLog({ runId, hypothesisId, location, message, data }) {
+  fetch('http://127.0.0.1:7419/ingest/a86fc408-7178-4abe-8dd9-f3e6bfb05d76', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'X-Debug-Session-Id': '034e19',
+    },
+    body: JSON.stringify({
+      sessionId: '034e19',
+      runId,
+      hypothesisId,
+      location,
+      message,
+      data,
+      timestamp: Date.now(),
+    }),
+  }).catch(() => {});
+}
+
 export default function TestDetail() {
   const { id } = useParams();
   const nav = useNavigate();
@@ -83,6 +118,7 @@ export default function TestDetail() {
   const [draftDescription, setDraftDescription] = useState('');
   const [draftPassing, setDraftPassing] = useState('70');
   const [draftQuestions, setDraftQuestions] = useState(() => [createEmptyQuestion()]);
+  const [draftSnapshotOnLoad, setDraftSnapshotOnLoad] = useState(null);
   const [draftStatus, setDraftStatus] = useState('');
   const [deactivateBusy, setDeactivateBusy] = useState(false);
   const [importPreview, setImportPreview] = useState(null);
@@ -106,6 +142,16 @@ export default function TestDetail() {
   const [assignLoadBusy, setAssignLoadBusy] = useState(false);
   const [attemptsList, setAttemptsList] = useState(undefined);
   const [attemptsErr, setAttemptsErr] = useState(null);
+  const debugRunId = 'pre-fix';
+  // #region agent log
+  postDebugLog({
+    runId: debugRunId,
+    hypothesisId: 'H1',
+    location: 'frontend/src/pages/TestDetail.jsx:component-start',
+    message: 'TestDetail render start',
+    data: { hasData: !!data, hasTaker: !!taker, hasErr: !!err, testId: id != null },
+  });
+  // #endregion
 
   async function load() {
     setErr(null);
@@ -127,14 +173,26 @@ export default function TestDetail() {
       setData(v);
       setChain(c);
       if (ed?.test) {
-        setDraftTitle(ed.test.title || '');
+        const loadedTitle = ed.test.title || '';
-        setAiGenTopic((ed.test.title || '').trim());
+        const loadedDescription = ed.test.description || '';
-        setDraftDescription(ed.test.description || '');
         const th = ed.test.passingThreshold;
-        setDraftPassing(
+        const loadedPassing =
-          th !== undefined && th !== null && String(th) !== '' ? String(th) : '70'
+          th !== undefined && th !== null && String(th) !== '' ? String(th) : '70';
+        const loadedQuestions = mapEditorToDraftQuestions(ed);
+
+        setDraftSnapshotOnLoad(
+          buildDraftSnapshot({
+            title: loadedTitle,
+            description: loadedDescription,
+            passing: loadedPassing,
+            questions: loadedQuestions,
+          })
         );
-        setDraftQuestions(mapEditorToDraftQuestions(ed));
+        setDraftTitle(loadedTitle);
+        setAiGenTopic(loadedTitle.trim());
+        setDraftDescription(loadedDescription);
+        setDraftPassing(loadedPassing);
+        setDraftQuestions(loadedQuestions);
       }
     } catch (e) {
       if (e.status === 401) {
@@ -590,13 +648,40 @@ export default function TestDetail() {
   }
 
   if (err) {
+    // #region agent log
+    postDebugLog({
+      runId: debugRunId,
+      hypothesisId: 'H3',
+      location: 'frontend/src/pages/TestDetail.jsx:return-err',
+      message: 'Returning error branch before memo hook',
+      data: { hasErr: true },
+    });
+    // #endregion
     return <p className="error-text">{err}</p>;
   }
   if (!data && !taker) {
+    // #region agent log
+    postDebugLog({
+      runId: debugRunId,
+      hypothesisId: 'H1',
+      location: 'frontend/src/pages/TestDetail.jsx:return-loading',
+      message: 'Returning loading branch before memo hook',
+      data: { hasData: false, hasTaker: false },
+    });
+    // #endregion
     return <p className="text-muted">Загрузка…</p>;
   }
 
   if (taker) {
+    // #region agent log
+    postDebugLog({
+      runId: debugRunId,
+      hypothesisId: 'H1',
+      location: 'frontend/src/pages/TestDetail.jsx:return-taker',
+      message: 'Returning taker branch before memo hook',
+      data: { hasTaker: true },
+    });
+    // #endregion
     const { test: t, hasActiveVersion } = taker.summary;
     const title = t?.title || 'Тест';
     return (
@@ -635,6 +720,42 @@ export default function TestDetail() {
   const assignSelectedInList = assignPeople.filter((p) =>
     assignSelected.has(assignPersonKey(p))
   );
+  // #region agent log
+  postDebugLog({
+    runId: debugRunId,
+    hypothesisId: 'H1',
+    location: 'frontend/src/pages/TestDetail.jsx:before-useMemo',
+    message: 'Reached line right before hasDraftChanges useMemo',
+    data: { hasData: !!data, hasTaker: !!taker },
+  });
+  // #endregion
+  const hasDraftChanges = useMemo(() => {
+    // #region agent log
+    postDebugLog({
+      runId: debugRunId,
+      hypothesisId: 'H2',
+      location: 'frontend/src/pages/TestDetail.jsx:inside-useMemo',
+      message: 'Computing hasDraftChanges',
+      data: {
+        hasDraftSnapshotOnLoad: !!draftSnapshotOnLoad,
+        titleLen: (draftTitle || '').length,
+        descriptionLen: (draftDescription || '').length,
+        passing: String(draftPassing || ''),
+        questionsCount: Array.isArray(draftQuestions) ? draftQuestions.length : -1,
+      },
+    });
+    // #endregion
+    if (!draftSnapshotOnLoad) {
+      return false;
+    }
+    const currentSnapshot = buildDraftSnapshot({
+      title: draftTitle,
+      description: draftDescription,
+      passing: draftPassing,
+      questions: draftQuestions,
+    });
+    return currentSnapshot !== draftSnapshotOnLoad;
+  }, [draftDescription, draftPassing, draftQuestions, draftSnapshotOnLoad, draftTitle]);
 
   return (
     <div className="test-detail-page test-detail-page--with-fixed-actions">
@@ -667,7 +788,7 @@ export default function TestDetail() {
           </div>
         )}
 
-        {chain?.hasAnyAttempt && (
+        {chain?.hasAnyAttempt && hasDraftChanges && (
           <div className="callout callout--warning" role="status" style={{ marginTop: '0.75rem' }}>
             При сохранении будет создана новая версия теста.
           </div>