Дорабоки интерфейса системы тестирования. Раздел 1 Шапка+Верхний brick

flask_app/README.md

@@ -1,17 +1,24 @@
-# Flask-контур тестирования (тот же стек, отдельный деплой)
+# Flask-контур тестирования (целевой стек)
 
-Здесь — **новое** приложение на **Python / Flask** в духе `HR_TG_Bot/tgFlaskForm` (шаблоны + серверный рендер, без React). Старый стек (`backend/` + `frontend/`) пока не удаляется: оба контура могут существовать параллельно, пока не зафиксирована политика «один источник записи» и cutover.
+Приложение на **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. Сервис **не** зависит от `testing-backend` и **не** требует внешней сети Postgres для старта (только внутренняя сеть compose).
+Из **корня** репозитория 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 testing-flask
 ```
 
-Когда подключите БД из контейнера к `hr_postgres_dev` / `clinic_tests`, в `docker-compose.dev.yml` у сервиса `testing-flask` добавьте сеть `postgres` (как у `testing-backend`).
-
 - **URL:** http://localhost:3108  
 - **Проверка:** http://localhost:3108/health  
 
@@ -42,16 +49,28 @@ python run.py
 - Один **стек** с кабинетом / мини-приложением — проще переносить экраны и запросы из `HR_TG_Bot/tgFlaskForm/webApp/interfaces/testing/`.
 - **Отдельный** процесс и порт — без риска сломать текущий `docker-compose.dev.yml` с Node до готовности.
 
-## Дальнейшие шаги (код)
+## Состояние спринтов
 
-Этот каталог — место разработки **Этапа 1** ([migration-final.md](../docs/migration-final.md)).
+Этот каталог — место разработки **Этапа 1**
+([migration-final.md](../docs/migration-final.md)).
 
-1. Подключить БД **`clinic_tests`** (схема не меняется), psycopg2-пул в стиле `tgFlaskForm/db/`.
-2. Перенести 22 эндпоинта Express из `backend/` в blueprint'ы Flask, ориентируясь на чек-лист в [migration-final-inventory.md](../docs/migration-final-inventory.md).
-3. Перенести экраны React (`frontend/src/pages/*`) в Jinja-шаблоны `app/templates/`, повторяя мобильный UX [Спринта 3](../docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md).
-4. Когда паритет закрыт — `docker-compose.dev.yml` указывает на этот сервис как основной, `backend/` и `frontend/` уходят.
+| Спринт | Что входит | Статус |
+|---|---|---|
+| 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). | ✅ |
 
-ETL `clinic_tests → hr_bot_test` и слияние с `tgFlaskForm` — это **Этап 2**, на будущее ([migration-to-tgflaskform.md](../docs/migration-to-tgflaskform.md)).
+Чек-лист эндпоинтов и 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)).
 
 ## Связанные документы