Files
mtusi2026lab2/REPORT.md
T

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 | Нет |