Ubicación del indicador
El indicador de sincronización se encuentra en la parte derecha de la barra superior (topbar) de la aplicación. Siempre está visible y muestra el estado actual de la conexión y la sincronización de datos.
Estados del indicador
Online (verde)
El dispositivo está conectado a internet, todos los datos están sincronizados con el servidor. Este es el estado normal.
El indicador se muestra como un punto verde o un icono de conexión.
Qué significa:
- La conexión con el servidor está establecida
- No hay cambios pendientes
- Todos los datos están actualizados
Offline (ámbar)
El dispositivo no está conectado a internet. La aplicación funciona con datos locales.
El indicador se muestra como un punto ámbar (naranja) o un icono de ausencia de conexión.
Qué significa:
- No hay conexión con el servidor
- La aplicación funciona con datos en caché
- Todos los nuevos cambios se guardan localmente
- La sincronización comenzará automáticamente cuando se restablezca la conexión
Syncing (animado)
La sincronización está en curso: los cambios locales se están enviando al servidor.
El indicador se muestra como un icono de sincronización animado (pulsante).
Qué significa:
- Se ha restablecido la conexión o se ha iniciado una sincronización manual
- Los cambios pendientes se envían al servidor en orden cronológico
- El proceso suele tardar unos segundos
Contador de cambios pendientes
Junto al indicador se muestra un número: la cantidad de cambios pendientes de sincronización. Cada acción realizada offline incrementa el contador en uno:
- Marcado de check-in -- +1
- Marcado manual de pago -- +1
- Cambio de estado de registro -- +1
Ejemplos de visualización:
- Punto verde sin número -- todo sincronizado
- Punto ámbar + 3 -- offline, 3 cambios pendientes de envío
- Animación + 3 -> 2 -> 1 -> 0 -- sincronización en curso, los cambios se envían
Cuando el contador llega a cero, el indicador cambia al estado verde.
Qué es pendingSync
Cada cambio realizado offline recibe la marca pendingSync=true en la base de datos local. Esta marca significa:
- El cambio se ha guardado localmente
- El cambio aún no se ha enviado al servidor
- Se transmitirá en la próxima sincronización
Tras el envío exitoso al servidor, la marca se elimina (pendingSync=false) y el registro se considera sincronizado.
Sincronización manual
Además de la sincronización automática al restablecerse la conexión, puedes iniciar la sincronización manualmente:
- Haz clic en el indicador de sincronización en la barra superior.
- Se abrirá el panel de detalles con información:
- Estado actual de la conexión
- Cantidad de cambios pendientes
- Hora de la última sincronización exitosa
- Pulsa el botón Sincronizar.
El inicio manual es útil cuando:
- Quieres asegurarte de que todos los datos se han enviado antes de cerrar la aplicación
- La sincronización automática no se ha iniciado tras restablecerse la conexión
- Quieres verificar que la sincronización funciona correctamente
Si el dispositivo está offline, el botón «Sincronizar» estará inactivo.
Notificaciones de sincronización
La aplicación muestra notificaciones toast en los eventos clave de sincronización:
| Evento | Notificación |
|---|---|
| Pérdida de conexión | «Estás offline. Los datos se guardan localmente» |
| Restablecimiento de conexión | «Conexión restablecida. Sincronizando...» |
| Sincronización exitosa | «Todos los datos sincronizados» |
| Error de sincronización | «Error de sincronización. Reintento en 30 s» |
| Conflicto de datos | «Conflicto detectado. Se requiere tu decisión» (Business+) |
Recomendaciones
- No cierres la aplicación inmediatamente después de trabajar offline. Espera a que el contador de cambios pendientes llegue a cero.
- Revisa el indicador antes del inicio del evento. Asegúrate de que los datos estén actualizados (estado verde).
- En sesiones largas de trabajo offline, revisa el contador periódicamente. Una gran cantidad de cambios pendientes (50+) puede ralentizar la sincronización al restablecerse la conexión.