Лабораторная 2. PostgreSQL, сессии и Redis
Переносит мессенджер Lab 1 на PostgreSQL и меняет учебную идентификацию на пароль и Bearer-сессию. PostgreSQL хранит пользователей, чаты, членство и сообщения. Redis хранит сессии с TTL и AOF persistence.
Запуск локального стенда
Требуются Docker Engine с Compose v2 и PowerShell 7 либо совместимый PowerShell. Стенд использует Python 3.12.6, PostgreSQL 16.4 и Redis 7.4.1; теги образов закреплены. Все порты хранилищ доступны только во внутренней сети Compose, API опубликован на 127.0.0.1:8080.
В корне проекта:
if (-not (Test-Path .env)) { Copy-Item .env.example .env }
./scripts/create-secrets.ps1
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
Миграция 001_initial.sql запускается одноразовой службой migrate до API. Дождитесь готовности и выполните публичный smoke:
docker compose ps
python tests/smoke.py --base-url http://localhost:8080
Или make test. Smoke создаёт синтетических пользователей, чат и сообщения; API не имеет endpoint для их удаления. Повторяйте проверки на отдельном учебном volume, если нужен чистый набор данных.
Проверки для оценки 4
Для короткого срока сессии переопределите значение при создании контейнеров. Десять секунд достаточно для проверки expiry, оставаясь безопасным для самого сценария:
$env:SESSION_TTL_SECONDS = '10'
docker compose --env-file .env up -d --build --force-recreate
python tests/grade4.py --base-url http://localhost:8080
Remove-Item Env:SESSION_TTL_SECONDS
docker compose --env-file .env up -d --force-recreate
tests/grade4.py проверяет ошибочный пароль, expiry, logout, гонку регистрации одинакового username, отсутствие частичного чата при ошибке и контролируемые 503 при остановке Redis или PostgreSQL. Скрипт останавливает и снова запускает сервисы, но не удаляет volumes. Сначала запустите публичный smoke с обычным TTL; тест сохранности сессии требует TTL не менее 300 секунд.
План запроса истории можно воспроизвести отдельно. Скрипт добавляет 10 000 временных сообщений в одной транзакции, фиксирует EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON), проверяет использование messages_history_idx и откатывает fixtures:
docker compose exec -T api python -m src.app.explain_history | Set-Content -Encoding utf8 evidence/query-plan.json
Повторное применение миграций не меняет данные:
docker compose run --rm migrate
Сценарий полного перезапуска API и обоих хранилищ с сохранением volumes:
chmod +x scripts/restart.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh
Запускайте этот сценарий из Linux, WSL или Git Bash, где доступны Docker Compose и исполняемые shell-скрипты. Проверка держит токен только в памяти и использует тот же токен после перезапуска.
Остановка и удаление учебных данных
Безопасно остановить контейнеры можно docker compose stop или удалить контейнеры и сеть командой docker compose down; именованные volumes сохраняются. Осознанно удалить все локальные данные можно только отдельной командой:
docker compose down --volumes
Не используйте её во время тестов persistence.
Архитектура и границы
users,chats,chat_membersиmessagesнаходятся в PostgreSQL. FK гарантируют членство отправителя в чате, уникальный индекс разрешает гонки username, а создание чата и участников выполняется одной транзакцией.messages_history_idx(chat_id, created_at, id)соответствует keyset-пагинации и сортировке истории. Курсор содержит чат, время и UUID; сортировка по тройке остаётся однозначной при совпавших временных метках.- Пароли хешируются библиотекой Argon2id. Basic принимается только на
POST /api/v1/auth/sessions; токен содержит 256 случайных бит, а Redis хранит запись под SHA-256 ключом с TTL. Ответы и логи не содержат пароль или токен. - Redis является источником истины для сессий. AOF с
appendfsync everysec, RDB snapshot и именованный volume сохраняют действующие сессии при контролируемом рестарте. При аварийном отключении Redis возможна потеря примерно последней секунды записей; API закрывает доступ и возвращает503, если Redis недоступен. - SQLAlchemy Core/ORM использует параметризованные выражения, пул ограничен 5 соединениями + 5 overflow, acquisition timeout — 3 секунды, connect timeout — 3 секунды, statement timeout — 5 секунд. Ошибки хранилищ не раскрывают SQL или credentials.
- PostgreSQL — источник истины сообщений и профилей. Приложение не кэширует сообщения, поэтому после записи чтение идёт из БД и не может вернуть историю из устаревшего кэша.
HTTP и Basic предназначены только для localhost со synthetic-данными. Удалённую демонстрацию проводите через TLS termination.
Команды разработки
python scripts/check_contract.py
python -m compileall -q src tests scripts
python -m pip install -r requirements-dev.txt
python scripts/validate_openapi.py
make check проверяет контрактные файлы; make test выполняет публичный API smoke; make test-grade4 запускает негативные и отказные проверки; make explain-history печатает план в терминал. Публичный smoke сам по себе не доказывает grading evidence: сохраните результат проверки, план запроса и фактическое состояние контейнеров в REPORT.md/evidence/.