Aller au contenu

Le journal des mutations

Facet garde l’historique dans une simple table de base de données. Chaque écriture acceptée ajoute exactement une ligne à mutations. La ligne enregistre le changement, l’acteur et la cause. Les lectures ne passent jamais par le journalà ; elles lisent l’état courant dans les projections.

Groupe Colonnes Ce qu’elles enregistrent
Cible domain, doc_type, doc_id, idx Quel document a changé, et son ordre dans l’historique de ce document
Contenu action, arguments create, update, delete ou snapshot, avec contenu ou diff
Provenance actioner_id, channel, app, api_key, acting_role Qui a écrit la ligne, et par quelle surface
Cause cause_kind, cause_name, cause_event, cause_source, cause_parent, cause_trace Ce qui a déclenché l’écriture, un maillon par ligne, et son cluster causal

Le journal n’accepte que les ajouts. Aucun chemin applicatif ne modifie une ligne en place. Une écriture que les contrôleurs refusent ne laisse aucune ligne, car la vérification de permission tourne avant tout changement en base. Les écritures système portent les mêmes mentionsà : la colonne du canal n’est jamais vide, triggers de base de données compris.

Un trigger de base de données applique chaque mutation à projections, la table qui porte l’état courant. Les lectures ne rejouent jamais l’historique. La projection stocke l’id de sa dernière mutation, et les lectures renvoient cet id comme ETag, le token de concurrence qu’un client vérifie avec If-None-Match. Les copies de documents suivent le même chemin : une copie ajoute ses propres lignes create par le même client de mutation, avec la même forme d’audit que n’importe quelle autre écriture.

Deux mécanismes gardent la table bornéeà :

  • Fusion à l’écriture. Quand le même acteur écrit par le même canal avec les mêmes identifiants dans la fenêtre (trois minutes par défaut), Facet fusionne les deux mises à jour en une seule ligne. La ligne fusionnée reçoit un nouvel id. L’ancien id cesse de se résoudre pour le reste de la fenêtreà ; un fetch répond 404. La projection stocke le nouvel id, donc son ETag correspond au contenu servi. Une fenêtre à zéro désactive la fusion.
  • Compactage de rétention. Un job quotidien remplace chaque mutation plus vieille que la fenêtre de rétention (180 jours par défaut) par un seul instantané synthétique. Le rejeu reste possible à partir de cette limite. La profondeur du retour arrière égale la fenêtreà : une cible plus vieille que la fenêtre répond 404. Un document supprimé garde son delete final et la ligne qui le précède, la restauration reste donc accessible dans la fenêtre.

Pourquoi ce n’est pas de l’event sourcing de domaine

Section intitulée « Pourquoi ce n’est pas de l’event sourcing de domaine »

Dans cette application, le journal sert deux usagesà : l’audit et l’état. Le rejeu existe, mais seulement en interne — le retour arrière et le compactage rejouent les lignes d’un document pour reconstruire un état. Aucun consommateur externe ne rejoue le journal. Ce n’est pas le contrat d’intégration du produit.

Les réactions voyagent à part. Les réactions à une écriture passent par un autre mécanisme. Après le commit en base, le chemin d’écriture publie des événements sur Redis Streams. Hooks, webhooks, réplication et mises à jour en direct y consomment. La livraison sur ce bus est au plus une fois, par conception. PostgreSQL reste le référentiel des données.

Les compromis sont assumés. La fusion masque les états intermédiairesà : deux sauvegardes rapides ne laissent qu’une seule ligne. Le compactage borne la profondeur de l’annuler. En échange, le journal reste borné, et le stockage reste prévisible.