feat(flask): E1.0–E1.3, E1.8 — миграция на Python/Flask + AI v2

Этап 1 миграции TestingWebApp на целевой стек (Python/Flask/Jinja),
БД остаётся clinic_tests.

E1.0 — База Flask-приложения: SQLAlchemy/psycopg2 пул, Flask sessions,
фабрика create_app, blueprint main с / и /health, base.html в стиле
кабинета HR (Tailwind CDN + Manrope + Material Symbols), 404/500.

E1.1 — Auth + /api/me: Flask sessions (signed cookie) вместо JWT,
bcrypt + Werkzeug, опц. HR_AUTH=1 с UPSERT в clinic_tests.users по
staff_id. UI /login, JSON /api/auth/{login,logout,me}, декораторы
@login_required / @require_role.

E1.2 — Тесты: список + редактор. 10 эндпоинтов, сервисы test_draft,
test_access, test_chain, ai_editor, llm_client, draft_validator,
editor_content. UI /tests (каталог + создание) и /tests/<id>/edit
(редактор с AI). Полный мобильный UX (аккордеоны/drag-n-drop) — в E1.7.

E1.3 — Импорт документов: pypdf + python-docx, эндпоинт
POST /api/tests/import/document, кнопка «Импорт документа» в
AI-панели редактора, лимит 16 МБ.

E1.8 — AI v2: страница /settings (статус ENV-ключа + ping),
ai/generate-by-title (без сетки), ai/check (рецензия), ai/improve
(массовое было→стало с чекбоксами). Унифицированный ответ AI-ошибок:
{ error, code, settingsUrl }.

Docker:
- docker-compose.dev.yml: добавлены DATABASE_URL, HR_AUTH/HR_DATABASE_URL,
  DEEPSEEK_API_KEY/OPENAI_API_KEY/LLM_BASE_URL/LLM_MODEL и сеть postgres
  для testing-flask.

Документация:
- docs/migration-final.md — двух-этапный план (Этап 1: унификация
  стека внутри TestingWebApp; Этап 2: слияние с tgFlaskForm).
- docs/migration-final-inventory.md — карта 22 эндпоинтов Express.

Made-with: Cursor

flask_app/app/services/editor_content.py

@@ -0,0 +1,95 @@
+"""Контент редактора: тест + активная версия + дерево вопросов с правильными вариантами.
+
+Порт `getEditorContent` + `loadQuestionsForVersion` (только includeCorrect=true вариант)
+из `services/testAttemptService.js`.
+"""
+from __future__ import annotations
+
+from sqlalchemy import text
+
+from ..db import get_engine
+from ..messages import RU
+from .test_access import is_test_author
+
+
+class HttpError(Exception):
+    def __init__(self, status: int, message: str):
+        super().__init__(message)
+        self.status = status
+        self.message = message
+
+
+def load_questions_for_version(conn, test_version_id, *, include_correct: bool) -> list[dict]:
+    qrows = conn.execute(
+        text(
+            'SELECT id, text, question_order, has_multiple_answers '
+            'FROM questions WHERE test_version_id = :v ORDER BY question_order'
+        ),
+        {'v': test_version_id},
+    ).mappings().all()
+    out = []
+    for r in qrows:
+        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:
+            base = {
+                'id': str(o['id']),
+                'text': o['text'],
+                'optionOrder': o['option_order'],
+            }
+            if include_correct:
+                base['isCorrect'] = bool(o['is_correct'])
+            options.append(base)
+        out.append(
+            {
+                'id': str(r['id']),
+                'text': r['text'],
+                'questionOrder': r['question_order'],
+                'hasMultipleAnswers': bool(r['has_multiple_answers']),
+                'options': options,
+            }
+        )
+    return out
+
+
+def get_editor_content(user_id: str, test_id: str) -> dict:
+    eng = get_engine()
+    with eng.connect() as conn:
+        tr = conn.execute(
+            text(
+                'SELECT id, title, description, passing_threshold, created_by '
+                'FROM tests WHERE id = :id'
+            ),
+            {'id': test_id},
+        ).mappings().first()
+        if not tr:
+            raise HttpError(404, 'Тест не найден.')
+        if not is_test_author(tr['created_by'], user_id):
+            raise HttpError(403, 'Доступ запрещён.')
+        tv = conn.execute(
+            text(
+                'SELECT id FROM test_versions WHERE test_id = :id AND is_active = true LIMIT 1'
+            ),
+            {'id': test_id},
+        ).mappings().first()
+        if not tv:
+            raise HttpError(400, 'Нет активной версии теста.')
+        version_id = tv['id']
+        questions = load_questions_for_version(conn, version_id, include_correct=True)
+
+    return {
+        'test': {
+            'id': str(tr['id']),
+            'title': tr['title'],
+            'description': tr['description'],
+            'passingThreshold': tr['passing_threshold'],
+        },
+        'activeVersionId': str(version_id),
+        'questions': questions,
+    }