forked from mtusi2026/mtusi2026lab2
31 lines
2.5 KiB
Markdown
31 lines
2.5 KiB
Markdown
# Отчёт — лабораторная 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) |