Files
mtusi2026lab2/REPORT.md
T

31 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Отчёт — лабораторная 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:
```text
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)