background task

This commit is contained in:
yves committed 2026-11-20 23:22:25 +01:00
1 parent 47b73e6935
commit ce44ee48b3
7 files changed
+483 -69

No files matched your search

+19
View File
@@ -285,6 +285,25 @@ let mut events = client.subscribe(); // Strea
* Le store applique une mise à jour de statut dans le segment qui contient le message, en
partant du plus récent. Seuls les segments modifiés sont réécrits.
### 5.3 Tâche de fond et flux d'événements
* `client.subscribe()` renvoie un `broadcast::Receiver<Event>`. Tout événement y passe, qu'il
vienne de `sync`, de `flush_outbox` ou de la tâche de fond. Un abonné qui prend plus de 256
événements de retard reçoit `Lagged` et doit recharger sa vue depuis le client.
* `client.start(BackgroundOptions)` déplace le client dans une tâche `tokio` et renvoie un
`ClientHandle` qui offre `subscribe()`, `lock()` (accès complet au client) et `stop()`
(rend le client).
* Boucle de la tâche : vider les dépôts dus, puis faire un long-poll sur tous les serveurs, puis
traiter et publier. Après une réception, la tâche repart aussitôt, sans attente, pour envoyer
les acks et les réponses. En cas d'échec de tous les serveurs : backoff de 2 s à 60 s.
* **Le verrou n'est jamais tenu pendant une attente réseau.** Le pull et le vidage de la file
sont découpés en trois temps : `prepare_*` sous verrou, appels réseau sans verrou, `apply_*`
sous verrou. Un envoi depuis l'UI n'attend donc ni un long-poll ni un serveur injoignable.
* Le long-poll est raccourci jusqu'au prochain réessai dû de la file : un dépôt en attente
repart à l'heure, même sans autre trafic.
* Arrêter la tâche abandonne le long-poll en cours. Ses acks n'ont pas été confirmés : ils
seront simplement renvoyés (ils sont idempotents).
---
## 6. Stockage client (`meow-store`)