6.8 KiB
Отчёт — лабораторная 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.