3.9 KiB
Лабораторная 2
Автор / группа: Антонова Екатерина
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: не заявлен
Что реализовано и что перенесено: перенесены пользователи, чаты, участники, сообщения и keyset-пагинация из lab1. Добавлены PostgreSQL, версионируемая миграция, Argon2id-хеширование паролей, Basic-аутентификация для создания Bearer-сессии, expiry и logout. PostgreSQL хранит пользователей, чаты, членство, сообщения и действующие сессии. Добавлены Dockerfile, compose.yaml, именованный volume PostgreSQL и restart hook scripts/restart.sh.
Команды запуска из чистого clone
$repo = Join-Path $HOME 'Desktop\univ\4\hideload\mtusi2026lab2'
Set-Location $repo
Copy-Item .env.example .env
docker compose --env-file .env down -v
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
Invoke-WebRequest http://localhost:8080/health/ready
После запуска:
python tests/smoke.py --base-url http://localhost:8080
Для Linux:
chmod +x scripts/restart.sh
make check
make validate
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
Остановка без удаления данных:
docker compose --env-file .env down
Намеренное удаление учебных данных:
docker compose --env-file .env down -v
Результаты проверок
scripts/check_contract.py— PASS.scripts/validate_openapi.py— PASS.docker compose --env-file .env config --quiet— PASS.- Compose успешно собрал и запустил API и PostgreSQL; оба контейнера стали
healthy. tests/smoke.py --base-url http://localhost:8080— PASS:PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.- После
docker compose restart postgres apiпрежний Bearer-токен продолжил работать; проверка вывелаPERSISTENCE=True. - Миграция
001применена, данные находятся в именованном volumepostgres-data.
В Windows-окружении make и Bash отсутствуют, поэтому smoke и persistence
были проверены эквивалентными командами PowerShell. В Linux/CI используются
команды Makefile из раздела выше.
Архитектура и ограничения
PostgreSQL является источником истины. Создание чата и записей членства выполняется атомарно в одной транзакции. Повторный запуск миграций не дублирует данные благодаря таблице schema_migrations.
Basic применяется только на POST /api/v1/auth/sessions. Все остальные защищённые endpoint требуют Bearer. X-User-Id не предоставляет доступ. Токены хранятся в PostgreSQL только в виде SHA-256 отпечатков, пароли — только в виде Argon2id-хешей.
Redis/Valkey, несколько API-реплик, failover и нагрузочное исследование не заявляются, поскольку относятся к следующим уровням. Стенд рассчитан на один локальный API и один PostgreSQL; secrets и volumes не добавляются в Git.