Files

3.9 KiB
Raw Permalink Blame History

Лабораторная 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 применена, данные находятся в именованном volume postgres-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.