Offline-first PWA

Qué es

La evaluación digital es una PWA (Progressive Web App) offline-first. Eso significa que:

• Se abre como una página web normal (no es una app de tienda).
• Una vez abierta, funciona aunque pierdas la conexión.
• Cuando la conexión vuelve, sincroniza automáticamente los datos al servidor.

Por qué importa

El obrador del chocolatero no siempre tiene buena conexión: cámaras frigoríficas con paredes gruesas, sótanos, cocinas industriales con WiFi limitado. Una herramienta que se cae cuando hay un bache de cobertura es inviable en la práctica.

Cómo funciona

Primera apertura (con red)

1. El panelista abre el enlace único. La PWA se descarga y queda cacheada en su navegador.
2. Datos básicos de la cata (muestras, protocolo, atributos) se descargan también.
3. Desde este punto, el panelista puede trabajar incluso si se cae la conexión.

Durante la evaluación (con o sin red)

• Cada cambio se guarda localmente en el dispositivo (IndexedDB / Dexie).
• Si hay red, los cambios se envían al servidor inmediatamente.
• Si no hay red, los cambios se acumulan localmente y se envían en cuanto vuelva la conexión.

Tras enviar

• Cuando el panelista pulsa Enviar al final, la evaluación queda marcada como completada localmente.
• En cuanto el dispositivo vuelve a tener red, la evaluación se sube al servidor y aparece como completada en el detalle de cata del líder.

Indicador de estado

Bajo la cabecera, el panelista ve una pequeña píldora que indica el estado de guardado y sincronización. Cuando todo está al día y hay conexión, la píldora se oculta. Los estados que puede mostrar son:

• Guardando… — el cambio se está guardando en el dispositivo.
• Sincronizando… / Sincronizando N pendientes… — los cambios se están enviando al servidor.
• Sin conexión — sin red y sin nada pendiente de enviar.
• Sin conexión · N guardados locales — sin red, con cambios guardados en el dispositivo a la espera de subir.
• Error de sincronización — algo falló al subir; vuelve a intentarlo cuando tengas red estable.

No existe un estado etiquetado como "Guardado": cuando hay conexión y nada pendiente, la píldora simplemente desaparece.

Qué pasa si cierro el navegador

• Los datos están guardados localmente. Al abrir de nuevo el enlace en el mismo dispositivo y mismo navegador, recuperas la evaluación en curso.
• Si cambias de dispositivo antes de sincronizar, los datos del primer dispositivo se quedarán ahí hasta que reabras. Para evitar perder datos: termina la evaluación en el mismo dispositivo en el que la empezaste y asegúrate de tener red al final para sincronizar.

Limitaciones honestas

• La primera apertura requiere conexión para descargar la PWA y los datos de la cata.
• La sincronización al servidor necesita conexión (la app no telepatea).
• Si cierras el navegador, pierdes la sesión y la cookie — pero los datos persisten en IndexedDB hasta que vuelvas a abrir el mismo enlace.