4.0 KiB
ЛР2 — PostgreSQL и сессии
Кузнецов Даниил Русланович, БПИ2304. На 3.
Запуск
Нужны Python 3.13, Git и Docker с Compose. Из папки репозитория:
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 — лог |
| Пароли, доступ, Unicode, пагинация, конкуренция | 17 тестов, PASS — лог |
| Рестарт API/БД: старые токен, курсор, сообщения и logout | PASS — данные, контейнеры |
| Повторные миграции | Данные не изменились — JSON |
| TTL=2 на отдельном порту 18112 | Истёкший токен 401, expiry не продлевается — JSON |
| Остановка БД и восстановление | live 200, ready/API 503, затем 200 — сводка |
Чистый клон коммита 8e06e7634f6082866d8ac4204106453490c103cf прошёл полный прогон:
python -X utf8 scripts/lab.py verify --project kuznetsov-lab2-clean --port 18122 --test-port 18132.
Использованы новые секреты и volume. Лог,
сводка.
TTL-стенд удаляет только свои временные контейнеры и сети, сохраняя volume. Ограничения: локальный HTTP, одна API-реплика и одна БД, без Redis и HA.
Основа — реализация Артура Югая. Для Даниила выделены свои настройки, секреты, ports/volumes и проверки. README задания, контракт и публичные тесты сохранены.