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

83 lines
5.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Отчёт — лабораторная 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.