Files
mtusi2026lab2/REPORT.md
T
2026-10-21 20:10:27 +03:00

6.8 KiB
Raw Blame History

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

  • Антипин Егор Иванович, БПИ2301
  • Целевая оценка: 4.
  • Commit/PR: заполнить после публикации.
  • Runtime: Java 23, Spring Boot 4.1.1, PostgreSQL 16.4, Redis 7.4, Python 3.11.

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

Требуются Docker Desktop/Compose, JDK 23 и Python 3.9+.

cp .env.example .env
# Заменить DATABASE_PASSWORD в локальном .env; файл игнорируется Git.
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait
python3 -m pip install -r requirements-dev.txt

Безопасная остановка сохраняет данные: docker compose --env-file .env stop. Намеренное удаление учебных данных: docker compose --env-file .env down -v.

Архитектура и источники истины

Путь запроса: клиент → Spring Security/API → PostgreSQL. Redis является необязательным cache-aside-ускорителем чтения пользователя после проверки Bearer-сессии.

PostgreSQL — источник истины для пользователей, чатов, членства, сообщений и сессий. Сессия хранит SHA-256-хеш opaque-токена, абсолютный expires_at и revoked_at. Каждый Bearer-запрос сначала проверяет в PostgreSQL, что сессия существует, не отозвана и не истекла. Только после этого пользователь берётся из Redis либо PostgreSQL. Поэтому Redis не может авторизовать отозванный токен.

Redis хранит messenger:user:<uuid> с TTL 300 секунд. Cache miss и недоступность Redis приводят к чтению PostgreSQL. Повреждённая запись удаляется. API пока не содержит изменения/удаления пользователя; при появлении такой операции ключ должен удаляться после commit. Redis настроен с AOF appendfsync everysec и именованным volume, хотя корректность не зависит от сохранности кэша.

Все JDBC-значения передаются параметрами. Динамические части запросов состоят только из статических фрагментов приложения. HikariCP ограничен 10 соединениями, JDBC-запросы/транзакции имеют таймаут 5 секунд. Lettuce pool ограничен 8 соединениями, connect timeout — 1 секунда, command/max-wait — 500 мс.

Создание чата — транзакция: INSERT чата и все INSERT членства либо фиксируются вместе, либо полностью откатываются. Уникальность username обеспечивается PostgreSQL, поэтому работает между процессами API; предварительный SELECT служит только быстрым путём ответа.

Подробное описание находится в infra/database-design.md.

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

Критерий Команда/сценарий Наблюдаемый результат Доказательство
Контракт и структура make check, make validate PASS stdout команд
Публичный API make test PASS: lab2 public API scenario tests/smoke.py
Полный рестарт make test-persistence ACTION_SCRIPT=scripts/restart.sh сообщение и сессия сохранены hook перезапускает postgres redis api без down -v
Expiry/logout/password/отказы make test-operational PASS для всех сценариев tests/operational.py
Гонка username 12 параллельных POST одного username один 201, остальные 409 tests/operational.py
Rollback чата временный trigger отклоняет участника API 503, строки чата нет tests/operational.py
Индекс истории make explain-history Index Scan, без Seq Scan, 10 000 строк evidence/message-history-explain.md
Java integration tests gradlew test с локальными DS env BUILD SUCCESSFUL, 10 тестов Gradle report
Secrets/volumes git ls-files и ignore-файлы приватные файлы не отслеживаются .gitignore, .dockerignore

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

Воздействие Ожидание Наблюдение Восстановление / потеря
Redis остановлен cache-aside обходит кэш Bearer /users/me остаётся 200 через PostgreSQL после start кэш заполняется снова; потери нет
PostgreSQL остановлен кэш не обходит проверку сессии Bearer получает 503; анонимный запрос — 401 соединения восстанавливаются; потери нет
TTL сессии 2 секунды токен перестаёт действовать до expiry 200, после 2.5 секунды 401 повторный Basic login создаёт новую сессию
Logout текущий токен отозван DELETE 204, следующий запрос 401 отзыв постоянный в PostgreSQL
Рестарт всех компонентов volumes сохраняются прежний токен и сообщение доступны автоматическое ожидание readiness; потери нет

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

  • Стенд содержит один экземпляр API; высокая доступность API не заявлена.
  • Redis ускоряет чтение пользователя, но проверка сессии всегда обращается в PostgreSQL ради строгих expiry/logout. Это осознанный компромисс корректности и производительности.
  • Защита от cache stampede и измерение latency/числа SQL-запросов относятся к треку 5 и не заявлены.
  • EXPLAIN проверяет 10 000 равномерных сообщений; набор 100 000+ относится к треку 5.