Formations — 1 037 leçons en français

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.

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.

Lire l'explication détaillée et faire le quiz →

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.