Status sinkronisasi

Halaman status sinkronisasi (/calendar/sync-status) adalah tampilan riwayat untuk setiap sinkronisasi kalender yang Zellbox lakukan untuk akun Anda. Inilah tempat yang dituju saat ada yang terasa janggal: "apakah sinkronisasi periodik berjalan?", "mengapa acara kemarin tidak muncul?", "apa yang baru saja diblokir pengaman?". Akses dari sini:

• label Disinkronkan N lalu pada halaman Kalender,
• tautan Lihat riwayat sinkronisasi lengkap → pada banner karantina sinkronisasi,
• tautan Lihat riwayat sinkronisasi → di bawah Google Calendar pada halaman Sinkronisasi Google (/google-sync), atau
• buka /calendar/sync-status secara langsung.

Memilih jendela waktu

Kartu filter di bagian atas halaman mempersempit sinkronisasi mana yang ditampilkan. Chip rentang cepat menetapkan jendela umum; input datetime Dari / Sampai memungkinkan Anda menyempurnakan masing-masing sisi; Bersihkan menghapus kedua batas. Penghitung {n} sinkronisasi dalam jendela di kanan menunjukkan berapa banyak pekerjaan sinkronisasi yang cocok dengan filter saat ini.

Chip	Jendela
Jam terakhir	Sekarang − 60 menit
24 jam terakhir (default)	Sekarang − 24 jam
7 hari terakhir	Sekarang − 7 hari
30 hari terakhir	Sekarang − 30 hari
Semua	Tanpa batas — dibatasi 100 hasil, terbaru dulu

Setiap baris adalah kartu status:

✓ Berhasil · Refresh · 2 menit lalu · 24s · 12 kalender · 1.247 acara tersentuh (812 ditambahkan · 311 diperbarui · 124 dibatalkan)
  12 selesai
  ▸ Tampilkan detail kalender

Titik berwarna + chip status memberi tahu Anda hasil sekilas:

Status	Arti
Berhasil (hijau)	Semua cabang kalender mendarat.
Sebagian (kuning)	Beberapa cabang berhasil, beberapa gagal. Perluas baris untuk melihat yang mana. Baris juga menampilkan jumlah "ditahan untuk ditinjau" saat pengaman mengarantina kohort.
Gagal (merah)	Setiap cabang gagal. Biasanya berarti token OAuth kedaluwarsa — hubungkan kembali Google.
Antri / Berjalan (biru)	Pekerjaan sedang berlangsung. Halaman melakukan polling otomatis selama pekerjaan apa pun belum terminal.

Baris juga menampilkan sumber pemicu:

• Koneksi awal — pekerjaan penyemaian pasca-OAuth yang berjalan sekali ketika Anda menghubungkan Google untuk pertama kali.
• Penyegaran manual — Anda mengklik tombol Segarkan pada halaman Kalender.
• Sinkronisasi otomatis — tick terjadwal 5 menit.
• Kalender baru ditambahkan — Anda mencentang kalender baru pada halaman Sinkronisasi Google; Zellbox menjalankan sinkronisasi sekali untuk menyemainya.

Di bawah baris utama, baris kedua merangkum bagaimana cabang kalender dalam sinkronisasi berkembang — berguna untuk membedakan tick yang sedang berjalan dari yang sudah selesai tanpa memperluas baris:

8 selesai · 2 berjalan · 2 antri

Jika belum ada kemajuan per kalender yang dicatat (jaring pengaman untuk momen-momen pertama sinkronisasi baru), baris berbunyi Belum ada kemajuan per kalender yang tercatat.

Detail per kalender

Klik baris → perluas untuk melihat rincian per kalender. Setiap cabang mendapatkan ikon status + jumlahnya:

✓ primary               · 234 acara disinkronkan
✓ Dr. Smith — Cardio    · 89 acara disinkronkan
⚠ Bersama — Pediatri    · 47 pembatalan ditahan untuk ditinjau — [Setujui]
✗ Dr. Lee — Dermatologi · error: token kedaluwarsa (perlu sambung ulang)

Cabang diurutkan sehingga entri yang dikarantina dan gagal muncul lebih dulu — hal-hal yang membutuhkan perhatian Anda berada di atas.

Meninjau pembatalan yang dikarantina

Saat pengaman aktif, Anda akan melihat banner kuning di halaman Dasbor + Kalender:

⚠ 47 pembatalan acara pada 1 kalender ditahan untuk ditinjau oleh pengaman.

Untuk menyelesaikan:

1. Klik Tinjau pada banner, atau buka halaman Status sinkronisasi.
2. Perluas baris dengan cabang yang dikarantina.
3. Baca diagnostiknya: "X calon pembatalan · ukuran cermin Y · alasan". Alasan menjelaskan mengapa pengaman aktif:
   • on-seed — pembatalan selama penyemaian awal (mencurigakan; cermin yang baru tidak seharusnya memiliki apa pun untuk dibatalkan).
   • abs-limit — lebih dari 25 pembatalan dalam satu sinkronisasi.
   • pct-limit — lebih dari 20% cermin akan dibatalkan.
4. Klik Lihat acara yang ditahan → untuk memperluas daftar per-acara (lihat di bawah). Pindai untuk mengonfirmasi bahwa acara tampak seperti pembersihan massal yang sah, bukan gangguan koneksi.
5. Klik Setujui pembatalan. Dialog konfirmasi memiliki tiga blok:
   • Apa yang akan terjadi: jumlah + id kalender.
   • Mengapa pengaman aktif: penjelasan khusus alasan (perbedaan on-seed / pct-limit / abs-limit yang sama dari langkah 3, tetapi diformulasi untuk keputusan operator).
   • Jaring pengaman: setiap acara yang akan dibatalkan Zellbox otomatis di-snapshot ke tabel cadangan terlebih dahulu. Anda memiliki 90 hari untuk memulihkan salah satu dari mereka secara individu dari Pemulihan — acara yang dipulihkan kembali sebagai Zellbox-saja dan tidak di-push ulang ke Google secara otomatis.
6. Klik Terapkan pembatalan. Zellbox memutar pekerjaan sinkronisasi satu-kalender baru dengan pengaman dilewati untuk kalender itu. Pembatalan diterapkan; Anda melihat pekerjaan pelewatan muncul di bagian atas riwayat.

Jika Anda lebih memilih tidak menyetujui — misalnya, Anda mencurigai pemilik kalender bersama menghapus semuanya secara tidak sengaja — biarkan karantina di tempatnya. Sinkronisasi bersih berikutnya akan membersihkan slot secara otomatis.

Drill-down acara yang ditahan

Di bawah baris diagnostik, Lihat acara yang ditahan → memuat dengan lazy setiap acara yang ditolak pengaman untuk cabang itu. Setiap baris memuat judul, waktu mulai (dalam zona waktu ruang kerja), nama pelanggan terkait jika ada, dan pratinjau deskripsi.

Daftar membedakan dua jenis baris:

• Acara yang cocok — Zellbox masih memiliki baris cermin untuk acara. Dirender sebagai kartu putih.
• Tombstone hantu — Google melaporkan status: cancelled untuk acara yang tidak ada di cermin kami (hampir selalu: pembatalan yang terjadi sebelum Zellbox terhubung ke kalender ini). Dirender sebagai kartu abu-abu dengan catatan miring "Tombstone Google (tanpa catatan Zellbox)".

Baris ringkasan di atas daftar ("41 cocok · 313 hantu · total 354") menunjukkan rincian sehingga angka agregat yang mengejutkan menjadi kurang menakutkan — paling sering sebagian besar dari "354 pembatalan" ternyata adalah hantu yang tidak berdampak nyata.

Cabang yang dikarantina sebelum fitur ini diluncurkan hanya menampilkan jumlah agregat (tanpa baris per-acara dalam log audit). Status kosong memunculkan tombol Pulihkan detail dari Google yang mengambil kembali kohort dari Google dengan jendela penyemaian yang sama dan menulis baris audit yang hilang secara retroaktif. Setelah dijalankan, daftar terisi secara normal.

Apa yang dilindungi pengaman

Pengaman ada untuk mencegah satu gangguan sinkronisasi membatalkan banyak acara secara diam-diam. Mode kegagalan konkret yang ditangkapnya:

• Google mengembalikan halaman yang rusak di mana banyak acara nyata muncul sebagai status: cancelled.
• Pergantian token atau perubahan izin kalender bersama membuat Zellbox berpikir seluruh kalender kosong.
• Bug dalam parser kami menandai acara yang sehat sebagai dibatalkan.

Dalam salah satu kasus ini pengaman menolak seluruh batch dan meminta Anda untuk mengonfirmasi sebelum menerapkan.