Domain events

Un domain event enregistre un fait qui compte pour le métier. Ces règles disent comment le modéliser : né dans le modèle, nommé dans le langage, immuable, et porteur de ce dont ses subscribers ont besoin.

La façon dont un event est conservé, transmis et consommé relève de messaging, et son contrat publié de contracts.

En pratique

Ce qui est arrivé à un wallet, nommé au passé :

export interface WalletOpened extends DomainEvent {
	readonly type: 'wallets.wallet.WalletOpened';
	readonly walletId: WalletId;
	readonly holderId: HolderId;
	readonly currency: Currency;
}

export interface MoneyDeposited extends DomainEvent {
	readonly type: 'wallets.wallet.MoneyDeposited';
	readonly walletId: WalletId;
	readonly amount: Money;
}

export interface MoneyWithdrawn extends DomainEvent {
	readonly type: 'wallets.wallet.MoneyWithdrawn';
	readonly walletId: WalletId;
	readonly holderId: HolderId;
	readonly amount: Money;
	readonly balance: Money;
}

• Des faits qui comptent pour le métier, nommés au passé (EVT-01, EVT-04).
• Nés dans le modèle : le wallet enregistre WalletOpened, et l’écriture que créent wallet.credit() et wallet.debit() enregistre MoneyDeposited et MoneyWithdrawn. Rien d’autre ne les enregistre (EVT-03).
• MoneyWithdrawn porte le titulaire et le solde après le retrait, pour qu’un subscriber agisse sans relire le wallet (EVT-05). Le wallet calcule ce solde au moment du débit : le solde qu’il vient de vérifier, moins le montant. Un débit concurrent échoue sur la version, donc ce solde est juste (AGG-15).
• Toutes les propriétés sont en lecture seule (EVT-06).

Règles

Modéliser l’event

Code	Règle	Sévérité	Détection
EVT-01	Un event capture un fait qui compte pour le métier	question
EVT-02	Un domain event n’est pas une notification technique	majeure
EVT-03	Les domain events naissent dans le modèle	majeure
EVT-04	Un event est nommé au passé, dans le langage du métier	mineure
EVT-05	Un event porte de quoi agir sans relire sa source	majeure
EVT-06	Un event est immuable	majeure	fitness

Les subscribers du bounded context

Code	Règle	Sévérité	Détection
EVT-07	Un subscriber synchrone ne modifie pas un autre aggregate	majeure