7.5 KiB
Отчёт — лабораторная 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: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.