Stato sincronizzazione

La pagina di stato della sincronizzazione (/calendar/sync-status) è la vista storica di ogni sincronizzazione del calendario che Zellbox ha eseguito per il tuo account. È il posto dove andare quando qualcosa sembra non quadrare: "la sincronizzazione periodica è partita?", "perché l'evento di ieri non è comparso?", "cosa ha appena bloccato il blocco di sicurezza?". Ci arrivi da:

• l'etichetta Sincronizzato N fa sulla pagina Calendario,
• il link Vedi storico sincronizzazione completo → su un banner di quarantena,
• il link Vedi storico sincronizzazione → sotto Google Calendar nella pagina Google Sync (/google-sync), o
• aprendo direttamente /calendar/sync-status.

Scegliere una finestra temporale

Una card di filtro in cima alla pagina restringe quali esecuzioni vengono elencate. I chip di intervallo rapido preimpostano le finestre comuni; gli input data/ora Da / A consentono di affinare entrambi i lati; Pulisci rimuove entrambi i limiti. Un contatore {n} esecuzioni nella finestra sulla destra ti dice quante esecuzioni corrispondono al filtro corrente.

Chip	Finestra
Ultima ora	Ora − 60 min
Ultime 24 h (predefinito)	Ora − 24 h
Ultimi 7 giorni	Ora − 7 giorni
Ultimi 30 giorni	Ora − 30 giorni
Tutto	Senza limiti — limitato a 100 risultati, dal più recente

Ogni riga è una card di stato:

✓ Riuscita · Aggiornamento · 2 min fa · 24s · 12 calendari · 1.247 eventi toccati (812 aggiunti · 311 aggiornati · 124 annullati)
  12 completati
  ▸ Mostra dettagli per calendario

Il pallino colorato + il chip di stato ti dicono l'esito a colpo d'occhio:

Stato	Significato
Riuscita (verde)	Tutti i rami calendario sono andati a buon fine.
Parziale (ambra)	Alcuni rami hanno avuto successo, altri errore. Espandi la riga per vedere quali. La riga mostra anche un conteggio "trattenuti per revisione" quando il blocco di sicurezza ha messo in quarantena una coorte.
Fallita (rossa)	Ogni ramo ha avuto errore. Di solito significa che il token OAuth è scaduto — ricollega Google.
In coda / In esecuzione (blu)	Job in corso. La pagina fa polling automatico finché un job non è in stato finale.

La riga mostra anche la fonte di trigger:

• Connessione iniziale — il job di seed post-OAuth che parte una sola volta al primo collegamento di Google.
• Aggiornamento manuale — hai cliccato il pulsante Aggiorna sulla pagina Calendario.
• Auto-sync — il tick programmato di 5 minuti.
• Nuovo calendario aggiunto — hai spuntato un nuovo calendario sulla pagina Google Sync; Zellbox esegue una sincronizzazione una tantum per popolarlo.

Sotto l'intestazione, una seconda riga riassume come procedono i rami calendario dell'esecuzione — utile per distinguere a colpo d'occhio un tick in corso da uno terminato senza espandere la riga:

8 completati · 2 in esecuzione · 2 in coda

Se non è stato ancora registrato alcun progresso per calendario (la rete di sicurezza per i primissimi istanti di una nuova esecuzione), la riga mostra Nessun progresso per calendario ancora registrato.

Dettagli per calendario

Clicca una riga → espandi per vedere il dettaglio per calendario. Ogni ramo ha la propria icona di stato + conteggi:

✓ primary               · 234 eventi sincronizzati
✓ Dr. Smith — Cardio    · 89 eventi sincronizzati
⚠ Condiviso — Pediatria · 47 annullamenti trattenuti per revisione — [Approva]
✗ Dr. Lee — Dermatologia · errore: token scaduto (riconnessione richiesta)

I rami sono ordinati così che le voci in quarantena e in errore vengono per prime — le cose che richiedono attenzione stanno in cima.

Rivedere un annullamento in quarantena

Quando il blocco di sicurezza scatta, vedi un banner giallo sulle pagine Dashboard + Calendario:

⚠ 47 annullamenti di evento su 1 calendario sono stati trattenuti per revisione dal blocco di sicurezza.

Per risolvere:

1. Clicca Rivedi sul banner, o apri la pagina Stato sincronizzazione.
2. Espandi la riga con il ramo in quarantena.
3. Leggi la diagnostica: "X potenziali annullamenti · dimensione mirror Y · motivo". Il motivo spiega perché è scattato il blocco:
   • on-seed — annullamenti durante un seed iniziale (sospetto; un mirror nuovo non dovrebbe avere nulla da annullare).
   • abs-limit — più di 25 annullamenti in una sola esecuzione.
   • pct-limit — oltre il 20% del mirror stava per essere annullato.
4. Clicca Vedi eventi trattenuti → per espandere l'elenco dei singoli eventi (vedi sotto). Scansiona per confermare che gli eventi sembrano una pulizia di massa legittima e non un problema di connessione.
5. Clicca Approva annullamenti. Il dialog di conferma ha tre blocchi:
   • Cosa sta per succedere: il conteggio + l'id del calendario.
   • Perché è scattato il blocco: una spiegazione specifica del motivo (la stessa distinzione tra on-seed / pct-limit / abs-limit del passo 3, ma riformulata per la decisione dell'operatore).
   • Rete di sicurezza: ogni evento che Zellbox sta per annullare viene prima automaticamente fotografato nella tabella di backup. Hai 90 giorni per ripristinarne uno per uno da Recupero — gli eventi ripristinati tornano come solo Zellbox e non vengono ri-pushati su Google automaticamente.
6. Clicca Applica annullamenti. Zellbox avvia una nuova sincronizzazione su quel singolo calendario con il blocco bypassato per esso. Gli annullamenti vengono applicati; vedi il job di bypass comparire in cima allo storico.

Se preferisci non approvare — per esempio sospetti che il proprietario di un calendario condiviso abbia cancellato tutto per sbaglio — lascia in quarantena. La prossima sincronizzazione pulita libererà lo slot automaticamente.

Dettaglio degli eventi trattenuti

Sotto la riga di diagnostica, Vedi eventi trattenuti → carica lazy ogni evento che il blocco di sicurezza ha rifiutato per quel ramo. Ogni riga riporta titolo, orario di inizio (nel fuso del workspace), nome del cliente collegato quando presente e un'anteprima della descrizione.

La lista distingue due tipi di righe:

• Eventi corrispondenti — Zellbox ha ancora una riga mirror per l'evento. Visualizzati come card bianca.
• Tombstone fantasma — Google ha riportato status: cancelled per un evento che non è nel nostro mirror (quasi sempre: un annullamento avvenuto prima che Zellbox fosse collegato a quel calendario). Visualizzati come card grigia con una nota in corsivo "Tombstone Google (nessun record Zellbox)".

La riga di riepilogo sopra la lista ("41 corrispondenti · 313 fantasma · totale 354") mostra la suddivisione, così un numero aggregato spaventoso si sgonfia — spesso il grosso di "354 annullamenti" risulta essere fantasma senza impatto reale.

I rami messi in quarantena prima del rilascio di questa funzionalità mostrano solo i conteggi aggregati (nessuna riga per evento nell'audit log). Lo stato vuoto mostra un pulsante Recupera dettagli da Google che riprende la coorte da Google con la stessa finestra di seed e scrive le righe di audit mancanti retroattivamente. Dopo l'esecuzione, la lista si popola normalmente.

Da cosa protegge il blocco

Il blocco di sicurezza esiste per evitare che un singolo intoppo nella sincronizzazione annulli silenziosamente molti eventi. Le modalità di errore concrete che intercetta:

• Google restituisce una pagina corrotta dove molti eventi reali appaiono come status: cancelled.
• Uno scambio di token o un cambio di permessi su un calendario condiviso fa pensare a Zellbox che l'intero calendario sia vuoto.
• Un bug nel nostro parsing marca eventi sani come annullati.

In tutti questi casi il blocco rifiuta l'intero batch e ti chiede conferma prima di applicare.