Files
2026-10-26 14:27:25 +03:00

5.6 KiB
Raw Permalink Blame History

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

  • Автор, группа: Дадайкин БВТ2302
  • Целевая оценка 4
  • Commit/PR: TODO после публикации
  • Использованные источники, библиотеки и помощь ИИ: Официальная документация FastAPI, SQLAlchemy, Redis; ИИ (помощь с написанием и профилированием SQL индексов).

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

Требования: Docker, Docker Compose, Python 3.9+ (для запуска проверочных скриптов).

Команды запуска:

# 1. Сборка и запуск инфраструктуры (API, PostgreSQL, Redis)
docker compose up -d --build

# 2. Применение миграций базы данных
alembic upgrade head

Остановка и полное удаление учебных данных:
docker compose down -v

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

Источник истины: PostgreSQL 15. Хранит пользователей, чаты, участников чатов и сообщения. Для пагинации сообщений добавлен составной индекс ix_messages_chat_id_created_at_id. Сессии и кэш: Redis 7. Используется для хранения пользовательских сессий. Настроен TTL сессии из SESSION_TTL_SECONDS. В compose.yaml включена опция --appendonly yes, чтобы сессии сохранялись на диск и переживали рестарт контейнера. Транзакционные границы: Составные операции (создание чата с участниками) выполняются внутри транзакций с автоматическим откатом при ошибке. Гонки (Race Conditions): Исключена гонка при регистрации пользователей с одинаковым username путём перехвата IntegrityError на уровне СУБД (вместо предварительного SELECT). Соединения: В src/database.py настроен пул соединений (pool_size=10, max_overflow=20) и таймауты (connect_args={"command_timeout": 5.0}).

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

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke python tests/smoke.py PASS: lab2 public API scenario Вывод в консоли
Сохранность при рестарте (Ур. 3) python tests/resilience.py --mode persistence --action-script scripts/restart.bat PASS: persistence preserved confirmed data and existing session. API, Postgres и Redis успешно восстановились. Токен валиден. Вывод в консоли
Redis для сессий (Ур. 4) Ручная проверка / код Токены сохраняются в Redis. При рестарте контейнера не пропадают (AOF включен). compose.yaml, src/main.py
Безопасный ORM, гонки (Ур. 4) python tests/custom_tests.py 100 сообщений от 10 воркеров успешно доставляются. Дубликаты username отлавливаются на уровне БД -> 409 Conflict. Вывод в консоли

Доказательство работы составного индекса (на 10 000 сообщениях):

Limit  (cost=0.29..5.08 rows=50 width=86) (actual time=0.045..0.058 rows=50 loops=1)
   Buffers: shared hit=1 read=2
   ->  Index Scan using ix_messages_chat_id_created_at_id on messages  (cost=0.29..958.53 rows=10000 width=86) (actual time=0.044..0.052 rows=50 loops=1)
         Index Cond: ((chat_id)::text = 'chat-test-idx'::text)
         Buffers: shared hit=1 read=2
 Planning:
   Buffers: shared hit=161 read=1 dirtied=5
 Planning Time: 1.540 ms
 Execution Time: 0.098 ms

Эксперименты и отказы

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
Остановка Redis (docker stop ) Ошибка авторизации (503) для защищенных путей При обращении к /health/ready или /api/v1/users/me выдается 503. Потерь данных нет. Восстановление мгновенное после включения контейнера.
Рестарт всего стенда (restart.bat) Токен продолжает действовать, сообщения сохранены Токен сессии остался валидным (прочитан с диска Redis). Сообщения в сохранности (Postgres Volume). Простой около 3-4 секунд.

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

Стенд не устойчив к падению хост-машины (нет репликации БД и Redis на другие физические узлы/серверы). Архитектура не поддерживает инвалидацию сессий на других устройствах при смене пароля. В будущем для масштабирования потребуется балансировщик нагрузки (LB) и запуск нескольких инстансов API.