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.