Константин Лебединский
4b0d56ff0e
Этап 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-контур тестирования (тот же стек, отдельный деплой)
Здесь — новое приложение на Python / Flask в духе HR_TG_Bot/tgFlaskForm (шаблоны + серверный рендер, без React). Старый стек (backend/ + frontend/) пока не удаляется: оба контура могут существовать параллельно, пока не зафиксирована политика «один источник записи» и cutover.
Запуск в Docker (рекомендуется)
Из корня репозитория TestingWebApp. Сервис не зависит от testing-backend и не требует внешней сети Postgres для старта (только внутренняя сеть compose).
docker compose -f docker-compose.dev.yml up -d --build testing-flask
Когда подключите БД из контейнера к hr_postgres_dev / clinic_tests, в docker-compose.dev.yml у сервиса testing-flask добавьте сеть postgres (как у testing-backend).
- 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).
- Подключить БД
clinic_tests(схема не меняется), psycopg2-пул в стилеtgFlaskForm/db/. - Перенести 22 эндпоинта Express из
backend/в blueprint'ы Flask, ориентируясь на чек-лист в migration-final-inventory.md. - Перенести экраны React (
frontend/src/pages/*) в Jinja-шаблоныapp/templates/, повторяя мобильный UX Спринта 3. - Когда паритет закрыт —
docker-compose.dev.ymlуказывает на этот сервис как основной,backend/иfrontend/уходят.
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 корня репозитория