Сценарии
NOTE
Статус: Target design. Документ описывает целевую доменную модель. Соответствующий код реализован частично (см.
backend/internal/core/) или пока не начат. Правила маркировки — в50-processes/documentation-standard.md.
Здесь — end-to-end бизнес-процессы Tracium. Каждый сценарий описывает участников (BC), последовательность событий и команд, decision points, edge cases. Это не дублирование контекстов — сценарии связывают BC между собой, показывая «как живут» доменные события через несколько границ.
Точка входа — ../domain-model.md: big picture timeline и context map.
Список сценариев
Поток данных от поставщика
- Поступление данных от поставщика — от scheduled job до
OfferObservationRecorded. - Обновления и определение разницы — апдейты, diff, derived events, rematching.
- Синхронизация справочников поставщика — периодический импорт manufacturer / characteristic / classification / client SKU map через ACL маппинги.
Каталог и матчинг
- Сопоставление: новый offer → каноническое решение — путь signal’ов и confidence.
- Подбор аналогов — analog query, equivalence, ranking.
Клиент
- B2C — auth flows для двух типов клиентов.
- Подключение клиентской credential поставщика — от ввода ключа до использования в pricing.
Цена и смета
- Расчёт цены (с custom handlers) — observation select → rules → handlers → breakdown.
- Полный путь сметы (Acts 1-8) — флагманский пользовательский сценарий.
AI-операции
- AI-модерация (автоматическая обработка очереди) — pipeline AI-агента для всех кейсов, ранее требовавших оператора.
Шаблон сценария
Каждый файл сценария:
- Триггер — что инициирует.
- Участники — какие BC, в каких ролях.
- Sequence diagram — mermaid
sequenceDiagramилиflowchart. - Шаги — нумерованный список с событиями (🟧), командами (🟦), policies (🟪), решениями (🟪 + branch).
- Edge cases — что если фейл, race, stale, unauthorized.
- Инварианты сценария — что обязательно должно сохраниться через flow.
- Метрики и observability — какие метрики, alerts, dashboards.
- Связанные файлы — контексты, deep-dive, ADR.