AGENTS.md — ingestion

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

Этот уровень описывает целевую сервисную границу ingestion, включая connector framework и поставщиковые интеграции.

Содержание

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

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

• Connector — отдельная интеграция конкретного поставщика.
• Raw payload — неизменяемые данные, полученные от поставщика.
• Rate budget — лимиты вызовов и стратегия их расходования.

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

• Добавляете нового поставщика.
• Разбираетесь с flow получения данных.
• Ищете документацию по connector framework.

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

• Нужна нормализация payload → ../normalization/.
• Нужен deployment/compose слой → ../../40-operations/.

Связано

• README.md
• connectors/AGENTS.md
• ../../20-architecture/integration-patterns.md

Соглашения

• Считайте ingestion target boundary, пока в backend/ не появится выделенный ingestion runtime.