forked from mtusi2026/mtusi2026lab2
3.4 KiB
3.4 KiB
Отчёт — лабораторная 2
- Автор, группа: Вотчицева, БВТ2302
- Целевая оценка: 4, трек 5 не заявлен
- Commit/PR: см. Merge Request в Gitea
- Использованные источники, библиотеки и помощь ИИ:
- Python 3.12, FastAPI, Uvicorn, SQLAlchemy (asyncpg), Redis, Passlib (bcrypt)
- При подготовке каркаса приложения использовался ассистент (Claude).
- Все зависимости закреплены в
requirements.txt.
Запуск из чистого clone
Prerequisites: Docker 24+, свободные порты 127.0.0.1:8080.
git clone https://gitea.privcloud.tech/Tutuxa/mtusi2026lab2.git
cd mtusi2026lab2
docker compose up -d --build
# В другом терминале:
python tests\smoke.py --base-url http://localhost:8080
python tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://localhost:8080
# Остановка:
docker compose down
## Архитектура и решения
API: Python 3.12 + FastAPI (Uvicorn). Работает в контейнере от non-root пользователя (UID 10001).
PostgreSQL: Источник истины для пользователей, чатов, участников и сообщений. Используется SQLAlchemy (ORM) + asyncpg.
Сессии (Redis): Сессии хранятся в Redis с TTL (по умолчанию 3600 секунд). Включена персистентность AOF (appendonly yes). Источник истины для сессий — Redis.
Хеширование: Passlib + bcrypt (версия 4.0.1 закреплена для стабильности).
Пагинация: Keyset cursor по (created_at, id). Добавлен составной индекс ix_messages_chat_created_id.
Обработка отказов: Если Redis или PostgreSQL недоступны, API возвращает 503 unavailable в едином формате ошибки.
Docker Compose: Поднимает api, db (PostgreSQL 16-alpine) и redis (Redis 7-alpine). Для БД и Redis используются именованные volumes (pgdata, redisdata).
## Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | `python tests\smoke.py` | `PASS` | evidence/smoke.txt |
| Persistence | `python tests\resilience.py ...` | `PASS` | evidence/persistence.txt |
| Свои тесты (уровень 4) | `python student-tests\run.py` | `PASS` | evidence/student-tests.txt |
| Отказ Redis (503) | `python scripts\test_redis_down.py` | `PASS` | evidence/redis-down.txt |
| EXPLAIN (Индекс) | `EXPLAIN ...` | `Index Scan` | evidence/explain.txt |
## Эксперименты и отказы
| Воздействие | Что ожидали | Что наблюдали | Потеря данных |
| --- | --- | --- | --- |
| `docker compose restart` | Сохранение данных | Токен выжил | Нет |
| Остановка Redis | Ошибка 503 | Ошибка 503 | Нет |
| Гонка при регистрации | Один 201, один 409 | 201 и 409 | Нет |