gRPC схемы

NOTE

Статус: Target schemas. Описание целевых схем данных. Миграции и реальные таблицы в backend/migrations/ могут отставать от документа. Правила маркировки — в 50-processes/documentation-standard.md.

public_api.proto — публичный gRPC API (см. ADR-0015).

Правила

• Не менять номера полей.
• Не удалять поля; помечать reserved.
• Не переиспользовать reserved.
• Breaking change → новый package public.v2, параллельная служба.

Генерация клиентов

CI генерирует клиентские SDK при изменении .proto:

• Go: gen/go/tracium/public/v1/
• TypeScript: gen/ts/tracium/public/v1/
• Python: gen/py/tracium/public/v1/

Команда (локально): make proto-gen.

Совместимость

buf breaking запускается в CI как gate:

# buf.yaml
version: v1
breaking:
  use:
    - WIRE_JSON
    - WIRE