Files
mtusi2026lab2/REPORT.md
T
2026-10-08 15:39:19 +03:00

7.5 KiB
Raw Blame History

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

  • Автор, группа: TODO
  • Целевая оценка; выбранный трек 5, если нужен: TODO
  • Commit/PR: TODO после публикации
  • Использованные источники, библиотеки и помощь ИИ: TODO

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

TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.

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

Схема процессов/хранилищ: Клиент → API (Spring Boot 4, Java 21) → PostgreSQL 16. На уровне 4 добавлен Redis 7.4 как кэш активных сессий. Все три сервиса в одном compose.yaml, объединены сетью messenger-net, volumes — pgdata и redisdata.

Источник истины: PostgreSQL. Пользователи, чаты, участники, сообщения и сессии хранятся в нём. Redis (уровень 4) — производное хранилище, кэш. При расхождении верим Postgres. При недоступности Redis приложение продолжает работать через Postgres.

Транзакционные границы: ChatService.createChat — @Transactional: вставка в chats + N вставок в chat_members. При ошибке любого INSERT — откат целиком (проверено rollback-сценарием). MessageService.createMessage — @Transactional: ACL-проверка, COUNT лимита, INSERT messages. SessionService.createSession — @Transactional: INSERT sessions + запись в Redis-кэш. requireActive, listChats, listMessages — @Transactional(readOnly = true).

Ограничения: Кэш сессий в Redis не инвалидируется по TTL-истечении Postgres-записи — только по expiresAt при чтении. При жёстком рассинхроне максимум до SESSION_TTL_SECONDS может висеть «протухшая» копия. Keyset-пагинация в JPQL транслируется в OR-условие — индекс используется как диапазон только в native-варианте. Один узел Postgres, без репликации; RPO = время с последнего pg_dump.

Перенесено из lab1: модель чатов и сообщений, CRUD-эндпоинты, структура DTO.

Изменено в этой работе: состояние переехало в Postgres (вместо in-memory), добавлены Flyway-миграции, аутентификация переведена с X-User-Id на Basic → Bearer с opaque-токеном, пароли хешируются BCrypt, на уровне 4 добавлен Redis для кэша сессий, на уровне 5 — исследование плана запроса и восстановления.

Соответствие .env → конфигурации: .env Куда попадает Роль APP_ENV SPRING_PROFILES_ACTIVE профиль Spring SESSION_TTL_SECONDS app.session.ttl TTL сессии и кэша SESSION_STORE флаг выбора хранилища сессий postgres / redis REDIS_COMMAND_TIMEOUT app.redis.command-timeout таймаут команды Lettuce REDIS_CONNECT_TIMEOUT app.redis.connect-timeout таймаут TCP-connect POSTGRES_* (secrets) SPRING_DATASOURCE__FILE креды БД через Docker secrets SPRING_DATA_REDIS_HOST/PORT spring.data.redis. адрес Redis

Секреты БД передаются через Docker secrets (/run/secrets/postgres_*), не через .env; .env содержит только неконфиденциальные параметры.

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

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke py tests/smoke.py PASS evidence/lab2/level3-/03-smoke.log
Persistence py tests/resilience.py --mode persistence PASS 05-persistence.log + 04/06-compose-ps
Структура и контракт py scripts/check_contract.py; validate_openapi.py PASS 01-check.log, 02-validate.log
Секреты не в Git git check-ignore 4 пути игнорируются 07-gitignore.txt
Составная операция атомарна @Transactional в ChatService код в репо src/main/java/ru/mtusi/messenger/service/ChatService.java
Все пункты уровня 4, если заявлен TODO TODO TODO
Выбранный трек 5, если заявлен TODO TODO TODO

TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.

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

TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
TODO TODO TODO TODO

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

TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.