Как проектировать gRPC API так, чтобы оно было backward compatible при эволюции схемы?

1. Никогда не изменять номера полей

Даже если поле удалено → отмечаем:

reserved 3;
reserved "old_field"

2. Нельзя менять тип поля

Это ломает бинарную совместимость.

3. Добавление новых полей — безопасно

Старый клиент их игнорирует.

4. Использовать wrapper-типы (google.protobuf.*Value)

Чтобы различать “не передано” и “нулевое значение”.

5. Oneof вместо enum

Удобно эволюционирует.

6. Версионирование пакетов

my.service.v1, my.service.v2.

7. Deprecation policy

Нельзя «ломать» контракты без подготовки.