Accueil › Architecture & design patterns › L'événement de domaine, et ce qu'il n'est pas
L'événement de domaine, et ce qu'il n'est pas
Événements, CQRS et cohérenceavance
Un événement de domaine est un fait métier qui vient de se produire. Il se nomme au passé, avec le vocabulaire du métier, et il ne se discute pas : quand il est émis, la décision est déjà prise.
// ❌ une commande déguisée en événement
publier({ type: "EnvoyerMailConfirmation", client: "c-18" });
// ✅ un fait, sans instruction sur la suite
publier({
type: "CommandeValidee",
commandeId: "cmd-412",
clientId: "c-18",
total: 89.9,
survenuLe: "2024-03-11T09:21:04Z",
});
La différence n'est pas cosmétique. Dans le premier cas, le producteur décide ce que les autres doivent faire : il connaît le service de courriel, donc il en dépend. Dans le second, il constate. Qui envoie un courriel, qui met à jour une statistique, qui ne fait rien — ce n'est plus son problème.
Reste une distinction que beaucoup de candidats manquent en entretien : tout événement n'est pas destiné à sortir du service.
- Un événement de domaine est interne. Il relie deux agrégats, ou deux modules, à l'intérieur d'une même application. On le change quand on veut.
- Un message d'intégration est publié vers d'autres services. C'est un contrat public. Dès qu'un consommateur s'y branche, le renommage d'un champ devient une rupture.
Confondre les deux revient à publier son modèle interne. La table devient une API que personne n'a conçue, et plus aucune refonte n'est possible sans coordination.
Les termes à connaître
- Événement de domaine
Un fait métier qui vient de se produire, nommé au passé, interne à un service. Il décrit ce qui s'est passé, pas ce qu'il faut faire ensuite.
- Message d'intégration
Un message publié vers d'autres services. C'est un contrat public : une fois des consommateurs branchés dessus, on ne le change plus librement.
- Commande
Une demande d'action, nommée à l'impératif, adressée à un destinataire précis, et qui peut être refusée. L'événement, lui, est déjà vrai.
- Nommage au passé
CommandeValidee,PaiementRefuse: le temps du verbe dit qu'il n'y a plus de décision à prendre sur le fait lui-même.- Producteur
Le module qui constate le fait et l'émet. Il ne connaît pas ses consommateurs, et ne doit rien attendre d'eux.
- Couplage par le modèle interne
Le défaut de publier son entité telle quelle : les consommateurs se lient à sa forme, et le producteur ne peut plus la refactoriser.
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.