État de la synchronisation

La page d'état de la synchronisation (/calendar/sync-status) est la vue historique de chaque exécution de synchronisation d'agenda réalisée par Zellbox pour votre compte. C'est l'endroit où aller quand quelque chose semble anormal : « la synchronisation périodique a-t-elle eu lieu ? », « pourquoi l'événement d'hier n'est-il pas apparu ? », « qu'est-ce que le garde-fou vient de bloquer ? ». On y arrive depuis :

• l'étiquette Synchronisé il y a N de la page Agenda,
• le lien Voir l'historique complet de la synchronisation → d'une bannière de quarantaine,
• le lien Voir l'historique de synchronisation → sous Google Calendar sur la page Synchronisation Google (/google-sync), ou
• en ouvrant directement /calendar/sync-status.

Choisir une fenêtre temporelle

Une carte de filtre en haut de la page restreint les exécutions listées. Des pastilles de plage rapide pré-réglent les fenêtres courantes ; les champs Du / Au vous permettent d'ajuster chaque borne ; Effacer retire les deux. Un compteur {n} exécutions dans la fenêtre à droite indique combien de tâches de synchronisation correspondent au filtre courant.

Pastille	Fenêtre
Dernière heure	Maintenant − 60 min
Dernières 24 h (par défaut)	Maintenant − 24 h
7 derniers jours	Maintenant − 7 jours
30 derniers jours	Maintenant − 30 jours
Tout	Sans borne — plafonné à 100 résultats, les plus récents d'abord

Chaque ligne est une carte d'état :

✓ Succeeded · Refresh · 2 min ago · 24s · 12 calendars · 1,247 events touched (812 added · 311 updated · 124 cancelled)
  12 done
  ▸ Show calendar details

Le point coloré et la pastille de statut indiquent l'issue d'un coup d'œil :

État	Sens
Succeeded (vert)	Toutes les branches d'agenda ont abouti.
Partial (ambre)	Certaines branches ont réussi, d'autres ont échoué. Déployez la ligne pour voir lesquelles. La ligne montre aussi un compteur « retenu pour examen » quand le garde-fou a mis une cohorte en quarantaine.
Failed (rouge)	Toutes les branches ont échoué. Signifie généralement que le jeton OAuth a expiré — reconnectez Google.
Queued / Running (bleu)	Le job est en cours. La page rafraîchit automatiquement tant qu'un job n'est pas terminal.

La ligne indique aussi la source du déclenchement :

• Connexion initiale — la tâche d'amorçage post-OAuth qui s'exécute une seule fois lorsque vous connectez Google pour la première fois.
• Actualisation manuelle — vous avez cliqué sur le bouton Actualiser de la page Agenda.
• Synchronisation automatique — le tic-tac programmé de 5 minutes.
• Nouvel agenda ajouté — vous avez coché un nouvel agenda sur la page Synchronisation Google ; Zellbox exécute une synchronisation ponctuelle pour l'amorcer.

Sous le titre, une deuxième ligne résume la progression des branches d'agenda de l'exécution — pratique pour distinguer un tic en cours d'un tic terminé sans déployer la ligne :

8 done · 2 running · 2 queued

Si aucune progression par agenda n'a encore été enregistrée (filet de sécurité pour les tout premiers instants d'une exécution fraîche), la ligne affiche Aucune progression par agenda enregistrée pour l'instant.

Détail par agenda

Cliquez sur une ligne → déployez pour voir la répartition par agenda. Chaque branche reçoit son propre statut et ses compteurs :

✓ primary               · 234 events synced
✓ Dr. Smith — Cardio    · 89 events synced
⚠ Shared — Pediatrics   · 47 cancellations held for review — [Approve]
✗ Dr. Lee — Dermatology · error: token expired (re-connect required)

Les branches sont triées de sorte que les entrées en quarantaine et en erreur arrivent en premier — ce qui réclame votre attention se trouve en haut.

Examiner une annulation en quarantaine

Quand le garde-fou se déclenche, une bannière jaune apparaît sur les pages Tableau de bord et Agenda :

⚠ 47 annulations d'événements sur 1 agenda ont été retenues pour examen par le garde-fou.

Pour résoudre :

1. Cliquez sur Examiner dans la bannière, ou ouvrez la page État de la synchronisation.
2. Déployez la ligne contenant la branche en quarantaine.
3. Lisez le diagnostic : « X annulations potentielles · taille du miroir Y · motif ». Le motif explique pourquoi le garde-fou s'est déclenché :
   • on-seed — annulations pendant un amorçage initial (suspect ; un miroir tout frais ne devrait avoir rien à annuler).
   • abs-limit — plus de 25 annulations en une exécution.
   • pct-limit — plus de 20 % du miroir était sur le point d'être annulé.
4. Cliquez sur Voir les événements retenus → pour déployer la liste par événement (voir ci-dessous). Parcourez-la pour confirmer que les événements ressemblent à un nettoyage en masse légitime plutôt qu'à un incident de connexion.
5. Cliquez sur Approuver les annulations. La boîte de dialogue de confirmation comporte trois blocs :
   • Ce qui est sur le point de se passer : le nombre + l'id de l'agenda.
   • Pourquoi le garde-fou s'est déclenché : une explication propre au motif (la même distinction on-seed / pct-limit / abs-limit qu'à l'étape 3, mais formulée pour la décision de l'opérateur).
   • Filet de sécurité : chaque événement que Zellbox est sur le point d'annuler est automatiquement copié au préalable dans la table de sauvegarde. Vous avez 90 jours pour en restaurer individuellement depuis Récupération — les événements restaurés reviennent en mode Zellbox uniquement et ne sont pas re-poussés vers Google automatiquement.
6. Cliquez sur Appliquer les annulations. Zellbox lance une nouvelle tâche de synchronisation mono-agenda avec le garde-fou contourné pour cet agenda. Les annulations s'appliquent ; vous voyez le job de contournement apparaître en haut de l'historique.

Si vous préférez ne pas approuver — par exemple, si vous suspectez que le propriétaire d'un agenda partagé a tout supprimé par accident — laissez la quarantaine en place. La prochaine synchronisation propre videra le créneau automatiquement.

Détail des événements retenus

Sous la ligne de diagnostic, Voir les événements retenus → charge en différé chaque événement que le garde-fou a refusé pour cette unique branche. Chaque ligne porte le titre, l'heure de début (dans le fuseau horaire de l'espace), le nom du client lié quand il est présent et un aperçu de description.

La liste distingue deux types de lignes :

• Événements correspondants — Zellbox a toujours une ligne miroir pour l'événement. Rendus en carte blanche.
• Pierres tombales fantômes — Google a rapporté status: cancelled pour un événement qui n'est pas dans notre miroir (presque toujours : une annulation survenue avant que Zellbox ne soit connecté à cet agenda). Rendues en carte grise avec une note en italique « Pierre tombale Google (aucune trace Zellbox) ».

La ligne de synthèse au-dessus de la liste (« 41 correspondants · 313 fantômes · total 354 ») montre la répartition, ce qui dégonfle un chiffre agrégé effrayant — le plus souvent, l'essentiel des « 354 annulations » se révèle être des fantômes sans impact réel.

Les branches mises en quarantaine avant la sortie de cette fonctionnalité n'affichent que des compteurs agrégés (aucune ligne par événement dans le journal d'audit). L'état vide propose un bouton Récupérer les détails depuis Google qui récupère à nouveau la cohorte auprès de Google avec la même fenêtre d'amorçage et écrit rétrospectivement les lignes d'audit manquantes. Une fois exécuté, la liste se peuple normalement.

Ce contre quoi le garde-fou protège

Le garde-fou existe pour empêcher qu'un seul hoquet de synchronisation n'annule silencieusement de nombreux événements. Modes d'échec concrets qu'il attrape :

• Google renvoie une page corrompue où de nombreux événements réels apparaissent comme status: cancelled.
• Un changement de jeton ou de permission sur un agenda partagé fait croire à Zellbox que l'agenda entier est vide.
• Un bug d'analyse marque des événements sains comme annulés.

Dans chacun de ces cas, le garde-fou refuse le lot entier et vous demande de confirmer avant d'appliquer.