Accueil › Architecture & design patterns › La boîte d'envoi, pour ne pas perdre un événement
La boîte d'envoi, pour ne pas perdre un événement
Événements, CQRS et cohérenceavance
Enregistrer une commande et publier CommandeValidee sont deux écritures
dans deux systèmes. Aucune transaction locale ne les couvre ensemble.
// ❌ double écriture : la fenêtre entre les deux lignes est un trou
depot.enregistrer(commande); // validé en base
courtier.publier(evenement); // le processus tombe ici → message perdu
Inverser l'ordre ne résout rien : on publie alors un fait dont l'enregistrement échouera. Les deux ordres ont un mode de panne, et il est silencieux.
La boîte d'envoi ramène la publication dans la transaction de la base.
// ✅ une seule transaction, deux lignes, le même destin
transaction(() => {
depot.enregistrer(commande);
boiteEnvoi.inserer({ id: evenement.id, charge: evenement, publieLe: null });
});
// Un relais, séparé, dépile ensuite.
function relais() {
for (const ligne of boiteEnvoi.nonPubliees()) {
courtier.publier(ligne.charge);
boiteEnvoi.marquerPublie(ligne.id);
}
}
Si la transaction est annulée, la ligne de boîte d'envoi disparaît avec la commande. Si le relais tombe après l'envoi mais avant le marquage, le message repart au redémarrage. On a donc échangé la perte possible contre le doublon certain à l'occasion — et c'est un bon échange, parce que le doublon se traite et la perte ne se rattrape pas.
La contrepartie est obligatoire : le consommateur doit être idempotent.
Les termes à connaître
- Boîte d'envoi
Une table écrite dans la même transaction que l'état métier, où l'on dépose le message à publier. Un relais la dépile ensuite.
- Double écriture
Écrire la base puis publier le message : deux opérations qu'aucune transaction ne couvre ensemble. Entre les deux, tout peut tomber.
- Relais
Le processus qui lit les lignes non publiées de la boîte d'envoi, les envoie au courtier, puis les marque publiées.
- Livraison au moins une fois
La garantie offerte par le relais : un message validé finira par partir, éventuellement plusieurs fois.
- Clé d'idempotence
L'identifiant que le consommateur mémorise pour reconnaître un message déjà traité. C'est ce qui rend le doublon inoffensif.
- Boîte de réception
La table symétrique côté consommateur : les identifiants déjà traités, écrits dans la même transaction que l'effet du message.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.