AGENTS.md — exchange

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

Сервисная граница exchange — exchange-rates layer для multi-currency pricing. Periodic pull из CBR daily-rates, 7d staleness cap, in-domain LastRefreshAge для observability.

Содержание

exchange/
├── AGENTS.md     # ← вы здесь
└── README.md     # назначение, контракты, зависимости

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

• ExchangeRate snapshot — daily, source: CBR XML.
• Staleness cap — pricing pipeline отказывается convert когда LastRefreshAge > 7d (избегает stale rate в proposal).
• Identity bypass БД — RUB↔RUB short-circuit без read.

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

• Pricing возвращает reason=exchange_stale или unsupported_currency.
• DKC USD/EUR pricing работает странно — debug exchange layer.

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

• Сами price observations → ../pricing/.
• Currency-formatting в UI → frontend.

Связано

• ../pricing/ — потребитель exchange rate.
• ADR-0042 — exchange layer design (P6).