storefront → management
Зачем нужно
Management получает метрики витрины: лиды, конверсии, источники, посещаемость публичных страниц.
Стороны
- источник: storefront
- потребитель: management
- вид: event-driven + sync snapshot
События
| messageType | Когда |
|---|---|
storefront.lead.submitted | (то же, что в storefront--crm.md) |
storefront.page.published | публикация страницы |
storefront.review.published | опубликован отзыв |
storefront.metric_snapshot.published | периодический снапшот метрик трафика |
Online read
GET /api/v2/storefront/aggregates/leads?period=...
GET /api/v2/storefront/aggregates/landing-views?period=...
Поведение management
- маркетинговый funnel в dashboards;
- метрики SEO и trafic;
- алерты по падению конверсии.
Идемпотентность
- события дедуплицируются по
messageId; - lead metrics используют stable
leadId; - periodic snapshots заменяются по ключу
metricKey + period.
Ошибки
| Сценарий | Поведение |
|---|---|
| snapshot пришёл с неполным периодом | пометить как partial и не использовать в KPI |
| storefront API недоступен | dashboard показывает последний успешный snapshot |
| неизвестный source/utm | сохранить как unknown, не падать |
Scopes
| Scope | Для чего |
|---|---|
service:storefront.aggregates.read | читать marketing aggregates |
service:storefront.metrics.read | читать traffic snapshots |
Безопасность
- payload не содержит исходных персональных данных лида (только агрегаты).
Retention
- 30 дней события;
- агрегаты — постоянно.