Стандарты · executable engineering corpus

Каталог архитектурных правил.

1472 правил · 18 стайл гайдов · 44 AI-скиллов

Каждое правило имеет код вида PG-T-013, R-AGG-X4, JS-4.7. AI-скиллы применяют их на каждом PR и цитируют код в обзорах. Кликаешь код — попадаешь сюда, видишь обоснование.

Подробнее про подход — в статье «Executable engineering standard»: что это, чем отличается от SonarQube/ESLint, когда не нужен.

Специализации

Методология устроена в две оси: специализация и язык. Контракты язык-нейтральны, биндинги дают реализацию под конкретный стек.

Backend: контракты и Java-биндинг ниже, Python-биндинг — в репозитории скиллов, Go и Node — в работе. Выбор языкового биндинга — на странице каждого раздела.

Контракты (язык-нейтральные)

Разделы с пронумерованными правилами. На эти коды ссылается AI-скилл в обзоре PR — разработчик переходит за обоснованием.

133 правил · 10 статей

REST API

Контракт REST API методологии UCP — язык-нейтральные правила R-XXX-N: URL и ресурсы, query, JSON, ошибки RFC 9457, версионирование, OpenAPI. Java-биндинг — статьи раздела, Python — скиллы ucp-py-api-*.

AI-скилл: ucp-api-review / ucp-api-design / ucp-py-api-review / ucp-py-api-design

→ Открыть раздел

39 правил · 7 статей

Обработка ошибок

Контракт обработки ошибок UCP (R-ERR-*): иерархия исключений, ProblemDetails RFC 9457, retry-семантика. Java-биндинг — статьи, Python — скиллы ucp-py-error-handling-*.

AI-скилл: ucp-error-handling-review / ucp-error-handling-design / ucp-py-error-handling-review / ucp-py-error-handling-design

→ Открыть раздел

35 правил · 8 статей

Graceful Shutdown

Контракт graceful shutdown UCP (R-SHUT-*): drain трафика, остановка consumers, k8s probes и preStop. Java-биндинг (Spring Boot) — статьи, Python — скилл ucp-py-shutdown-review.

AI-скилл: ucp-shutdown-review / ucp-py-shutdown-review

→ Открыть раздел

35 правил · 6 статей

Security

Контракт security UCP (R-SEC-*, BS-SEC-*): SAST в CI, suppressions со сроком, секреты, криптография, контейнеры. Java-биндинг — статьи, Python — скиллы ucp-py-security-*.

AI-скилл: ucp-security-review / ucp-security-design / ucp-py-security-review / ucp-py-security-design

→ Открыть раздел

21 правил · 9 статей

Auth Patterns

Контракт аутентификации и авторизации UCP (AUTH-*): JWT на границе, RBAC/ABAC, audit log, идемпотентность. Java-биндинг (Spring Security) — статьи, Python — скиллы ucp-py-auth-*.

AI-скилл: ucp-auth-review / ucp-auth-design / ucp-py-auth-review / ucp-py-auth-design

→ Открыть раздел

69 правил · 12 статей

Отказоустойчивость

Контракт отказоустойчивости UCP (R-RES-*): timeouts, circuit breaker, retry, bulkhead, fallback. Java-биндинг (Resilience4j) — статьи, Python — скиллы ucp-py-resilience-*.

AI-скилл: ucp-resilience-review / ucp-py-resilience-review / ucp-py-resilience-design

→ Открыть раздел

55 правил · 8 статей

Валидация

Контракт валидации UCP (R-VLD-*): где валидируем, constraints, groups, cross-field. Java-биндинг (Jakarta Validation) — статьи, Python (Pydantic) — скиллы ucp-py-validation-*.

AI-скилл: ucp-validation-review / ucp-validation-design / ucp-py-validation-review / ucp-py-validation-design

→ Открыть раздел

54 правил · 8 статей

Кеширование

Контракт кеширования UCP (R-CACHE-*): где кешируем, ключи и TTL, invalidation, stampede. Java-биндинг (Spring Cache + Redis) — статьи, Python — скиллы ucp-py-caching-*.

AI-скилл: ucp-caching-review / ucp-caching-design / ucp-py-caching-review / ucp-py-caching-design

→ Открыть раздел

63 правил · 9 статей

Kafka (стандарт)

Контракт работы с Kafka UCP (R-KFK-*): producer/consumer, outbox, retry и DLQ, дизайн событий. Java-биндинг (Spring Kafka) — статьи, Python (aiokafka) — скиллы ucp-py-kafka-*.

AI-скилл: ucp-kafka-review / ucp-kafka-design / ucp-py-kafka-review / ucp-py-kafka-design

→ Открыть раздел

60 правил · 7 статей

Наблюдаемость

Контракт наблюдаемости UCP (R-OBS-*): structured logging, метрики, tracing, health-checks, SLO. Java-биндинг (Micrometer, OpenTelemetry) — статьи, Python — скиллы ucp-py-observability-*.

AI-скилл: ucp-observability-review / ucp-observability-design / ucp-py-observability-review / ucp-py-observability-design

→ Открыть раздел

42 правил · 6 статей

CQRS

Контракт CQRS UCP (R-CQRS-*): command/query разделение, read-model, синхронизация через события. Java-биндинг — статьи, Python — скиллы ucp-py-cqrs-*.

AI-скилл: ucp-cqrs-review / ucp-cqrs-design / ucp-py-cqrs-review / ucp-py-cqrs-design

→ Открыть раздел

58 правил · 9 статей

DDD Tactical

Контракт тактического DDD UCP (R-AGG-*, R-VO-*, R-EVT-*, R-REP-*): агрегаты, value objects, события, репозитории. Java-биндинг — статьи, Python — скиллы ucp-py-ddd-tactical-*.

AI-скилл: ucp-ddd-tactical-review / ucp-ddd-tactical-design / ucp-py-ddd-tactical-review / ucp-py-ddd-tactical-design

→ Открыть раздел

55 правил · 8 статей

Hexagonal Architecture

Контракт Hexagonal Architecture UCP (R-HEX-*): чистое ядро, ports/adapters, композиция bootstrap, архитектурные тесты. Java-биндинг — статьи, Python — скиллы ucp-py-hexagonal-*.

AI-скилл: ucp-hexagonal-review / ucp-hexagonal-design / ucp-py-hexagonal-review / ucp-py-hexagonal-design

→ Открыть раздел

46 правил · 7 статей

Distributed Patterns

Контракт распределённых паттернов UCP (R-DIST-*): saga и компенсации, идемпотентность, eventual consistency, outbox/inbox. Java-биндинг — статьи, Python — скиллы ucp-py-distributed-*.

AI-скилл: ucp-distributed-review / ucp-distributed-design / ucp-py-distributed-review / ucp-py-distributed-design

→ Открыть раздел

PostgreSQL

Стандарты самой базы — язык-нейтральные; биндинг меняет только инструмент миграций.

554 правил · 31 статей

PostgreSQL (стандарт)

PostgreSQL-стандарты UCP (PG-T/N/I/E/M/W/V/L-*): типы, нейминг, индексы, миграции, runtime. Язык-нейтральны — биндинг меняет только инструмент миграций (Liquibase или Alembic).

AI-скилл: ucp-pg-schema-review / ucp-pg-explain-review / ucp-pg-runtime-review / ucp-pg-migration-review

→ Открыть раздел

Java-биндинг

Языко-специфичные разделы Java-стека: стиль, persistence, тестовая стратегия. У других языков — свои аналоги в репозитории скиллов.

53 правил · 8 статей

Java Style Guide

Java Style Guide — языко-специфичный раздел Java-биндинга UCP (коды JS-*): нейминг, импорты, выражения, Lombok-дефолты. Python-аналог — скилл ucp-py-style-review.

AI-скилл: ucp-java-style-review

→ Открыть раздел

87 правил · 11 статей

jOOQ Style Guide

jOOQ Style Guide — persistence-слой Java-биндинга UCP (R-JOOQ-*): repository-pattern, multiset, мапперы, транзакции. Python-аналог — SQLAlchemy, скиллы ucp-py-sqlalchemy-*.

AI-скилл: ucp-jooq-design / ucp-jooq-review

→ Открыть раздел

14 правил · 8 статей

Test Strategy Style Guide

Test Strategy — тестовая стратегия Java-биндинга UCP (TS-*): Testcontainers и WireMock, детерминированные время и UUID, слои тестов. Python-аналог — pytest-стек, скиллы ucp-py-test-*.

AI-скилл: ucp-test-design

→ Открыть раздел

Python-биндинг

Разделы Java-биндинга скрыты профилем Python. Python-биндинг (style-guide и скиллы ucp-py-*) живёт в репозитории скиллов; статьи на сайте появятся по мере наполнения.

Frontend-трек

Backend-разделы скрыты профилем Frontend. Каркас frontend-трека (React + TypeScript) →

Ищешь теоретические гайды, кейсы и эссе? → Раздел «Статьи»