AGENTS.md — taxonomy

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

Сервисная граница taxonomy — иерархическая классификация (категории + ETIM-mapping + canonical category assignment). Two namespace: supplier_native (supplier-specific дерево) + canonical (federated tree, человекочитаемая в админке).

Содержание

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

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

  • CategoryRef(namespace, external_id) identity reference в supplier-native space.
  • Canonical category — tree-level entity, mapped через CategoryExternalLink.
  • ETIM-7 bootstrap — federated taxonomy seed для canonical namespace.
  • LLM classifier — batched assignment supplier-native category → canonical bucket.
  • Manual-guard — admin-side override blocks автоматическое присваивание.

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

  • Canonical category дерево показывает странную иерархию.
  • Новый supplier добавлен, taxonomy needs federation.
  • ETIM classifier результат → нужен manual review pipeline.

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

  • Сами canonical product entries → ../catalog-core/.
  • Per-product characteristics → ../catalog-core/canonical-assignments/.

Связано

  • ../catalog-core/ — taxonomy classifies canonical products.
  • ADR-0055 — taxonomy namespace + external link model.