# Spécification du workflow — alertes de stock

**Statut : modèle documentaire.** L’exemple et toutes les valeurs ci-dessous sont fictifs. Ce document ne signifie pas qu’un workflow a été créé ou lancé. Aucune connexion à un système de stock ou de notification n’est active et aucun message n’a été envoyé.

## But

Repérer, pour chaque article et chaque lieu de stockage, une quantité disponible inférieure ou égale au seuil minimum configuré, puis préparer une alerte vérifiable pour la personne responsable.

## Déclencheur

Le contrôle peut commencer après une **modification de stock** ou lors d’une **vérification périodique**. La source des événements ou des relevés et la fréquence de vérification sont **à définir**. Aucun déclencheur n’est actuellement connecté.

## Entrées attendues

- Article et SKU
- Lieu de stockage
- Stock physique
- Quantité réservée
- Quantité disponible, calculée par le workflow
- Seuil minimum configuré pour cet article et ce lieu
- Horodatage de la source, nécessaire pour contrôler l’actualité des données

## Règle de calcul et décision

**Quantité disponible = stock physique − quantité réservée**

Si la quantité disponible est **inférieure ou égale** au seuil minimum, une alerte est préparée. Si elle est supérieure au seuil, aucune nouvelle alerte n’est préparée. La gestion des alertes déjà ouvertes suit une règle de déduplication **à définir**.

## Étapes prévues

1. **Reprendre le déclencheur et identifier le stock** — associer le changement de stock ou le passage périodique à l’article, au SKU et au lieu concernés.
2. **Vérifier la complétude et l’actualité** — contrôler les champs requis et l’horodatage. L’âge maximal admis est **à définir**; les données manquantes ou trop anciennes sont signalées pour vérification.
3. **Calculer la quantité disponible** — soustraire la quantité réservée du stock physique. Une quantité manquante ou non numérique empêche le calcul.
4. **Appliquer le seuil configuré** — comparer la quantité disponible au seuil de l’article dans ce lieu; préparer l’alerte si disponible ≤ seuil.
5. **Rechercher une alerte ouverte** — appliquer la règle de déduplication **à définir** afin d’éviter une nouvelle alerte identique.
6. **Préparer une alerte vérifiable** — rassembler l’article/SKU, le lieu, les quantités, le seuil, l’heure du contrôle et l’état de notification. La transmission reste **à configurer**.

## Exemple fictif et simulé

- Article : **Kit de joint EX-042** (fictif)
- SKU : **AZ-EX-042** (fictif)
- Lieu : **Démo Nord** (fictif)
- Stock physique : **12** unités (fictif)
- Quantité réservée : **9** unités (fictive)
- Quantité disponible : **3** unités (calcul fictif : 12 − 9)
- Seuil minimum : **5** unités (fictif)
- Décision : **seuil atteint; alerte préparée dans la simulation**, car 3 ≤ 5
- Durée totale : **2,8 s simulées**, sans mesure d’un système réel

## Décisions encore à prendre

Choisir la source des stocks, la règle d’actualité, le type de déclencheur et sa fréquence, le seuil par article et lieu, la personne responsable, le canal de notification, la règle de déduplication, les tentatives de répétition et l’escalade.