Alertes — anatomie

Les alertes (Signaux) lèvent des instances quand les entités d’intérêt apparaissent, puis notifient et vous permettent d’agir. Cette référence documente le modèle complet. Pour le guide utilisateur, voir Signaux → Alertes.

Le modèle basé sur les étiquettes

C’est le concept clé : une alerte se déclenche sur des étiquettes, pas sur un seuil de métrique brute.

seuil de métrique  ──(règle de tagging)──►  étiquette sur les entités  ──(alerte surveille l'étiquette)──►  instance d'alerte

La logique métrique → seuil vit dans les règles de tagging (une condition de métrique étiquette les entités correspondantes).
Une alerte surveille alors les entités portant ces étiquettes, dans un périmètre et à un niveau de vérification, et notifie.

Donc « alerte-moi si jours de stock ≤ 7 » s’exprime comme : une règle de tagging qui étiquette les articles en manque de stock, plus une alerte qui surveille cette étiquette.

Définition d’alerte

Une ligne alerts a :

Champ	Signification
`name`	Nom d’affichage.
`category` / `subcategory`	Classification (ex. `INVENTORY` / `STOCK`).
`rules`	Le déclencheur basé sur les étiquettes — voir Règles & périmètre.
`scope`	Le périmètre (magasins / marques / produits / taxonomies / collections).
`destination`	Notifications — voir Notifications & actions.
`isActive`	Si l’alerte est évaluée.

{
  "name": "Low Stock Critical Products",
  "category": "INVENTORY",
  "subcategory": "STOCK",
  "rules": { "operator": "AND", "tagRules": [ { "tagId": "<uuid>", "mode": "INCLUDE" } ], "checkLevel": "PRODUCT" },
  "scope": { "storesIds": ["<uuid>"], "brandIds": ["<uuid>"] },
  "destination": { "frequency": "DAILY", "mediums": ["EMAIL"], "recipientIds": [] },
  "isActive": true
}

Le catalogue de métriques

Les métriques vivent dans un catalogue alert_metrics séparé (référencé par les conditions de métrique des règles de tagging). Chaque métrique est GLOBAL (partagée) ou scoped ORG, a un kind (precomputed_column, aggregation, time_windowed_aggregation, formula, composite), un corps de calcul body, un grain, et une sortie. Les métriques standard :

Métrique	Mesure
`CURRENT_STOCK_LEVEL`	Stock actuel.
`GROSS_SALES_VALUE` / `GROSS_SALES_QUANTITY`	Valeur de ventes / unités.
`GROSS_SALES_VALUE_PREVIOUS`	Ventes de la période précédente (pour la tendance).
`FORECASTED_SALES_QUANTITY`	Demande prévue.
`INVENTORY_TURN_OVER_RATE`	Taux de rotation.
`DAYS_OF_STOCK`	Jours de couverture à la vélocité actuelle.
`RISK_SCORE`	Risque couche intelligence.
`UNACTIONED_RECOMMENDATIONS_COUNT`	Recommandations ouvertes.
`SALES_TREND_PERCENT`	Pourcentage de tendance des ventes.

Les attributs du catalogue (scope, kind, body, grain) sont renseignés au niveau data-platform/seed — ils font partie de la définition stockée de la métrique, pas du formulaire de création côté application (qui ne définit que category, subcategory, metricName, description, selectors).

Ces métriques sont consommées par les conditions de métrique des règles de tagging, c’est là que l’opérateur (y compris les centiles) et le seuil sont définis. Les alertes surveillent ensuite les étiquettes résultantes.

Cycle de vie

Une alerte est soit active, soit non (isActive). Chaque évaluation produit des instances avec leur propre cycle de vie — voir Instances & exécutions.

Intégration API

Recettes API

Plateforme & modèle de données

Couche décision (référence)

Exploitation & infrastructure

Specs d'ingestion (référence)

Workflows (référence)

Règles de tagging (référence)

Alertes (référence)

Alertes — anatomie

Le modèle basé sur les étiquettes

Définition d’alerte

Le catalogue de métriques

Cycle de vie

​Le modèle basé sur les étiquettes

​Définition d’alerte

​Le catalogue de métriques

​Cycle de vie

Le modèle basé sur les étiquettes

Définition d’alerte

Le catalogue de métriques

Cycle de vie