AGENTS.md — connectors

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

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

Содержание

connectors/
├── AGENTS.md          # ← вы здесь
├── framework.md       # интерфейс Connector, lifecycle, регистрация
└── <supplier>/
    ├── AGENTS.md
    ├── README.md
    ├── spec.md
    ├── mapping.md
    └── rate-budget.md

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

• Connector — изолированная интеграция одного поставщика.
• Rate budget — лимиты вызовов и стратегия деградации.
• Supplier mapping — отображение внешней модели поставщика на внутреннюю каноническую модель.

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

• Добавляете нового поставщика.
• Нужно понять контракт connector framework.
• Нужно найти спецификацию или mapping конкретного поставщика.

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

• Нужна общая orchestration-логика ingestion → ../README.md.
• Нужен process/runbook подключения поставщика → ../../../50-processes/adding-new-supplier.md.

Связано

• ../README.md
• framework.md
• ../../../20-architecture/integration-patterns.md

Соглашения

• Коннектор описывается документацией внутри этой папки, а целевой код по module-layout должен жить в backend/internal/connectors/<supplier>/, когда появится реализация.
• Никакие внутренние детали коннектора не должны утекать в ядро за пределы интерфейса Connector.