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/__init__.py

@@ -1,8 +1,16 @@
-# -*- coding: utf-8 -*-
+"""Фабрика Flask-приложения.
+
+Этап 1:
+  E1.0 — фундамент (БД-пул, sessions, base.html).
+  E1.1 — авторизация (cookie-сессии Flask, bcrypt + Werkzeug, опц. HR_AUTH).
+"""
+from __future__ import annotations
+
 import os
 import secrets
+from datetime import timedelta
 
-from flask import Flask, jsonify
+from flask import Flask, jsonify, render_template, request
 
 
 def create_app() -> Flask:
@@ -13,17 +21,55 @@ def create_app() -> Flask:
         static_folder='static',
         static_url_path='/static',
     )
+
     sk = (os.environ.get('SECRET_KEY') or '').strip()
     app.config['SECRET_KEY'] = sk or secrets.token_hex(32)
+    app.config['MAX_CONTENT_LENGTH'] = 16 * 1024 * 1024  # 16 MB upload limit
 
-    @app.route('/health')
-    def health():
-        return jsonify(status='ok', service='testing-flask-app')
+    app.config.update(
+        SESSION_COOKIE_NAME='testing_session',
+        SESSION_COOKIE_HTTPONLY=True,
+        SESSION_COOKIE_SAMESITE='Lax',
+        SESSION_COOKIE_SECURE=(os.environ.get('FLASK_ENV') == 'production'),
+        PERMANENT_SESSION_LIFETIME=timedelta(days=7),
+    )
 
-    @app.route('/')
-    def index():
-        from flask import render_template
+    from .blueprints.main import main_bp
+    from .blueprints.settings import settings_bp
+    from .auth import auth_bp
+    from .tests import tests_bp
 
-        return render_template('index.html')
+    app.register_blueprint(main_bp)
+    app.register_blueprint(auth_bp)
+    app.register_blueprint(tests_bp)
+    app.register_blueprint(settings_bp)
+
+    from .config import is_assignment_feature_enabled, is_dev_ui, is_hr_auth_enabled
+    from .auth.decorators import current_user as _current_user
+
+    @app.context_processor
+    def _inject_globals():
+        return {
+            'current_user': _current_user(),
+            'hr_auth_enabled': is_hr_auth_enabled(),
+            'dev_ui': is_dev_ui(),
+            'assignment_ui': is_assignment_feature_enabled(),
+        }
+
+    @app.errorhandler(404)
+    def _not_found(_e):
+        if _is_api_path():
+            return jsonify(error='not_found'), 404
+        return render_template('404.html'), 404
+
+    @app.errorhandler(500)
+    def _internal_error(_e):
+        if _is_api_path():
+            return jsonify(error='internal_error'), 500
+        return render_template('500.html'), 500
 
     return app
+
+
+def _is_api_path() -> bool:
+    return request.path.startswith('/api/')