AGENTS.md — connectors/etm

Назначение уровня

Этот уровень описывает документацию по коннектору ETM как референсной интеграции поставщика в границе ingestion.

Содержание

etm/
├── AGENTS.md            # ← вы здесь
├── README.md            # назначение, статус, контракты и ограничения ETM
├── spec.md              # сводка по API ETM
├── mapping.md           # маппинг ETM -> canonical-модель
└── rate-budget.md       # лимиты и стратегия обхода rate limits

Ключевые концепции уровня

• ETM session — login/session flow ETM API.
• Rate budget — лимиты запросов по endpoint’ам ETM.
• Supplier mapping — отображение ETM полей на внутреннюю модель.

Когда смотреть сюда

• Нужно понять специфику ETM API.
• Нужно проверить mapping и ограничения по загрузке данных.
• Нужен референс для нового коннектора.

Когда НЕ смотреть сюда

• Нужен общий connector framework → ../framework.md.
• Нужен общий ingestion flow → ../../README.md.

Связано

• README.md
• ../framework.md
• ../../../../50-processes/adding-new-supplier.md

Соглашения

• ETM рассматривается как target connector, пока в backend/internal/connectors/etm/ не появится реализация.
• Факты про API ETM храните в spec.md, а не дублируйте по разным файлам.