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.
Explication
Section intitulée « Explication »| 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.
Voir aussi
Section intitulée « Voir aussi »- Architecture en un coup d’œil — la place du journal dans le chemin d’écriture.
- Documents, doctypes et projections — l’état courant que le journal alimente.
- Événements et livraison — le bus de réaction, séparé de ce journal.
- Glossaire — le terme mutation, défini en une ligne.
- Gouverner l’accès — les règles de rétention de l’historique que le journal garde.
- Internes sur GitHubà : mutation.md, audit.md.