Files
mtusi2026lab2/REPORT.md
T
afanasefff_a 736cb71bf7
Skeleton contracts / contracts (pull_request) Canceled after 0s
Заполнить отчёт лабораторной 2
2026-11-13 18:24:44 +03:00

4.7 KiB

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

  • Автор, группа: Афанасьев Андрей, БПИ2304
  • Целевая оценка; выбранный трек 5, если нужен: 3
  • Commit/PR: ветка solution/bpi2304-afanasyev; PR создаётся в mtusi2026/mtusi2026lab2
  • Использованные источники, библиотеки и помощь ИИ: PostgreSQL/JDBC, Jackson, jBCrypt, Docker Compose; помощь ИИ использовалась для переноса реализации и проверки контракта.

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

Требуется Docker с Compose. Версии образов зафиксированы в compose.yaml, Java 21 и Maven 3.9.9 используются внутри multi-stage Dockerfile.

cp .env.example .env
docker compose --env-file .env up -d --build
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
docker compose down

Миграция src/main/resources/db/migration/V1__initial.sql запускается API при первом подключении к PostgreSQL и отмечается в schema_version. Для намеренного удаления учебных данных используется только docker compose down -v.

Архитектура и решения

API написан на Java 21 и запускается в контейнере api; PostgreSQL является источником истины для пользователей, чатов, членства, сообщений и сессий. Именованный volume postgres_data сохраняет данные при пересоздании контейнеров. Создание чата и участников выполняется одной транзакцией. Перенесены endpoint пользователей, чатов, сообщений и пагинация из lab1; X-User-Id заменён на Basic-вход и Bearer-сессии. SESSION_TTL_SECONDS задаёт срок действия сессии, параметры базы передаются через DATABASE_*.

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

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke make test PASS: lab2 public API scenario tests/smoke.py
Persistence и действующая сессия make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS: данные и Bearer-сессия сохранены после перезапуска tests/resilience.py
Миграция и схема PostgreSQL docker compose up -d --build; запрос schema_version V1 применена; таблицы и ограничения созданы src/main/resources/db/migration/V1__initial.sql
Уровень 4 Не заявлен Не выполнялся —
Трек 5 Не заявлен Не выполнялся —

Проверка persistence пересоздаёт API и PostgreSQL-контейнеры без удаления именованного volume; тест использует прежний токен и проверяет сохранённые данные.

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

Для целевой оценки 3 отдельный нагрузочный эксперимент не заявлялся. Выполнен сценарий полного перезапуска с сохранением volume и действующей сессии.

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
Перезапуск API и PostgreSQL без удаления volume Данные и активная сессия сохраняются Persistence-тест завершился PASS Время восстановления менее 90 секунд, потери подтверждённых данных нет

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

Реализован обязательный минимум оценки 3. Redis/Valkey, несколько API-реплик, failover и исследовательские треки оценки 4/5 не реализованы. Сессии хранятся в PostgreSQL, поэтому их TTL контролируется запросом к базе и не продлевается при рестарте. .env, secrets и volumes не входят в Git.