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. Cuando la cata ya está guardada en el móvil, la bienvenida lo indica con el aviso Ya puedes catar sin conexión.

Durante la evaluación (con o sin red)

• Cada muestra se guarda al pulsar Guardar y volver al selector. Si hay red, se envía al servidor en ese momento.
• Si no hay red, la muestra queda guardada en el dispositivo (IndexedDB) y se envía sola en cuanto vuelve la conexión; mientras haya guardados pendientes, la app lo reintenta cada 30 segundos.
• Si el panelista abre la ficha sin conexión y el móvil tiene la copia de la cata, ve el aviso "Sin conexión: estás catando con la copia guardada en este móvil. Lo que puntúes se enviará solo en cuanto vuelva la cobertura."

Tras enviar

• El panelista envía la evaluación con Confirmar y enviar: en la cata descriptiva y en las pruebas que se puntúan muestra a muestra, ese botón está en la pantalla de revisión (a la que se llega con Revisar y enviar); en las pruebas triangular, pares, dúo-trío y ordenamiento está en la propia ficha y el envío se confirma después con Enviar definitivamente. Si en ese momento no hay red, la pantalla final muestra Pendiente de enviar: la evaluación queda registrada en el móvil.
• 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. Si abres el enlace sin conexión en un dispositivo que no tiene copia, verás "Sin conexión y en este móvil no hay copia de esta cata…". 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.