Files
mtusi2026lab2/REPORT.md

2.5 KiB
Raw Permalink Blame History

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

  • Автор, группа: БВТ-2302, Копытов Максим
  • Целевая оценка: 4
  • Стек: Python 3.12, FastAPI, PostgreSQL 15, Redis 7, Docker Compose.

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

  1. Создать локальный .env по примеру .env.example.
  2. Собрать и запустить стенд: docker compose --env-file .env up -d --build
  3. Дождаться готовности БД и Redis (статус healthy).
  4. Запустить тесты:
    • make test PYTHON="py -3.12"
    • py -3.12 tests/resilience.py --mode persistence --action-script "scripts/restart.bat" --base-url "http://localhost:8080"
    • py -3.12 -m pytest student-tests -v

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

  • PostgreSQL (источник истины): Все пользователи, чаты, участники и сообщения хранятся в БД. Используются параметризованные запросы через asyncpg, транзакции для атомарного создания чатов. Добавлены индексы для быстрой пагинации истории.
  • Redis (сессии): Используется для хранения Bearer-токенов с TTL. Включена персистентность (appendonly yes), поэтому сессии выживают при перезапуске контейнеров.
  • Безопасность: Пароли хешируются с помощью bcrypt. Basic Auth используется только для /auth/sessions, остальные запросы требуют Bearer.

Выполнение критериев на 4

  • Redis с TTL: Реализован вход с выдачей токена, сохранение в Redis через setex с TTL из .env.
  • Connection pool и таймауты: В asyncpg настроен пул соединений. Обработка гонок при регистрации (UniqueViolationError).
  • Индекс истории: Создан idx_messages_chat_created на (chat_id, created_at, id). Проверен через EXPLAIN ANALYZE:
    Limit  (cost=0.27..8.29 rows=1 width=60) (actual time=0.016..0.016 rows=0 loops=1)
      ->  Index Scan using idx_messages_chat_created on messages
            Index Cond: (chat_id = '00000000-0000-0000-0000-000000000000'::uuid)