AGENTS.md — 60-flows/10-ingestion

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

Раздел описывает слой ingestion как построено (current, as-built), сверено с кодом. Целевая сервисная граница ingestion — в ../../30-services/ingestion/; не смешивать.

Содержание

10-ingestion/
├── AGENTS.md              # ← вы здесь
└── README.md              # обзор слоя: участники, use-case файлы

Use-case файлы (например, russvet.md) добавляются последующими задачами инициативы прямо в эту директорию.

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

• supplier-sync — фактический worker-процесс, реализующий ingestion; отдельного сервиса ingestion в коде нет. См. README.md.
• PipelineRouter — диспетчер, выбирающий пайплайн (bulk-snapshot или cursor) по Capabilities поставщика.
• Остальные термины — см. ../../GLOSSARY.md.

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

• Нужно проследить реальный путь загрузки данных от конкретного поставщика.
• Нужна точная ссылка на символ кода (file:line) внутри supplier-sync или пайплайнов.
• Готовите impact-анализ изменений в ingestion и хотите отталкиваться от проверенных фактов.

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

• Нужен целевой дизайн сервисной границы ingestion → ../../30-services/ingestion/README.md.
• Нужна документация конкретного коннектора (протокол, маппинг полей) → ../../30-services/ingestion/connectors/<supplier>/.
• Нужны бизнес-правила загрузки → ../../10-business/.

Связано

• README.md
• ../AGENTS.md
• ../entry-points.md
• ../../30-services/ingestion/AGENTS.md

Соглашения

• Use-case файлы этого слоя следуют общему правилу раздела: каждый факт — со ссылкой на file:line, каждый файл — с маркером «Статус: current (as-built), сверено на commit <hash>».