Le parcours de retrait confirme la commande, mais le magasin ne reçoit pas la demande de préparation. Le site annonce une commande confirmée alors que le support ignore si le stock a été réservé. Pour reprendre le dossier, l’équipe doit retrouver ce que chaque application a réellement reçu.
Un événement diffuse un fait déjà établi et laisse chaque destinataire traiter sa propre réaction. En réalité, le parcours peut encore avoir besoin d’une demande adressée à un système et d’une réponse avant d’engager le client. Le contrat précise quels effets peuvent attendre et qui traite les échecs.
Un middleware sur mesure peut relayer ce fait entre le portail, le stock et le magasin. Choisissez le premier échange en comparant transaction locale, commande adressée et événement, puis vérifiez ce qui se passe lorsque l’un des destinataires s’arrête.
Reconnaître un besoin métier réellement événementiel
Le premier cas utile apparaît lorsqu’un même fait déclenche plusieurs réactions indépendantes. Après l’expédition d’une commande, la facturation, le suivi client, la comptabilité analytique et le calcul d’une prime peuvent avancer séparément. L’équipe qui expédie n’a pas à connaître chaque consommateur ni à attendre leur disponibilité pour terminer son action.
Le deuxième cas concerne des rythmes incompatibles. Un dossier doit être accepté en moins d’une seconde, mais son enrichissement externe prend plusieurs minutes. Publier le fait « dossier accepté » permet d’afficher un résultat honnête immédiatement, puis de suivre l’enrichissement avec un statut distinct plutôt que de prolonger artificiellement la requête.
Le troisième cas est la conservation d’une trace de faits utiles : contrat signé, colis remis, droit révoqué. Cette trace peut alimenter un audit ou reconstruire une projection, à condition que l’événement exprime ce qui s’est produit et non la structure interne d’une table. Tous les changements techniques ne méritent pas de devenir des événements publics.
En revanche, deux modules déployés ensemble, possédés par la même équipe et écrivant dans la même base, bénéficient souvent davantage d’une transaction locale. Les séparer par un bus ajoute latence, doublons et supervision sans donner d’autonomie réelle. Le découplage organisationnel doit précéder ou accompagner le découplage technique.
Distinguer un fait publié d’une commande adressée
Un événement décrit un fait passé : « paiement autorisé », « dossier clôturé », « expédition annulée ». Son producteur ne décide pas quelles réactions auront lieu. Les consommateurs choisissent de s’abonner et restent responsables de leur propre résultat. Le nom au passé rappelle que le fait ne peut plus être retiré parce qu’un destinataire le refuse.
Une commande demande une action à un destinataire connu : « réserver le stock », « émettre la facture », « recalculer l’échéancier ». Elle peut être acceptée ou refusée et possède souvent une échéance. La cacher sous un nom d’événement entretient une fausse autonomie : si le processus dépend de cette action, quelqu’un doit suivre son verdict.
Cette distinction influence le support. Pour un événement, l’équipe vérifie quels consommateurs l’ont reçu et ce qu’ils ont décidé. Pour une commande, elle cherche le responsable, la réponse et le délai promis. Mélanger les deux conduit à des messages sans propriétaire qui attendent pourtant une réponse indispensable.
Décision pratique. Utilisez un événement lorsqu’une capacité annonce son propre changement d’état. Utilisez une commande lorsque le produit attend une action précise. Gardez un appel synchrone lorsque l’utilisateur ne peut recevoir de réponse honnête sans le résultat immédiat et que la dépendance respecte un budget de latence compatible.
Définir un événement stable et compréhensible
Le contrat commence par un nom non ambigu, la date du fait, l’identifiant métier, la version du schéma et un identifiant unique de message. Il contient les informations nécessaires à la réaction prévue, mais n’expose pas automatiquement toutes les colonnes de l’agrégat. Une charge trop large fige le modèle interne et diffuse des données sensibles.
Le producteur garantit la signification du fait, pas l’usage de chaque consommateur. « Client mis à jour » est trop vague si certains veulent savoir si l’adresse de facturation a changé. À l’inverse, publier un événement pour chaque champ couple le monde au formulaire. Des faits comme « adresse de facturation remplacée » ou « consentement retiré » portent une conséquence métier identifiable.
Un catalogue précise pour chaque événement le producteur, la source de vérité, le schéma, la politique de conservation et le canal d’assistance. Il contient aussi un exemple valide et les garanties de livraison. Cette documentation doit être versionnée près du code et vérifiée automatiquement, sans devenir un portail séparé qui vieillit.
Les données personnelles demandent une attention particulière. Le message peut transporter un identifiant et laisser le consommateur relire une donnée autorisée, mais ce choix réintroduit une dépendance de disponibilité. S’il contient la donnée, chiffrement, durée de rétention et droits d’accès doivent suivre toutes les copies. Le compromis dépend du besoin de reprise et du niveau de sensibilité.
Accepter la cohérence différée sans perdre le contrôle
La cohérence différée n’est acceptable que si le produit sait nommer l’état intermédiaire. « Commande confirmée, facturation en cours » est compréhensible ; afficher « terminée » alors que deux réactions peuvent encore échouer crée une promesse fausse. Les interfaces et les équipes support doivent partager le même vocabulaire.
Chaque décalage possède un budget. Une projection de recherche peut tolérer cinq minutes, un retrait de droit critique beaucoup moins. Une équipe peut alerter lorsqu’un événement de révocation n’est pas appliqué sous soixante secondes, mais accepter six heures pour une statistique de pilotage. Ces seuils sont locaux, validés selon le risque et le volume.
La réconciliation compare périodiquement deux sources indépendantes et produit une file d’écarts qualifiés. Elle n’est pas un aveu d’échec ; elle reconnaît qu’un système distribué peut perdre temporairement une réaction. En revanche, une réconciliation sans responsable ni action masque les défauts et crée une dette permanente.
Contre-intuitivement, ajouter un flux synchrone ciblé peut renforcer une architecture événementielle. Si l’autorisation d’une opération doit être connue avant d’engager le client, la demander immédiatement reste honnête. L’événement annonce ensuite la décision aux réactions autonomes. Tout rendre asynchrone n’est pas un objectif métier.
Suivre une commande omnicanale de bout en bout
Cas concret : retrait en magasin après achat en ligne
Une cliente demande le paiement en ligne et choisit un retrait en boutique. Le service vérifie le panier puis enregistre, dans une transaction locale, « autorisation de paiement en cours » et une commande de paiement idempotente dans sa boîte d’envoi. À la réponse du prestataire, le processus enregistre « commande confirmée » et l’événement correspondant dans une nouvelle transaction locale. Il ne marque pas encore la commande « prête ».
Le stock consomme le fait, crée une réservation idempotente et publie « stock réservé » ou « réservation refusée ». Un processus suit cette réponse, demande la préparation au magasin et fixe une échéance de deux heures. Le magasin confirme ensuite que le colis est prêt ; le canal client peut alors envoyer une notification cohérente.
Lors d’une double livraison du message, le stock applique une seule fois l’opération « réserver » pour la même commande et sa version. Une nouvelle demande de réservation peut ainsi garder son identité propre. Si le magasin ne répond pas, le processus escalade vers le responsable local et affiche « préparation retardée ». Après le seuil décidé, il propose un autre magasin ou déclenche le remboursement selon le choix produit.
Chaque équipe possède son résultat : commerce pour la commande, logistique pour la réservation, boutique pour la préparation et relation client pour l’information. Le processus transverse possède les échéances et les compensations. Cette répartition évite qu’un consommateur isolé modifie silencieusement le statut global.
Traiter doublons, ordre et livraison incomplète
Dans un mode de livraison au moins une fois, fréquent sur les plateformes de messages, un événement peut être présenté de nouveau au consommateur. Celui-ci doit donc mémoriser les messages appliqués ou concevoir une opération naturellement idempotente. La vérification et l’écriture doivent partager une transaction ou une contrainte persistante ; un simple « existe-t-il déjà ? » avant écriture reste vulnérable à la concurrence.
L’ordre global est rarement garanti et rarement nécessaire. Il faut plutôt garantir l’ordre par entité ou refuser une version antérieure. Le message porte alors la version de l’agrégat, et le consommateur met à part une rupture de séquence pour attendre l’élément manquant ou relire un état de référence.
Une file d’échec ne constitue pas une stratégie de reprise. Elle conserve le message et sa cause, puis une procédure décrit qui corrige la donnée, quand relancer et comment vérifier l’absence de double effet. Les opérations dangereuses ne sont jamais relancées en boucle sans limite ; elles changent d’état et demandent un arbitrage.
Pour chaque flux critique, testez un doublon, un message retardé, une inversion, une indisponibilité du consommateur et un redémarrage pendant l’écriture. L’acceptation dépend du résultat métier final et de la trace disponible. Une démonstration nominale avec un tableau de bord vert ne prouve aucune capacité de reprise.
Faire évoluer les schémas sans bloquer les équipes
Une évolution additive reste la plus sûre : ajouter un champ optionnel, déployer les consommateurs capables de le lire, puis le rendre nécessaire dans une version suivante si le métier le justifie. Renommer ou changer le sens d’un champ doit créer un nouveau contrat explicite plutôt qu’une modification silencieuse.
Le producteur vérifie la compatibilité de son schéma dans l’intégration continue. Les consommateurs critiques publient des exemples ou des tests de contrat qui révèlent les hypothèses importantes. Ces tests ne doivent pas donner à chaque consommateur un droit de veto éternel ; une durée de migration et une politique de fin de support sont annoncées.
Lorsqu’une nouvelle version coexiste, le producteur peut publier deux formats pendant une fenêtre bornée ou fournir un adaptateur. La date de retrait, la volumétrie restante et les équipes concernées sont visibles. Une compatibilité maintenue sans limite devient un impôt invisible payé sur chaque changement.
Le contrat inclut aussi la sémantique des absences, des montants, des fuseaux horaires et des identifiants. Un champ techniquement compatible peut changer de sens et produire une erreur plus grave qu’un message rejeté. La revue associe donc une personne métier au responsable technique du producteur.
Rendre les chaînes d’événements exploitables
L’identifiant de corrélation suit l’intention initiale, tandis que chaque message garde son identifiant propre et celui de sa cause. Cette filiation permet de reconstruire une chronologie sans supposer que toutes les réactions utilisent la même trace technique. Les journaux indiquent l’événement, la version, le consommateur, l’issue et la durée.
Les métriques essentielles sont l’âge du plus ancien message, le débit, le retard par groupe de consommateurs, le taux d’échec, les doublons absorbés et les réconciliations ouvertes. Le volume seul peut rester normal alors qu’un seul client critique attend depuis deux jours. Les alertes doivent combiner durée, criticité et action attendue.
Un écran de support cherche par identifiant métier et affiche les faits dans l’ordre observé, les réactions, les refus et les prochaines échéances. Il autorise uniquement des actions sûres : relancer un consommateur idempotent, corriger une donnée avec motif ou déclencher une compensation prévue. Toute intervention laisse une trace.
La fiche d’exploitation relie les entrées, les sorties, les dépendances, les seuils et la journalisation de chaque flux. Une seconde fiche attribue les responsabilités, l’instrumentation et le rollback au producteur, au consommateur et à l’équipe de plateforme. Ces deux preuves sont testées avec les mêmes droits qu’en production.
Attribuer chaque décision à la bonne équipe
Le producteur possède le sens, la disponibilité et la qualité de l’événement. Un consommateur possède sa réaction et ne demande pas au producteur d’ajouter des données étrangères au fait uniquement pour éviter de maintenir son propre modèle. La plateforme possède le transport, pas la réussite métier de toutes les chaînes.
Un processus transverse a besoin d’une responsabilité produit clairement désignée. Cette personne décide des états visibles, des délais et des compensations. Sans elle, chaque équipe optimise son étape et le client reste bloqué entre plusieurs succès techniques. Le comité d’architecture ne remplace pas cette décision fonctionnelle.
Une revue mensuelle examine les flux au-delà de leur seuil, les versions à retirer, les réconciliations récurrentes et le coût complet de la plateforme. Elle ne discute pas chaque message. Les équipes corrigent d’abord les événements sans propriétaire et les compensations manuelles qui touchent argent, droit ou engagement client.
Pour qui cette architecture apporte un gain net
Cette approche convient aux produits où plusieurs équipes autonomes réagissent à des faits stables, où les volumes imposent un découplage temporel ou lorsque certaines étapes peuvent attendre sans tromper l’utilisateur. Elle est particulièrement utile aux parcours omnicanaux, logistiques et documentaires.
Elle est disproportionnée pour une application administrée par une seule équipe, avec une base commune et des opérations locales. Un monolithe modulaire peut publier des événements internes sans déployer de courtier ni accepter une cohérence différée. Il conserve ainsi les frontières conceptuelles et une exploitation plus simple.
La décision associe responsable produit, responsables des domaines, sécurité, exploitation et support. L’équipe doit pouvoir financer contrats, supervision, reprise et accompagnement des consommateurs. Si le budget ne couvre que la mise en place du bus, le chantier est incomplet.
Erreurs fréquentes qui dispersent la responsabilité
Publier une copie de table au lieu d’un fait
Un message « entity_updated » transporte le modèle technique et force tous les destinataires à déduire la décision. Nommez le fait métier, réduisez sa charge et conservez l’état complet derrière une API ou un instantané prévu pour cet usage.
Croire à l’exécution exactement une fois
Le transport peut fournir des garanties exactement une fois dans un périmètre défini, mais un crash entre un effet externe et l’acquittement conserve une zone d’incertitude si les deux systèmes ne coordonnent pas leur état. Concevez l’idempotence, utilisez des clés métier et rendez visible l’état inconnu au lieu d’étendre abusivement la garantie du courtier à toute la chaîne.
Laisser les consommateurs écrire le statut du producteur
Chaque réaction qui modifie directement la commande centrale détruit la responsabilité du domaine. Le consommateur publie son propre fait ou répond à une commande ; le processus responsable calcule ensuite le statut transverse selon des règles explicites.
Choisir l’outil avant le scénario de reprise
Le débit maximal et le nombre de connecteurs ne disent rien du traitement d’un message empoisonné. Décrivez d’abord les faits, budgets de retard, doublons et compensations. La technologie se choisit ensuite selon ces contraintes et les compétences d’exploitation disponibles.
Arbitrer entre transaction, message et événement
Bloc de décision. Gardez une transaction locale lorsque les invariants doivent être vrais immédiatement dans une même source. Adressez une commande lorsqu’une action distante possède un destinataire et un verdict attendus. Publiez un événement lorsqu’un fait stable peut susciter plusieurs réactions autonomes.
Différez l’événementiel si les équipes ne savent pas encore nommer la source de vérité, les états intermédiaires et la responsabilité de reprise. Instrumentez le flux actuel et observez dix incidents ou dossiers dégradés. Une architecture distribuée appliquée à une décision floue augmente seulement la distance du diagnostic.
Refusez l’extension si les consommateurs ne sont pas idempotents, si aucun budget de cohérence n’est accepté ou si la suppression d’un champ bloque des équipes inconnues. Ces conditions signalent que le contrat et la gouvernance ne sont pas prêts, même lorsque le transport fonctionne parfaitement.
Comparez enfin le coût complet : développement, plateforme, astreinte, réconciliation, évolution des schémas et support. Le gain attendu doit provenir d’une autonomie ou d’une résilience observable, pas d’un alignement avec une tendance technique.
- D’abord, conserver la transaction pour les invariants locaux qui exigent une réponse immédiate.
- Ensuite, adresser une commande lorsque le produit attend le verdict d’un responsable identifié.
- Puis, publier un événement seulement quand les réactions peuvent évoluer et échouer indépendamment.
- Enfin, refuser la distribution si aucun budget de cohérence ni procédure de reprise ne sont assumés.
Plan d’action pour un premier flux maîtrisé
Semaines un et deux : fermer le contrat métier
Choisissez un fait à forte valeur mais à effet réversible, puis réunissez producteur, deux consommateurs et support. Décrivez le déclencheur, l’identifiant, le schéma, les états visibles et le budget de cohérence. Écartez les champs qui ne participent à aucune réaction légitime.
Écrivez deux scénarios : le chemin attendu et une réaction manquante. Pour chacun, précisez les entrées, les sorties, les dépendances, la responsabilité et le seuil d’alerte. Le produit décide ce que voit l’utilisateur pendant l’attente et quelle compensation reste acceptable.
Semaines trois et quatre : éprouver la livraison et la reprise
Implémentez une boîte d’envoi, une clé d’idempotence et une corrélation. Déployez un consommateur en observation avant de lui confier un effet. Comparez ses résultats à la source pendant une semaine ou un cycle métier représentatif, puis expliquez chaque écart.
Coupez ensuite le consommateur, livrez un doublon et inversez deux versions dans un environnement proche de la production. L’exploitation suit l’instrumentation, utilise la file d’échec et exécute le rollback documenté. Le test est accepté lorsque le fait reste opposable et que la reprise ne produit aucun double effet.
Décision de poursuite. Étendez le flux si la latence respecte le budget, si les écarts sont qualifiés et si le support retrouve un dossier sans aide. Différez si le schéma change encore chaque semaine. Revenez à une intégration plus directe si l’autonomie gagnée ne compense pas la charge durable de supervision.
Guides complémentaires sur les workflows et le run
Le pilier sur la coordination des flux entre logiciels situe la progression de la commande et les points de reprise. Le guide orchestration et chorégraphie aide à attribuer le verdict global. Les conseils Symfony sur les gestionnaires idempotents détaillent ce que doit supporter un traitement relivré.
Tester les exceptions avant la montée en charge
Le guide sur les tests de workflows métier et de leurs exceptions aide à organiser les scénarios de retard, de concurrence et de compensation autour d’une preuve métier.
Relier les métriques à une action opérationnelle
La méthode d’observabilité des workflows métier prolonge la chaîne de corrélation, les seuils et les gestes de support nécessaires pour exploiter des réactions asynchrones.
Ces pratiques restent utiles dans un monolithe modulaire. Publier un fait interne, rendre un traitement idempotent et suivre un état intermédiaire ne nécessite pas forcément une infrastructure distribuée.
Conclusion : publier moins de faits, mais mieux les posséder
Publiez un fait dont le sens et le producteur sont connus. Pour chaque consommateur, fixez le délai, la condition de rejet et le moyen de retrouver l’effet déjà confirmé.
Testez le traitement avec un message retardé, répété ou reçu dans le désordre. Le support doit retrouver la commande et vérifier son état avant de décider d’une relance.
Dawap peut vous aider à cadrer le middleware de vos échanges en éprouvant les contrats, les délais et le circuit de reprise avec les équipes qui les exploiteront.