53 lines
4.3 KiB
Markdown
53 lines
4.3 KiB
Markdown
## Лабораторная 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 содержит инструкцию именно моего решения.
|