1. Le Déclencheur Initial (L'Action Humaine)
Tout commence uniquement quand le gérant ouvre une réservation (qui est en statut attente) et coche la case envoyer_contrat, puis clique sur Enregistrer.
Si la case n'est PAS cochée : Rien ne se passe. Le module reste inactif.
Si la case est cochée : Le hook hook_webform_submission_update se déclenche.
2. La Chaîne d'Événements (Une fois la case cochée)
Voici ce qui se passe automatiquement dans l'ordre :
📧 Envoi Email 1 (Immédiat)
Le module détecte la case cochée.
Il génère le Lien de Paiement Stripe.
Il génère le PDF du Contrat (via Entity Print).
Il envoie l'email au voyageur avec le lien et la pièce jointe.
Il coche une case interne stripe_payment_link_sent pour ne pas renvoyer un deuxième email si le gérant modifie autre chose plus tard.
💳 Paiement du Voyageur (Action Externe)
Le voyageur reçoit l'email, clique sur le lien et paie sur Stripe.
Stripe valide le paiement.
🔔 Le Webhook (Action Automatique Stripe)
Stripe envoie un signal invisible (POST) à votre site (/webhook/stripe-auto ou /webhook/stripe-manual).
C'est ce signal qui déclenche la suite, sans intervention du gérant.
⚙️ Traitement Webhook (Selon le module activé)
Module AUTO : Le webhook coche acompte_recu ET contrat_recu ➔ Déclenche l'email de confirmation finale.
Module MANUAL : Le webhook coche acompte_recu (laisse contrat_recu vide) ➔ Déclenche l'email "Paiement reçu" (ou attend que le gérant coche contrat_recu manuellement plus tard).
📝 Résumé pour le Gérant
Son seul travail : Cocher envoyer_contrat et sauvegarder.
Ce que fait le système : Envoie le lien, attend le paiement, reçoit la confirmation de Stripe, met à jour les cases (acompte/contrat), et envoie les emails de suivi.
C'est bien cela : une seule action humaine (cocher la case) lance tout le processus automatisé.