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

Приложение на **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. `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`.

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

- **URL:** http://localhost:3107  
- **Проверка:** http://localhost:3107/health  

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

```bash
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
```

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

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

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

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

Этот каталог — место разработки **Этапа 1**
([migration-final.md](../docs/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`](../docs/migration-final-inventory.md).
ETL `clinic_tests → hr_bot_test` и слияние с `tgFlaskForm` — это
**Этап 2**, на будущее
([migration-to-tgflaskform.md](../docs/migration-to-tgflaskform.md)).

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

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