# Отчёт — лабораторная 2 - Автор, группа: Ромашко Владимир, БВТ2301 - Целевая оценка: 5, трек 1 — согласованность кэша - Commit/PR: указать после публикации - Источники и помощь ИИ: документация PostgreSQL, Redis, SQLAlchemy; использован ChatGPT ## Запуск из чистого clone Требуется Docker Desktop/Engine с Compose v2 и Python 3.9+. ```powershell 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.