9.1 KiB
Лабораторная 2
- Автор, группа: Савин Александр БВТ2303
- Целевая оценка: 5; выбранный трек: 1 (cache consistency)
- 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.
Методика
- Создать пользователя и получить Bearer токен.
- Проверить, что токен сохраняется в Valkey с TTL.
- Сымитировать stale payload.
- Выполнить запрос к защищённому endpoint и проверить отклонение.
- Выполнить logout и убедиться, что кэш-ключ удалён.
- Подтвердить, что запросы с отозванным токеном возвращают 401.
Результат
Проверка подтверждает, что stale cache и logout корректно обрабатываются. Это соответствует требованиям уровня 5 и обеспечивает устойчивость аутентификации при падении/конфликте кэша.
Дополнительно была исправлена пагинация сообщений: курсор теперь корректно работает по (created_at, id) и связан с конкретным чатом, что закрывает публичный smoke test и устраняет повторяющуюся ошибку "second page must finish history".
Ограничения
- PostgreSQL остаётся источником истины; Valkey выполняет роль кэша, а не единственного хранилища.
- Полный stress benchmark на очень большие объёмы не выполнялся; здесь подтверждён корректный и проверяемый уровень 5, а не большой production benchmark.
- Для дальнейшей глубокой проверки можно добавить p50/p95/p99 метрики, конкурентный сценарий и разбор
EXPLAIN ANALYZEна истории сообщений.
Вывод
Лабораторная работа 2 выполнена в полном объёме: PostgreSQL задействован как реальный источник данных, Valkey используется как TTL-кэш сессий, аутентификация реализована по Basic/Bearer, а выбранный трек 1 по cache consistency подтверждён на живом стенде. Все ключевые проверки проходят: public smoke test, OpenAPI validation и проверка корректности кэша. Это соответствует README: уровень 4 + завершённый трек 1 для оценки 5.
Финальная рабочая версия исправлена, проверена и подготовлена к пушу в удалённый Gitea-репозиторий.
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