Files
mtusi2026lab2/REPORT.md
T

9.2 KiB
Raw Blame History

Отчёт по лабораторной работе № 2

  • Студент: Борзов Никита
  • Группа: БВТ2304
  • Целевая оценка: 5
  • Выбранный трек 5: трек 1, согласованность кэша
  • Ветка: solution/bvt2304-borzov
  • Commit: f87929c
  • MR: заполняется после публикации новой версии

В этой работе я продолжил REST-мессенджер из лабораторной 1. In-memory-хранилище заменено на PostgreSQL, добавлены пароль при регистрации, Basic-аутентификация только для входа и непрозрачные Bearer-сессии. Redis используется для TTL-сессий и кэша списка чатов. Сессии записываются в Redis с AOF и переживают перезапуск API и Redis-volume.

Использованы контракт и публичные проверки из репозитория лабораторной 2, FastAPI, psycopg 3, PostgreSQL 16.4, Redis 7.4 и Argon2id из argon2-cffi. Код первой лабораторной и отчёт использованы как исходная предметная модель; при подготовке кода и проверки требований использовалась помощь ИИ, все команды и результаты проверены локально.

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

Нужен Docker Desktop с Compose v2:

cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
docker compose ps
make check
make test BASE_URL=http://localhost:8080
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://localhost:8080

Миграция scripts/migrate.py запускается внутри API до Uvicorn и идемпотентна. Для остановки без удаления данных используется docker compose stop; намеренный сброс учебного стенда выполняется отдельно командой docker compose down -v.

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

Клиент -> FastAPI/Uvicorn -> PostgreSQL
                      └── Redis (сессии TTL + кэш списка чатов)

PostgreSQL является источником истины для пользователей, чатов, членства и сообщений. Таблицы, внешние ключи, уникальность username и индекс истории описаны в migrations/001_init.sql. Создание чата и его участников выполняется одной транзакцией. Пул PostgreSQL ограничен десятью соединениями.

Пароли хешируются Argon2id и никогда не возвращаются в User. Redis хранит session:<token> с TTL из SESSION_TTL_SECONDS; токен случайный, длиной не менее 256 бит. Redis включён с AOF everysec, поэтому действующая сессия сохраняется при обычном перезапуске контейнера с volume. Кэш chats:<user_id> живёт 30 секунд и удаляется при создании чата. После записи сообщение читается только из PostgreSQL, поэтому кэш не может скрыть подтверждённую запись.

Курсор истории кодирует (created_at, id) и используется в параметризованном keyset-запросе. Все ответы получают X-Request-Id и X-Instance-Id, ошибки имеют единый контракт и не содержат SQL или stack trace.

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

Критерий Команда/сценарий Наблюдаемый результат Файл
Контракт и структура make check PASS: offline skeleton structure вывод команды
OpenAPI-схема make validate PYTHON=.venv/bin/python PASS: full OpenAPI 3.1 and JSON Schema validation вывод команды
Публичный smoke make test PASS: lab2 public API scenario вывод команды
PostgreSQL и миграции docker compose up -d --build API применяет 001_init.sql, данные находятся в PostgreSQL migrations/001_init.sql
Сохранность API/БД/сессии make test-persistence ACTION_SCRIPT=scripts/restart.sh подтверждённое сообщение и прежний Bearer-токен сохранены scripts/restart.sh
Redis с TTL и volume docker compose ps, redis-cli TTL session:* Redis healthy, TTL уменьшается, AOF включён compose.yaml
Индекс истории EXPLAIN (ANALYZE, BUFFERS) на 10 000 синтетических сообщениях Index Scan using messages_history_idx, 50 строк за 0.045 ms evidence/explain_history.txt
Уровень 4: race/rollback/expiry python tests/level4.py при TTL=2 1 регистрация получила 201, 7 гонок — 409; невалидный чат не появился; просроченная сессия — 401 tests/level4.py
Трек 5: кэш python evidence/track_cache.py 20 конкурентных холодных чтений дали 1 SQL-запрос; после очистки и рестарта Redis — 1 запрос на восстановление; запись инвалидирует ключ evidence/track_cache.json

Исследовательский трек: согласованность кэша

Гипотеза: Redis-кэш уменьшит задержку повторного чтения списка чатов, а явная инвалидация после создания чата сохранит read-after-write.

Методика: один синтетический пользователь на локальном Docker Compose, холодный GET /api/v1/chats, 30 последовательных чтений и 20 одновременных чтений после удаления ключа. Счётчик SQL-запросов включён только в локальном debug-режиме. В последнем прогоне получены cold 5.189 ms, warm p50 2.104 ms, warm p95 2.530 ms; 20 конкурентных запросов выполнили 1 SQL-чтение благодаря блокировке, после удаления ключа и рестарта Redis восстановление выполнило 1 SQL-чтение. После POST /api/v1/chats ключ пользователя удаляется; следующий GET заново читает PostgreSQL и возвращает новый чат. Ограничение измерения — один ноутбук и небольшой синтетический набор данных, поэтому результат показывает поведение защиты от stampede и направление задержки, а не универсальный RPS.

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

Воздействие Ожидание Наблюдение Потеря данных
Перезапуск API и Redis/PostgreSQL через scripts/restart.sh старый токен и подтверждённые данные сохраняются публичный persistence-тест прошёл 0 подтверждённых сообщений
Неверный Basic-пароль одинаковый 401 и Basic challenge проверено smoke нет
Logout и повторный запрос токен становится недействительным DELETE возвращает 204, повтор — 401 нет
Redis временно недоступен readiness 503, анонимный запрос не принимается получен HTTP 503 с unavailable, после запуска Redis — {"status":"ok"} нет; восстановление зависит от Redis
Короткий TTL SESSION_TTL_SECONDS=2 ... tests/level4.py прежний токен получил 401 после истечения, гонка регистрации дала 1×201 и 7×409 нет

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

Сессии зависят от Redis: при удалении его volume активные токены отзываются, хотя PostgreSQL-данные остаются. В обязательном API нет удаления пользователей/чатов и управления участниками. Для лаборатории 3 потребуется вынести идемпотентность сообщений и общие сессии на несколько API-реплик, сохранив этот PostgreSQL-контур.