Лабораторная 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/.

S
Description
No description provided
Readme
22 MiB
Languages
Python 94.1%
PowerShell 2%
Shell 1.5%
Makefile 1.4%
Dockerfile 1%