Glossary / Глоссарий¶

A¶

API Gateway¶

Единая точка входа для всех данных. Обеспечивает аутентификацию (mTLS), маршрутизацию и rate limiting.

Avro¶

Бинарный формат сериализации данных, разработанный Apache. Поддерживает эволюцию схем и compact storage.

{
  "type": "record",
  "name": "Order",
  "fields": [
    {"name": "order_id", "type": "string"},
    {"name": "amount", "type": "double"}
  ]
}

B¶

Backward Compatibility¶

Свойство схемы, при котором новая версия может читать данные, записанные старой версией.

Breaking Change¶

Изменение контракта, которое может сломать существующих потребителей: - Удаление поля - Изменение типа поля - Добавление required поля - Ужесточение constraints

C¶

CDC (Change Data Capture)¶

Метод захвата изменений в базе данных в реальном времени. Используется для репликации данных в Kafka.

Consumer (Потребитель)¶

Система или команда, которая читает данные из Kafka topics и использует их (BI, ML, аналитика).

Contract Version¶

Семантическая версия контракта в формате MAJOR.MINOR.PATCH: - MAJOR: breaking changes - MINOR: новые nullable поля - PATCH: изменения описания

D¶

Data Contract (Контракт данных)¶

Формализованное соглашение между издателем и потребителем данных, определяющее схему, качество, SLA и ответственность.

Data Lineage¶

Информация о происхождении данных: откуда пришли, как трансформировались, кто использует.

Dead Letter Queue (DLQ)¶

Kafka topic для данных, не прошедших проверку качества. Формат: {namespace}.{entity}_dlq.

Domain (Домен)¶

Бизнес-область, группирующая связанные сущности данных. Примеры: sales, warehouse, marketing.

E¶

Entity (Сущность)¶

Конкретный тип данных внутри домена. Примеры: orders, customers, products.

Escalation¶

Процесс передачи инцидента на более высокий уровень ответственности при нарушении SLA.

F¶

Freshness (Свежесть)¶

SLA метрика, определяющая максимальный возраст данных. Формат ISO 8601: PT1H = 1 час.

Forward Compatibility¶

Свойство схемы, при котором старая версия может читать данные, записанные новой версией.

G¶

GitLab CI/CD¶

Система непрерывной интеграции и доставки. Автоматически проверяет изменения контрактов при создании MR.

J¶

JSON Schema¶

Стандарт для описания структуры JSON документов. Используется для валидации YAML контрактов.

K¶

Kafka¶

Распределённая платформа потоковой передачи данных (Apache Kafka). Центральный компонент архитектуры.

Kafka Topic¶

Категория/канал для публикации сообщений в Kafka. Формат naming: {namespace}.{entity}[_suffix].

M¶

Merge Request (MR)¶

Запрос на слияние изменений в Git. Все изменения контрактов проходят через MR с проверками CI/CD.

mTLS (Mutual TLS)¶

Двусторонняя аутентификация по сертификатам. Используется в API Gateway для идентификации издателей.

MTTR (Mean Time To Resolve)¶

Среднее время устранения инцидента от момента обнаружения до восстановления.

MTTD (Mean Time To Detect)¶

Среднее время обнаружения инцидента от момента его возникновения.

N¶

Namespace¶

Логическое пространство имён для группировки контрактов. Обычно совпадает с доменом.

Non-breaking Change¶

Изменение контракта, безопасное для существующих потребителей: - Добавление nullable поля - Изменение описания - Смягчение constraints

Nullable¶

Поле, которое может содержать null. Nullable поля безопасно добавлять в контракт.

O¶

Owner (Владелец)¶

Команда или человек, ответственный за качество данных и реагирование на инциденты.

P¶

PII (Personally Identifiable Information)¶

Персональные данные, требующие особой защиты: email, телефон, ФИО и т.д.

Postmortem¶

Документ-анализ после инцидента: что случилось, почему, как предотвратить.

Producer (Издатель)¶

Система или команда, которая генерирует и отправляет данные в соответствии с контрактом.

Prod Topic¶

Kafka topic с данными, прошедшими проверку качества. Формат: {namespace}.{entity}_prod.

Q¶

Quality Rules (Правила качества)¶

Набор проверок, определённых в quality_rules.yml, которые применяются к каждой записи данных.

rules:
  - name: "order_id_not_null"
    field: "order_id"
    type: "not_null"
    severity: "error"

R¶

RACI Matrix¶

Матрица распределения ответственности: - **R**esponsible — кто делает - **A**ccountable — кто отвечает за результат - **C**onsulted — кого консультируют - **I**nformed — кого информируют

Raw Topic¶

Kafka topic для сырых данных до валидации. Формат: {namespace}.{entity}.raw.

Runbook¶

Пошаговая инструкция для реагирования на типовые инциденты.

S¶

Schema Registry¶

Сервис (Confluent Schema Registry) для хранения и версионирования Avro схем.

SemVer (Semantic Versioning)¶

Стандарт версионирования: MAJOR.MINOR.PATCH (например, 2.1.0).

Severity¶

Уровень критичности инцидента: P1 (Critical), P2 (High), P3 (Medium), P4 (Low).

SLA (Service Level Agreement)¶

Соглашение об уровне сервиса: доступность, свежесть, время реакции.

Steel Thread¶

Минимальный сквозной путь через систему для быстрой валидации архитектуры. Первый контракт для PoC.

T¶

Topic Naming Convention¶

Соглашение об именовании Kafka topics: - Raw: {namespace}.{entity}.raw - Prod: {namespace}.{entity}_prod - DLQ: {namespace}.{entity}_dlq

V¶

Validator (Quality Validator)¶

Сервис, который читает данные из raw topic, применяет quality rules и маршрутизирует в prod или dlq.

W¶

WAP (Write-Audit-Publish)¶

Паттерн обработки данных: 1. Write — записать в staging 2. Audit — проверить качество 3. Publish — опубликовать в production

Сокращения¶

Версия: 1.0 Последнее обновление: 24 января 2026