Files
mtusi2026lab2/REPORT.md
T
2026-10-08 17:04:26 +03:00

4.4 KiB
Raw Blame History

Отчёт — лабораторная 2

  • Автор, группа: TODO
  • Целевая оценка: 3
  • Commit/PR: TODO после публикации
  • Использованные библиотеки: FastAPI 0.141.1, Uvicorn 0.40.0, asyncpg 0.31.0, argon2-cffi 25.1.0; зафиксированы в pyproject.toml и uv.lock.

Запуск из чистого clone

Нужны Docker Engine с Docker Compose v2 и OpenSSL. Создайте только локальные секреты — они исключены из Git:

mkdir -p secrets
openssl rand -hex 32 -out secrets/postgres_password
awk '{printf "postgresql://messenger:%s@postgres:5432/messenger\\n", $0}' \
  secrets/postgres_password > secrets/database_url
chmod 700 secrets
chmod 600 secrets/postgres_password secrets/database_url
docker compose --env-file .env.example config --quiet
docker compose --env-file .env.example up -d --build

API публикуется на http://localhost:8080. Миграции запускаются API при старте; таблица schema_migrations не применяет уже записанную миграцию повторно. Проверка готовности:

curl -fsS http://localhost:8080/health/ready
make test
chmod +x scripts/restart.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh

Обычная остановка сохраняет учебные данные:

docker compose down

Намеренно удалить учебные данные можно только отдельной командой docker compose down -v; она не входит в restart hook.

Архитектура и решения

HTTP-клиент → FastAPI API → asyncpg pool (1..10 соединений) → PostgreSQL
                         └→ миграции SQL при старте

PostgreSQL — источник истины для users, chats, chat_members, messages и sessions. Named volume postgres_data хранит каталог БД. Токен сессии создаётся через secrets.token_urlsafe(32); в БД лежит только SHA-256 токена и время истечения. Пароли хешируются Argon2 через argon2-cffi; plaintext и hash не попадают в API-ответы.

POST /api/v1/users требует password. POST /api/v1/auth/sessions принимает только Basic и выдаёт opaque Bearer token. Все бизнес-endpoint определяют пользователя только по Bearer; X-User-Id игнорируется. Logout удаляет текущую серверную сессию. Срок действия фиксируется при создании и задаётся SESSION_TTL_SECONDS (3600 по умолчанию).

Создание чата — одна транзакция: проверка состава пользователей, запись чата и всех участников. Внешние ключи и уникальность username заданы миграцией. История выбирается keyset-запросом по (created_at, id); индекс messages_chat_created_id_idx соответствует этому запросу.

Доказательства критериев

Критерий Команда Наблюдаемый результат Статус
Контракт и синтаксис make check PASS выполнено
Импорт приложения и Basic parser uv run --frozen python … PASS выполнено
Согласованность lock-файла uv lock --check PASS выполнено
Публичный smoke make test PASS: lab2 public API scenario evidence/smoke-2026-10-08.txt
Persistence make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS: persistence preserved confirmed data and existing session evidence/persistence-2026-10-08.txt

Ограничения и следующие шаги

Redis/Valkey не используется: он относится к уровню 4 этой лабораторной. Публичные smoke и persistence выполнены на локальном Compose-стенде 2026-10-08. При фиксации работы в PR сохраните их stdout в evidence/ без токенов и паролей.