Sync-Status

Die Sync-Status-Seite (/calendar/sync-status) ist die Verlaufsansicht für jeden Kalender-Sync-Lauf, den Zellbox für dein Konto durchgeführt hat. Sie ist der richtige Ort, wenn etwas seltsam wirkt: „lief der periodische Sync?“, „warum tauchte der gestrige Termin nicht auf?“, „was hat die Sicherheitssperre gerade blockiert?“. Du kommst hierhin über:

• das Label Synchronisiert vor N auf der Kalender-Seite,
• den Link Vollständigen Sync-Verlauf anzeigen → im Sync-Quarantäne-Banner,
• den Link Sync-Verlauf anzeigen → unter Google Calendar auf der Google-Sync-Seite (/google-sync),
• oder direkt über /calendar/sync-status.

Zeitraum wählen

Eine Filterkarte oben auf der Seite schränkt die angezeigten Läufe ein. Schnellbereich-Chips setzen gängige Zeitfenster; die Eingaben Von und Bis mit Datum und Uhrzeit feinjustieren beide Seiten; Zurücksetzen entfernt beide Grenzen. Ein Zähler {n} Läufe im Zeitraum rechts zeigt dir, wie viele Sync-Jobs zum aktuellen Filter passen.

Chip	Zeitraum
Letzte Stunde	Jetzt − 60 Min
Letzte 24 h (Standard)	Jetzt − 24 h
Letzte 7 Tage	Jetzt − 7 Tage
Letzte 30 Tage	Jetzt − 30 Tage
Alle	Keine Grenzen – auf 100 Ergebnisse limitiert, neueste zuerst

Jede Zeile ist eine Status-Karte:

✓ Erfolgreich · Aktualisieren · vor 2 Min · 24s · 12 Kalender · 1.247 Termine berührt (812 hinzugefügt · 311 aktualisiert · 124 storniert)
  12 fertig
  ▸ Kalender-Details anzeigen

Der farbige Punkt + das Status-Chip zeigen dir das Ergebnis auf einen Blick:

Zustand	Bedeutung
Erfolgreich (grün)	Alle Kalender-Zweige sind durchgelaufen.
Teilweise (bernstein)	Einige Zweige erfolgreich, andere fehlerhaft. Klappe die Zeile auf, um zu sehen, welche. Die Zeile zeigt zusätzlich „zur Prüfung zurückgehalten“, wenn die Sicherheitssperre eine Kohorte in Quarantäne genommen hat.
Fehlgeschlagen (rot)	Alle Zweige fehlerhaft. Üblicherweise ist das OAuth-Token abgelaufen – Google neu verbinden.
In Warteschlange / Läuft (blau)	Job läuft. Die Seite pollt automatisch, solange ein Job nicht abgeschlossen ist.

Die Zeile zeigt auch die Auslösequelle:

• Erstverbindung – der einmalige Seed-Job nach OAuth, der beim ersten Verbinden von Google läuft.
• Manuelle Aktualisierung – du hast den Aktualisieren-Button auf der Kalender-Seite geklickt.
• Auto-Sync – der geplante 5-Minuten-Takt.
• Neuer Kalender hinzugefügt – du hast einen neuen Kalender auf der Google-Sync-Seite angehakt; Zellbox startet einen einmaligen Sync, um ihn zu befüllen.

Unter der Hauptzeile fasst eine zweite Zeile zusammen, wie der Lauf durch die Kalender-Zweige voranschreitet – hilfreich, um einen laufenden Takt von einem abgeschlossenen zu unterscheiden, ohne die Zeile aufzuklappen:

8 fertig · 2 laufen · 2 in Warteschlange

Wurde noch kein Fortschritt pro Kalender erfasst (Sicherheitsnetz für die ersten Sekunden eines frischen Laufs), steht da Noch kein Fortschritt pro Kalender erfasst.

Details pro Kalender

Klicke eine Zeile an → sie klappt auf und zeigt die Aufschlüsselung pro Kalender. Jeder Zweig hat sein eigenes Statussymbol und Zähler:

✓ primary                · 234 Termine synchronisiert
✓ Dr. Schmidt — Kardio   · 89 Termine synchronisiert
⚠ Geteilt — Pädiatrie    · 47 Stornierungen zur Prüfung zurückgehalten — [Freigeben]
✗ Dr. Lehmann — Dermat.  · Fehler: Token abgelaufen (Neuverbindung erforderlich)

Die Zweige sind so sortiert, dass quarantänierte und fehlerhafte Einträge oben stehen – das, was deine Aufmerksamkeit braucht, sitzt ganz oben.

Eine quarantänierte Stornierung prüfen

Wenn die Sicherheitssperre greift, siehst du auf Dashboard- und Kalender-Seite einen gelben Banner:

⚠ 47 Terminstornierungen auf 1 Kalender wurden von der Sicherheitssperre zur Prüfung zurückgehalten.

So gehst du vor:

1. Klicke Prüfen im Banner oder öffne die Sync-Status-Seite.
2. Klappe die Zeile mit dem quarantänierten Zweig auf.
3. Lies die Diagnose: „X potenzielle Stornierungen · Mirror-Größe Y · Grund“. Der Grund erklärt, warum die Sperre ausgelöst hat:
   • on-seed – Stornierungen während eines Initial-Seeds (verdächtig; ein frischer Mirror sollte nichts zu stornieren haben).
   • abs-limit – mehr als 25 Stornierungen in einem Lauf.
   • pct-limit – mehr als 20 % des Mirrors wären storniert worden.
4. Klicke auf Zurückgehaltene Termine anzeigen →, um die Liste pro Termin auszuklappen (siehe unten). Prüfe, ob die Termine wie eine legitime Massenbereinigung aussehen und nicht wie ein Verbindungsproblem.
5. Klicke auf Stornierungen freigeben. Der Bestätigungsdialog enthält drei Blöcke:
   • Was gleich passiert: die Anzahl + die Kalender-ID.
   • Warum die Sperre auslöste: eine grund-spezifische Erklärung (dieselbe on-seed / pct-limit / abs-limit-Unterscheidung wie in Schritt 3, aber formuliert für die Entscheidung der/des Operator:in).
   • Sicherheitsnetz: jeder Termin, den Zellbox storniert, wird zuvor automatisch in der Backup-Tabelle gesichert. Du hast 90 Tage, jeden einzeln aus Wiederherstellung zurückzuholen – wiederhergestellte Termine kommen als Zellbox-only zurück und werden nicht automatisch erneut zu Google übertragen.
6. Klicke auf Stornierungen anwenden. Zellbox startet einen frischen Einzel-Kalender-Sync-Job, bei dem die Sperre für diesen Kalender umgangen wird. Die Stornierungen werden angewandt; den Umgehungs-Job siehst du oben im Verlauf.

Wenn du lieber nicht freigeben möchtest – etwa weil du vermutest, dass die/der Inhaber:in eines geteilten Kalenders versehentlich alles gelöscht hat – lass die Quarantäne stehen. Der nächste saubere Sync räumt den Slot automatisch ab.

Detailansicht zurückgehaltener Termine

Unter der Diagnosezeile lädt Zurückgehaltene Termine anzeigen → bei Bedarf jeden Termin nach, den die Sicherheitssperre für diesen Zweig abgelehnt hat. Jede Zeile zeigt Titel, Startzeit (in der Workspace-Zeitzone), den verknüpften Kundennamen, falls vorhanden, und eine Beschreibungsvorschau.

Die Liste unterscheidet zwei Arten von Zeilen:

• Übereinstimmende Termine – Zellbox hat noch eine Mirror-Zeile für den Termin. Werden als weiße Karte dargestellt.
• Geister-Tombstones – Google meldet status: cancelled für einen Termin, der nicht im Mirror ist (fast immer: eine Stornierung, die geschah, bevor Zellbox mit diesem Kalender verbunden war). Werden als graue Karte mit kursiver Notiz „Google-Tombstone (kein Zellbox-Datensatz)“ dargestellt.

Die Summenzeile über der Liste („41 übereinstimmend · 313 Geister · gesamt 354“) zeigt die Aufteilung, sodass eine erschreckende Aggregatzahl entzaubert wird – meistens entpuppt sich der Großteil von „354 Stornierungen“ als Geister ohne reale Auswirkung.

Zweige, die vor Einführung dieses Features quarantäniert wurden, zeigen nur Aggregatzahlen (keine Zeilen pro Termin im Audit-Log). Der Leerzustand zeigt einen Button Details aus Google nachladen, der die Kohorte mit demselben Seed-Fenster erneut von Google abruft und die fehlenden Audit-Zeilen nachträglich schreibt. Nach dem Lauf befüllt sich die Liste normal.

Wovor die Sperre schützt

Die Sicherheitssperre verhindert, dass ein einzelner Sync-Schluckauf viele Termine still storniert. Konkrete Fehlerquellen, die sie abfängt:

• Google liefert eine korrupte Seite, in der viele echte Termine als status: cancelled erscheinen.
• Ein Token-Tausch oder eine Berechtigungsänderung an einem geteilten Kalender lässt Zellbox den ganzen Kalender leer wirken.
• Ein Fehler beim Parsen markiert gesunde Termine als storniert.

In all diesen Fällen verweigert die Sperre die gesamte Batch und bittet dich vor der Anwendung um Bestätigung.