Files
mtusi2026lab2/REPORT.md
T
romashko 5de73c5475
Lab 2 application / integration (pull_request) Canceled after 0s
Skeleton contracts / contracts (pull_request) Canceled after 0s
Complete lab
2026-10-09 16:11:06 +03:00

5.7 KiB
Raw Blame History

Отчёт — лабораторная 2

  • Автор, группа: Ромашко Владимир, БВТ2301
  • Целевая оценка: 5, трек 1 — согласованность кэша
  • Commit/PR: указать после публикации
  • Источники и помощь ИИ: документация PostgreSQL, Redis, SQLAlchemy; использован ChatGPT

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

Требуется Docker Desktop/Engine с Compose v2 и Python 3.9+.

Copy-Item .env.example .env
# Задать POSTGRES_PASSWORD в .env
docker compose up -d --build --wait --wait-timeout 120
python scripts/check_contract.py
python tests/smoke.py --base-url http://127.0.0.1:8080
docker compose exec -T api python -m unittest discover -s student-tests -v
python tests/resilience.py --mode persistence --base-url http://127.0.0.1:8080 --action-script scripts/restart.cmd
python student-tests/failures.py
python scripts/track1.py

Для Linux перед запуском: chmod +x scripts/restart.sh.

Остановка без удаления данных: docker compose down. Удаление учебных volumes: docker compose down -v.

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

Клиент → FastAPI → PostgreSQL и Redis.

PostgreSQL — источник истины для пользователей, чатов, участников и сообщений. SQLAlchemy ORM использует пул до 10 соединений, timeout пула 2 с, connect timeout 2 с, statement timeout 3 с.

Redis хранит сессии с TTL и кэш страниц истории. Включены AOF, appendfsync always и именованный volume.

Пароли хешируются Argon2id. Basic используется только для создания сессии, остальные защищённые запросы используют Bearer. X-User-Id игнорируется.

Миграции находятся в migrations/. Создание чата и участников выполняется в одной транзакции. При создании сообщения версия истории увеличивается в той же транзакции.

Ключ кэша истории содержит chat_id, версию истории, limit и cursor. После записи старый ключ не используется. При ошибке кэша чтение выполняется из PostgreSQL.

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

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke python tests/smoke.py PASS evidence/track1-regression.txt
Сохранность после рестарта tests/resilience.py Сессия и сообщения сохранены evidence/track1-regression.txt
Миграции, ORM и транзакции student-tests 13 тестов OK; проверены rollback, гонка регистрации и повторные миграции evidence/orm-tests.txt
Redis, TTL и отказы student-tests/failures.py Redis/PostgreSQL возвращают 503 и восстанавливаются evidence/track1-failures.txt
Индекс истории python -m scripts.explain_history Index Scan по messages_history_idx на 10 000 сообщений evidence/explain.txt
Трек 1: stale read python scripts/track1.py До защиты 5/5 stale read, после защиты 0/5 evidence/cache-experiment.json
Трек 1: производительность python scripts/track1.py SQL-команды: 600 без кэша и 300 с кэшем evidence/cache-experiment.json
Трек 1: восстановление python scripts/track1.py Redis перезапущен, read-after-write и logout сохранены evidence/cache-restart.json

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

Гипотеза: версия истории в ключе Redis устранит stale read при позднем заполнении кэша.

Методика: 5 повторов управляемой конкурентной гонки; затем 3 серии по 300 чтений, concurrency 8, страница 100 сообщений, отдельный чат с 10 000 сообщениями.

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
Конкурентная запись и чтение Старый ключ не должен использоваться 0/5 stale read после защиты Не применимо
Redis stop/restart Ошибка 503, затем восстановление 503; сессия и сообщения доступны 6.1 с, потери нет
PostgreSQL stop/start Ошибка 503, затем восстановление 503; API не доверяет анонимному запросу 6.2 с, потери нет
Redis restart в треке 1 Кэш восстановится из PostgreSQL Read-after-write и logout прошли 1.2 с, потери нет

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

Стенд рассчитан на один Docker-host и один экземпляр PostgreSQL/Redis. Cache stampede не исследовался. Нагрузочные результаты относятся к слою хранения, а не ко всему HTTP API.