AGENTS.md — stock

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

Сервисная граница stock — наличие товара per (supplier, warehouse, sku). Layer 1.3 в pricing pipeline. Tier-1 batch (bulk_snapshot) + Tier-2 detail warming (low-stock priority).

Содержание

stock/
├── AGENTS.md             # ← вы здесь
├── README.md             # назначение, контракты, зависимости
└── operator-runbook.md   # ops процедуры

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

  • stock_observation — snapshot per (supplier, sku, warehouse).
  • sku_warm_state — priority queue для Tier-2 (low-stock first + TTL freshness).
  • Stock completeness flag — Tier-1 batch может вернуть subset; warmer добавляет «edge» данные.

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

  • Live customer query показывает «нет в наличии» для известного SKU — debug stock layer.
  • Tier-2 warmer не догоняет — посмотреть priority queue health.
  • Multi-warehouse strategy (например ETM per-store).

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

  • Цены → ../pricing/.
  • Доставка → ../delivery/.
  • LLM-driven характеристики → ../charnorm/.

Связано

  • ../offers/ — stock observation pаrt из offer set.
  • ../ingestion/ — bulk_snapshot pipeline + stock-detail-warmer cmd.
  • ADR-0037 — stock pipeline design.
  • ADR-0059 — ETM Tier-1/Tier-2 batch-shape.