Améliorer vos APIs grâce à l’event sourcing et au domain modeling

Vous héritez d’un vieux projet. La doc n’existe plus ou ne correspond plus à rien. La logique métier est dispersée un peu partout, les règles sont cachées dans des migrations SQL, et personne ne sait vraiment ce que le système fait.

Il existe une autre approche : l’event sourcing.

Pourquoi l’event sourcing change la donne

Au lieu de garder uniquement l’état actuel de vos données, vous enregistrez chaque modification sous forme d’événement immuable. Chaque action laisse une trace.

Pour les APIs et les microservices, ça change beaucoup de choses :

• Vous avez un historique complet, sans effort supplémentaire
• Vous pouvez retracer précisément comment le système est arrivé à son état actuel
• Vous séparez les écritures des lectures, ce qui facilite la scalabilité
• Vous êtes forcé de comprendre vraiment ce qui se passe dans votre métier

Ça paraît simple en théorie, mais l’event sourcing peut vite sembler abstrait.

Le modeling de domaine, étape trop souvent négligée

Avant d’écrire du code, il faut d’abord cartographier le domaine :

• Quelles commandes déclenchent des changements ?
• Quels événements sont émis ?
• Comment les différentes parties du système dialoguent-elles ?
• Quelles règles doivent toujours être respectées ?

C’est ce travail de modélisation qui fait la différence entre un système qui grandit bien et un système qui devient ingérable.

Un langage commun pour décrire l’architecture

Au lieu de laisser la logique métier éparpillée dans des fichiers ou des discussions informelles, on peut la décrire dans un format structuré. Ce format permet de définir :

• Les aggregates : les entités qui portent les règles métier
• Les events : ce qui s’est réellement produit
• Les commands : les actions qui déclenchent des changements
• Les read models : les vues optimisées pour les requêtes
• Les process managers : la logique qui coordonne plusieurs aggregates
• Les context mappings : les relations entre les contextes

Ce document devient une vraie référence, versionnable et compréhensible par toute l’équipe.