# ЛР2 — PostgreSQL и сессии Кузнецов Даниил Русланович, БПИ2304. На **3**. ## Запуск Нужны Python 3.13, Git и Docker с Compose. Из папки репозитория: ```powershell python -X utf8 scripts/lab.py verify ``` Создаются `.venv`, локальный `.env` и новые секреты. Скрипт собирает образ, применяет миграции, запускает API и проверки. Повторный setup сохраняет настройки. API: `http://127.0.0.1:18102`, Compose-проект: `kuznetsov-lab2`. Linux: те же команды через `python3`. Отдельно доступны `setup`, `build`, `start`, `test`, `restart-check`, `stop`. Например: `python -X utf8 scripts/lab.py stop`. Остановка сохраняет volume. Намеренный сброс учебной БД: `docker compose -p kuznetsov-lab2 --env-file .env down --volumes`. ## Реализация FastAPI → PostgreSQL. В БД хранятся пользователи, чаты, участники, сообщения и сессии. Чат и участники создаются одной транзакцией; история выбирается SQL-пагинацией по `(created_at, id)`, курсоры подписываются постоянным ключом. Регистрация требует пароль; в БД только Argon2id-хеш. Basic используется при входе, дальше Bearer. Хранится SHA-256 токена, TTL — 3600 секунд; logout удаляет сессию. SQL параметризован, пул и запросы имеют таймауты. Миграции нумеруются и проверяют checksum. Python 3.13.14, PostgreSQL 17.11, Psycopg 3.3.8. Образы и зависимости закреплены. API работает без root, наружу открыт только его порт, БД и секреты доступны внутри стенда. ## Проверки Команда: `python -X utf8 scripts/lab.py verify`. | Проверка | Результат | | --- | --- | | Структура, OpenAPI, Compose, публичный smoke | PASS — [лог](evidence/verification.txt) | | Пароли, доступ, Unicode, пагинация, конкуренция | 17 тестов, PASS — [лог](evidence/verification.txt) | | Рестарт API/БД: старые токен, курсор, сообщения и logout | PASS — [данные](evidence/persistence.json), [контейнеры](evidence/restart.json) | | Повторные миграции | Данные не изменились — [JSON](evidence/persistence.json) | | TTL=2 на отдельном порту 18112 | Истёкший токен 401, expiry не продлевается — [JSON](evidence/expiry.json) | | Остановка БД и восстановление | live 200, ready/API 503, затем 200 — [сводка](evidence/summary.json) | Чистый клон коммита `8e06e7634f6082866d8ac4204106453490c103cf` прошёл полный прогон: `python -X utf8 scripts/lab.py verify --project kuznetsov-lab2-clean --port 18122 --test-port 18132`. Использованы новые секреты и volume. [Лог](evidence/clean-clone-verification.txt), [сводка](evidence/clean-clone-summary.json). TTL-стенд удаляет только свои временные контейнеры и сети, сохраняя volume. Ограничения: локальный HTTP, одна API-реплика и одна БД, без Redis и HA. Основа — [реализация Артура Югая](https://gitea.privcloud.tech/ArturYugay/mtusi2026lab2/src/commit/2ae42b5ef61fe05695c9a28224599109454bde9d). Для Даниила выделены свои настройки, секреты, ports/volumes и проверки. README задания, контракт и публичные тесты сохранены.