Files
mtusi2026lab2/.github/pull_request_template.md
T
EgorAnti a5a24f1325
Skeleton contracts / contracts (pull_request) Canceled after 0s
fix validation empty pass and fix cache logic
2026-10-22 13:12:50 +03:00

53 lines
4.3 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
Целевая оценка (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:
```sh
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](../REPORT.md),
план запроса: [evidence/message-history-explain.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 не добавлялись.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.