Estado de sincronización

La página de estado de sincronización (/calendar/sync-status) es la vista histórica de cada sincronización del calendario que Zellbox hizo para tu cuenta. Es el lugar al que ir cuando algo parece raro: "¿corrió la sincronización periódica?", "¿por qué no aparece el evento de ayer?", "¿qué acaba de bloquear la protección de seguridad?". Llega aquí desde:

• la etiqueta Sincronizado hace N de la página del Calendario,
• el enlace Ver historial completo de sincronización → del banner de cuarentena,
• el enlace Ver historial de sincronización → bajo Google Calendar en la página de Sincronización con Google (/google-sync), o
• abriendo /calendar/sync-status directamente.

Elegir una ventana de tiempo

Una tarjeta de filtro en la parte superior de la página acota qué ejecuciones se listan. Los chips de rango rápido preconfiguran ventanas comunes; los inputs Desde / Hasta te permiten afinar cada extremo; Limpiar descarta ambos. Un contador {n} ejecuciones en la ventana a la derecha te dice cuántas ejecuciones coinciden con el filtro actual.

Chip	Ventana
Última hora	Ahora − 60 min
Últimas 24 h (predeterminado)	Ahora − 24 h
Últimos 7 días	Ahora − 7 días
Últimos 30 días	Ahora − 30 días
Todo	Sin límites — tope de 100 resultados, más recientes primero

Cada fila es una tarjeta de estado:

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

El punto de color + el chip de estado te dicen el resultado de un vistazo:

Estado	Significado
Succeeded (verde)	Todas las ramas de calendario terminaron bien.
Partial (ámbar)	Algunas ramas funcionaron, otras dieron error. Expande la fila para ver cuáles. La fila también muestra un conteo de "retenidos para revisión" cuando la protección de seguridad puso un lote en cuarentena.
Failed (rojo)	Todas las ramas dieron error. Suele significar que el token OAuth expiró — vuelve a conectar Google.
Queued / Running (azul)	El trabajo está en curso. La página se vuelve a consultar mientras haya cualquier trabajo no terminal.

La fila también muestra el origen del disparo:

• Initial connect — la carga inicial post-OAuth que corre una vez cuando conectas Google por primera vez.
• Manual refresh — hiciste clic en Refrescar en la página del Calendario.
• Auto-sync — la pasada programada cada 5 minutos.
• New calendar added — marcaste un nuevo calendario en la página de Sincronización con Google; Zellbox corre una sincronización puntual para cargarlo.

Bajo el titular, una segunda línea resume cómo van las ramas de calendario de la ejecución — útil para distinguir una pasada en curso de una terminada sin expandir la fila:

8 done · 2 running · 2 queued

Si todavía no se ha registrado progreso por calendario (la red de seguridad para los primeros instantes de una pasada nueva), la línea dice No per-calendar progress recorded yet.

Detalles por calendario

Haz clic en una fila → se expande para mostrar el desglose por calendario. Cada rama trae su propio ícono de estado + conteos:

✓ 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)

Las ramas se ordenan para que las entradas en cuarentena y con error queden primero — lo que necesita tu atención se queda arriba.

Revisar una cancelación en cuarentena

Cuando la protección de seguridad se dispara, verás un banner amarillo en las páginas del Panel y del Calendario:

⚠ 47 cancelaciones de eventos en 1 calendario fueron retenidas para revisión por la protección de seguridad.

Para resolverlo:

1. Haz clic en Revisar en el banner, o abre la página de Estado de sincronización.
2. Expande la fila con la rama en cuarentena.
3. Lee el diagnóstico: "X cancelaciones potenciales · tamaño del espejo Y · motivo". El motivo explica por qué se disparó la protección:
   • on-seed — cancelaciones durante una carga inicial (sospechoso; un espejo recién creado no debería tener nada que cancelar).
   • abs-limit — más de 25 cancelaciones en una ejecución.
   • pct-limit — más del 20 % del espejo iba a ser cancelado.
4. Haz clic en Ver eventos retenidos → para expandir la lista por evento (ver más abajo). Revísala para confirmar que los eventos parecen una limpieza masiva legítima en vez de un percance de conexión.
5. Haz clic en Aprobar cancelaciones. El diálogo de confirmación tiene tres bloques:
   • Qué está por pasar: el conteo + el id del calendario.
   • Por qué se disparó la protección: una explicación específica del motivo (la misma distinción on-seed / pct-limit / abs-limit del paso 3, pero orientada a la decisión del operador).
   • Red de seguridad: todos los eventos que Zellbox está por cancelar se guardan automáticamente como instantánea en la tabla de respaldo primero. Tienes 90 días para restaurar cualquiera de ellos individualmente desde Recuperación — los eventos restaurados vuelven como Solo de Zellbox y no se vuelven a empujar a Google automáticamente.
6. Haz clic en Aplicar cancelaciones. Zellbox levanta una sincronización nueva para ese único calendario con la protección desactivada para él. Las cancelaciones se aplican; verás el trabajo de bypass aparecer arriba del historial.

Si prefieres no aprobar — por ejemplo, sospechas que el dueño de un calendario compartido eliminó todo por accidente — deja la cuarentena en su lugar. La próxima sincronización limpia liberará el slot automáticamente.

Detalle de los eventos retenidos

Debajo de la línea de diagnóstico, Ver eventos retenidos → carga de forma diferida cada evento que la protección rechazó para esa rama. Cada fila lleva el título, la hora de inicio (en la zona horaria del espacio de trabajo), el nombre del cliente vinculado cuando lo hay y un preview de la descripción.

La lista distingue dos tipos de filas:

• Eventos coincidentes — Zellbox todavía tiene una fila de espejo del evento. Se muestran como una tarjeta blanca.
• Tombstones fantasma — Google reportó status: cancelled para un evento que no está en nuestro espejo (casi siempre: una cancelación que ocurrió antes de que Zellbox se conectara a este calendario). Se muestran como una tarjeta gris con una nota en cursiva "Tombstone de Google (sin registro en Zellbox)".

La línea de resumen sobre la lista ("41 coincidentes · 313 fantasma · total 354") muestra el desglose, así un número agregado que asusta se desinfla — la mayoría de las veces el grueso de "354 cancelaciones" resulta ser fantasmas sin impacto real.

Las ramas puestas en cuarentena antes de que existiera esta función muestran solo conteos agregados (sin filas por evento en el log de auditoría). El estado vacío muestra un botón Recuperar detalles desde Google que vuelve a traer el lote desde Google con la misma ventana inicial y escribe las filas de auditoría faltantes en retrospectiva. Después de ejecutarse, la lista se puebla normalmente.

Contra qué protege la protección

La protección de seguridad existe para evitar que un hipo puntual de sincronización cancele en silencio muchos eventos. Modos concretos de falla que atrapa:

• Google devuelve una página corrupta donde muchos eventos reales aparecen como status: cancelled.
• Un cambio de token o de permisos en un calendario compartido hace que Zellbox crea que todo el calendario está vacío.
• Un bug en nuestro parseo marca eventos sanos como cancelados.

En cualquiera de esos casos la protección rechaza todo el lote y te pide confirmar antes de aplicar.