Files
mtusi2026lab2/REPORT.md

4.0 KiB
Raw Permalink Blame History

ЛР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 задания, контракт и публичные тесты сохранены.