При договорённости с соседними командами по контрактам важно понимать различия между protobuf и event-контрактами:

Protobuf (Protocol Buffers) — это бинарный формат сериализации данных с чётко описанной схемой (schema). Контракт в protobuf — это определение структуры сообщений (например, запросов и ответов API). Он строго типизирован и позволяет гарантировать совместимость версий.
Event-контракты — это соглашения о формате и содержании событий, которые публикуются и потребляются в системе (например, через Kafka). Они могут быть описаны с помощью protobuf, JSON Schema или других форматов. Главное — договориться о структуре события, его семантике и поведении при изменениях.

В практике:

Для RPC или API часто используют protobuf-контракты, чтобы строго описать входные и выходные данные.
Для событийных систем — event-контракты, которые описывают события, их поля и правила эволюции.

Договорённости включают:

Версионирование контрактов
Обратную совместимость
Процесс обновления и деплоя
Ответственность за поддержку и тестирование

Таким образом, protobuf — это технология описания структуры данных, а event-контракты — более широкое понятие, включающее соглашения о событиях и их обработке.

Как договариваетесь с соседними командами по контрактам — protobuf, event-контракты, в чём разница?