#Gestion des workflows

# Analyse du workflow : décrémenter le stock à la création de commande

## Vue d'ensemble du workflow
**Nom du workflow :** décrémenter le stock à la création de commande

### Déclencheur
- **Type :** Événement post-action (Action)
- **Condition de déclenchement :** déclenché lorsque la collection `orders` (commandes) exécute l'action «créer» (déclenchement global).
- **Données associées :** transporte les données associées `details` (détails de commande) lors du déclenchement.
- **Mode d'exécution :** asynchrone

---

### Chaîne d'exécution des nœuds

**[Déclencheur] Création de commande**
        │
        ▼
**[1] Boucler les détails de commande (Loop)**
    * **Cible :** `{{$context.data.details}}`
    * *Action : exécuter les étapes suivantes pour chaque détail :*
        │
        ▼
    **branchIndex=0 (corps de boucle)**
        │
        ▼
    **[2] Interroger le stock du produit (Query)**
    * **Collection :** `products`
    * **Condition de filtrage :** `id = {{$scopes.5u6lsjzf8vh.item.productId}}`
        │
        ▼
    **[3] Vérifier si le stock est suffisant (Condition)**
    * **Moteur :** `formula.js`
    * **Expression :** `{{$jobsMapByNodeKey.n6rf8lf2lum.inventory}} < {{$scopes.5u6lsjzf8vh.item.quantity}}`
        │
        ├── **YES (branchIndex=1, stock insuffisant, condition VRAIE) :**
        │   ▼
        │   **[4] Notifier le super administrateur (Notification)**
        │   *envoyer une notification aux utilisateurs du rôle root, contenant :*
        │   *nom du produit, ID du produit, stock actuel, quantité requise par la commande.*
        │
        └── **NO (branchIndex=0, stock suffisant, branche vide)**
        │
        ▼
    **[5] Décrémenter le stock (SQL)**
    * **Instruction SQL :** `UPDATE products SET inventory = inventory - :quantity`

---

### Logique clé

| Étape | Description |
| :--- | :--- |
| **Déclenchement** | À la création de la commande, le système entre dans le workflow avec la liste complète des détails de commande. |
| **Boucle** | Chaque ligne de détail est traitée individuellement, chaque ligne correspondant à un produit et sa quantité achetée. |
| **Requête** | Récupération du stock actuel du produit via `productId`. |
| **Décision** | Vérification que `inventory < quantity` est vrai (c'est-à-dire stock insuffisant). |
| **Notification** | En cas de stock insuffisant, envoi d'un message interne aux utilisateurs ayant le rôle `root`. |
| **Décrémentation** | Mise à jour directe du stock via SQL ; en raison de la convergence des branches, la décrémentation est exécutée que le stock soit suffisant ou non. |

---

### ⚠️ Problème potentiel de conception

Le `downstreamId` du nœud de condition pointe vers le nœud «Décrémenter le stock», ce qui signifie que quelle que soit la branche empruntée (stock suffisant ou insuffisant), l'exécution converge finalement vers la décrémentation. Le comportement réel est le suivant :

- **Stock suffisant** $\rightarrow$ décrémentation directe (flux normal). ✓
- **Stock insuffisant** $\rightarrow$ notification de l'administrateur d'abord, **suivie quand même de la décrémentation** (le stock peut devenir négatif).

**Analyse :** cette conception relève du modèle «autoriser la survente avec alerte préventive», ou peut-être d'un oubli logique (l'intention initiale étant probablement de bloquer la décrémentation en cas de stock insuffisant). Il faut confirmer l'intention de conception avec la partie métier.

---

### État actuel

- **État d'activation :** `false` (désactivé)
- **Historique d'exécution :** déjà exécuté 1 fois.
- **Contrôle de version :** la version actuelle est gelée, toute modification nécessite la création d'une nouvelle version.