Files
mtusi2026lab2/REPORT.md
T
2026-10-16 16:40:49 +03:00

8.5 KiB

Лабораторная 2

  • Автор, группа: Савин Александр БВТ2303
  • Целевая оценка: 5; выбранный трек: 1
  • Commit/PR: локальный рабочий результат в текущем clone, подготовленный к пушу в Gitea
  • Использованные источники, библиотеки и помощь ИИ: README проекта, OpenAPI-контракт, FastAPI, Uvicorn, PostgreSQL, Valkey/Redis client, Python 3.13

Запуск из чистого окружения

cd /Users/alexander/Documents/вп/mtusi2026lab2
docker-compose up -d db valkey

Запуск API в отдельной вкладке терминала:

cd /Users/alexander/Documents/вп/mtusi2026lab2
. .venv/bin/activate
CACHE_URL=redis://localhost:6379/0 \
SESSION_STORE=valkey \
DATABASE_URL=postgresql://messenger:messenger@localhost:5432/messenger \
SESSION_TTL_SECONDS=3600 \
uvicorn app:app --host 0.0.0.0 --port 8080

Проверка:

make test

Для очистки состояния и повторного запуска:

docker-compose down -v

Важный момент: API и тесты исполняются в разных терминальных вкладках. При конфликте порта 8080 нужно сначала остановить старый uvicorn.

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

  • Источник истины — PostgreSQL. В БД хранятся пользователи, чаты, сообщения и сессии.
  • Кэш — Valkey. В кэше держится session:<token> с TTL. Это делает cache layer контролируемым и временным, а не единственным хранилищем.
  • Пароли хранятся в виде Argon2 hash.
  • Basic auth используется для входа и создания токена сессии.
  • Bearer auth используется для доступа к защищённым endpoint.
  • При logout токен отзывается, а кэшовая запись удаляется.
  • Ожидание stale cache: если кэш указывает на устаревший или поддельный токен, приложение не должно доверять ему и должно отклонить запрос или проверить источник истины.
  • API-слой оформлен в соответствии с OpenAPI 3.1 и JSON Schema.
  • Реализация покрывает весь минимальный уровень lab2 и дополнительно выбранный трек 1 по согласованности кэша, что соответствует README для уровня 5.

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

Критерий README Команда / сценарий Наблюдаемый результат Файл доказательства
Public smoke test make test PASS: лабораторный сценарий успешно пройден stdout команды make test
OpenAPI validation make validate PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested stdout команды make validate
Cache consistency make cache-consistency cache_key_exists=True, ttl_seconds=3599, stale_cache_rejected=True, logout_revokes_cache=True stdout команды make cache-consistency
Источник истины и кэш PostgreSQL + Valkey Данные живут в БД, кэш хранит только временные session snapshots лог запуска и тесты

Проверки и свежие результаты

1. Smoke test

Команда:

cd /Users/alexander/Documents/вп/mtusi2026lab2 && . .venv/bin/activate && make test

Вывод:

python3 tests/smoke.py --base-url "http://localhost:8080"
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.

2. OpenAPI validation

Команда:

cd /Users/alexander/Documents/вп/mtusi2026lab2 && . .venv/bin/activate && make validate

Вывод:

python3 scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.

3. Cache consistency proof

Команда:

cd /Users/alexander/Documents/вп/mtusi2026lab2 && . .venv/bin/activate && make cache-consistency

Вывод:

python3 tests/cache_consistency.py
cache_key_exists=True
ttl_seconds=3599
avg_latency_ms=11.44
p95_latency_ms=12.35
stale_cache_rejected=True
logout_revokes_cache=True

Таблица результатов по уровню 5

Проверка Ожидание Факт Статус
В кеше существует session key есть запись для токена cache_key_exists=True PASS
TTL работает запись истекает по таймауту ttl_seconds=3599 PASS
Stale cache не принимается старые данные не должны использоваться stale_cache_rejected=True PASS
Logout отменяет сессию запись удаляется и запросы с токеном отклоняются logout_revokes_cache=True PASS
Latency запросы выполняются быстро avg_latency_ms=11.44, p95_latency_ms=12.35 PASS

Эксперимент и вывод по треку 1 (cache consistency)

Гипотеза

Если в Valkey лежит stale или поддельный payload, сервис не должен доверять кэшу и должен либо отозвать сессию, либо проверить источник истины в PostgreSQL.

Методика

  1. Создать пользователя и получить Bearer токен.
  2. Проверить, что токен сохраняется в Valkey с TTL.
  3. Сымитировать stale payload.
  4. Выполнить запрос к защищённому endpoint и проверить отклонение.
  5. Выполнить logout и убедиться, что кэш-ключ удалён.
  6. Подтвердить, что запросы с отозванным токеном возвращают 401.

Результат

Проверка подтверждает, что stale cache и logout корректно обрабатываются. Это соответствует требованиям уровня 5 и обеспечивает устойчивость аутентификации при падении/конфликте кэша.

Дополнительно была исправлена пагинация сообщений: курсор теперь корректно работает по (created_at, id) и связан с конкретным чатом, что закрывает публичный smoke test и устраняет повторяющуюся ошибку "second page must finish history".

Ограничения

  • PostgreSQL остаётся источником истины; Valkey выполняет роль кэша, а не единственного хранилища.
  • Полный stress benchmark на очень большие объёмы не выполнялся; здесь подтверждён корректный и проверяемый уровень 5, а не большой production benchmark.

Вывод

Лабораторная работа 2 выполнена в полном объёме: PostgreSQL задействован как реальный источник данных, Valkey используется как TTL-кэш сессий, аутентификация реализована по Basic/Bearer, а выбранный трек 1 по cache consistency подтверждён на живом стенде. Все ключевые проверки проходят: public smoke test, OpenAPI validation и проверка корректности кэша.

lsof -t -i :8080 | xargs kill -9
cd /Users/alexander/Documents/вп/mtusi2026lab2
. .venv/bin/activate
CACHE_URL=redis://localhost:6379/0 \
SESSION_STORE=valkey \
DATABASE_URL=postgresql://messenger:messenger@localhost:5432/messenger \
SESSION_TTL_SECONDS=3600 \
uvicorn app:app --host 0.0.0.0 --port 8080
curl -s http://localhost:8080/health/live
curl -s http://localhost:8080/health/ready