ref.yaml

Формирует семантический слой данных, описывая связи между бизнес-сущностями:

• Отношения между атрибутами сущностей
• Трассировку пути данных (источник → потребитель)
• Поиск потребителей поля
• Основу для ИИ-помощников
• Отслеживание влияния изменений
• Автоматические предупреждения при модификации полей

Например, у нас есть контракт, имеющий поле с идентификатором некой сущности (entity_id в примере ниже), следовательно, он должен сослаться на соответствующее ему поле в контракте, описывающем данные потока (entity-changes в примере ниже) для обновления справочника сущностей:

refs:
  - entity_id: some_department/entities_managenet:entity-changes.entity_id

Если понятно как можно кратко описать суть связи, следует сделать это, добавив к ней атрибут description.