diff --git a/.dockerignore b/.dockerignore index bc16e556..796eb7ed 100644 --- a/.dockerignore +++ b/.dockerignore @@ -18,3 +18,4 @@ __pycache__ node_modules evidence .DS_Store +!gradle-9.7.1-bin.zip \ No newline at end of file diff --git a/Dockerfile b/Dockerfile index e9438fbb..20085dbd 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,15 +1,20 @@ FROM eclipse-temurin:21-jdk-jammy AS builder WORKDIR /build +RUN apt-get update && apt-get install -y --no-install-recommends unzip \ + && rm -rf /var/lib/apt/lists/* COPY gradle gradle COPY gradlew settings.gradle build.gradle ./ -RUN ./gradlew dependencies --no-daemon +COPY gradle-9.7.1-bin.zip /tmp/gradle.zip +RUN unzip -q /tmp/gradle.zip -d /opt && rm /tmp/gradle.zip +ENV PATH="/opt/gradle-9.7.1/bin:$PATH" +RUN gradle dependencies --no-daemon COPY contracts contracts COPY src src -RUN ./gradlew bootJar -x test --no-daemon +RUN gradle bootJar -x test --no-daemon -FROM eclipse-temurin:21-jre-alpine AS runner +FROM eclipse-temurin:21-jre-jammy AS runner WORKDIR /app -RUN addgroup -S spring && adduser -S spring -G spring +RUN groupadd --system spring && useradd --system --gid spring --no-create-home spring COPY --from=builder /build/build/libs/*.jar app.jar RUN chown spring:spring app.jar USER spring diff --git a/REPORT.md b/REPORT.md index e42f2b05..6f5fd99a 100644 --- a/REPORT.md +++ b/REPORT.md @@ -11,16 +11,54 @@ TODO: версии runtime/образов, prerequisites, команды соз ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab1, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +Схема процессов/хранилищ: +Клиент → 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 | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +| Критерий 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 требует подтверждения, какие реальные процессы/хранилища перезапущены. diff --git a/build.gradle b/build.gradle index 8952432a..e28f457d 100644 --- a/build.gradle +++ b/build.gradle @@ -36,6 +36,10 @@ dependencies { implementation 'org.bouncycastle:bcprov-jdk18on:1.78.1' implementation 'org.springframework.boot:spring-boot-starter-security' implementation 'org.springframework.boot:spring-boot-starter-oauth2-resource-server' + implementation 'org.springframework.boot:spring-boot-starter-cache' + implementation 'org.springframework.boot:spring-boot-starter-aspectj' + + runtimeOnly 'io.netty:netty-transport-native-epoll::linux-x86_64' testImplementation 'org.springframework.boot:spring-boot-starter-test:4.1.1' diff --git a/evidence/lab2/level3-2026-10-08_65bd58c/04-compose-ps-before.txt b/evidence/lab2/level3-2026-10-08_65bd58c/04-compose-ps-before.txt new file mode 100644 index 00000000..518a09fb Binary files /dev/null and b/evidence/lab2/level3-2026-10-08_65bd58c/04-compose-ps-before.txt differ diff --git a/evidence/lab2/level3-2026-10-08_65bd58c/06-compose-ps-after.txt b/evidence/lab2/level3-2026-10-08_65bd58c/06-compose-ps-after.txt new file mode 100644 index 00000000..ab146b9c Binary files /dev/null and b/evidence/lab2/level3-2026-10-08_65bd58c/06-compose-ps-after.txt differ diff --git a/evidence/lab2/level3-2026-10-08_65bd58c/07-gitignore.txt b/evidence/lab2/level3-2026-10-08_65bd58c/07-gitignore.txt new file mode 100644 index 00000000..a341c0f1 Binary files /dev/null and b/evidence/lab2/level3-2026-10-08_65bd58c/07-gitignore.txt differ diff --git a/evidence/lab2/level4-2026-10-08_65bd58c/01-redis-keys.txt b/evidence/lab2/level4-2026-10-08_65bd58c/01-redis-keys.txt new file mode 100644 index 00000000..49cc8ef0 Binary files /dev/null and b/evidence/lab2/level4-2026-10-08_65bd58c/01-redis-keys.txt differ diff --git a/evidence/lab2/level4-2026-10-08_65bd58c/02-redis-ttl.txt b/evidence/lab2/level4-2026-10-08_65bd58c/02-redis-ttl.txt new file mode 100644 index 00000000..f71aab7d Binary files /dev/null and b/evidence/lab2/level4-2026-10-08_65bd58c/02-redis-ttl.txt differ diff --git a/src/main/java/ru/mtusi/messenger/config/RedisConfig.java b/src/main/java/ru/mtusi/messenger/config/RedisConfig.java index 854f4dfe..190bfa37 100644 --- a/src/main/java/ru/mtusi/messenger/config/RedisConfig.java +++ b/src/main/java/ru/mtusi/messenger/config/RedisConfig.java @@ -83,19 +83,19 @@ public class RedisConfig implements CachingConfigurer { return new CacheErrorHandler() { @Override public void handleCacheGetError(RuntimeException e, Cache cache, Object key) { - log.warn("Cache GET failed ({}): {}", cache.getName(), e.getMessage()); + log.warn("Cache GET failed ({}): {}", cache.getName(), e.getMessage(), e); } @Override public void handleCachePutError(RuntimeException e, Cache cache, Object key, Object value) { - log.warn("Cache PUT failed ({}): {}", cache.getName(), e.getMessage()); + log.warn("Cache PUT failed ({}): {}", cache.getName(), e.getMessage(), e); } @Override public void handleCacheEvictError(RuntimeException e, Cache cache, Object key) { - log.warn("Cache EVICT failed ({}): {}", cache.getName(), e.getMessage()); + log.warn("Cache EVICT failed ({}): {}", cache.getName(), e.getMessage(), e); } @Override public void handleCacheClearError(RuntimeException e, Cache cache) { - log.warn("Cache CLEAR failed ({}): {}", cache.getName(), e.getMessage()); + log.warn("Cache CLEAR failed ({}): {}", cache.getName(), e.getMessage(), e); } }; } diff --git a/src/main/java/ru/mtusi/messenger/config/SecurityConfig.java b/src/main/java/ru/mtusi/messenger/config/SecurityConfig.java index d61091fb..a29ab546 100644 --- a/src/main/java/ru/mtusi/messenger/config/SecurityConfig.java +++ b/src/main/java/ru/mtusi/messenger/config/SecurityConfig.java @@ -60,6 +60,7 @@ public class SecurityConfig { ).permitAll() .requestMatchers(HttpMethod.POST, "/api/v1/users").permitAll() .requestMatchers(HttpMethod.POST, "/api/v1/auth/sessions").permitAll() + .requestMatchers("/actuator/health", "/actuator/health/**").permitAll() .anyRequest().authenticated()) .addFilterBefore(sessionFilter, UsernamePasswordAuthenticationFilter.class) .exceptionHandling(eh -> eh.authenticationEntryPoint(entryPoint)); diff --git a/src/main/resources/application.yaml b/src/main/resources/application.yaml index 29c9d928..3f85cde9 100644 --- a/src/main/resources/application.yaml +++ b/src/main/resources/application.yaml @@ -49,12 +49,15 @@ management: endpoints: web: exposure: - include: health,metrics + include: health,metrics,caches endpoint: health: probes: enabled: true show-details: always + caches: + enabled: true + app: limits: @@ -76,4 +79,7 @@ app: logging: pattern: - console: "%d{ISO8601} %-5level [%X{requestId}] %logger{20} - %msg%n" \ No newline at end of file + console: "%d{ISO8601} %-5level [%X{requestId}] %logger{20} - %msg%n" + level: + org.springframework.cache: TRACE + org.springframework.cache.interceptor: TRACE \ No newline at end of file