TestingWebApp/flask_app

Flask-контур тестирования (целевой стек)

Приложение на Python 3.11 / Flask 3 / Jinja2 в духе HR_TG_Bot/tgFlaskForm (серверный рендер, без React). На этом контуре работает прод edullm.pirogov.ai.

Старый стек (backend/ + frontend/) пока не удаляется: оба контура существуют параллельно до закрытия паритета (спринты E1.4–E1.6 в docs/migration-final.md).

Запуск в Docker (рекомендуется)

Из корня репозитория TestingWebApp. docker-compose.dev.yml уже подключён к сети postgres (hr_postgres_dev_net) и пробрасывает DATABASE_URL, HR_AUTH, HR_DATABASE_URL, DEEPSEEK_API_KEY / OPENAI_API_KEY / LLM_BASE_URL / LLM_MODEL из корневого .env.

docker compose -f docker-compose.dev.yml up -d --build testing-flask

• URL: http://localhost:3108
• Проверка: http://localhost:3108/health

Вместе со старым UI и API:

docker compose -f docker-compose.dev.yml up -d --build

Тогда Node-интерфейс остаётся на http://localhost:3107, Flask — на 3108.

Запуск локально (без Docker)

cd flask_app
python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env      # при необходимости поправьте PORT
python run.py

По умолчанию: http://127.0.0.1:3108 , проверка: http://127.0.0.1:3108/health
Для режима как в Docker (waitress): в .env задайте WEB_USE_WAITRESS=1.

Зачем отдельная папка

• Один стек с кабинетом / мини-приложением — проще переносить экраны и запросы из HR_TG_Bot/tgFlaskForm/webApp/interfaces/testing/.
• Отдельный процесс и порт — без риска сломать текущий docker-compose.dev.yml с Node до готовности.

Состояние спринтов

Этот каталог — место разработки Этапа 1 (migration-final.md).

Спринт	Что входит	Статус
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 / check / improve).	✅

Чек-лист эндпоинтов и gap-analysis с tgFlaskForm — migration-final-inventory.md. ETL clinic_tests → hr_bot_test и слияние с tgFlaskForm — это Этап 2, на будущее (migration-to-tgflaskform.md).

Связанные документы

• docs/migration-final.md — главный трекер двух этапов.
• docs/migration-final-inventory.md — карта Express-функционала, чек-лист Этапа 1.
• docs/migration-to-tgflaskform.md — план Этапа 2.
• README корня репозитория