Aller au contenu

Événements et garanties de livraison

Dans Facet, les événements sont des réactions, pas des enregistrements. Une fois l’écriture validée, Facet publie des événements sur Redis Streams, et des consommateurs réagissent. PostgreSQL porte l’état durable. Lisez cette page pour comprendre ce qui se passe quand une réaction se perd, et pourquoi c’est voulu.

Document write commits Document write commits

Chaque écriture acceptée ajoute une ligne au journal des mutations. Une fois la transaction validée, le chemin d’écriture pousse sa file d’événements vers Redis Streams. Une transaction annulée abandonne la file.

Les consommateurs tournent en groupes. Les hooks de domaine exécutent des scripts Lua. Les webhooks livrent des enveloppes signées à des URL externes. La réplication copie des champs entre domaines. Le pont WebSocket pousse des mises à jour en direct vers les navigateurs.

La livraison est au plus une fois, par conception. Les consommateurs lisent avec no_ack, et aucun code n’acquitte un message. Une publication ou une distribution en échec est abandonnée avec une seule ligne de log. PostgreSQL porte l’état durableà ; Redis est un bus de réactions, pas un registre.

La perte reste visible. Les compteurs event_loss sur GET /Healthcheck comptent les échecs de publication et les distributions abandonnées. Tant qu’un consommateur rapporte des échecs consécutifs, le même endpoint répond 503.

Les webhooks sont le seul consommateur réparé. Un job planifié, Cron::WebhookReconcile, rejoue la décision de mise en file depuis le journal des mutations. Il rattrape les envois manqués dans une fenêtre fixée par webhook.reconcile_window_hours, 24 heures par défaut. La fenêtre doit rester en dessous de la durée de rétention des jobs. Une fenêtre plus large renverrait des événements dont les enregistrements de livraison sont déjà purgés.

Un nouveau groupe de consommateurs choisit son point de départ. Les groupes de réplication partent de 0 et rejouent tout le flux conservé. Un rejeu converge, car chaque handler recalcule les lignes à partir de la projection courante. Les hooks et les webhooks gardent $, la fin du flux. Là, un rejeu déclencherait des automatisations une seconde fois et livrerait à nouveau vers des systèmes externes.

Un contrôle du retard vous prévient tôt. Il tourne toutes les dix minutes par défaut. Il lit le retard de chaque groupe et avertit avant qu’un groupe lent n’atteigne le point de troncature. Le retard maximal apparaît comme une jauge sur /Healthcheck, à côté de event_loss.

Une boucle, un bail. Facet fait tourner ces jobs sur son ordonnanceur cron. Une expression cron dit quand une tâche se déclenche. L’ordonnanceur exécute une seule boucle. Un bail unique à l’échelle du cluster garantit que chaque tick ne se déclenche qu’une fois, toutes instances backend confondues. Une tâche en échec écrit une erreur dans les logs, et l’ordonnanceur continue de tourner.

Ce que coûte la livraison au plus une fois. L’approche achète la simplicité et le débit. Elle renonce à la livraison garantie. Un consommateur doit tolérer la perte, ou prévoir un chemin de réparation, comme le réconciliateur des webhooks. La réplication tolère la perteà : ses handlers recalculent à partir de l’état durable, et un rejeu converge.