vikulin-va.ru

Почему jOOQ вместо JPA / MyBatis / Spring Data

Fri, 8 May 2026 18:29:42 GMT

Почему мы выбрали jOOQ как persistence-слой в Use Case Pattern + DDD + CQRS. Сравнение с Hibernate/JPA, MyBatis, Spring Data JDBC: где они скрывают SQL и ломают агрегат, а где jOOQ оставляет контроль команде.

ddd-building-blocks: DDD-абстракции для Java

Sat, 9 May 2026 05:36:53 GMT

ddd-building-blocks — open-source библиотека DDD-абстракций для Java/Spring: Entity, AggregateRoot, ValueObject, DomainEvent, Repository, Specification. Эталонная база, на которую опираются правила R-ENT/R-AGG/R-VO и AI-скилл ucp-ddd-tactical-review.

usecase-pattern — Java-библиотека UseCase / Handler / Dispatcher

Sun, 17 May 2026 07:52:11 GMT

usecase-pattern — open-source Java-библиотека: UseCase / UseCaseHandler / UseCaseDispatcher, маркеры UseCaseCommand / UseCaseQuery для CQRS, Spring Boot auto-configuration, метрики Micrometer на каждый use case. Эталонная база для слоистой архитектуры Use Case Pattern.

hexagonal-architecture — аннотации портов/адаптеров + ArchUnit

Sun, 17 May 2026 07:52:11 GMT

hexagonal-architecture — open-source Java-библиотека: аннотации @Port, @Adapter, @UseCase для разметки слоёв Ports & Adapters + ArchUnit-правила, которые ловят нарушения границ домена и инфраструктуры на каждом PR. Теория и обоснование выбора — в разделе «Гексагональная архитектура».

Executable engineering standard: AI-скилл это твой ESLint для архитектуры

Thu, 7 May 2026 19:28:02 GMT

У вас уже есть линтер для запятых. У вас нет линтера для агрегатов и доменных событий. AI-скиллы с corpus правил — это второй линтер, и его исполняет LLM. Сравнение с SonarQube и ESLint, концепт «rule corpus + executor», когда не нужен.

AI-скиллы vs SonarQube vs ESLint vs ревью тимлидом

Thu, 7 May 2026 19:28:02 GMT

Чем AI-скиллы как executable engineering standard отличаются от SonarQube, ESLint и обычного code review глазами тимлида. Таблица сравнения по 12 параметрам, когда что использовать вместе.

AI пишет код. Зачем тогда методология?

Thu, 7 May 2026 18:16:30 GMT

Самое частое возражение к Use Case Pattern: «зачем учить методологию, если Claude и так пишет код». Полный ответ с экспериментом, пятью сценариями где AI без методологии разваливается, разбором что такое «общий контекст» технически, и историческими параллелями.

Как ревьюить код, который написал AI

Thu, 7 May 2026 18:16:30 GMT

Объём AI-кода в 5–10 раз выше, обычный review-цикл размыкается. Что искать в первую очередь, что отдать автоматам, как масштабировать через AI-скиллы и spec-as-code. Антипаттерны, чек-лист команды на 15 пунктов.

AI как design-критик: то, что не делает code-generator

Thu, 7 May 2026 18:16:30 GMT

AI как код-генератор известен. Менее известно — он делает работу архитектора, которую человек обычно проваливает: валидация спеки до кодогенерации. Ловит синонимы в Ubiquitous Language, агрегаты с >7 инвариантами, события без потребителей, команды без владельца. 9 категорий проверок и скилл ucp-spec-review.

Какой язык программирования выбрать для AI-кодинга в команде

Thu, 7 May 2026 18:16:30 GMT

Для одиночного разработчика язык вторичен — AI работает везде. Для команды на годы — определяющий выбор. Четыре критерия AI-friendly языка, сравнение Java/Python/Go/Rust/Scala и других, что компенсировать если стек уже выбран.

AI-native компания: маленькая команда + агенты, и почему ей всё равно нужна методология

Thu, 7 May 2026 18:16:30 GMT

PO + тимлид + по одному senior-инженеру на компетенцию + Claude и агенты вместо штата — модель, в которой 3–7 человек выкатывают продукт, на который раньше нужны были 30–50. Что это такое, как устроена разработка внутри, где разваливается без методологии, и что нужно положить поверх, чтобы кодовая база пережила первый год.

Уровень зрелости 0: As-is (реверс из кода)

Fri, 22 May 2026 05:58:06 GMT

Нижняя ступень: спецификация восстановлена из существующего кода без бизнес-брифа. Снимок «как сейчас» для онбординга brownfield-сервиса и точка отсчёта для миграции на уровень 1/2/3.

Уровень зрелости 1: Слоёный

Sun, 26 Apr 2026 15:57:40 GMT

Базовая ступень: слоёная архитектура Controller → Service → Repository без Use Case Pattern. Когда её достаточно, где она ломается и какой сигнал говорит, что пора на уровень 2.

Уровень зрелости 2: Use Case Pattern

Sun, 26 Apr 2026 15:57:40 GMT

Каждая бизнес-операция — отдельный UseCase + Handler, общий диспетчер, метрики на операцию. CQRS (UseCaseCommand / UseCaseQuery + Read Model) — опция этого уровня.

Уровень зрелости 3: DDD + Hexagonal

Sun, 26 Apr 2026 15:57:40 GMT

Высший уровень: инварианты живут в доменной модели (агрегаты, value objects, доменные события), а инфраструктура изолирована портами и адаптерами с ArchUnit. DDD и Hexagonal — один уровень.

Use Case спецификация: формат

Sun, 26 Apr 2026 15:33:23 GMT

Формат спецификации Bounded Context: один файл на контекст + по файлу на агрегат, домен без техники, карточки команд и запросов, события у агрегатов, контракты на рёбрах интеграций. Уровни зрелости 1/2/3.

Use Case Pattern: пошаговый гид по применению

Wed, 29 Apr 2026 19:22:29 GMT

Практический гид: что и в каком порядке делать, чтобы получить результат. Два сценария — один UseCase за 3 минуты и целый сервис от спеки до прода за день-два. Команды, ожидаемый результат, чек-листы и антипаттерны.

Настройка Claude Code под UCP (Use Case Pattern)

Tue, 28 Apr 2026 15:17:55 GMT

Установка стека за 5 шагов: usecase-pattern-skills, superpowers (оркестратор), context7 (актуальная документация). Два сценария — один UseCase за 3 минуты и целый сервис от спеки до прода за день-два. Решение проблем.

Карта сервисов маркетплейса: от бизнес-брифа к архитектуре

Mon, 4 May 2026 17:44:28 GMT

Промежуточный артефакт между бизнес-брифом и спекой Уровня 3 каждого сервиса. На примере маркетплейса показано 7 шагов: Event Storming → Bounded Contexts → монолит vs микросервисы → карта сервисов с границами → data ownership → интеграции (sync/async/Saga) → failure domains → C4. Без этого пласта AI быстро сгенерирует код по плохой спеке.

Notification Service — Use Case спецификация (Уровень 1)

Mon, 27 Apr 2026 07:08:32 GMT

Полная Use Case спецификация Notification Service из кейса маркетплейса. Уровень 1: классическая слоёная архитектура без UseCase Pattern и DDD. Контрпример к Order Service — показывает, когда DDD избыточен.

Catalog Service — Use Case спецификация (Уровень 2)

Mon, 27 Apr 2026 18:58:07 GMT

Полная Use Case спецификация Catalog Service из кейса маркетплейса. Уровень 2: UseCase Pattern без DDD-агрегатов. Простая state machine, ABAC-проверки в handler'е, jOOQ-репозитории.

Catalog Service: пошаговая генерация от бизнес-описания до кода

Wed, 29 Apr 2026 19:35:11 GMT

Полный сеанс работы с Use Case Pattern на примере Catalog Service: конкретные промпты, выдержки из ответов AI, последовательность команд от бизнес-описания до работающего кода. Уровень 2 за 3 часа.

Order Service — Use Case спецификация (Уровень 3)

Sun, 26 Apr 2026 17:43:35 GMT

Use Case спецификация Order Service из кейса маркетплейса. Уровень 3 (DDD + Hexagonal): три агрегата — Order, Dispute, Refund. Домен без техники, события у агрегатов, контракты на рёбрах, Outbox и ABAC.

Что такое DDD и зачем он нужен

Sat, 11 Apr 2026 15:41:43 GMT

Введение в Domain Driven Design: какую проблему он решает, когда оправдан и когда избыточен, основные концепции — доменная модель, контексты, единый язык. База перед стратегическими и тактическими паттернами.

Стратегические паттерны DDD

Sat, 11 Apr 2026 15:41:43 GMT

Стратегические паттерны DDD: Bounded Context, Context Map, Ubiquitous Language, поддомены (core/supporting/generic). Как разрезать большую систему на сервисы по бизнес-смыслу, а не по таблицам.

Тактические паттерны DDD

Sat, 11 Apr 2026 15:41:43 GMT

Тактические паттерны DDD: Entity, Value Object, Aggregate, Repository, Domain Event — с примерами Java/Spring и описанием каждого паттерна. Правила-якоря с кодами R-ENT/R-VO/R-AGG для AI-ревью — в DDD Tactical Style Guide.

Интеграционные паттерны DDD

Sat, 11 Apr 2026 15:41:43 GMT

Интеграционные паттерны DDD: ACL (Anti-Corruption Layer), Open Host Service, Published Language, Conformist, Customer/Supplier. Как соединять Bounded Context-ы без утечки чужой модели в свой код.

Принципы проектирования в DDD

Sat, 11 Apr 2026 15:41:43 GMT

Принципы проектирования в DDD: инварианты внутри агрегата, границы транзакций по агрегату, eventual consistency между агрегатами. Базовые правила, которые ловятся AI-скиллом ucp-ddd-tactical-review на ревью PR.

CQRS

Mon, 18 May 2026 07:54:55 GMT

CQRS: разделение моделей чтения и записи. Когда применять, цена eventual consistency, как ложится на Use Case Pattern уровня 2 и Spring Boot. Без переусложнения.

Гексагональная архитектура

Mon, 18 May 2026 07:54:55 GMT

Ports & Adapters: изоляция бизнес-логики от инфраструктуры. Gradle multi-module, домен на чистой Java, тесты без Spring. Соответствует Use Case Pattern уровня 4 — берётся под сложные модули, не везде.

Паттерны авторизации

Mon, 18 May 2026 07:54:55 GMT

Обучающий гайд по аутентификации и авторизации для SPA, мобильных приложений и микросервисов: OAuth2, JWT, RBAC, ABAC. Со схемами и Spring Boot примерами. Стандартные правила с кодами AUTH-N — отдельным style guide.

Распределённые паттерны

Mon, 18 May 2026 07:54:55 GMT

2PC, 3PC, SAGA, Transactional Outbox, CDC, Event Sourcing, Idempotent Consumer, Distributed Lock — как обеспечить согласованность данных между сервисами. Когда какой паттерн оправдан, как ложится на Java/Spring и Kafka.

Паттерны отказоустойчивости

Mon, 18 May 2026 07:54:55 GMT

Retry, Circuit Breaker, Timeout, Bulkhead, Fallback, Rate Limiter, DLQ на Java/Resilience4j. Как ограничить радиус поражения при сбоях соседних сервисов и не уронить свой при нагрузке.

Структурные паттерны микросервисов

Mon, 18 May 2026 07:54:55 GMT

API Gateway, BFF, Sidecar, Service Mesh, Strangler Fig, ACL, Service Discovery — как организовать взаимодействие сервисов. Примеры на Spring Cloud Gateway.

Батч-процессинг: от @Scheduled-цикла к очереди задач

Sat, 6 Jun 2026 17:10:31 GMT

Разбор фоновой обработки на реальном коде: чем ломается наивный @Scheduled-полер и как его чинят — FOR UPDATE SKIP LOCKED, lease, ретраи с backoff, Spring Batch, брокер.

Протокол AMQP: exchange, queue, binding, ack

Mon, 18 May 2026 08:24:13 GMT

Модель AMQP 0.9.1: четыре типа exchange (direct, topic, fanout, headers), routing keys, bindings, queues, ack/nack/reject, prefetch (basic.qos), publisher confirms, mandatory/immediate, TTL и max-length. Без привязки к конкретному брокеру.

RabbitMQ в production: Quorum Queues, кластеризация, мониторинг

Mon, 18 May 2026 08:24:13 GMT

Как RabbitMQ работает в проде: кластеризация (все-узлы-знают-всё), три типа queue (Classic / Quorum / Streams), отказ от classic mirroring в 4.0, persistence и lazy queue, federation/shovel для гео-репликации, мониторинг через Prometheus + Management UI, sizing и backpressure.

Spring AMQP: RabbitTemplate, @RabbitListener, retry, DLX

Mon, 18 May 2026 08:24:13 GMT

Практический гайд по spring-amqp / spring-rabbit: RabbitTemplate для публикации, @RabbitListener + ConcurrentRabbitListenerContainerFactory, MessageConverter (Jackson), обработка ошибок и retry, декларативный Dead Letter Exchange, publisher confirms, transactional listener. С примерами Java-кода.

Messaging-паттерны через AMQP: work queue, pub/sub, RPC, idempotency

Mon, 18 May 2026 08:24:13 GMT

Шесть классических messaging-паттернов на AMQP/RabbitMQ: work queue (распределение нагрузки), publish/subscribe (broadcast), routing (тематическая маршрутизация), topic (иерархия событий), RPC (запрос-ответ через reply-to + correlation-id), idempotent consumer. Плюс delayed retry, Dead Letter pattern, Outbox через AMQP.

AMQP vs Kafka: какой брокер брать

Mon, 18 May 2026 08:24:13 GMT

Сравнение двух моделей: AMQP (queue, push, message-consumed-once) и Kafka (log, pull, replay). Семь конкретных критериев выбора: характер потока, ordering, throughput, retention, ack model, routing flexibility, операционная сложность. Сценарии где AMQP, где Kafka, и когда обе вместе.

Apache Kafka: топики, партиции, порядок и гарантии

Mon, 18 May 2026 08:04:20 GMT

Что внутри Kafka: топики, партиции, ключи, consumer groups, гарантии доставки (at-most/at-least/exactly-once), idempotent producer, transactional producer + outbox, replication, retention. Без привязки к конкретному фреймворку.

Kafka в production: Spring Kafka, DLQ, Schema Registry, тюнинг, KRaft

Mon, 18 May 2026 08:04:20 GMT

Что Java/Spring-разработчику нужно знать про Kafka сверх основ: Spring Kafka (@KafkaListener, KafkaTemplate, ErrorHandler, @RetryableTopic), Dead Letter Queue, Schema Registry с Avro/Protobuf и режимы совместимости, headers и трейсинг, consumer lag и его причины, performance tuning (batch.size / linger.ms / compression), безопасность (SASL/SSL/ACL), KRaft вместо ZooKeeper.

Kubernetes Fundamentals: pod, deployment, service

Sat, 6 Jun 2026 18:14:04 GMT

Kubernetes для backend-разработчика: зачем pod поверх контейнера, как Deployment держит желаемое состояние, зачем Service над смертными подами и как запрос доходит до приложения.

Сеть в Kubernetes: Service, DNS, Ingress, NetworkPolicy

Sat, 6 Jun 2026 18:14:04 GMT

Как сервисы находят друг друга в Kubernetes: типы Service, DNS-имена, путь через Ingress и Gateway API, связь readiness и endpoints, NetworkPolicy и место service mesh.

Spring Boot в Kubernetes: probes, ресурсы и JVM, graceful shutdown

Sat, 6 Jun 2026 18:14:04 GMT

Зона ответственности разработчика в Kubernetes: probes через Actuator, requests/limits и память JVM (OOMKilled), graceful shutdown без потери запросов, ConfigMap, HPA.

Деплой в Kubernetes: манифесты, Helm, rolling update, GitOps

Sat, 6 Jun 2026 18:14:04 GMT

Как сервис доезжает до кластера: манифесты vs kustomize vs Helm, механика rolling update и связь с readiness, откаты, GitOps, миграции БД при безостановочном деплое.

Kubernetes на практике: kubectl-набор и разбор типичных инцидентов

Sat, 6 Jun 2026 18:14:04 GMT

Отладка сервиса в Kubernetes: рабочий kubectl-набор и разбор инцидентов — CrashLoopBackOff, OOMKilled, ImagePullBackOff, Pending, мигающая readiness, «запрос не доходит».

AWS Fundamentals: аккаунты, IAM, регионы, VPC

Sat, 6 Jun 2026 18:24:35 GMT

Модель AWS для backend-разработчика: организация аккаунтов, IAM (роли вместо ключей), регионы и зоны доступности, VPC без сетевой магии — подсети, security groups.

Вычисления в AWS: EC2, ECS, EKS или Lambda для Spring-сервиса

Sat, 6 Jun 2026 18:24:35 GMT

Где запускать backend в AWS: EC2 как ручной режим, ECS/Fargate как контейнеры без кластера, EKS как managed Kubernetes, Lambda и её границы для JVM. Критерии и ошибки.

Managed-данные в AWS: RDS, ElastiCache, SQS, MSK

Sat, 6 Jun 2026 18:24:35 GMT

Managed-данные AWS против self-hosted: RDS/Aurora для PostgreSQL, ElastiCache, SQS против RabbitMQ, MSK против своей Kafka, ниша DynamoDB. Что облако снимает, что оставляет.

AWS из Spring: SDK v2, credentials chain, Spring Cloud AWS, LocalStack

Sat, 6 Jun 2026 18:24:35 GMT

Работа с AWS из Spring Boot: SDK v2 и клиенты-бины, credentials chain без ключей в коде, Spring Cloud AWS для SQS и секретов, LocalStack в тестах, цена вызовов.

Безопасность и наблюдаемость в AWS: Secrets Manager, KMS, CloudWatch

Sat, 6 Jun 2026 18:24:35 GMT

Секреты и шифрование в AWS: Secrets Manager с ротацией, KMS, CloudTrail как аудит. Наблюдаемость: CloudWatch против связки Prometheus/Grafana — когда что.

Принципы CI/CD: конвейер от коммита до прода

Sat, 6 Jun 2026 18:36:12 GMT

Что делает конвейер доставки надёжным: артефакт собирается один раз, быстрые проверки раньше медленных, pipeline as code, зелёный main, деплой отделён от релиза.

CI для Java/Spring: сборка, тесты, quality gates

Sat, 6 Jun 2026 18:36:12 GMT

Конвейер CI для Spring-сервиса: Gradle-сборка с кешами, слои тестов (unit → Testcontainers), quality gates — SAST, зависимости, секреты. Что блокирует merge, а что нет.

Стратегии релиза: rolling, blue-green, canary, feature flags

Sat, 6 Jun 2026 18:36:12 GMT

Как выкатывать без страха: rolling update, blue-green с мгновенным откатом, canary с метриками-критериями, feature flags как разделение деплоя и релиза. Выбор стратегии.

Ветки и релизный цикл: trunk-based, версии, GitOps

Sat, 6 Jun 2026 18:36:12 GMT

Workflow, который кормит конвейер: trunk-based против долгих веток, дисциплина коротких PR, флаги для незавершённого, версионирование, GitOps как замыкание петли.

Числа и точность — bigint для id, numeric для денег

Sat, 9 May 2026 04:42:30 GMT

Числовые типы PostgreSQL: для id таблицы — bigint, без вариантов (миграция int→bigint на бою болезненная). smallint только для нумератора фиксированной шкалы. С PG 10+ — GENERATED ALWAYS AS IDENTITY, не serial/bigserial. Деньги — numeric(p,s), никогда real/double (float хранит в двоичном, 0.1+0.2≠0.3). Тип money PostgreSQL не используем (привязан к локали). real/double только для неточности (метрики, ML). Boolean — это boolean. Раскрытие PG-T-010..PG-T-016.

Строковые типы — text по умолчанию, никогда varchar(255)

Sat, 9 May 2026 04:42:30 GMT

Строковые типы PostgreSQL: text, varchar(n), char(n) хранятся одинаково, разница только в семантике ограничения длины. По умолчанию — text; varchar(255) — наследие из MySQL/Oracle. Длину ставим когда это доменное правило (E.164, ISO 3166-1), не «техническое ограничение». char(n) почти никогда — паддинг пробелами создаёт сюрпризы. Case-insensitive: citext или functional unique index на lower(email). Кластер UTF8. TOAST автоматически выносит длинные значения (>2KB). Раскрытие PG-T-020..PG-T-025.

Время и таймзоны — timestamptz всегда, никогда timestamp

Sat, 9 May 2026 04:42:30 GMT

Время — самый частый источник тихих багов в проде. Для бизнес-времени всегда timestamptz, никогда timestamp без TZ. timestamptz не хранит зону — хранит UTC, конвертирует на границе I/O. На Java-стороне Instant или OffsetDateTime; LocalDateTime никогда (потеряется зона). timestamp без TZ допустим только для локального времени без привязки (расписание магазина). now() = время транзакции, clock_timestamp() = момент вызова. DateTimeService для тестируемости. INTERVAL для смещений в SQL. +infinity для бессрочных. Раскрытие PG-T-030..PG-T-035.

UUID и идентификаторы — тип uuid, UUID v7, bigint vs UUID

Sat, 9 May 2026 04:42:30 GMT

UUID хранится в типе uuid (16 байт), никогда varchar(36)/char(36)/text (36+ байт, посимвольное сравнение, без валидации). v4 vs v7: UUID v7 (48-bit timestamp + 74 случайных бита) для PK/FK — соседние по времени id близки в btree, страницы заполняются на 90%+ vs 30-60% у v4. Генерируем на стороне приложения (UuidCreator.getTimeOrderedEpoch()) — id известен до commit. bigint IDENTITY дешевле, UUID — когда нужен (multi-service, public API, до commit). Обычная практика: bigint для внутренних FK + uuid для public_id. При UUID-PK обязательно индекс по FK. Раскрытие PG-T-040..PG-T-044.

Enum, boolean и перечисления — три способа выбора

Sat, 9 May 2026 04:42:30 GMT

Boolean — это boolean, не smallint 0/1, не varchar Y/N. 3 способа перечисления: PG ENUM (4 байта, type-safety, но удаление значения нативно невозможно), reference table (20 байт + JOIN, full CRUD + атрибуты), text + CHECK IN (простой, без FK, до 5-7 значений). Правила выбора: редко меняется без атрибутов → ENUM; растёт, нужны атрибуты → reference table; до 5-7 без атрибутов → CHECK IN. Статусы доменных сущностей обычно reference table. ENUM миграционные ловушки: ADD VALUE мгновенно но в отдельной tx, удаление нативно невозможно. Java enum, не String. Не путать: status vs lifecycle (переходы это state machine). Раскрытие PG-T-050..PG-T-052.

JSONB — когда оправдан, когда нет

Sat, 9 May 2026 04:42:30 GMT

JSONB — мощный тип, который часто используют не по назначению. Всегда jsonb, не json. Главное правило: если по полю регулярно фильтруют, сортируют, джойнят — это колонка, не JSON-ключ. Хорошие случаи: журнал аудита (payload полиморфен по event_type), полиморфные атрибуты товара, интеграционные конфиги, кеш-копии external API. Плохо: все поля сущности в одном data jsonb, поле по которому ищут регулярно, JSONB чтобы не писать миграции. Базовые операторы -> ->> #> #>> @> ?. GIN с jsonb_path_ops для @>; functional index дешевле для конкретного ключа. Не пишите бинарь, большие тексты, base64. Раскрытие PG-T-060..PG-T-067.

Массивы и range-типы — теги, бронирования, EXCLUDE constraint

Sat, 9 May 2026 04:42:30 GMT

PostgreSQL умеет хранить массивы и интервалы (range-типы). Массив уместен: набор скалярных значений, до десятков, нет отдельной идентичности, не нужно ссылаться извне. Массив неуместен: атрибуты у элементов (это таблица), ссылки на элементы, тысячи элементов. GIN-индекс для @>, &&, ANY. Range-типы (tstzrange, daterange) — когда сущность сама по себе интервал (тариф, бронь, цена с историей). Атомарная семантика, @> и && операторы вместо длинных WHERE. EXCLUDE constraint — уникальная возможность PG для гарантии непересечения через btree_gist. По умолчанию [) — корректное && без перекрытия концов. Multirange (PG14+) для расписаний. Раскрытие PG-T-070..PG-T-074.

Именование объектов в PostgreSQL — snake_case, единственное число, префиксы

Sat, 9 May 2026 04:42:30 GMT

Именование PostgreSQL: snake_case для всего, никаких кавычек в идентификаторах. Таблицы — существительные в единственном числе (order_doc, customer); junction-таблицы — обе сущности в порядке. Колонки: id, FK — _id, boolean — is_/has_/can_, время — _at для timestamp, деньги — _amount/_price/_rate, длительность — _seconds/_ms. Audit: created_at, updated_at, version; soft-delete — deleted_at, не is_deleted. Индексы префикс по типу: ix_/uk_/ck_/fk_. Зарезервированные слова (user, order) не использовать. Лимит 63, целевая до 30 символов. Раскрытие PG-N-001..PG-N-094.

Типы индексов в PostgreSQL — B-tree, GIN, GiST, BRIN

Sat, 9 May 2026 04:42:30 GMT

PostgreSQL поддерживает шесть типов индексов: B-tree (дефолт 80-90%), Hash (почти никогда), GIN (JSONB, массивы, full-text), GiST (range, PostGIS, EXCLUDE), BRIN (огромные append-only), SP-GiST (IP-префиксы). pg_trgm для LIKE %X%. Partial index с WHERE — размер в разы меньше. Раскрытие PG-I-020..PG-I-026.

Composite-индексы и левый префикс — порядок колонок

Sat, 9 May 2026 04:42:30 GMT

Composite-индексы: индекс работает только на левый префикс полей (a,b,c) — WHERE a, WHERE a AND b, WHERE a AND b AND c; для WHERE b или c — Seq Scan. Порядок в WHERE не важен — оптимизатор переставляет. Первым = равенство, range последним. ORDER BY совпадает с индексом. Дубликаты не нужны. INCLUDE — покрывающий без раздувания ключа. FK обязательно с индексом. Раскрытие PG-I-010..PG-I-018.

Как выбрать индекс и считать селективность

Sat, 9 May 2026 04:42:30 GMT

Селективность колонки = distinct/total. Индекс на низкоселективной (is_deleted, status) бесполезен. < 5-10% через = обычно индекс; > 20% обычно seq-scan. random_page_cost 1.1 на SSD (default 4.0 под HDD). Композитный может работать там где single-column бесполезен. ANALYZE после массовой загрузки. CREATE STATISTICS для коррелирующих колонок. Раскрытие PG-I-030..PG-I-037.

EXPLAIN ANALYZE — типы узлов и как читать план

Sat, 9 May 2026 04:42:30 GMT

EXPLAIN (ANALYZE, BUFFERS) — стандарт. Реальное время узла = actual time × loops. Расхождение rows/actual rows 10x+ = ANALYZE. Filter vs Index Cond — если важное условие в Filter, индекс не используется. Heap Fetches > 0 на Index Only Scan — VACUUM. Batches > 1 в Hash Join — work_mem. external merge Disk в Sort — work_mem или индекс. Раскрытие PG-E-030..PG-E-039.

Блокировки и как использовать их с jOOQ

Sat, 9 May 2026 04:42:30 GMT

PostgreSQL три уровня блокировок: table (DDL), row (SELECT FOR UPDATE), advisory. UPDATE/DELETE автоматически берут row-level. SELECT FOR UPDATE — read-modify-write защита, только в @Transactional. SKIP LOCKED — distributed очередь задач. Pessimistic vs Optimistic (version-колонка для read-heavy). Advisory lock для глобальных операций. Deadlock — упорядочивание по PK. @Retryable на CannotAcquireLockException. Раскрытие PG-L-001..PG-L-095.

Уровни изоляции и аномалии

Sat, 9 May 2026 04:42:30 GMT

PG 3 уровня: READ COMMITTED (default), REPEATABLE READ (snapshot), SERIALIZABLE (SSI). PG RC строже стандарта — dirty read невозможен. PG RR — snapshot, phantom предотвращён. Только SERIALIZABLE ловит write skew. Дефолт RC в 95% случаев. 40001 на RR/SERIALIZABLE требует @Retryable. idle_in_transaction_session_timeout 30s. Раскрытие PG-IS-001..PG-IS-082.

Spring @Transactional — нюансы и антипаттерны

Sat, 9 May 2026 04:42:30 GMT

Spring @Transactional: на UseCase/Handler, не на репозитории, не на контроллере. Self-invocation не работает — выноси в отдельный бин. Метод public. REQUIRED (default), REQUIRES_NEW (отдельная TX + соединение). readOnly=true: setReadOnly + skip flush + routing на replica. rollbackFor: только RuntimeException; checked не откатывают. @TransactionalEventListener AFTER_COMMIT. TX секунды, не минуты. Раскрытие PG-TX-001..PG-TX-097.

HikariCP и connection pooling — формула Wooldridge, PgBouncer

Sat, 9 May 2026 04:42:30 GMT

Формула Wooldridge: 2N+1 = 10-20 для SSD. «Больше = больше throughput» миф. HikariCP: max=min-idle (нет ramp-up), connection-timeout 3s, max-lifetime 30 мин, leak-detection 60s. PgBouncer для много инстансов/serverless — transaction mode оптимален но prepareThreshold 0, SET LOCAL, нет LISTEN/NOTIFY. Read-replica отдельный пул + routing через readOnly. Раскрытие PG-CP-001..PG-CP-086.

Миграции и breaking changes без даунтайма

Sat, 9 May 2026 04:42:30 GMT

ALTER TABLE берёт ACCESS EXCLUSIVE. N-1 правило. Expand-Contract на 3+ релиза. SET LOCAL lock_timeout 3s. SET NOT NULL через CHECK NOT VALID + VALIDATE + SET NOT NULL. ADD FK через NOT VALID + VALIDATE. CREATE INDEX CONCURRENTLY, runInTransaction=false. Удаление enum нативно невозможно — теневой тип. UPDATE миллионов — backfill-job, не миграция. Rollback почти не работает — forward-fix. squawk линтер. Раскрытие PG-M-001..PG-M-140.

Полнотекстовый поиск (FTS) — tsvector, GIN, russian

Sat, 9 May 2026 04:42:30 GMT

PG FTS закрывает 90% задач поиска без Elasticsearch. Хватает ≤ 10M документов, ≤ 100 RPS. Generated column tsvector ... STORED + GIN-индекс. russian для стемминга. websearch_to_tsquery (PG11+) Google-style. ts_headline для подсветки. setweight A/B/C/D. pg_trgm дополняет для fuzzy и коротких полей. Раскрытие PG-FTS-001..PG-FTS-094.

Materialized views и стратегии refresh

Sat, 9 May 2026 04:42:30 GMT

MV = закэшированный snapshot тяжёлого запроса. Подходит для агрегаций, отчётов, dashboards, pre-computed search. UNIQUE-индекс обязателен для CONCURRENTLY refresh. REFRESH MATERIALIZED VIEW CONCURRENTLY — стандарт. Инкрементальный через pg_ivm. @Scheduled 5 минут для отчётов. Debouncing через Redis-флаг лучше триггера AFTER. Раскрытие PG-MV-001..PG-MV-041.

Партиционирование — когда, как, по какому ключу

Sat, 9 May 2026 04:42:30 GMT

Партиционируй если > 50 GB / 100M строк, time-series, удаление по сроку, autovacuum не справляется. Избыточно < 10 GB. 3 типа: RANGE (самый частый), LIST, HASH (редко). Ключ должен быть в WHERE почти всех запросов. Размер партиции 1-50 GB; > 1000 — тормоза. DROP TABLE партиции мгновенный vs DELETE минуты. PK обязан включать ключ. pg_partman для автоматизации. Раскрытие PG-P-001..PG-P-085.

Multi-tenancy паттерны — row, schema, db per tenant

Sat, 9 May 2026 04:42:30 GMT

3 паттерна: row-per-tenant (default до тысяч тенантов), schema-per-tenant (enterprise с регуляторными), db-per-tenant (≤ десятков). Row-per-tenant: tenant_id первой колонкой везде; каждый запрос WHERE tenant_id; RLS для defense in depth. SET LOCAL app.tenant_id обязателен. Schema-per-tenant не масштабируется до тысяч (pg_class распухает). Гибрид — самое частое. Раскрытие PG-MT-001..PG-MT-085.

PostGIS для геоданных — точки, полигоны, поиск в радиусе

Sat, 9 May 2026 04:42:30 GMT

PostGIS закрывает 95% задач для геоданных без отдельной БД. geography(Point, 4326) — default. POINT(lon lat) — долгота сначала. GiST-индекс обязателен. ST_DWithin использует индекс, ST_Distance без WHERE — нет. <-> для kNN. ST_Contains/ST_Within/ST_Intersects для полигонов. JTS на Java. Generated column geography из lat/lon. Раскрытие PG-GIS-001..PG-GIS-095.

Репликация для разработчика — read-replica и routing

Sat, 9 May 2026 04:42:30 GMT

Streaming replication: master пишет WAL → реплика проигрывает. Replication lag 50-500ms норма. Routing через AbstractRoutingDataSource + LazyConnectionDataSourceProxy (обязателен — без него Spring выбирает DataSource до знания readOnly). Read-after-write антипаттерн — read-from-master, возврат из write, или wait for catch-up. Synchronous replication обычно не нужно. Failover через HikariCP + @Retryable. Алёрт replay_lag > 30 сек. Раскрытие PG-RP-001..PG-RP-085.

Расширения, которые часто нужны — pgcrypto, pg_trgm, btree_gist

Sat, 9 May 2026 04:42:30 GMT

На любой проект: pg_stat_statements (мониторинг, требует shared_preload_libraries), pgcrypto (gen_random_uuid, crypt bcrypt), pg_trgm (LIKE %X% + опечатки). btree_gist для EXCLUDE и composite GiST. citext — case-insensitive text. pg_partman для автоматизации партиций. pg_repack для реорганизации без блокировки. hstore legacy → jsonb. uuid-ossp устарел → gen_random_uuid. Раскрытие PG-EXT-001..PG-EXT-153.

Триггеры и хранимые процедуры — когда НЕ надо

Sat, 9 May 2026 04:42:30 GMT

Бизнес-логика в коде, не в БД. Триггер для updated_at — антипаттерн, лучше DEFAULT now() + явный UPDATE. Денормализация триггером терпимо, но MV/event-handler гибче. Audit-trail триггером оправдан для compliance (банки, медицина). CHECK > триггер для простых инвариантов. Stored procedures почти никогда — @Transactional покрывает. FOR EACH ROW дорог на bulk. Триггеры могут вызывать deadlock. Раскрытие PG-TR-001..PG-TR-095.

VACUUM, autovacuum и bloat

Sat, 9 May 2026 04:42:30 GMT

MVCC: UPDATE/DELETE копят dead tuples. VACUUM освобождает место в FSM (не возвращает на диск), обновляет visibility map, предотвращает XID wraparound. VACUUM не блокирует чтение/запись. VACUUM FULL почти никогда в проде (ACCESS EXCLUSIVE). autovacuum scale_factor 0.05 на больших горячих. Bloat обнаружение через n_dead_tup и pgstattuple. fillfactor 80-90 на write-heavy. Долгие TX блокируют освобождение. Раскрытие PG-V-001..PG-V-080.

Мониторинг и slow queries

Sat, 9 May 2026 04:42:30 GMT

pg_stat_statements — топ запросов. auto_explain — автоматический EXPLAIN на медленных, overhead 5-20%. log_min_duration_statement 500ms-1s. pg_stat_activity для текущих, алёрт xact_age > 5 минут. pg_stat_user_tables: n_dead_tup, last_autovacuum, idx_scan=0. Cache hit ratio > 95%. Цикл диагностики «медленно»: activity → statements → IO → bloat → replication → OS. Раскрытие PG-MON-001..PG-MON-094.

Backup и restore — что должен знать разработчик

Sat, 9 May 2026 04:42:30 GMT

Два класса: логический (pg_dump SQL-дамп, гранулярность) и физический (pg_basebackup, весь кластер, PITR). pg_dump -Fc + pg_restore -j 4 parallel. Прод физический + WAL archive для PITR (recovery_target_time). Retention: daily 7d + weekly 4w + monthly 12m. Backup всегда в отдельном хранилище. Тестировать restore. При катастрофе: STOP → DBA → current state → PITR. Раскрытие PG-BK-001..PG-BK-084.

WAL и как разработчик влияет на него

Sat, 9 May 2026 04:42:30 GMT

WAL = журнал всех изменений. fsync WAL в каждом COMMIT — цена durability. UPDATE пишет новую строку целиком, не дельту (кроме HOT). COPY вместо INSERT — 10-100x. HOT и fillfactor 80-90 на write-heavy. TOAST не переписывается если не изменился. UNLOGGED таблицы для сессий/кешей (нулевой WAL). synchronous_commit=off для аналитики. Долгие TX блокируют освобождение. Раскрытие PG-W-001..PG-W-081.

Дамп прода для разработчика — анонимизация

Sat, 9 May 2026 04:42:30 GMT

Никогда не передавай прод-дамп без анонимизации (GDPR / 152-ФЗ). Default — синтетический dataset через faker. PII: имя, email, телефон, адрес, паспорт, ИНН, дата рождения, IP, карта. Стратегии: удаление, замена константой, псевдонимизация (md5), faker, shuffle, generalization. Email — псевдонимизация через md5. postgresql_anonymizer для декларативных правил. Re-identification через комбинацию полей. Раскрытие PG-AN-001..PG-AN-072.

Антипаттерны типов — сводный чек-лист

Sat, 9 May 2026 04:42:30 GMT

Сводный список антипаттернов схем: varchar(255), timestamp без TZ, varchar(36) для UUID, float для денег, serial/bigserial, smallint/char(1) вместо boolean, PG ENUM для растущего списка, JSONB как гибкая схема, массив вместо таблицы, valid_from/valid_to вместо range, тип money, LocalDateTime для timestamptz, Instant.now() напрямую, UUID v4 для PK. Чек-лист на ревью схемы, индексов, миграции. Раскрытие PG-T-080..PG-T-093.

Именование — пакеты, классы, методы, переменные, константы

Tue, 26 May 2026 10:48:08 GMT

Именование в Java: пакеты в нижнем регистре без подчёркиваний, единственное число (java.util, не java.utils). Классы — существительные; интерфейсы — существительные или -able без префикса I. Аббревиатуры: 2 буквы CAPS (IOStream), 3+ только первая большая (XmlParser). Методы — глаголы (getName, expand). Имена тестов — длинное говорящее или короткое + @DisplayName, snake_case запрещён. Переменные — camelCase. Константы — UPPER_SNAKE_CASE, обязательно static final. Раскрытие JS-2.1..JS-2.8.

Импорты — не wildcard и без unused

Tue, 26 May 2026 10:48:08 GMT

Импорты в Java: не использовать wildcard-импорты (import some.package.*) — скрывает откуда что приходит, ломает сборку при коллизии имён. Исключение — java.util.* допустим. Не оставлять неиспользуемых импортов — IDE auto-cleanup при save должен быть включён, Checkstyle UnusedImports блокирует merge. Раскрытие JS-3.1..JS-3.2.

Выражения — guard, method references и порядок модификаторов

Tue, 26 May 2026 10:48:08 GMT

Выражения в Java: сложность булева выражения не более 3 операторов &&/||. Java-стиль массивов (int[] nums, не int nums[]). Порядок модификаторов: public/protected/private → static → final → transient → volatile → synchronized. Не указывать неявные модификаторы (public/abstract в methods интерфейса; static во вложенных enum). Method reference вместо лямбды где имеет смысл. Большие лямбды (> 1 выражения) выносить в named methods. Guard expression вместо вложенных условий — early return после условия-нарушения. Раскрытие JS-4.1..JS-4.7.

Отступы и форматирование — 120 символов и без выравнивания

Tue, 26 May 2026 10:48:08 GMT

Отступы и форматирование Java: длина строки не более 120 символов включая отступы. Перенос длинных выражений: после запятой для аргументов; перед оператором для арифметики; сопоставление новой строки с началом выражения. Не использовать горизонтальное выравнивание переменных — diff-noise при переименовании. .editorconfig обеспечивает консистентность между IDE/редакторами. Раскрытие JS-5.1..JS-5.3.

Lombok — @RequiredArgsConstructor, @Slf4j и запрет @Data

Tue, 26 May 2026 10:48:08 GMT

Lombok в UCP: @RequiredArgsConstructor всегда для классов с private final-полями. @Slf4j вместо ручного LoggerFactory.getLogger. @Getter на custom exceptions с payload и value-objects не record. Lombok НЕ на records (record уже даёт ctor/accessors/equals/hashCode/toString). @Data ЗАПРЕЩЁН в production — mutable setters + equals/hashCode по всем полям. @Builder точечно (5+ полей в DTO; запрещён на aggregate root — построение через named-конструкторы). @Getter/@Setter для mutable классов где record неприменим (jOOQ POJO, JPA entity). Запреты: явный all-args ctor где подошёл @RequiredArgsConstructor; @AllArgsConstructor на DI-классах. Раскрытие JS-6.1..JS-6.8 и JS-6.X1..JS-6.X2.

Комментарии — без Javadoc и без кодов правил в исходниках

Tue, 26 May 2026 10:48:08 GMT

Комментарии в UCP: по умолчанию не пишем — хорошее имя класса/метода/переменной + структура уже отвечают на «что делает». Комментарий уместен только когда WHY неочевиден. Не цитируем коды правил из спеки и стайл-гайдов в коде (BR-C5, AUTH-15, R-LAY-3 не попадают в исходники). Не пишем «что тут было», «убрано для X», «TODO до spring 4» — git blame. Javadoc не используем нигде, включая публичный API библиотек — гниёт быстрее кода. Запреты: /** ... */ блок с тегами @param, @return, @throws, @see; конфигурация javadoc-task в build.gradle. Раскрытие JS-7.1..JS-7.5 и JS-7.X1..JS-7.X2.

Современные фичи Java — sealed, switch expressions, records

Tue, 26 May 2026 10:48:08 GMT

Современные фичи Java 21+: switch expression на sealed-иерархии вместо if-else цепочек — компилятор гарантирует exhaustiveness. Record patterns в case для деконструкции. Record patterns в instanceof. Exhaustive switch без default для sealed-иерархий — default превращает compile-time error в runtime. Sealed interfaces для closed-набора альтернатив (None/Reused/Created). String.formatted() вместо String.format() — читается линейно. Records для in-class data carriers (3-5 полей, только в этом классе) — private record без Lombok. Раскрытие JS-8.1..JS-8.7.

Enforcement через Checkstyle — механические правила

Tue, 26 May 2026 10:48:08 GMT

Enforcement Java Style Guide через Checkstyle: подключается через стандартный checkstyle gradle plugin с конфигом config/checkstyle/checkstyle.xml в репо. Покрывает механические правила: именование, импорты, отступы, whitespace. Семантические правила (Lombok-defaults, комментарии, Java 21+ фичи) в Checkstyle не выносим — false positive утопят сигнал; применяются скиллом ucp-java-style-review. maxWarnings=0 + ignoreFailures=false обязательно; suppression с justify и сроком до YYYY-MM-DD. Checkstyle привязан к check, не к checkSecurity. Запреты: @SuppressWarnings без justify ≥ 30 символов; удаление правил локально; Checkstyle для семантики. Раскрытие JS-CS-1..JS-CS-5 и JS-CS-X1..JS-CS-X3.

ACID и уровни изоляции транзакций в PostgreSQL

Mon, 18 May 2026 06:27:24 GMT

Что такое ACID, как четыре буквы реализуются в PostgreSQL (MVCC, WAL, snapshots, SSI). Четыре уровня изоляции — Read Uncommitted, Read Committed, Repeatable Read, Serializable — детально, с конкретными примерами на таблицах category и product. Когда какой уровень брать, что такое dirty read, non-repeatable read, phantom, write skew.

Размер БД, партиционирование и шардирование в PostgreSQL

Mon, 18 May 2026 06:22:20 GMT

Как считать размер базы PostgreSQL (pg_database_size, pg_total_relation_size). Когда применять партиционирование, когда — шардирование. Плюсы и минусы каждого подхода. Как выбирать ключ партиционирования и ключ шардирования. Конкретные примеры на таблицах category и product.

Covering Index в PostgreSQL: INCLUDE vs ключевая колонка

Mon, 25 May 2026 15:09:36 GMT

Что такое covering index в PostgreSQL и зачем нужен INCLUDE. Чем INCLUDE отличается от добавления колонки в ключ индекса: листовые страницы vs дерево, влияние на сортировку и уникальность, index-only scan. Когда брать INCLUDE, когда — обычный composite. Примеры на таблицах category и product.

Веса в полнотекстовом поиске PostgreSQL (FTS)

Mon, 25 May 2026 15:09:36 GMT

Как правильно использовать веса A/B/C/D в полнотекстовом поиске PostgreSQL. setweight, tsvector, ts_rank, generated column + GIN-индекс. Как сделать так, чтобы совпадение в названии товара ранжировалось выше, чем в описании. Примеры на таблицах category и product.

ACID, read и write concerns, транзакции в MongoDB

Mon, 18 May 2026 06:59:05 GMT

Что MongoDB гарантирует на уровне одного документа, что — на уровне нескольких, как работают пять уровней read concern (local, available, majority, linearizable, snapshot), что значит w:majority и j:true, как использовать multi-document транзакции с 4.0, и причём тут causal consistency. Примеры на коллекциях category и product.

Репликация и шардинг в MongoDB: replica set, sharded cluster, shard key

Mon, 18 May 2026 06:59:05 GMT

Как устроена репликация в MongoDB: replica set, oplog, выбор primary, read preference. Как считать размер БД (db.stats, collection.stats). Когда переходить на sharded cluster, как устроен mongos/config server/shard, три стратегии shard key (ranged / hashed / zoned) с примерами на коллекциях category и product.

Моделирование документов в MongoDB: embed vs reference, индексы

Mon, 18 May 2026 06:59:05 GMT

Главный вопрос документной БД — embed или reference? Шесть правил выбора по объёму связи (one-to-few / one-to-many / one-to-millions), частоте чтения, частоте изменения. Антипаттерны с массивами без границ. Schema validation через JSON Schema. Типы индексов: single field, compound, multikey, partial, TTL.

Spring DI/IoC, bean scopes

Mon, 18 May 2026 09:08:39 GMT

Как Spring создаёт и связывает объекты: ApplicationContext, BeanFactory, скоупы (singleton, prototype, request, session), @Configuration vs @Component, условные бины, BeanPostProcessor, циклические зависимости. Жизненный цикл бина — отдельная статья.

Жизненный цикл Spring-бина с примерами

Mon, 18 May 2026 09:45:26 GMT

Восемь фаз жизненного цикла бина в Spring: instantiation, dependency injection, Aware-колбэки, BeanPostProcessor.before, инициализация (@PostConstruct/afterPropertiesSet/init-method), BeanPostProcessor.after (AOP-прокси), готовность к использованию, destruction. С рабочим демо-кодом, выводом в консоль и разбором ловушек.

Spring Boot auto-configuration, properties, profiles

Mon, 18 May 2026 09:08:39 GMT

Как Spring Boot собирает ApplicationContext автоматически: @EnableAutoConfiguration, AutoConfiguration.imports, условные бины, externalized configuration, @ConfigurationProperties vs @Value, профили, как написать собственный starter.

Spring MVC: REST, валидация, exception handlers

Mon, 18 May 2026 09:08:39 GMT

Spring MVC для REST-сервисов: DispatcherServlet и фильтры, @RestController, валидация через Bean Validation (@Valid + @Validated), единая обработка ошибок (@RestControllerAdvice), HandlerInterceptor vs OncePerRequestFilter, content negotiation, ResponseEntity vs ProblemDetail.

Spring WebFlux: когда брать, Mono/Flux, R2DBC

Mon, 18 May 2026 09:08:39 GMT

Reactive-стек Spring: чем отличается от Spring MVC, когда оправдан, основные типы Mono/Flux, особенности контроллеров и репозиториев (R2DBC), типичные ловушки (block, threadlocal, context propagation), границы применимости с виртуальными потоками Java 21+.

@Transactional глубоко: propagation, isolation, ловушки

Mon, 18 May 2026 09:08:39 GMT

Как @Transactional работает под капотом через AOP-прокси, что не работает (self-invocation, private методы, checked exceptions). Все семь propagation modes с примерами, isolation, rollback rules. Distributed transactions и почему 2PC обычно нельзя.

Spring Data JPA: repositories, проекции, OSIV, fetch

Mon, 18 May 2026 09:08:39 GMT

Repository-абстракция Spring Data JPA: query methods, JPQL и Native Query, проекции (interface, class, dynamic), paging и sorting, fetch strategies, проблема OSIV (Open Session In View), N+1 и как ловить, когда переходить на jOOQ для read-side.

Spring Events: @EventListener, @TransactionalEventListener, AsyncEvents

Mon, 18 May 2026 09:08:39 GMT

Внутриприложенческий pub/sub в Spring: ApplicationEventPublisher, @EventListener (синхронный), @Async + @EventListener (асинхронный), @TransactionalEventListener (привязка к фазам транзакции — BEFORE_COMMIT, AFTER_COMMIT, AFTER_ROLLBACK). Как использовать для domain events.

Spring AOP: когда нужен, @Aspect, ограничения

Mon, 18 May 2026 09:08:39 GMT

Aspect-Oriented Programming в Spring: что такое pointcut/advice/aspect, как Spring инструментирует бины через прокси (JDK proxy vs CGLIB), типичные кейсы (логирование, метрики, retry, авторизация), ограничения (final-методы, self-invocation, не-Spring-бины).

Spring Security: фильтры, AuthN, AuthZ, OAuth2

Mon, 18 May 2026 09:08:39 GMT

Архитектура Spring Security: SecurityFilterChain, аутентификация vs авторизация, OAuth2 Resource Server (валидация JWT), OAuth2 Client (получение токена), method security (@PreAuthorize/@PostAuthorize), CSRF, session management, типичные конфигурации для REST-сервиса.

Spring Testing: @SpringBootTest, слайсы, TestContainers

Mon, 18 May 2026 09:08:39 GMT

Пирамида тестов в Spring: unit-тесты без контекста, слайсы (@WebMvcTest, @DataJpaTest, @JsonTest), полный интеграционный @SpringBootTest, MockMvc и WebTestClient, тестирование транзакций и rollback, TestContainers для реальной БД/Kafka/RabbitMQ.

Spring Actuator, Micrometer, трейсинг

Mon, 18 May 2026 09:08:39 GMT

Spring Boot Actuator: health, info, custom endpoints, security. Micrometer как абстракция над метриками (Counter, Timer, Gauge), connectors к Prometheus/CloudWatch/Datadog. Distributed tracing через Micrometer Tracing + OpenTelemetry. Структурированное логирование с correlation ID.

Spring Scheduled, Async, виртуальные потоки

Mon, 18 May 2026 09:08:39 GMT

Spring @Scheduled (cron, fixedDelay, fixedRate) и @Async для асинхронных операций. Пулы потоков (TaskExecutor, TaskScheduler), стандартные ловушки (self-invocation, exception swallowing). Виртуальные потоки Java 21+ в Spring Boot 3.2+: что меняют, когда WebFlux всё ещё нужен.

SOLID на примерах Spring

Sat, 6 Jun 2026 15:45:44 GMT

Пять принципов SOLID на примерах Spring: как фреймворк воплощает SRP, OCP, LSP, ISP, DIP и как применять их в своём коде — от толстого @Service к Handler-ам и стратегиям.

Паттерны GoF в Spring: все 23 с примерами

Sat, 6 Jun 2026 15:45:44 GMT

Все 23 паттерна GoF на примерах Spring: Proxy в @Transactional, Strategy в PasswordEncoder, Observer в @EventListener. Какие пишут руками, какие дал фреймворк, какие вытеснил язык.

GRASP на примерах Spring

Sat, 6 Jun 2026 15:55:00 GMT

Девять принципов GRASP на Java/Spring: Information Expert, Creator, Controller, Low Coupling, High Cohesion, Polymorphism, Pure Fabrication, Indirection, Protected Variations.

DRY, KISS, YAGNI и другие инженерные принципы

Sat, 6 Jun 2026 15:55:00 GMT

Девять инженерных принципов на Java/Spring: DRY, KISS, YAGNI, Separation of Concerns, Law of Demeter, композиция вместо наследования, Fail Fast, бритва Оккама.

Elasticsearch fundamentals: inverted index, cluster, shards, mapping, analyzers

Mon, 18 May 2026 18:27:54 GMT

Как устроен Elasticsearch: inverted index как основа быстрого поиска, segments и refresh interval, near-real-time природа, cluster (master/data/coordinating), primary и replica shards, mapping (dynamic vs explicit), analyzers (standard, ru, ngram). Без привязки к языку клиента.

Elasticsearch Query DSL и relevance scoring

Mon, 18 May 2026 18:27:54 GMT

Query DSL Elasticsearch: match/term/range/bool, разница между query context и filter context, scoring через BM25, boosting полей, function_score, фасеты через aggregations, типичные запросы каталога товаров. Без привязки к языку клиента.

Spring Data Elasticsearch: клиент, репозитории, индексация, CDC

Mon, 18 May 2026 18:27:54 GMT

spring-data-elasticsearch: ElasticsearchOperations vs ElasticsearchRepository, маппинг entity через @Document, bulk-индексация, паттерны синхронизации PostgreSQL/MongoDB → Elasticsearch (dual write, transactional outbox, CDC через Debezium → Kafka → ES), типичные ловушки.

Elasticsearch operations: ILM, snapshots, hot/warm/cold, sizing, мониторинг

Mon, 18 May 2026 18:27:54 GMT

Эксплуатация Elasticsearch в production: Index Lifecycle Management (ILM) для time-based данных, snapshots в S3/GCS, hot/warm/cold/frozen tiers, force merge, sizing (heap, shards, RAM), мониторинг через Prometheus exporter, типичные оперативные ловушки.

S3 fundamentals: bucket, object, key, storage classes, presigned URLs, multipart

Mon, 18 May 2026 18:50:26 GMT

Модель S3: bucket / object / key, эталонная семантика и eventual consistency (с 2020 — strong read-after-write), storage classes (Standard / IA / Glacier), versioning, encryption (SSE-S3, SSE-KMS, SSE-C), lifecycle policies, presigned URLs для прямой загрузки клиентом, multipart upload.

Spring + AWS SDK v2 для S3: интеграция, паттерны, MinIO

Mon, 18 May 2026 18:50:26 GMT

Интеграция Spring с S3 через AWS SDK v2: S3Client / S3AsyncClient / S3TransferManager, конфигурация для AWS S3 / MinIO / Yandex Object Storage / R2, паттерны загрузки и скачивания, presigned URLs из Spring, Outbox для атомарных операций «БД + S3», тесты с MinIO в Testcontainers.

S3 operations: backup, replication, lifecycle, costs, monitoring

Mon, 18 May 2026 18:50:26 GMT

Эксплуатация object storage в production: стратегии резервного копирования (S3 как backup-target и backup для самого S3), cross-region replication, lifecycle policies, оценка стоимости (storage + requests + egress), мониторинг (CloudWatch metrics, доступ через access logs), типичные оперативные проблемы и инциденты.

ClickHouse Fundamentals: колоночное хранение, MergeTree, OLAP vs OLTP

Sat, 6 Jun 2026 16:23:44 GMT

Как устроен ClickHouse: колоночное хранение и сжатие, parts и merges в MergeTree, разреженный первичный индекс, семейство движков. Когда ClickHouse дополняет PostgreSQL.

ClickHouse: моделирование схемы, запросы, materialized views

Sat, 6 Jun 2026 16:23:44 GMT

Проектирование таблиц ClickHouse: выбор ORDER BY и PARTITION BY, типы, агрегатные идиомы, materialized views, дедупликация через ReplacingMergeTree, антипаттерны.

ClickHouse из Java/Spring: JDBC, батчи, пайплайн из PostgreSQL и Kafka

Sat, 6 Jun 2026 16:23:44 GMT

ClickHouse из Spring Boot: JDBC и второй DataSource, батчевая вставка и идемпотентность, пайплайн PostgreSQL → outbox → Kafka → ClickHouse, Testcontainers.

ClickHouse Operations: репликация, шардинг, TTL, мониторинг

Sat, 6 Jun 2026 16:23:44 GMT

Эксплуатация ClickHouse: ReplicatedMergeTree и Keeper, шардинг через Distributed, TTL и многоуровневое хранение, бэкапы, system-таблицы, типичные инциденты.

Codegen jOOQ из живой схемы PostgreSQL

Mon, 25 May 2026 15:44:54 GMT

Как настроить codegen jOOQ так, чтобы сгенерированные типы не расходились с реальной базой: Liquibase + Testcontainers + introspection вместо xml/ddl, OffsetDateTime для timestamptz, forced types, fluent setters. Раскрытие правил R-JOOQ-CFG-1..7 и R-JOOQ-CFG-X1..X4.

Repository pattern в jOOQ

Mon, 25 May 2026 15:20:25 GMT

Что такое Repository в подходе UCP, как разделять domain-интерфейс и jOOQ-реализацию, почему конструкторное внедрение через @RequiredArgsConstructor, что нельзя класть в репозиторий. Раскрытие правил R-JOOQ-REPO-1..6 и R-JOOQ-REPO-X1..X4 с примерами на доменах Order и Product.

DSLContext в jOOQ — Spring-bean, один на ApplicationContext

Mon, 25 May 2026 15:44:54 GMT

Что такое DSLContext в jOOQ, почему он Spring-bean и singleton, когда менять Settings и RecordMapperProvider, что нельзя делать руками (DSL.using, хранение в state репозитория). Раскрытие правил R-JOOQ-CTX-1..3 и R-JOOQ-CTX-X1..X2.

Построение запросов в jOOQ

Mon, 25 May 2026 15:44:54 GMT

Как писать читаемые SQL-запросы через jOOQ DSL: static imports, выбор между selectFrom и select(...), fetch-методы под цель (fetchOptional / fetchOne / fetchExists / fetchCount), позиционные bind-параметры, EXISTS-подзапросы. Раскрытие правил R-JOOQ-QRY-1..7 и R-JOOQ-QRY-X1..X6.

Multiset в jOOQ — eager-fetch вложенных коллекций одним запросом

Mon, 25 May 2026 15:44:54 GMT

Как доставать вложенные коллекции в jOOQ через multiset() без N+1, как организовать константы alias-keys, как извлекать nested-результаты через RecordMappingUtils, когда multiset не подходит и нужен batch-fetch. Раскрытие правил R-JOOQ-MS-1..4 и R-JOOQ-MS-X1..X2.

Filter Builders в jOOQ — динамические WHERE без if-цепочек

Mon, 25 May 2026 15:44:54 GMT

Как организовать сложные WHERE с динамическими условиями в jOOQ: FilterConditionBuilder как Spring-компонент, Filter как immutable record в core, FilterConditionHelper с andIfNotNull / andIfNotEmpty, EXISTS для cross-table, единственное место знания о Filter ↔ jOOQ-таблицах. Раскрытие правил R-JOOQ-FLT-1..6 и R-JOOQ-FLT-X1..X2.

Маппинг record ↔ domain в jOOQ — plain Java, не MapStruct

Mon, 25 May 2026 15:44:54 GMT

Почему маппер в jOOQ — это plain Java @Component, а не MapStruct interface. Как организовать assembleAggregate из плоских POJO, делегацию child-маппера, JSONB через JooqJsonbHelper, enum-конверсию. Почему forcedType вытаскивает OffsetDateTime в codegen-time. Раскрытие правил R-JOOQ-MAP-1..7 и R-JOOQ-MAP-X1..X3.

Пагинация в jOOQ — offset, cursor, PaginationView

Mon, 25 May 2026 15:44:54 GMT

Как организовать offset-based и cursor-based пагинацию в jOOQ: PaginationView как domain-record, выбор между offset/cursor, отдельный fetchCount для total, opaque-cursor токены. Когда не считать total. Раскрытие правил R-JOOQ-PAG-1..5 и R-JOOQ-PAG-X1..X2.

Lock-режимы в jOOQ — SelectMode, FOR UPDATE, SKIP LOCKED

Mon, 25 May 2026 15:44:54 GMT

Как организовать lock-режимы в репозиториях jOOQ через SelectMode enum, почему forUpdate() обязан жить внутри @Transactional, что такое SKIP LOCKED для batch-схедулеров, почему optimistic locking — через version-колонку, не Settings. Раскрытие правил R-JOOQ-LCK-1..4 и R-JOOQ-LCK-X1..X3.

Транзакции в jOOQ — @Transactional на handler'е

Mon, 25 May 2026 15:44:54 GMT

Где живут границы транзакций в UCP: @Transactional на UseCaseHandler, не на репозитории, не на сервисе. @Transactional(readOnly = true) на query-handler. Когда менять isolation level. Почему dslContext.transaction(...) внутри Spring-транзакции — антипаттерн. Раскрытие правил R-JOOQ-TX-1..3 и R-JOOQ-TX-X1..X3.

View-репозитории в jOOQ — read-проекции отдельно от агрегата

Mon, 25 May 2026 15:44:54 GMT

Зачем выделять ViewRepository рядом с Repository, как организовать read-DTO в core, чем view отличается от агрегата, почему не стоит перегружать основной репозиторий методами findSummaries/findForExport. Раскрытие правил R-JOOQ-VIEW-1..3 и R-JOOQ-VIEW-X1.

Базовые правила — синхронные тесты и AAA-структура

Tue, 26 May 2026 09:39:15 GMT

Базовые правила интеграционных тестов UCP: тест быстрый и детерминированный — Awaitility/Thread.sleep признак инфраструктурного smoke, не бизнес-логики. Интеграционный = полный Spring + PostgreSQL + HTTP. Внешние HTTP — WireMock или @MockitoBean. Kafka/Redis заменяются на Outbox-проверку или выключаются профилем. Все тесты синхронные — никаких CompletableFuture.get(), Awaitility, Thread.sleep; время и UUID детерминированные через @MockitoBean. Один тест — один сценарий, AAA-структура. Раскрытие TS-1..TS-3.

BaseIntegrationTest — платформенный + доменный base

Tue, 26 May 2026 09:39:15 GMT

BaseIntegrationTest: один платформенный PlatformBaseIntegrationTest + по одному доменному base на каждый Bounded Context. @ServiceConnection (Spring Boot 3.1+) — Spring сам прокидывает свойства в spring.datasource.* без @DynamicPropertySource. @TestInstance(Lifecycle.PER_CLASS) — дорогой setup в @BeforeAll без static. Время и UUID — @MockitoBean DateTimeService + UuidGenerator. @Import(TestJwtConfiguration.class) даёт фейковый JWT + TestHttpHeaders.withSuccessToken(). Раскрытие TS-4..TS-8.

DatabasePreparer — fluent setup БД через DSLContext

Tue, 26 May 2026 09:39:15 GMT

DatabasePreparer: на каждый Bounded Context — свой DatabasePreparer как @Component-обёртка над DSLContext. Три группы методов: clear*() очистка, create*(...) вставка, prepare() запуск очереди. Не пересоздаём схему между тестами — только DELETE нужных таблиц (миллисекунды вместо секунд). Порядок вызовов = порядок исполнения: при наличии FK сначала чистим зависимые, последними создаём родительские. Раскрытие TS-9..TS-11.

TestObjectGenerator — fluent builders сущностей с разумными дефолтами

Tue, 26 May 2026 09:39:15 GMT

TestObjectGenerator: на каждую POJO-таблицу — builder с with*-методами и generate(). Разумные дефолты (UUID.randomUUID(), текущее время с обнулёнными наносекундами); в тесте перезаписываем только то что важно для сценария. withNano(0) обязательно при сравнении OffsetDateTime в БД — PostgreSQL timestamp хранит миллисекунды, Java наносекунды; без обнуления сравнение даст false negative. Раскрытие TS-12..TS-14.

Один тест — структура, имена и TestRestTemplate

Tue, 26 May 2026 09:39:15 GMT

Структура одного integration-теста: extends BaseIntegrationTest, инжектит TestRestTemplate и DatabasePreparer. Имена: _when_ с @DisplayName и BR-кодом. HTTP через TestRestTemplate.exchange(...) — точный контроль над методом, заголовками, телом; MockMvc для unit-тестов контроллера без БД. JWT через TestHttpHeaders.withSuccessToken() или специализированные хелперы — не собираем токены руками. Раскрытие TS-15..TS-18.

Kafka, Redis, async — по умолчанию НЕТ

Tue, 26 May 2026 09:39:15 GMT

Kafka, Redis, async в integration-тестах UCP: не поднимаем Kafka — события остаются в Outbox-таблице, проверяем через DSLContext. Redis не поднимаем — профиль integration-test ставит spring.cache.type=none. Kafka listener (idempotent consumer) тестируем напрямую как Spring-бин: eventHandler.handle(testEvent) без EmbeddedKafka. Async/Saga (@TransactionalEventListener AFTER_COMMIT) переводим в синхрон через профиль теста или ручной commit + явный вызов handler-а. Раскрытие TS-19..TS-22.

Внешние HTTP — WireMock в BaseIntegrationTest

Tue, 26 May 2026 09:39:15 GMT

Внешние HTTP в integration-тестах: WireMock в BaseIntegrationTest через @RegisterExtension с dynamic port и @DynamicPropertySource. Стабы пишем в самом тесте, не в общих mappings/*.json — видно на что опирается тест. Если внешний клиент @FeignClient можно мокать через @MockitoBean, но WireMock предпочтительнее — проверяет ещё сериализацию HTTP, заголовки, retry, timeout. Раскрытие TS-23..TS-25.

Что НЕ покрывается интеграционными — unit, @WebMvcTest и E2E

Tue, 26 May 2026 09:39:15 GMT

Что НЕ покрывается интеграционными: чистая бизнес-логика агрегата — unit-тест без Spring (new Order, order.confirm()), самые быстрые. Контроллер + сериализация JSON без БД — @WebMvcTest + MockMvc. E2E через настоящие Kafka / внешние сервисы — отдельная группа @Tag(e2e), отдельный CI-этап, ≤ 5-10 тестов на сервис. Пирамида: много unit → integration → мало E2E; каждый слой своя цель и стоимость. Раскрытие TS-26..TS-28.

URL и ресурсы — kebab-case, множественное число и HTTP-методы

Tue, 26 May 2026 11:01:22 GMT

URL и ресурсы REST: 4 принципа (предсказуемость, единообразие, читаемость, стабильность); HATEOAS-ссылки в теле запрещены, навигация в OpenAPI. Формат пути: kebab-case, lowercase, без trailing slash, без расширений; служебные эндпоинты (/health, /ready) вне /api/v1/. Коллекции — множественное число; singleton — единственное. HTTP-методы по семантике. Максимум 2 уровня вложенности; ID в пути не в теле; path-переменная в дизайне URL — {id}. Раскрытие R-PRIN-1..4, R-URL-1..3, R-RES-1..3, R-MTH-1..6, R-NEST-1..4.

Alias и Action-эндпоинты — me, latest, default и доменные команды

Tue, 26 May 2026 11:01:22 GMT

Alias-сегменты REST: me только в эндпоинтах принимающих и свой и чужой ID; временные/порядковые (latest, current, next) и логические (default, primary, active) — для singleton-выборки. Action-эндпоинты для команд не укладывающихся в CRUD: POST /orders/{id}/confirm, имя — глагол в инфинитиве, метод POST всегда, параметры в теле. Запреты: me где endpoint singleton; me без users/ префикса; существительное или причастие в имени action; PUT для action. Раскрытие R-ALIAS-1..3, R-ACT-1..4 и X-кодов.

Версионирование — v1/v2 в URL и breaking vs non-breaking

Tue, 26 May 2026 11:01:22 GMT

Версионирование REST: версия в URL-пути (формат v + целое; /api/v1/orders); /api префикс обязателен. Новая версия только при breaking change. Клиент ОБЯЗАН игнорировать неизвестные enum-значения и поля в ответе — на этом основано: добавление optional поля = non-breaking. Breaking: удаление/переименование поля, изменение типа, удаление enum-значения, изменение HTTP-метода/URL. Non-breaking: добавление optional поля, enum-значения, endpoint, ослабление валидации. Запреты: минорная или дата-версия в пути; версия в query; endpoint без /api или без версии; новая версия для optional поля. Раскрытие R-VER-1..6 и X-кодов.

Query-параметры и пагинация — offset 1-based, cursor и POST /search

Tue, 26 May 2026 11:01:22 GMT

Query-параметры REST: camelCase; фильтрация по полю (?status=CONFIRMED); диапазоны через From/To. Offset-based — page (1-based!) + size. Cursor-based — cursor (opaque) + size. Сортировка sort=поле,direction. Множественные значения — повтор параметра (style=form, explode=true). Сложные запросы — POST /resources/search с JSON body. Запреты: snake_case или PascalCase; page=0 в публичном контракте; comma-separated значения; бизнес-логика в query; парсинг cursor на клиенте. Раскрытие R-QRY-1..9 и X-кодов.

JSON и формат ответов — camelCase, ISO 8601, без envelope и null

Tue, 26 May 2026 11:01:22 GMT

JSON REST: camelCase, ISO 8601, enum UPPER_SNAKE_CASE, коллекции — множественное, ID-суффикс. null в PATCH body — команда удалить поле; null в response 2xx запрещён (отсутствие = нет в JSON). Единичный ресурс — плоский без обёртки; коллекция — content + пагинация; создание 201 + Location; обновление 200; удаление 204; action 200. Пустые коллекции — []. Запреты: null в response, пустые строки, nullable=true в OpenAPI, envelope-обёртка {success, data}. Раскрытие R-FLD-1..7, R-RSP-1..8 и X-кодов.

Заголовки и трассировка — Idempotency-Key и traceparent W3C

Tue, 26 May 2026 11:01:22 GMT

Заголовки REST: стандартные по назначению. Кастомные с доменным префиксом единым для всех сервисов проекта (Shop-Request-Id). Idempotency-Key для POST безопасных при retry. traceparent (W3C Trace Context): 00-{trace-id}-{parent-id}-{flags}; если клиент прислал — используем trace-id, создаём новый parent-id; иначе генерируем. trace-id используется как traceId в теле ошибки RFC 9457. Запреты: X- префикс в кастомных headers (устарел RFC 6648). Раскрытие R-HDR-1..4 и X-кодов.

Ошибки RFC 9457 — Problem Details, URN type и violations

Tue, 26 May 2026 11:01:22 GMT

Ошибки REST по RFC 9457 Problem Details: type (URI/URN категории), status, title, detail, instance, traceId, code (UPPER_SNAKE_CASE enum). type — URL на документацию или urn:problem::

. Content-Type — application/problem+json. Валидация: 400 + VALIDATION_ERROR + violations массив (field dot-notation, message, все ошибки за раз). HTTP-коды: 400/500 всегда, 401/403 при auth, 404 по ID, 409 conflict, 410 deprecated, 429 rate limit. Запреты: application/json для ошибки; type=about:blank; коды вне списка; stack traces в 500. Раскрытие R-ERR-1..9 и X-кодов.



Rate limiting, файлы, deprecation — 429, multipart, Sunset
Tue, 26 May 2026 11:01:22 GMT
Rate limiting REST: 429 + Retry-After + RateLimit-Limit/Remaining/Reset в каждом успешном response. Файлы — POST multipart/form-data на вложенный ресурс; скачивание — GET с бинарным Content-Type и Content-Disposition. Deprecation: deprecated=true в OpenAPI + Sunset (RFC 8594) + Deprecation: true + Link rel=successor-version; после Sunset → 410 Gone. Запреты: 429 без headers; file upload через JSON Base64; deprecated без Sunset header. Раскрытие R-RATE-1..3, R-FILE-1..5, R-DEP-1..3.


Batch, async, локализация — partial success, 202 polling, Accept-Language
Tue, 26 May 2026 11:01:22 GMT
Batch-операции REST: поэлементно (partial success); POST /resources/batch; request {items: [...]}; response 200 + results (index, status, error) + summary. Max-size в OpenAPI; превышение → 400 BATCH_SIZE_EXCEEDED. Async через polling: 202 Accepted + Location + taskId/status/statusUrl; статусы PENDING/PROCESSING/COMPLETED/FAILED; resultUrl или error. Локализация через Accept-Language — локализуются detail и violations.message. Запреты: локализация code enum, title, type URI, JSON-полей. Раскрытие R-BATCH-1..5, R-ASYNC-1..4, R-LOC-1..3.


OpenAPI-метаданные и сводка антипаттернов
Tue, 26 May 2026 11:01:22 GMT
OpenAPI-метаданные REST: operationId уникальный в camelCase, формат действие+ресурс (createOrder, confirmOrder). Группировка через tags — один на ресурс, множественное число с заглавной (Orders). Параметры пути в OpenAPI уникальны ({orderId}, {itemId}) — требование Swagger/Redoc; в дизайне URL — {id}. summary до 80 символов; description если логика неочевидна. Сводка антипаттернов из всех разделов гайда — единая checkin-таблица: URL (X1..X4), версионирование, query, JSON, headers, errors, rate-limiting, deprecation, alias-actions, локализация. Раскрытие R-OAS-1..4.


Иерархия исключений в Spring Boot — Domain / Validation / Integration / Technical
Mon, 25 May 2026 16:11:08 GMT
Четыре базовых типа RuntimeException в UCP: DomainException, ValidationException, IntegrationException, TechnicalException. Где они живут, как именовать, почему конструкторы фиксируют контекст. Запрет throw new RuntimeException и IllegalStateException в доменном коде. Раскрытие правил R-ERR-HIER-1..5 и R-ERR-HIER-X1..X2.


Где throw, где catch — три точки catch в Spring Boot
Mon, 25 May 2026 16:11:08 GMT
Throw — везде, где нужно. Catch — ровно в трёх местах: @RestControllerAdvice, out-adapter, резильянс-обёртка. Главный антипаттерн — silent catch (Exception e). Раскрытие правил R-ERR-WHERE-1..3 и R-ERR-WHERE-X1..X3.


Mapping исключений в ProblemDetails (RFC 9457)
Mon, 25 May 2026 16:11:08 GMT
Как мапить иерархию исключений в HTTP-ответы по RFC 9457: DomainException → 409/422, ValidationException → 400, IntegrationException → 502/503/504, TechnicalException → 500. Что класть в type / detail / properties, что НЕ класть. Раскрытие правил R-ERR-MAP-1..5 и R-ERR-MAP-X1..X3.


Логирование исключений в Spring Boot — WARN / ERROR, один раз, на edge
Mon, 25 May 2026 16:11:08 GMT
Какой log-level использовать: DomainException → WARN, IntegrationException → WARN/ERROR, TechnicalException → ERROR. Логируем один раз — на edge. Запрет двойного логирования и log.error без объекта e. Раскрытие правил R-ERR-LOG-1..4 и R-ERR-LOG-X1..X2.


Retry / no-retry семантика по типу исключения
Mon, 25 May 2026 16:11:08 GMT
Какие исключения retry-safe, а какие — нет: DomainException и ValidationException никогда не retry, IntegrationException — при идемпотентности, TechnicalException обычно retry. HTTP 4xx — не retry, 5xx и timeout — retry safe только при Idempotency-Key. Раскрытие правил R-ERR-RETRY-1..3 и R-ERR-RETRY-X1.


Result-types vs exceptions в Spring Boot — когда и где
Mon, 25 May 2026 16:11:08 GMT
Когда Result разрешён (чисто-функциональные модули — парсеры, calc-engines), когда нет (UseCase Handler → Domain → Adapter цепочка). Почему глобальная замена исключений на Result в Java без pattern-matching — те же яйца, в профиль. Раскрытие правил R-ERR-RESULT-1..2 и R-ERR-RESULT-X1.


Observability ошибок — метрики, trace, алёрты
Mon, 25 May 2026 16:11:08 GMT
Метрика app_errors_total с type/exception, OpenTelemetry span как ERROR, алёрты на необычные паттерны (рост unexpected = новый баг, рост integration = внешка деградирует), а не на каждый exception. Запрет алёрта на любой exception в логах. Раскрытие правил R-ERR-OBS-1..3 и R-ERR-OBS-X1.


JVM/Spring конфигурация — server.shutdown=graceful и ApplicationAvailability
Tue, 26 May 2026 08:06:00 GMT
Spring Boot graceful shutdown: server.shutdown=graceful обязательно — без этого Tomcat/Netty forceShutdown() сразу на SIGTERM, активные HTTP-запросы получают 502. spring.lifecycle.timeout-per-shutdown-phase 30s — баланс между «успеть дрейнить» и «не SIGKILL». Hook на SIGTERM ставит ApplicationAvailability.readinessState OUT_OF_SERVICE первым. management.health.{livenessstate,readinessstate}.enabled true. Запреты: свой AtomicBoolean shuttingDown — не интегрируется с health-эндпоинтами, k8s не узнает. Раскрытие R-SHUT-CFG-1..4 и R-SHUT-CFG-X1.


HTTP drain — preStop sleep и долгие endpoints
Tue, 26 May 2026 08:06:00 GMT
HTTP drain: in-flight HTTP-запросы дожимаются до response, новые принимаются до switch readiness в OUT_OF_SERVICE. preStop hook со sleep 10 обязателен даже при правильном Spring graceful — k8s запускает SIGTERM до того как kube-proxy на других нодах распространит «убрать pod из endpoints», без preStop 5-15 секунд новый трафик идёт на pod который уже shutdown. Долгие синхронные endpoints (>10 сек) — @Async + Idempotency-Key либо 202 Accepted + polling. Запреты: WebServerCustomizer с awaitTermination(0) — аннулирует graceful. Раскрытие R-SHUT-HTTP-1..3 и R-SHUT-HTTP-X1.


Kafka shutdown — listener container stop и producer flush
Tue, 26 May 2026 08:06:00 GMT
Kafka shutdown в Spring: @KafkaListener дожимает текущий batch и коммитит offset перед остановкой через ConcurrentMessageListenerContainer.stop(timeout) с настройкой spring.kafka.listener.shutdown-timeout 20s. Listener не запускает долгий cascade — не уложится в shutdown-timeout, cascade в outbox/async-flow. ack-mode BATCH или RECORD явно, не MANUAL_IMMEDIATE без обоснования. Producer.flush() автоматически через KafkaTemplate.destroy(); raw KafkaProducer — обязательно producer.close(Duration.ofSeconds(15)). Запреты: enable.auto.commit=true — потеря сообщений. Раскрытие R-SHUT-KFK-1..4 и R-SHUT-KFK-X1.


БД и persistence — HikariCP в правильную фазу, активные транзакции
Tue, 26 May 2026 08:06:00 GMT
БД при graceful shutdown: HikariCP закрывается после Spring shutdown phases — дефолт Spring Boot правильный (DataSource.close() в последней фазе); не переопределять @PreDestroy на DataSource — может закрыть pool до завершения @Scheduled. Активные транзакции на SIGTERM: HTTP-handler в transaction → graceful HTTP дожимает; @Scheduled → ждать текущую итерацию; @KafkaListener → batch завершается; @Async — отдельная боль awaitTermination. Liquibase/Flyway — startup только. Запреты: DataSource.close() в кастомном @PreDestroy с @Order(LOWEST_PRECEDENCE). Раскрытие R-SHUT-DB-1..3 и R-SHUT-DB-X1.


Scheduled / @Async / outbox — TaskScheduler shutdown и await-termination
Tue, 26 May 2026 08:06:00 GMT
Graceful shutdown для Scheduled, @Async и outbox-relay: @Scheduled-методы завершают текущую итерацию через TaskScheduler.shutdown() с spring.task.scheduling.shutdown.await-termination=true и await-termination-period 25s. @Async-таски с долгим cascade опасны — ExecutorService default делает interrupt(); ThreadPoolTaskExecutor с setWaitForTasksToCompleteOnShutdown(true) и setAwaitTerminationSeconds(20). Outbox-relay завершает текущий batch (FOR UPDATE SKIP LOCKED атомарно), не начинает новый. Запреты: setWaitForTasksToCompleteOnShutdown(false) — частичные изменения в БД без rollback. Раскрытие R-SHUT-SCHED-1..3 и R-SHUT-SCHED-X1.


Kubernetes — terminationGracePeriodSeconds, probes, maxSurge
Tue, 26 May 2026 08:06:00 GMT
Kubernetes graceful: terminationGracePeriodSeconds 60 обязательно (не дефолт-30); preStop sleep не входит в этот бюджет. readinessProbe на /actuator/health/readiness, livenessProbe на /actuator/health/liveness — на shutdown нужен readiness=503 (убирает из endpoints), не liveness (рестартует pod). maxSurge 1 + maxUnavailable 0 — zero downtime rolling deploy. Запреты: отсутствие preStop — 5-15 секунд после SIGTERM kube-proxy ещё льёт трафик, гарантированные 502; terminationGracePeriodSeconds=30 с Spring graceful 30s — preStop 10s не помещается, SIGKILL посередине дрейна. Раскрытие R-SHUT-K8S-1..3 и R-SHUT-K8S-X1..X2.


Идемпотентность in-flight операций — защита от replay при SIGTERM
Tue, 26 May 2026 08:06:00 GMT
Идемпотентность in-flight при graceful shutdown: операции которые SIGTERM может прервать обязаны быть retry-safe. HTTP POST — Idempotency-Key обязателен (AUTH-19). Kafka-listener закоммитил offset но не завершил side-effect → replay создаёт дубль; защита: processed_event(event_id) в той же транзакции что и side-effect. Outbox-relay отправил в Kafka но не пометил published=true → следующий relay отправит повторно; защита: двух-фаза pending→publishing→published либо processed_event-дедуп на consumer-стороне. Запреты: money-операция без Idempotency-Key с @Retry — при SIGTERM в retry дважды списать. Раскрытие R-SHUT-IDEM-1 и R-SHUT-IDEM-X1.


Бюджеты и observability — раскладка 60s budget и app_shutdown_duration
Tue, 26 May 2026 08:06:00 GMT
Бюджет graceful shutdown: 60s total (cumulative) = preStop 10s + Spring graceful HTTP drain до 25s + TaskScheduler/@Async до 20s + Kafka listener до 15s = 70s max, но Spring выполняет phases частично параллельно, реальный wall clock 30-40s. Не помещается — сократить scope операций (batch Kafka 100→20), не увеличивать budget. Метрика app_shutdown_duration_seconds (gauge) + structured лог start/end. Лог причины SIGTERM — kubectl describe pod показывает событие, в коде только факт. Запреты: ERROR-уровень на normal shutdown events (HikariPool Shutdown initiated) — alert-канал заспамлен каждым деплоем. Раскрытие R-SHUT-OBS-1..3 и R-SHUT-OBS-X1.


SAST по коду — Error Prone, SpotBugs, FindSecBugs
Tue, 26 May 2026 07:54:04 GMT
SAST для Java/Spring: Error Prone обязателен через gradle-plugin, ловит на этапе компиляции EqualsHashCode, NullableDereference, мисьюз CompletableFuture, утечки try-with-resources. SpotBugs + FindSecBugs обязательны для production: общие баги + security-specific — SQLi, XSS, path traversal, weak crypto, XXE, hardcoded passwords. HIGH/CRITICAL → failOnError true; MEDIUM — комментарий ревьюера; LOW — игнор. Suppressions в config/spotbugs-exclude.xml с обязательным justify и сроком до 2026-MM-DD. Запреты: @SuppressFBWarnings без justification ≥ 30 символов. Раскрытие R-SEC-SAST-1..4 и R-SEC-SAST-X1.


CVE в зависимостях — OWASP Dependency-Check и Renovate
Tue, 26 May 2026 07:54:04 GMT
CVE в зависимостях: OWASP Dependency-Check обязателен — сканирует runtime/test-зависимости против NIST NVD. Запускается на merge в main + nightly + release-tag, не на каждом PR. NVD_API_KEY обязателен — без ключа NVD-rate-limit убьёт CI. Renovate или Dependabot обязателен — auto-PR на minor/patch, major — manual review. CVSS ≥ 7.0 → failBuildOnCVSS=7.0 ломает сборку; 4.0-6.9 — отчёт + 30 дней; ниже — игнор. Suppressions с обязательным until= и notes. Запреты: подавление CVE без until= (бессрочное); snapshot-зависимости в production. Раскрытие R-SEC-DEP-1..4 и R-SEC-DEP-X1..X2.


Секреты в коде и истории — Gitleaks pre-commit и rotation
Tue, 26 May 2026 07:54:04 GMT
Секреты: Gitleaks в pre-commit + CI, full history scan раз в неделю. Pre-commit hook через husky или pre-commit-framework — не как ручная инструкция README. Утечка → rotate сначала, удаление из истории опционально (GitHub уже проиндексировал, git rebase не помогает); rotation в течение часа от обнаружения. Запреты: секреты в application.yml — только через ${ENV_VAR}; .env в git (даже с пометкой example) — используй .env.example без значений. Раскрытие R-SEC-SECRET-1..3 и R-SEC-SECRET-X1..X2.


Container/image-уязвимости — Trivy, non-root, digest-pin
Tue, 26 May 2026 07:54:04 GMT
Container/image-уязвимости: Trivy обязателен для Docker-образов — сканирует base image, OS-пакеты, библиотеки; запускается в CI после сборки до push в registry. HIGH/CRITICAL → exit-code 1 + ignore-unfixed. Base image — eclipse-temurin:21-jre-alpine или distroless; никогда :latest без digest-pin. Non-root user USER 1000:1000 в конце Dockerfile — иначе CVE escape → root. HEALTHCHECK или K8s liveness/readiness обязательно. Запреты: USER root или отсутствие USER; :latest base image (сборка не воспроизводима). Раскрытие R-SEC-IMG-1..4 и R-SEC-IMG-X1..X2.


Криптография в коде — BCrypt, AES-GCM, SecureRandom
Tue, 26 May 2026 07:54:04 GMT
Криптография в Java: пароли — только BCryptPasswordEncoder с factor ≥ 12, никогда MD5/SHA1/SHA256 без salt. Random для security — только java.security.SecureRandom; java.util.Random только тесты и не-security код. Симметричное шифрование — AES-GCM (AES/GCM/NoPadding) с 12-байтным IV рандомным на каждый encrypt; не AES/ECB, не AES/CBC без MAC. TLS минимум 1.2. JWT verification — через oauth2ResourceServer().jwt(), вручную парсить (Jwts.parser без проверки подписи) критическая ошибка. Запреты: hardcoded ключи/IV в коде — Vault/KMS + env. Раскрытие R-SEC-CRYPTO-1..5 и R-SEC-CRYPTO-X1.


Реакция на findings — severity, SLA и suppressions со сроком
Tue, 26 May 2026 07:54:04 GMT
Реакция на security findings: CRITICAL — hotfix < 24 часа; HIGH — патч в текущем спринте (≤ 2 недели); MEDIUM — отчёт + 30 дней; LOW — игнор. Suppressions имеют срок (until=...) — без срока finding считается долгом; раз в квартал автоматический отчёт просроченных. GitHub Code Scanning / SARIF — единый dashboard через GitHub Security tab без отдельной инфры. Baseline-механика: release блокируется только на новые findings, старый долг трекается отдельно. Запреты: игнорирование finding без suppression «потому что не уверен эксплуатируется ли» — молчание = долг. Раскрытие R-SEC-FIND-1..3 и R-SEC-FIND-X1.


Где какая проверка — Gateway, BFF и Domain Service
Tue, 26 May 2026 07:33:54 GMT
Распределение auth-проверок по слоям: Gateway/API edge — аутентификация (валидация JWT, rate limiting). BFF/Application Layer — грубая авторизация по роли (RBAC): @PreAuthorize hasRole. Domain Service — авторизация по ресурсу (ABAC): order.customerId == jwt.sub. ABAC никогда на Gateway — Gateway не знает доменную модель. Каждый слой имеет свою responsibility — Gateway не делает RBAC, Domain не делает JWT validation. Раскрытие AUTH-1..AUTH-3.


JWT validation — Spring Security oauth2ResourceServer и JWK Set cache
Tue, 26 May 2026 07:33:54 GMT
JWT validation в Spring: через oauth2ResourceServer().jwt() — кастомный фильтр запрещён (маскирует ошибки). JWK Set тянется из IdP по jwk-set-uri, кеш 5 минут default, вручную распаковывать запрещено. При невалидной подписи или просроченном exp — 401 Unauthorized (не 403). Семантика: 401 = не аутентифицирован, 403 = прав не хватает. Раскрытие AUTH-4..AUTH-6.


RBAC — маппинг ролей JWT и @PreAuthorize
Tue, 26 May 2026 07:33:54 GMT
RBAC в Spring: роли в JWT — realm_access.roles (Keycloak) или scope (OAuth2). На вход handler приходят как SimpleGrantedAuthority с префиксом ROLE_ через JwtAuthenticationConverter. Разрешённые роли UCP: customer, seller, admin, system — любая другая роль = пересмотр Bounded Context. На каждом REST-endpoint @PreAuthorize обязательна — endpoint без проверки = критическое нарушение. RBAC отвечает endpoint-level, не resource-level (для этого ABAC). Раскрытие AUTH-7..AUTH-9.


ABAC — владение ресурсом через @access-бин или handler-check
Tue, 26 May 2026 07:33:54 GMT
ABAC в Spring: когда команда работает с агрегатом по id — обязателен ABAC. Два способа: @PreAuthorize @access.canEditOrder для простых случаев, либо проверка внутри Handler — загрузить агрегат, сравнить aggregate.ownerId с jwt.sub, FORBIDDEN. ABAC-логика выносится в @Component access бин или Handler — не размазывается по контроллерам. Для роли admin ABAC обходится (полный доступ), но каждое действие admin пишется в audit log. Раскрытие AUTH-10..AUTH-12.


Service-to-service — mTLS и Client Credentials Flow
Tue, 26 May 2026 07:33:54 GMT
Service-to-service auth: mTLS (рекомендуется) через двусторонний TLS на K8s Service Mesh / Istio, либо Client Credentials Flow (grant_type=client_credentials) с scope=service:operation. Внутренние клиенты в adapter-out-* никогда не делают RestTemplate без mTLS или Bearer — анонимный inter-service трафик = критическое нарушение. mTLS даёт автоматическую identity-привязку (CN сертификата = service-account). Раскрытие AUTH-13..AUTH-14.


Audit admin-команд — *_audit_log таблица и @Around-аспект
Tue, 26 May 2026 07:33:54 GMT
Audit admin-команд: каждая команда от роли admin изменяющая state агрегата обязана писать строку в *_audit_log таблицу с полями actor_id, occurred_at, action, resource_type, resource_id, metadata JSONB. Реализация — @Around-аспект или явный вызов в Handler-е. Та же БД, одна транзакция. Append-only: только INSERT, REVOKE UPDATE/DELETE. При admin override ABAC audit обязателен — compliance, расследование инцидентов. Раскрытие AUTH-15.


PII и секреты — что нельзя в логи, detail и Kafka
Tue, 26 May 2026 07:33:54 GMT
PII-поля (email, phone, ФИО, адрес, паспорт) не попадают: в логи (даже DEBUG), в Exception.getMessage и далее в ProblemDetails.detail, в Kafka-события (передавать только id, payload подгружается потребителем). Секреты (client-secret, JDBC-пароли, ключи шлюзов) никогда не коммитятся в git — только через Vault / SealedSecrets / env vars. RestControllerAdvice не выводит cause.getMessage() в detail — только заранее заданное сообщение по коду. Раскрытие AUTH-16..AUTH-18.


Идемпотентность как часть auth-контракта — Idempotency-Key для money
Tue, 26 May 2026 07:33:54 GMT
Идемпотентность как часть auth-контракта: любая команда меняющая деньги или резерв (CreateOrder, ConfirmPayment, Refund) обязана требовать Idempotency-Key header. Повторный вызов с тем же ключом возвращает прежний результат не дубль. Защита от retry клиента, мобильного приложения, S2S, network timeout. Без Idempotency-Key два списания одного клиента = money-инцидент. Тот же ключ + другая команда = 409 Conflict. Раскрытие AUTH-19.


Хранение токенов на клиенте — HttpOnly cookie и refresh rotation
Tue, 26 May 2026 07:33:54 GMT
Хранение токенов SPA: HttpOnly + Secure + SameSite=Lax cookie. localStorage запрещён — уязвим к XSS, любой скрипт читает. Refresh-токены с rotation: при каждом обновлении старый инвалидируется; при повторном использовании старого RT — компрометация, инвалидируется вся цепочка. SameSite=Lax защищает от CSRF на cross-site GET; Secure требует HTTPS. BFF pattern — server-side хранит токены. Раскрытие AUTH-20..AUTH-21.


Где какая защита — outbound, internal, scheduler, inbound
Mon, 25 May 2026 19:09:38 GMT
Где применять Resilience4j в Spring Boot-сервисе и где не нужно: outbound HTTP — полный набор (timeout + CB + Bulkhead + опционально Retry); internal service-to-service — timeout + CB; schedulers / outbox-relay — task-queue retry (DB-driven), не Resilience4j; inbound REST — RateLimiter на API Gateway. Запреты: Resilience4j вокруг локальных операций (репозиторий, JOOQ, in-memory). Раскрытие правил R-RES-WHERE-1..4 и R-RES-WHERE-X1.


Per-system isolation — отдельный OkHttpClient и CB на каждую внешнюю систему
Mon, 25 May 2026 19:09:38 GMT
Per-system isolation в Resilience4j: на каждую внешнюю систему отдельный OkHttpClient с собственным ConnectionPool, Dispatcher, CircuitBreaker и Bulkhead. Имя bean'а и инстансов R4J совпадают (sber, odnakassa, insurance). Connection pool sizing: pool = maxConcurrent × 1.2; total всех систем ≤ HikariCP size / 2. Запреты: shared OkHttpClient на несколько систем, дефолтный Builder() без явного pool/dispatcher. Раскрытие правил R-RES-ISO-1..3 и R-RES-ISO-X1..X2.


Timeouts — connectTimeout < readTimeout < callTimeout без бесконечностей
Mon, 25 May 2026 19:09:38 GMT
Иерархия timeouts в OkHttpClient: connectTimeout (TCP/TLS handshake, 2-5s) < readTimeout (между байтами ответа, 10-60s) < callTimeout (общий cap, ≥ connect+read+1s buffer). Per-system конфиг через ClientSettings (@ConfigurationProperties). При traceparent с TimeBudget — клиент уважает оставшийся бюджет. Запреты: OkHttpClient без timeouts (default ∞), callTimeout < readTimeout, readTimeout >60s для sync-вызова. Раскрытие правил R-RES-TO-1..3 и R-RES-TO-X1..X3.


Circuit Breaker — fast-fail при отказе внешней системы
Mon, 25 May 2026 19:09:38 GMT
Circuit Breaker в Resilience4j: @CircuitBreaker(name = sber) на public-методе out-adapter (не на generated client, не на handler-е, не на репозитории). Sliding window COUNT_BASED size 50, minimumNumberOfCalls 10, failureRateThreshold 50% (30% для критичных), waitDurationInOpenState 30s, slowCallDurationThreshold = readTimeout/2. CallNotPermittedException маппится в port-specific exception. Запреты: CB на репозитории, custom CB на try/catch + AtomicInteger, общий name default для разных систем. Раскрытие правил R-RES-CB-1..6 и R-RES-CB-X1..X3.


Retry — только при идемпотентности (read или Idempotency-Key)
Mon, 25 May 2026 19:09:38 GMT
Когда применять @Retry в Resilience4j: только если метод — read (GET-эквивалент) или write с Idempotency-Key (внешняя система дедуплицирует). max-attempts: 3 типовое, 5 предел; больше — task-queue. enable-exponential-backoff: true с multiplier 2.0. retry-exceptions: IOException, HttpServerErrorException; 4xx игнорируем. In-memory retry для транзиентов <5s; task-queue для отказов >30s. Запреты: @Retry на write без Idempotency-Key (двойное списание), @Retry на 4xx, без exp backoff, Spring Retry для outbound. Раскрытие правил R-RES-RE-1..5 и R-RES-RE-X1..X4.


Bulkhead — semaphore-based лимит на concurrent calls
Mon, 25 May 2026 19:09:38 GMT
Bulkhead в Resilience4j: @Bulkhead(name = sber) обязательный слой отдельно от connection pool — pool ограничивает TCP, bulkhead ограничивает Java concurrent calls. Тип SEMAPHORE (не THREADPOOL — теряет MDC/SecurityContext). Sizing: maxConcurrentCalls = pool maxConcurrent × 0.8 (запас 20% — bulkhead срабатывает раньше pool). maxWaitDuration 100ms короткое, иначе теряется fail-fast. Запреты: thread-pool bulkhead для outbound (MDC/SecurityContext теряются без DelegatingSecurityContextExecutor). Раскрытие правил R-RES-BH-1..3 и R-RES-BH-X1.


Fallback — три легитимных случая (cached read, default value, async-mode write)
Mon, 25 May 2026 19:09:38 GMT
Когда fallback допустим в Resilience4j: cached read (отдать данные из локального кеша / последнего успешного ответа), default value для read (пустой список, нейтральный объект), async-mode для write (202 Accepted + task-queue). Контракт fallback-метода: same return type, дополнительный last-параметр Throwable. Запреты: fallback с null/Money.ZERO для money-операций, тихий fallback с success (клиент не узнает о проблеме), каскадный fallback в другой провайдер без своего CB. Раскрытие правил R-RES-FB-1..2 и R-RES-FB-X1..X3.


Конфигурация Resilience4j — declarative через application.yml
Mon, 25 May 2026 19:09:38 GMT
Конфиг Resilience4j через application.yml (declarative), не через @Bean CustomCircuitBreakerConfig. Defaults в секции default, переопределения per-instance через base-config: default. Имена instances совпадают с именами beans и систем (sber, odnakassa, insurance). Это позволяет менять параметры через Spring Cloud Config / Vault без redeploy. Запреты: программная конфигурация через CircuitBreakerConfig.custom() без причины (скрыта от Cloud Config). Раскрытие правил R-RES-CFG-1..3 и R-RES-CFG-X1.


Связка с OpenAPI generator — аннотации на out-adapter, не на generated client
Mon, 25 May 2026 19:09:38 GMT
Где вешать Resilience4j-аннотации при использовании openapi-generator: на public-методе out-adapter класса, оборачивающего generated client. Не на generated interface (перегенерируется), не в executeCall helper (теряется compile-time check имени), не на handler. Target generator для нового кода — spring-restclient (Spring 6.1+) с native RestClient, Observation API, OTel auto-config. OpenAPI-спека внешнего API в -client-generator. Между generated DTO и port-интерфейсом обязателен mapper (Plain Java или MapStruct). Запреты: аннотации на generated Api interface, @CircuitBreaker в executeCall с backendName-строкой, возврат generated DTO из port-метода. Раскрытие правил R-RES-OAS-1..4 и R-RES-OAS-X1..X3.


Health checks — HealthIndicator с TTL-кешем, light probe, не business-операция
Mon, 25 May 2026 19:09:38 GMT
HealthIndicator в Spring Boot Actuator на каждую внешнюю систему: SberHealthIndicator implements HealthIndicator. Probe cached с TTL 30s — не каждый actuator-call ходит в Sber. Probe-метод — light GET /health или OPTIONS /, не реальный business-вызов. Health отражается в /actuator/health/, k8s readinessProbe смотрит на /actuator/health/readiness. Запреты: sync-probe без кеша (DDoS внешней системы силами k8s probes каждые 5s), health-probe с business-операцией (изменение состояния, test-данные в проде). Раскрытие правил R-RES-HC-1..4 и R-RES-HC-X1..X2.


Async и polling — task-queue вместо Thread.sleep в sync-handler
Mon, 25 May 2026 19:09:38 GMT
Async polling в Resilience4j: если внешняя система требует polling, реализуется через task-queue (БД с next_attempt_at), не через Thread.sleep в синхронном handler-е. Команда создаёт PollingTask в БД, возвращает 202 Accepted клиенту, scheduler (@Scheduled каждые 5s) дёргает внешнюю систему. Thread.sleep в sync-методе допустим только при total wait <2s. Для CompletableFuture-возврата — @TimeLimiter(name = ) обязателен. Запреты: Thread.sleep(N) в цикле в синхронном handler-е (блокирует worker), любая Thread.sleep > 5s. Раскрытие правил R-RES-ASYNC-1..3 и R-RES-ASYNC-X1..X2.


Observability Resilience4j — Micrometer-метрики, OTel-spans, structured logs
Mon, 25 May 2026 19:09:38 GMT
Observability для Resilience4j: Micrometer метрики через resilience4j-micrometer dependency (resilience4j_circuitbreaker_state, resilience4j_circuitbreaker_calls, resilience4j_retry_calls, resilience4j_bulkhead_available_concurrent_calls). OTel-spans на adapter-методах с атрибутами circuit_breaker.state и external.system. Логирование structured, при state-transition CB — WARN с system, prev_state, new_state, failure_rate (не на каждый успешный call). Запреты: отключение metrics через management.metrics.enable.resilience4j=false без причины — без них SRE не увидит «у нас CB Sber стабильно half-open» до прода. Раскрытие правил R-RES-OBS-1..3 и R-RES-OBS-X1.


Где валидировать в Spring Boot — три места и ни одно из них не Handler
Mon, 25 May 2026 17:57:13 GMT
Три места валидации в Spring Boot UCP-сервисе: @Valid на контроллере для входного HTTP DTO, @Validated на @ConfigurationProperties для конфига, бросание domain exception в методе агрегата для доменных инвариантов. Запреты: manual if-проверки в Handler, дублирование Jakarta на UseCase command, @ConfigurationProperties без @Validated, доменный инвариант через @Min на поле Aggregate. Раскрытие правил R-VLD-WHERE-1..4 и R-VLD-WHERE-X1..X4.


Стандартные constraints Jakarta Validation — @NotNull, @Size, @Email, @Pattern
Mon, 25 May 2026 17:57:13 GMT
Какие стандартные constraints из Jakarta Validation использовать в Spring Boot: @NotNull/@NotBlank/@NotEmpty по типу, @Size/@Min/@Max/@DecimalMin для размеров, @Email вместо ручного regex, @Pattern только для редких форматов, @Past/@Future для времени, тип-зависимая валидация (Long vs long). Запреты: @NotNull на примитиве (молчит), кастомный regex для email, composite-аннотации поверх стандартных. Раскрытие правил R-VLD-STD-1..5 и R-VLD-STD-X1..X3.


Custom constraints в Jakarta Validation — annotation + ConstraintValidator пара
Mon, 25 May 2026 17:57:13 GMT
Когда писать custom constraint в Spring Boot: для частых доменных форматов (RussianPhone, VatNumber, BicCode), которые встречаются на 3+ полях. Пара annotation interface + ConstraintValidator. isValid(null) возвращает true (комбинируется с @NotNull). Stateless validator без runtime-state. Расположение: core//validation для доменных, common/validation для общих технических. Имена без префиксов Valid/Check/Is. Запреты: isValid(null)=false, constraint в одном файле с DTO, inline @AssertTrue. Раскрытие правил R-VLD-CC-1..5 и R-VLD-CC-X1..X3.


Validation groups в Spring Boot — один DTO с разными required в разных контекстах
Mon, 25 May 2026 17:57:13 GMT
Что такое validation groups в Jakarta Validation: один DTO с разными required-полями в разных сценариях (OnCreate vs OnUpdate). Group — пустой маркер-interface. @Validated(OnCreate.class) на контроллере. Когда применять — только когда тот же класс DTO реально нужен в разных контекстах. Запреты: группы для строгая/мягкая (это два разных DTO), цепочки @Validated({A.class, B.class, C.class}) — класс делает слишком много. Раскрытие правил R-VLD-GRP-1..2 и R-VLD-GRP-X1..X2.


Cross-field validation в Jakarta — class-level constraint, не @AssertTrue в DTO
Mon, 25 May 2026 17:57:13 GMT
Как валидировать правила между несколькими полями DTO в Spring Boot: class-level @Constraint аннотация на классе DTO + ConstraintValidator на сам класс. Пример — @DateRange (dateFrom ≤ dateTo). Прицеп ошибки к конкретному полю через addPropertyNode. Имя описывает правило (@DateRange, @PasswordsMatch), не объект (@OrderRequestValid). Запреты: @AssertTrue-метод в DTO (не переиспользуется), cross-field валидация в Handler перед dispatcher.dispatch (это контракт, не бизнес). Раскрытие правил R-VLD-XF-1..2 и R-VLD-XF-X1..X2.


OpenAPI-сгенерированные DTO в Spring Boot — useBeanValidation и правила в YAML
Mon, 25 May 2026 17:57:13 GMT
Как валидируются generated DTO из OpenAPI в Spring Boot: useBeanValidation=true в openapi-generator config (без него generated DTO без аннотаций, @Valid silent-passes), все validation-правила в OpenAPI YAML (один источник правды), маппинг keyword → Jakarta annotation (minLength → @Size, format: email → @Email, $ref → @Valid). Custom constraint через wrapper-class в коде. Запреты: дописывать аннотации в build/generated, дублировать в YAML и в Java, handcrafted DTO без OpenAPI. Раскрытие правил R-VLD-OAS-1..6 и R-VLD-OAS-X1..X5.


Валидация конфигурации в Spring Boot — @ConfigurationProperties с @Validated и fail-fast
Mon, 25 May 2026 17:57:13 GMT
Как валидировать конфиг в Spring Boot: @ConfigurationProperties + @Validated на классе → невалидный конфиг падает на старте с BeanCreationException, не на первом запросе. @NotBlank для String, @NotNull для object, @Min/@Max для числовых лимитов, @Valid для nested-структур, @DurationMax для бизнес-пределов. Запреты: @ConfigurationProperties без @Validated, @Value для required-конфига (не валидируется). Раскрытие правил R-VLD-CFG-1..4 и R-VLD-CFG-X1..X2.


Сообщения валидации и i18n — на русском, для пользователя, через {placeholders}
Mon, 25 May 2026 17:57:13 GMT
Как писать message в Jakarta-аннотациях в Spring Boot: на русском (для пользователя на UI), без технических терминов, интерполяция через {value}/{min}/{max} из спецификации, локализация через {key} + messages_ru.properties для multi-language. Запреты: английский в message, технические термины (field, must be positive), дублирование message в каждом DTO для одного constraint. Раскрытие правил R-VLD-MSG-1..3 и R-VLD-MSG-X1..X3.


Где кешируем — read-heavy данные, money с осторожностью, агрегаты никогда
Tue, 26 May 2026 04:47:10 GMT
Что кешируем в Spring-сервисах: read-heavy и редко меняющиеся данные — справочники (часы), user profile (15-30 мин), feature flags (60 сек), heavy aggregations. Money-данные допустимы, но с TTL ≤ 30 секунд и явной @CacheEvict на каждом write. Cache-aside — дефолтный паттерн. Запреты: @Cacheable на write-методах (createOrder, confirmPayment); кеширование доменного агрегата целиком (нарушает границы, кешируем read-проекции OrderSummary); money без TTL/invalidation; результаты валидации и авторизации. Раскрытие правил R-CACHE-WHERE-1..3 и R-CACHE-WHERE-X1..X5.


Конфигурация Spring Cache — RedisCacheManager и JSON-сериализация
Tue, 26 May 2026 04:47:10 GMT
Конфигурация Spring Cache: RedisCacheManager через spring-boot-starter-data-redis, не in-memory ConcurrentMapCacheManager (каждый pod имел бы свой кеш). Сериализация JSON через GenericJackson2JsonRedisSerializer, никогда Java native JdkSerializationRedisSerializer (deserialization vulnerability). Per-cache configuration с explicit TTL. @ConfigurationProperties + @Validated для cache settings. В тестах — ConcurrentMapCacheManager или Testcontainers, не моки Cache. Запреты: JdkSerializationRedisSerializer, ConcurrentMapCacheManager в multi-instance проде, один глобальный TTL, @EnableCaching без CacheManager-бина (silent NoOpCacheManager). Раскрытие правил R-CACHE-CFG-1..5 и R-CACHE-CFG-X1..X4.


Ключи кеша — namespace, SpEL и custom KeyGenerator
Tue, 26 May 2026 04:47:10 GMT
Ключи Spring Cache: namespace через cacheNames (Redis user-profiles::42), kebab-case slug для имени кеша. Ключ через SpEL explicit: key = "#userId", composite через #customerId + ":" + #status. Custom KeyGenerator — только для очень сложных ключей. Запреты: дефолтный generator на multi-arg (SimpleKey ломается); Object.toString() в ключе для DTO без переопределения; один общий cache "shared-cache" (теряется namespacing); plain PII/токенов в ключе — хешировать через SHA-256. Раскрытие правил R-CACHE-KEY-1..4 и R-CACHE-KEY-X1..X4.


TTL — explicit duration per cache и типовые значения по характеру данных
Tue, 26 May 2026 04:47:10 GMT
TTL Spring Cache: каждый именованный cache имеет explicit duration, никаких infinite-кешей. Типовые значения: static reference — часы; user profile — 15-30 мин; feature flags — 30-60 сек; heavy aggregations — 5-10 мин; money — 5-30 сек. TTL через application.yml, не hard-coded — SRE меняет под нагрузку без redeploy. Если cached data имеет естественный invalidation event — TTL longer, invalidation does heavy lifting. Запреты: TTL = Duration.ZERO или infinite (Redis при max-memory eviction по LRU без вашего контроля); TTL > 24 часов (deploy чаще, кеш переживает релиз со старой структурой DTO); money без TTL. Раскрытие правил R-CACHE-TTL-1..4 и R-CACHE-TTL-X1..X3.


Invalidation — @CacheEvict, @EventListener и distributed-sync
Tue, 26 May 2026 04:47:10 GMT
Invalidation Spring Cache: на каждом write-методе того же агрегата — @CacheEvict с явным key; @Caching композит для нескольких кешей. При доменных событиях (UserUpdatedEvent) — invalidation через @EventListener + @CacheEvict (пустой метод-marker). Distributed cache invalidation — встроенно в Redis backend. Запреты: @CacheEvict(allEntries=true) без причины (холодный старт = нагрузка на БД спайком); полагаться только на TTL для money/orders consistency; eventual consistency без декларации в OpenAPI description. Раскрытие правил R-CACHE-INV-1..4 и R-CACHE-INV-X1..X3.


Паттерны кеширования — cache-aside, write-through и refresh-ahead
Tue, 26 May 2026 04:47:10 GMT
Паттерны Spring Cache: cache-aside (lazy load + write evict) — дефолтный, простой и читаемый. Write-through через @CachePut — для высокочастотных read+write одного значения, на write кеш обновляется явно не evict-ится. Refresh-ahead через @Scheduled — для критичных hot keys (top-100 продуктов), гарантирует no cache miss for hot keys. Запреты: write-behind (write в кеш, async в БД) для money/critical — crash до flush = потеря данных; mix паттернов на одном cache (cache-aside + write-through одновременно) — invalidation logic становится непонятной. Раскрытие правил R-CACHE-PATTERN-1..3 и R-CACHE-PATTERN-X1..X2.


Cache stampede — distributed lock и refresh-ahead против thundering herd
Tue, 26 May 2026 04:47:10 GMT
Cache stampede — multiple parallel requests на холодную ключ: все промахиваются → N одновременных запросов в БД → инцидент. Для локального кеша — @Cacheable(sync=true), блокирует параллельные вызовы. Для distributed cache (Redis) sync=true не помогает (lock только within JVM): distributed lock через Redis SET NX EX или Redisson RLock с double-check; probabilistic refresh. Для hot keys — refresh-ahead через @Scheduled, stampede исключён по дизайну. Запреты: игнорировать stampede для hot endpoints (>100 RPS); synchronized-блок Java для distributed-cache защиты. Раскрытие правил R-CACHE-STAMP-1..3 и R-CACHE-STAMP-X1..X2.


Observability кеша — hit rate, eviction metrics и Redis-side мониторинг
Tue, 26 May 2026 04:47:10 GMT
Observability Spring Cache: автоматический экспорт через Micrometer — cache_gets_total{cache,result=hit|miss}, cache_puts_total, cache_evictions_total, cache_size. Cache hit rate — основная метрика здоровья: hits / (hits + misses); алерт при hit rate < 70% для долго существующих кешей. Eviction логировать на DEBUG. Redis-side метрики через отдельный Redis Exporter — redis_memory_used_bytes, redis_keys_total. Запреты: отключение Spring Cache metrics (management.metrics.enable.cache=false) — без них SRE не увидит что кеш бесполезен. Раскрытие правил R-CACHE-OBS-1..4 и R-CACHE-OBS-X1.


Kafka Producer — idempotence, acks=all, partition key
Tue, 26 May 2026 07:14:19 GMT
Kafka producer в Spring: enable.idempotence=true всегда — автоматически acks=all, retries=MAX, max.in.flight ≤ 5, exactly-once на partition. Partition key обязателен для бизнес-событий — без ключа round-robin теряет ordering; дефолтный ключ — aggregate id. JSON сериализация по умолчанию. KafkaTemplate.send из use-case handler-а запрещён для domain-событий — через outbox. Запреты: enable.idempotence=false (дубликаты при retry); acks=0/1 (потеря данных при rebalance/failure leader); send без partition key; send в @Transactional с DB (Kafka не XA). Раскрытие R-KFK-PROD-1..4 и R-KFK-PROD-X1..X4.


Kafka Consumer — manual ack, group.id, concurrency и max.poll.interval
Tue, 26 May 2026 07:14:19 GMT
Kafka consumer в Spring: уникальный group.id формата -. Manual ack (ack-mode=MANUAL_IMMEDIATE), auto-commit опасен — offset коммитится по таймеру, crash = потеря. Listener idempotent — at-least-once норма. auto.offset.reset=earliest для critical. Concurrency ≤ partitions. max.poll.interval ≥ времени обработки batch. Запреты: enable.auto.commit=true (crash = loss); Thread.sleep > 1s (rebalance); group.id отсутствует/общий; HTTP без CB/Bulkhead (зависает, rebalance, дубликаты). Раскрытие R-KFK-CONS-1..6 и R-KFK-CONS-X1..X4.


Outbox publishing — атомарная публикация Kafka-событий из write-handler
Tue, 26 May 2026 07:14:19 GMT
Outbox publishing в Kafka: запись в outbox_event в той же DB-транзакции что бизнес-write, либо обе commit либо обе rollback. Outbox-relay — отдельный @Component с @Scheduled, читает unpublished с FOR UPDATE SKIP LOCKED, публикует, помечает published_at. Topic name ... Relay в batch 10-50. Запреты: KafkaTemplate.send в @Transactional с DB; @TransactionalEventListener для Kafka (потеря при crash между commit и publish); outbox без partial-индекса WHERE published_at IS NULL (full scan тормоза). Раскрытие R-KFK-OBX-1..4 и R-KFK-OBX-X1..X3.


Idempotent consumer — processed_event таблица и dedup по eventId
Tue, 26 May 2026 07:14:19 GMT
Idempotent consumer в Kafka: at-least-once = дубликаты норма. Каждое событие имеет eventId UUID v7 в payload, consumer проверяет через processed_event таблицу с PRIMARY KEY на event_id. Запись в processed_event и бизнес-результат в одной транзакции. Money — двойная защита: eventId + Idempotency-Key на downstream HTTP. TTL через partitioning или background-job. Запреты: listener без проверки eventId для critical; Kafka offset как dedup-ключ (offset зависит от consumer-group). Раскрытие R-KFK-IDEM-1..4 и R-KFK-IDEM-X1..X2.


Retry topic + DLQ — non-blocking retry с возрастающим backoff
Tue, 26 May 2026 07:14:19 GMT
Retry topic + DLQ в Kafka: blocking-retry в listener (Thread.sleep + retry в цикле) — антипаттерн, блокирует poll-цикл. Non-blocking retry через отдельные топики *.retry-1m, *.retry-10m, *.dlq. @RetryableTopic с attempts=4, backoff multiplier=10. Retry только для transient (сеть, 5xx, DB timeout); не retry для 4xx, validation, NPE. DLQ-monitoring обязателен. Replay из DLQ — manual. Запреты: blocking retry через Thread.sleep; try/catch + log.error + ack (событие потеряно); retry без max-attempts; DLQ без monitoring. Раскрытие R-KFK-RTRY-1..4 и R-KFK-RTRY-X1..X4.


Event design — past tense, eventId UUID v7 и forward-compatible schema
Tue, 26 May 2026 07:14:19 GMT
Дизайн Kafka events: имя в прошедшем времени (OrderConfirmed, не ConfirmOrder). Payload: eventId UUID v7, eventType версионированный (order.confirmed.v1), occurredAt (когда произошло, не когда опубликовано), aggregateType+aggregateId, бизнес-данные. PII не в payload широковещательных topics. Forward-compatible: добавление non-breaking; удаление/переименование — новый eventType.v2. Domain event — Java record в core//domain/event/. Запреты: имя — команда (ConfirmOrder вместо OrderConfirmed); aggregate целиком в payload; PII в широких topics; breaking change без версии. Раскрытие R-KFK-EVT-1..4 и R-KFK-EVT-X1..X4.


Конфигурация Kafka — application.yml, trusted-packages и missing-topics-fatal
Tue, 26 May 2026 07:14:19 GMT
Конфигурация Kafka в Spring Boot через @ConfigurationProperties + @Validated. application.yml: bootstrap-servers через env, producer enable.idempotence=true acks=all, consumer auto-offset-reset=earliest enable-auto-commit=false, listener ack-mode=MANUAL_IMMEDIATE missing-topics-fatal=true. spring.json.trusted.packages — explicit allow-list (security). missing-topics-fatal=true в проде — fail-fast если топика нет. Запреты: spring.json.trusted.packages="*" — RCE через deserialization gadgets; bootstrap-servers hard-coded без env-substitution. Раскрытие R-KFK-CFG-1..4 и R-KFK-CFG-X1..X2.


Observability Kafka — consumer lag alerts, traceparent и DLQ-size
Tue, 26 May 2026 07:14:19 GMT
Observability Kafka в Spring: автоматический Micrometer экспорт — kafka_consumer_lag (главный сигнал), kafka_producer_record_error_total, kafka_consumer_records_consumed_total. Alert на consumer lag > N для критичных topics; threshold per criticality (money 100, orders 1000, analytics 100000). Traceparent в Kafka headers — distributed trace продолжается через producer/consumer, Spring Kafka + OTel автоконфиг. DLQ-size alert обязателен. Запреты: отсутствие consumer-lag alerts — пропадание сообщений замечается через жалобы клиентов. Раскрытие R-KFK-OBS-1..4 и R-KFK-OBS-X1.


Kafka Security — TLS, ACLs per-сервис и restricted PII topics
Tue, 26 May 2026 07:14:19 GMT
Безопасность Kafka в проде: TLS (security.protocol=SSL) обязателен для cross-network; SASL/PLAIN over plaintext запрещён. ACLs per-сервис — каждый service-account на свои топики, blast-radius containment. PII — отдельные restricted topics с узким ACL, либо слабая ссылка: customerId в широком topic, PII подгружается через customer-service. Запреты: PLAINTEXT в проде (только локальная разработка); один service-account на весь кластер (нет blast-radius containment, компрометация одного сервиса = доступ ко всем топикам). Раскрытие R-KFK-SEC-1..3 и R-KFK-SEC-X1..X2.


Logging — structured JSON, MDC, уровни и PII-гигиена
Mon, 25 May 2026 19:35:58 GMT
Логирование в Java/Spring: structured JSON в проде через logstash-logback-encoder, текстовый pattern только в dev; @Slf4j через Lombok с {} placeholders; уровни ERROR/WARN/INFO/DEBUG/TRACE; MDC поля traceId, requestId, userId автоматически в JSON; логи на границах. Запреты: PII в логах (email, phone, паспорт, токены) — критическое нарушение; System.out.println; string-concat в log args; log.error без stack trace; полный request body для money; INFO на каждый HTTP-запрос. Раскрытие правил R-OBS-LOG-1..6 и R-OBS-LOG-X1..X6.


Metrics — Micrometer, Prometheus, RED/USE и стандартные dimensions
Mon, 25 May 2026 19:35:58 GMT
Метрики в Spring Boot: Micrometer + Prometheus через spring-boot-starter-actuator, endpoint /actuator/prometheus. Стандартизованные dimensions service/env/version через management.metrics.tags.*. RED method для HTTP (http_server_requests_seconds — rate, errors, duration p95), USE для resources (jvm_memory, executor pools, hikaricp_connections). Custom business metrics через MeterRegistry: Counter, Gauge, Timer, DistributionSummary. Имена snake_case с единицей. Tags — низкая cardinality. Запреты: user_id/request_id как tag value (OOM в Prometheus), не-стандартизованные dimensions, micrometer-core без registry, /actuator/prometheus публично. Раскрытие правил R-OBS-MTR-1..7 и R-OBS-MTR-X1..X4.


Tracing — OpenTelemetry, traceparent, sampling и span attributes
Mon, 25 May 2026 19:35:58 GMT
Distributed tracing в Spring Boot через OpenTelemetry автоинструментацию: opentelemetry-spring-boot-starter даёт auto-spans для HTTP server/client, JDBC, Kafka, Spring Cache. Traceparent W3C propagation между сервисами автоматически. Manual spans для use case handlers через Tracer и try-with-resources. Span attributes — business context (orderId, paymentMethod), не PII. Sampling 1-10% + 100% для error-traces через tail-based. TraceId/spanId в MDC автоматически через OpenTelemetryAppender — связка лог-запись с trace. Запреты: sampling 100% в проде, PII в attributes, manual span без try-finally, trace разрывается на @Async. Раскрытие правил R-OBS-TRC-1..6 и R-OBS-TRC-X1..X4.


Health checks — liveness, readiness, custom HealthIndicator и /actuator/info
Mon, 25 May 2026 19:35:58 GMT
Health checks через Spring Boot Actuator с разделением liveness и readiness. /actuator/health/liveness — UP пока процесс отвечает, не зависит от внешних систем. /actuator/health/readiness — UP когда сервис готов принимать трафик. Custom HealthIndicator для критичной внешней системы с TTL-кешем. /actuator/info содержит git.commit.id, build.version. Запреты: business-state в health check (orderCount > N → DOWN), liveness зависит от внешних систем (loop при недоступности), health-probe делает business-операцию (ddos самих себя). Раскрытие правил R-OBS-HC-1..3 и R-OBS-HC-X1..X3.


Конфигурация observability — management port, exposure, Logback profiles
Mon, 25 May 2026 19:35:58 GMT
Конфигурация observability в Spring Boot: отдельный management port (server.port 8080 + management.server.port 8081) для изоляции actuator от business traffic и сетевой защиты. Explicit exposure список — только health/info/metrics/prometheus. Default percentiles-histogram для http.server.requests + SLO buckets. Стандартные tags через management.metrics.tags. Logback-spring.xml с двумя springProfile — dev/test (text pattern) и prod/staging (LogstashEncoder с MDC keys). Запреты: exposing /actuator/env, /heapdump, /threaddump публично; один port для business + actuator в проде; exposure.include "*". Раскрытие правил R-OBS-CFG-1..4 и R-OBS-CFG-X1..X3.


Context propagation (MDC) — filter, TaskDecorator и MDC.clear() в finally
Mon, 25 May 2026 19:35:58 GMT
Context propagation через MDC в Spring Boot: MdcFilter с @Order(HIGHEST_PRECEDENCE) populates requestId из X-Request-Id header на каждый incoming HTTP request, MDC.clear() в finally обязательно. TraceId/spanId автоматически через OpenTelemetry Logback appender. UserId populates после JWT-валидации в Security filter chain. Async/CompletableFuture — пропагация через TaskDecorator с copyOfContextMap → setContextMap → clear. Запреты: MDC без MDC.clear() в finally — утечка контекста между requests в thread pool, чужой userId в логах = compliance incident; MDC.put в произвольных местах; @Async без TaskDecorator. Раскрытие правил R-OBS-CTX-1..4 и R-OBS-CTX-X1..X3.


SLO и алерты — multi-window burn rate, error budget и runbook'и
Mon, 25 May 2026 19:35:58 GMT
SLO в Java/Spring: каждый critical-endpoint имеет SLO (99.9% successful, p95 < 500ms) в течение rolling 30-day window. Multi-window multi-burn-rate alerts по Google SRE Workbook — fast burn (1h, rate > 14.4) и slow burn (6h, rate > 6). Error budget exhaustion — отдельный алерт когда бюджет < 10%. Алерты отдельные от SLO: infrastructure, domain, resilience, Kafka consumer lag, cache hit rate. Запреты: alert на каждый ERROR (alert fatigue), SLO без error budget (100% target — нечем оперировать; 99.9% даёт 43 минуты downtime в месяц), алерты без runbook'ов. Раскрытие правил R-OBS-SLO-1..4 и R-OBS-SLO-X1..X3.


Когда CQRS оправдан — три уровня и три порога применения
Mon, 25 May 2026 18:44:36 GMT
Когда применять CQRS в Spring Boot-сервисе: lightweight маркеры UseCaseCommand/UseCaseQuery обязательны с Уровня 2, полный split с разделением хранилищ оправдан при read:write ratio ≥ 10:1 или принципиально разной структуре read-проекции, денормализованная read-таблица в той же БД — middle-ground для join'ов 5+ таблиц и тяжёлых aggregations. Запреты: full CQRS «just in case» для нового сервиса, разделение баз без явной причины. Раскрытие правил R-CQRS-WHEN-1..3 и R-CQRS-WHEN-X1..X2.


Command side в CQRS — write-handler через агрегат и outbox
Mon, 25 May 2026 18:44:36 GMT
Как устроен command-handler в CQRS: Command — record, реализует UseCaseCommand; меняет один агрегат; загружает через Repository.findById(id, FOR_UPDATE); вызывает доменный метод; сохраняет; пишет в outbox для синхронизации read-model. Command возвращает минимум: id или статус, не полный read-DTO. Запреты: отдельный SELECT для чтения, возврат read-DTO, мутация нескольких агрегатов без саги. Раскрытие правил R-CQRS-CMD-1..5 и R-CQRS-CMD-X1..X3.


Query side в CQRS — read-handler через ViewRepository и read-DTO
Mon, 25 May 2026 18:44:36 GMT
Как устроен query-handler в CQRS: Query — record, реализует UseCaseQuery; handler с @Transactional(readOnly=true); грузит данные через ViewRepository, отдельный от write-Repository; возвращает read-DTO (record), не агрегат; не вызывает доменные методы. Запреты: query делает write, грузит агрегат целиком и маппит в DTO, возвращает агрегат или Entity наружу. Раскрытие правил R-CQRS-QRY-1..4 и R-CQRS-QRY-X1..X3.


Read-model в CQRS — где хранить и как обновлять денормализованную проекцию
Mon, 25 May 2026 18:44:36 GMT
Read-model в CQRS: денормализованная проекция, оптимизированная под чтение. Где хранить: PG-таблица для tabular queries, materialized view для тяжёлых aggregations, Redis для key-lookup, ElasticSearch для full-text search. Schema независимая от write-стороны, eventual consistency 100ms-1s через outbox + Kafka. Read-model восстановима из write-side скриптом replay. Запреты: read-model как source-of-truth, бизнес-логика в триггерах read-таблицы, bidirectional sync read → write. Раскрытие правил R-CQRS-RM-1..4 и R-CQRS-RM-X1..X3.


Синхронизация read-model через события — outbox + Kafka + idempotent consumer
Mon, 25 May 2026 18:44:36 GMT
Как синхронизировать read-model с write-side в CQRS: write-handler commit → outbox-таблица атомарно, outbox-relay публикует в Kafka, read-side consumer (этот же сервис или другой) обновляет read-model. Idempotent consumer обязателен через processed_event таблицу или idempotent UPDATE по version. Batch-rebuild для bootstrap и disaster recovery. Eventual consistency декларируется в API. Read-your-writes — через sticky session, polling или non-CQRS endpoint. Запреты: synchronous UPDATE read-model в write-tx, sync через PG triggers, schema-coupled events. Раскрытие правил R-CQRS-SYNC-1..5 и R-CQRS-SYNC-X1..X3.


Уровень и эволюция CQRS — от lightweight маркеров к event-driven read-model
Mon, 25 May 2026 18:44:36 GMT
Эволюция CQRS по уровням зрелости: Уровень 1 — без CQRS; Уровень 2 — lightweight маркеры UseCaseCommand/UseCaseQuery обязательны, один Repository, readOnly=true на query; Уровень 3 split — отдельный ViewRepository в core/, read-DTO; Уровень 3 event-driven — отдельная read-таблица или хранилище, sync через outbox+Kafka. Эволюция всегда снизу вверх. Запреты: маркеры на Уровне 1 без enforcement, event-driven read-model с одним Repository для R+W. Раскрытие правил R-CQRS-TIER-1..5 и R-CQRS-TIER-X1..X2.


Entity в DDD — стабильный ID, equals по ID, бизнес-методы вместо сеттеров
Mon, 25 May 2026 17:10:33 GMT
Что такое Entity в тактическом DDD: наследование Entity, final-поле id, equals/hashCode по идентификатору (никогда по полям), валидация инвариантов в конструкторе, изменение состояния только через бизнес-методы. Запреты: переопределять equals в наследниках, ссылаться на другие агрегаты объектами, держать публичные сеттеры, писать анемичный класс из одних геттеров. Раскрытие правил R-ENT-1..5 и R-ENT-X1..X5.


Value Object в DDD — immutable, equals по значению, Java record как идеальный носитель
Mon, 25 May 2026 17:10:33 GMT
Что такое Value Object в тактическом DDD: маркер ValueObject, immutability (final class, final fields), equals по всем значимым полям, валидация инвариантов в конструкторе, мутации через возврат нового экземпляра. Java record + ValueObject — идеальная связка. Запреты: id или жизненный цикл в VO, primitive obsession, мутабельные коллекции без обёртки. Раскрытие правил R-VO-1..5 и R-VO-X1..X3 на примерах Money, Email, Address.


Aggregate Root в DDD — граница транзакции и точка входа в агрегат
Mon, 25 May 2026 17:10:33 GMT
Что такое Aggregate Root в тактическом DDD: наследование AggregateRoot, все внешние операции через методы корня, внутренние Entity скрыты, доменные события регистрируются только в корне через registerEvent. Транзакция изменяет один агрегат, между агрегатами — eventual consistency через события. Ссылки между агрегатами — по ID. Запреты: God aggregate, мутабельные коллекции наружу, регистрация событий вне корня, изменение чужого агрегата напрямую. Раскрытие правил R-AGG-1..5 и R-AGG-X1..X4.


Domain Event в DDD — иммутабельный факт в прошлом, который регистрируется корнем агрегата
Mon, 25 May 2026 17:10:33 GMT
Что такое Domain Event в тактическом DDD: наследование DomainEvent, имя в прошедшем времени (OrderPaid не PayOrder), immutability, бизнес-контекст в полях (не ссылка на агрегат), публикация через DomainEventPublisher после save(), clearDomainEvents() после публикации. Запреты: ссылка на агрегат внутри события, публикация из сервиса/контроллера, @TransactionalEventListener AFTER_COMMIT для критичных эффектов (нужен Outbox). Раскрытие правил R-EVT-1..5 и R-EVT-X1..X4.


Repository в DDD — интерфейс в core, реализация в адаптере, агрегат сохраняется целиком
Mon, 25 May 2026 17:10:33 GMT
Что такое Repository в тактическом DDD: наследование AggregateRepository, интерфейс в domain-пакете, реализация в out-adapter, один репозиторий = один корень агрегата, save сохраняет агрегат целиком и публикует собранные события + clearDomainEvents, методы названы в терминах домена. Запреты: возврат DAO/jOOQ типов наружу, методы про конкретную таблицу, Specification для SQL. Раскрытие правил R-REP-1..5 и R-REP-X1..X3.


Domain Service в DDD — только когда логика касается двух агрегатов
Mon, 25 May 2026 17:10:33 GMT
Что такое Domain Service в тактическом DDD: создаётся, ТОЛЬКО когда правило касается двух и более агрегатов и не помещается в один корень. Stateless, принимает доменные объекты, имя выражает доменную операцию (TransferService, PricingService). Запреты: оркестрация (загрузка из репозитория, транзакции, публикация событий — это Application Service), Domain Service как свалка вместо rich domain. Раскрытие правил R-DS-1..3 и R-DS-X1..X2.


Factory в DDD — когда конструктор не справляется
Mon, 25 May 2026 17:10:33 GMT
Что такое Factory в тактическом DDD: вводится ТОЛЬКО когда конструктор не справляется — нужны данные из другого агрегата, выбор подкласса по политике, сборка из нескольких частей. Factory возвращает уже валидный агрегат с зарегистрированными начальными событиями (OrderCreated). Запрет — Factory ради Factory: если new Order(...) работает, лишний слой не нужен. Раскрытие правил R-FAC-1..2 и R-FAC-X1.


Specification в DDD — переиспользуемое доменное правило с комбинаторами
Mon, 25 May 2026 17:10:33 GMT
Что такое Specification в тактическом DDD: наследование Specification, метод isSatisfiedBy(T), комбинаторы and/or/not, используется ТОЛЬКО когда правило применяется в двух и более местах либо нужны комбинации. Запреты: Specification для генерации SQL (это Query Side, не доменное правило), Specification для одного if в одном месте (преждевременная абстракция). Раскрытие правил R-SPEC-1..2 и R-SPEC-X1..X2.


Структура пакетов в DDD — по домену, не по типу
Mon, 25 May 2026 17:10:33 GMT
Как раскладывать DDD-код по пакетам: верхний уровень — Bounded Context, внутри — domain/ (aggregate, entity, valueobject, event, repository, service, specification) и usecase/ (command, query). Запрет на верхнеуровневые папки entity/, service/, repository/ — это группировка по типу, классический антипаттерн. core/ без зависимостей от Spring/JPA/jOOQ. Раскрытие правил R-MOD-1..2.


Когда переходить на Hexagonal Architecture
Mon, 25 May 2026 16:01:20 GMT
Hexagonal — паттерн с ceremony. Когда выгода (testability, изоляция домена, тех-опции) реально перевешивает: интеграции с 2+ системами, богатая domain-логика, 3+ способа входа, команда 3+ человек. Когда рано: монолит из 3 endpoints, 1-2 разработчика, неустоявшаяся бизнес-логика. Запрет cargo-cult и частичного Hexagonal. Раскрытие правил R-HEX-WHEN-1..3 и R-HEX-WHEN-X1..X2.


Структура модулей в Hexagonal Architecture
Mon, 25 May 2026 16:01:20 GMT
Multi-module gradle для Hexagonal: core/ без Spring, persistence/, отдельные *-in-adapter и *-out-adapter на каждую систему/тип входа, bootstrap/ как composition root. Почему один модуль с папками core/adapter — антипаттерн, и почему стрелка зависимостей строго bootstrap → core ← adapters. Раскрытие правил R-HEX-MOD-1..5 и R-HEX-MOD-X1..X3.


Core слой в Hexagonal Architecture
Mon, 25 May 2026 16:01:20 GMT
Что попадает в core/: DDD-агрегаты, ports out-интерфейсы, use cases, application-DTO. От чего core/ зависит (JDK, Lombok, DDD-библиотеки) и от чего НЕ зависит (Spring, JOOQ, Jackson, OkHttp, Kafka). Почему rich domain методы внутри агрегата, а не в *Service. Почему generated POJO и HTTP-DTO в core/ — антипаттерн. Раскрытие правил R-HEX-CORE-1..4 и R-HEX-CORE-X1..X5.


Ports в Hexagonal Architecture — interfaces в core/
Mon, 25 May 2026 16:01:20 GMT
Что такое outbound port в Hexagonal, почему port лежит в core//port/out/, как именовать (Repository, Port, EventPublisher), почему методы port'а оперируют domain-типами, а не generated DTO внешней системы. Зачем abstract PortException в core и конкретные подклассы в out-adapter. Почему inbound port — это UseCase, отдельный интерфейс не нужен. Раскрытие правил R-HEX-PORT-1..4 и R-HEX-PORT-X1..X4.


Adapters In в Hexagonal — REST / Kafka consumer / CLI как entry-points
Mon, 25 May 2026 16:01:20 GMT
Что такое in-adapter в Hexagonal: per-purpose модули (user-api / admin-api / kafka-in / cli-in), Controller через generated Api, маппер REST-DTO ↔ Use Case command, что нельзя класть в Controller (бизнес-логика, прямой вызов Repository, domain entity наружу), почему in-adapter не зависит от out-adapter. Раскрытие правил R-HEX-AIN-1..4 и R-HEX-AIN-X1..X4.


Adapters Out в Hexagonal — реализация port-интерфейсов из core
Mon, 25 May 2026 16:01:20 GMT
Что такое out-adapter в Hexagonal: per-system модули (persistence/, sber-out-adapter/, kafka-out-adapter/, s3-out-adapter/), implements port из core, mapper для generated DTO ↔ domain. Что нельзя класть в out-adapter (бизнес-логика, generated DTO в port-методе, координация с другим адаптером). Почему один адаптер на систему. Раскрытие правил R-HEX-AOUT-1..4 и R-HEX-AOUT-X1..X4.


Bootstrap / Composition Root в Hexagonal
Mon, 25 May 2026 16:01:20 GMT
Что лежит в bootstrap-модуле: @SpringBootApplication, application.yml, @Configuration для wiring, Dockerfile. Почему bootstrap зависит от всех модулей, а никто — от bootstrap. Почему бизнес-логика в bootstrap и @SpringBootApplication в core/adapter — антипаттерны. Раскрытие правил R-HEX-BOOT-1..3 и R-HEX-BOOT-X1..X2.


Архитектурные тесты Hexagonal через ArchUnit
Mon, 25 May 2026 16:01:20 GMT
Зачем ArchUnit-тесты в Hexagonal-сервисе и какие правила они enforce-ят (core без Spring/JOOQ, port — interface в core, in-adapter не зависит от out-adapter, controller implements generated Api). Почему один required CI check ловит то, что человек-ревьюер пропустит. Раскрытие правил R-HEX-TEST-1..3 и R-HEX-TEST-X1.


Когда нужны распределённые паттерны — три условия и три альтернативы
Mon, 25 May 2026 19:24:51 GMT
Когда применять распределённые паттерны: бизнес-операция охватывает 2+ сервиса и невозможно завершить локальной транзакцией; в одном сервисе и одном PostgreSQL — обычный @Transactional. Альтернативы перед введением: объединение в один BC, modular monolith, eventual consistency без саги. Запреты: распределённые паттерны для одного сервиса, микросервисы из амбиций. Раскрытие правил R-DIST-WHEN-1..3 и R-DIST-WHEN-X1..X2.


Saga — оркестрация vs хореография, выбор и реализация
Mon, 25 May 2026 19:24:51 GMT
Saga — управление long-running cross-service операцией через серию локальных транзакций + compensation. Orchestration с центральным координатором — для саг 4+ шагов и branching; choreography через события — для 2-3 шагов. State хранится в saga_ таблице PostgreSQL для видимости, recovery и audit. SagaId сквозной для трассировки. Запреты: 2PC/XA вместо саги, saga без compensation, state in-memory, saga смешана с use case. Раскрытие правил R-DIST-SAGA-1..5 и R-DIST-SAGA-X1..X4.


Idempotency в распределённых системах — таблицы processed_event и idempotency_record
Mon, 25 May 2026 19:24:51 GMT
Idempotency обязательна в распределённой системе: at-least-once приводит к дубликатам. Каждое сообщение имеет ID — eventId UUID v7 для Kafka, Idempotency-Key header для HTTP money, sagaId+stepName для шагов саги. Receiver хранит processed_event и проверяет перед обработкой; для HTTP — idempotency_record с (key, command_hash, response), конфликт ключа с другой командой — 409. Money — двойная защита: client Idempotency-Key + внутренний unique constraint. TTL 24-72 часа. Запреты: receiver без dedup для money, только receiver-side, новый UUID каждый retry. Раскрытие правил R-DIST-IDEM-1..5 и R-DIST-IDEM-X1..X3.


Eventual consistency — декларация в OpenAPI, read-your-writes, bounded staleness
Mon, 25 May 2026 19:24:51 GMT
Eventual consistency требует явного контракта: декларация в OpenAPI с ожидаемой задержкой, bounded staleness SLO «не более 5 секунд между write и появлением в read-проекции», read-your-writes реализуется через sticky session, polling, synchronous wait или альтернативный endpoint из write-side. Causal consistency через version-поля. Запреты: молчаливая eventual consistency, strict immediate через 2PC. Раскрытие правил R-DIST-EC-1..4 и R-DIST-EC-X1..X2.


Outbox и Inbox — атомарная публикация и приём в распределённой системе
Mon, 25 May 2026 19:24:51 GMT
Outbox решает атомарность «БД commit + message publish»: команда commits в БД и INSERT в outbox_event атомарно, outbox-relay (@Scheduled с FOR UPDATE SKIP LOCKED) публикует в Kafka и помечает published_at. Inbox — обратное: consumer пишет полученное сообщение в inbox_event + processed=false, отдельный handler обрабатывает. В большинстве случаев — inbox избыточен, достаточно processed_event dedup. Single source of truth — БД сервиса, Kafka — транспорт. Запреты: direct send из command-handler, @TransactionalEventListener для Kafka. Раскрытие правил R-DIST-OBX-1..3 и R-DIST-OBX-X1..X2.


Compensation в saga — semantic state-change, идемпотентность, DLQ
Mon, 25 May 2026 19:24:51 GMT
Compensation — отмена эффекта предыдущего шага саги. Каждая command имеет парную compensation (chargePayment ↔ refundPayment, reserveInventory ↔ releaseInventory). Compensation идемпотентен — saga может повторить compensation при retry. Semantic compensation, не технический rollback: refund — новая транзакция, не «откат». Audit trail обязателен — статус REFUNDED с reference. При failure compensation — DLQ и manual review. Запреты: saga без compensation, DELETE как compensation, compensation без retry-механики. Раскрытие правил R-DIST-COMP-1..4 и R-DIST-COMP-X1..X3.


Distributed transactions — почему 2PC, JTA и XA не подходят для микросервисов
Mon, 25 May 2026 19:24:51 GMT
2PC, JTA, XA в UCP запрещены: Kafka не поддерживает XA, 2PC synchronous block не масштабируется, transaction coordinator — single point of failure, сложно operate в Kubernetes. ChainedTransactionManager — best-effort, не атомарность; failure между commit-ами оставляет inconsistency. Альтернативы: saga с локальными транзакциями (стандарт UCP), outbox + idempotent consumer для event-driven sync, modular monolith для tight coupling — один PG с локальным @Transactional. Раскрытие правил R-DIST-TX-X1..X3 и R-DIST-TX-1..3.


Метод системного дизайна: от требований к архитектуре
Sat, 6 Jun 2026 18:30:47 GMT
Пошаговый метод системного дизайна: требования, оценки нагрузки на салфетке, контракты, модель данных, схема, горячие точки, отказы — и принципы, которые держат процесс.


Строительные блоки системного дизайна и их цена
Sat, 6 Jun 2026 18:30:47 GMT
Словарь системного дизайна: балансировка, кеш, репликация и шардинг, очереди, поиск, аналитика, CDN. Что каждый блок покупает, чем платят и по какому числу он появляется.


Системный дизайн на практике: проектируем систему уведомлений
Sat, 6 Jun 2026 18:30:47 GMT
Весь метод системного дизайна на одной задаче: уведомления для 10 млн пользователей — оценки на салфетке, контракты, модель данных, схема с очередями, отказы и деградация.


Оформление и защита дизайна: design doc, C4, ревью
Sat, 6 Jun 2026 18:30:47 GMT
Как превратить системный дизайн в решение: структура design doc, диаграммы C4 по уровням, ADR для развилок, процесс ревью с чек-листом вопросов и типичные провалы защиты.


Выбор начальной архитектуры: монолит, модульный монолит, микросервисы
Mon, 18 May 2026 07:48:58 GMT
Слойный монолит, модульный монолит или микросервисы: критерии выбора, чек-лист на старте проекта и сценарии перехода. Как Use Case Pattern переживает каждый из этих режимов без переписывания.


PostgreSQL или MongoDB: как принять решение
Mon, 18 May 2026 07:48:58 GMT
Десять конкретных критериев выбора между PostgreSQL и MongoDB на новом сервисе: природа данных, шаблон запросов, требования к транзакциям, схема, нагрузка, операционная зрелость команды. Чек-лист, типичные ошибки выбора, сценарии где обе БД работают вместе.


PostgreSQL или ClickHouse: когда добавлять OLAP
Sat, 6 Jun 2026 16:38:02 GMT
Когда аналитику пора выносить из PostgreSQL в ClickHouse: восемь критериев, чек-лист с баллами, типичные ошибки — ClickHouse как замена PG, кластер на пять миллионов строк.


Поиск: PostgreSQL FTS или Elasticsearch
Sat, 6 Jun 2026 16:38:02 GMT
Когда полнотекстового поиска PostgreSQL (tsvector, pg_trgm) достаточно, а когда нужен Elasticsearch: восемь критериев, чек-лист, типичные ошибки — ES ради одного LIKE.


Файлы: в базе данных или в object storage
Sat, 6 Jun 2026 16:38:02 GMT
Где хранить файлы — bytea в PostgreSQL или S3: семь критериев, граница по размеру и трафику, целостность «БД + S3» через двухфазную загрузку и outbox, типичные ошибки.


Между сервисами: синхронный вызов или события
Sat, 6 Jun 2026 16:38:02 GMT
REST-вызов или событие через брокер: семь критериев выбора взаимодействия сервисов, чек-лист, типичные ошибки — синхронная сага из пяти сервисов, RPC поверх Kafka.


Веб-стек: Spring MVC, WebFlux или виртуальные потоки
Sat, 6 Jun 2026 16:38:02 GMT
Выбор веб-стека Spring: что виртуальные потоки Java 21 закрыли из аргументов WebFlux, где reactive ещё оправдан, чек-лист и ошибки — WebFlux «для скорости», block() в цепочке.


ADR: как фиксировать архитектурные решения
Sat, 6 Jun 2026 16:43:55 GMT
Architecture Decision Records: формат (контекст, решение, последствия), статусы, где хранить, когда писать и когда нет. Пример ADR на реальной развилке и ошибки ведения.


Что делает архитектор — и какие задачи закрывают AI-скиллы
Sat, 6 Jun 2026 16:43:55 GMT
Обязанности архитектора в команде: карта системы, развилки и ADR, границы контекстов, бизнес-процессы, impact-анализ, согласованность — и какие ucp-скиллы закрывают каждую.


Вход тимлида в проблемную команду: разбор кейса
Sat, 6 Jun 2026 18:02:08 GMT
Разбор кейса: новый тимлид принимает команду с экс-лидом в составе, перегруженным продакт-овнером, потоком чужих задач и подорванным доверием стейкхолдеров. План 30/60/90 и приёмы.


Архитектурный аудит сервиса или системы
Tue, 28 Apr 2026 09:28:08 GMT
Разбор существующего кода и архитектуры с письменным отчётом и приоритизацией проблем. Команда после аудита знает что чинить в первую очередь и в каком порядке.


Внедрение Use Case Pattern в команде
Tue, 28 Apr 2026 09:28:08 GMT
Workshop + сопровождение. После — команда самостоятельно применяет UCP, ведёт спецификацию-как-код, использует AI-скиллы для review каждой PR.


Технический ментор для тимлида и архитектора
Tue, 28 Apr 2026 09:28:08 GMT
Регулярные сессии 1-на-1: sparring-партнёр по конкретным архитектурным решениям. Не общая лекция, а разбор того, что прямо сейчас на столе.


Code review как сервис
Tue, 28 Apr 2026 09:28:08 GMT
Async-ревью PR-ов с цитированием правил методологии. Команда поднимает уровень кода без необходимости держать senior full-time.


Кейс: enterprise без отдельных системных аналитиков
Tue, 28 Apr 2026 09:30:00 GMT
Enterprise-команда 25+ инженеров. Внедрили Use Case спецификацию-как-код и AI-скиллы для генерации артефактов и review. Отдел системного анализа расформирован — функция распределена между разработчиками и AI-скиллами.


Кейс: код стартапа остаётся понятным
Tue, 28 Apr 2026 09:30:00 GMT
Стартап 4-8 разработчиков, MVP с быстрой эволюцией требований. Внедрили UCP с правильным уровнем по модулям и AI-скиллы для review с первого дня. Через 1.5 года код адаптируется без переписывания.