Passer au contenu principal
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 :
ChampSignification
nameNom d’affichage.
category / subcategoryClassification (ex. INVENTORY / STOCK).
rulesLe déclencheur basé sur les étiquettes — voir Règles & périmètre.
scopeLe périmètre (magasins / marques / produits / taxonomies / collections).
destinationNotifications — voir Notifications & actions.
isActiveSi 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étriqueMesure
CURRENT_STOCK_LEVELStock actuel.
GROSS_SALES_VALUE / GROSS_SALES_QUANTITYValeur de ventes / unités.
GROSS_SALES_VALUE_PREVIOUSVentes de la période précédente (pour la tendance).
FORECASTED_SALES_QUANTITYDemande prévue.
INVENTORY_TURN_OVER_RATETaux de rotation.
DAYS_OF_STOCKJours de couverture à la vélocité actuelle.
RISK_SCORERisque couche intelligence.
UNACTIONED_RECOMMENDATIONS_COUNTRecommandations ouvertes.
SALES_TREND_PERCENTPourcentage 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.