Files
mtusi2026lab2/.github/pull_request_template.md
T

4.3 KiB
Raw Blame History

Лабораторная 2

Автор / группа: Антипин Егор Иванович, БПИ2301 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен

Что реализовано и что перенесено: пользователи, чаты, членство, сообщения и действующие сессии перенесены в PostgreSQL. Добавлены версионируемые Flyway-миграции, первичные и внешние ключи, уникальность username, атомарное создание чата и keyset-пагинация истории. Реализованы password KDF, Basic-вход только через POST /auth/sessions, opaque Bearer-сессии с expiry и logout, Spring Security и Swagger UI. Redis используется как cache-aside-кэш пользователей с TTL и fallback в PostgreSQL; включён AOF. Настроены ограниченные пулы соединений и таймауты.

Команды запуска из чистого clone:

cp .env.example .env
# Задать DATABASE_PASSWORD в локальном .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait
python3 -m pip install -r requirements-dev.txt
make check
make validate
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-operational
make explain-history

Результаты проверок и ссылка на REPORT.md: make check, make validate и make test — PASS; make test-persistence ACTION_SCRIPT=scripts/restart.sh подтвердил сохранение данных и действующей сессии после рестарта; make test-operational проверил expiry, logout, неверный пароль, отказы Redis и PostgreSQL, гонку регистрации и rollback создания чата; make explain-history подтвердил Index Scan без полного сканирования таблицы на 10 000 сообщениях. Подробности: REPORT.md, план запроса: evidence/message-history-explain.md.

Ограничения / известные ошибки: запущен один экземпляр API, высокая доступность не заявлена. Проверка каждой Bearer-сессии обращается в PostgreSQL для строгого expiry/logout; Redis кэширует только данные пользователя. Защита от cache stampede и нагрузочное исследование на 100 000+ сообщениях относятся к треку 5 и не реализованы. Известных ошибок обязательного уровня 4 нет.

Источники и использование ИИ: использованы материалы и контракт лабораторной работы, документация Spring Boot/Spring Security, PostgreSQL, Flyway и Redis. ИИ применялся для анализа архитектуры, подготовки реализации и тестовых сценариев; результат проверен автоматическими тестами и ручным просмотром изменений. Секреты, токены и приватные ключи ИИ не передавались и в Git не добавлялись.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.