Saltar al contenido principal

«Sala de Continuidad» — la pantalla sin conexión deja de ser un callejón sin salida

Cuando se caía la red, la aplicación mostraba una pantalla de tres líneas con un botón «Reintentar». El cliente quedaba sin saber qué seguía funcionando, qué se había guardado ni cuándo volvería: un callejón sin salida con un icono de wifi tachado.

Ahora esa pantalla es una sala de control: sondea el servidor de verdad, muestra lo que el equipo tiene guardado y deja consultarlo mientras el enlace vuelve. Se llama Sala de Continuidad.

El diagnóstico: no era la pantalla que creíamos​

La ruta /offline del proyecto no la referenciaba nadie. Lo que el cliente veía era un HTML incrustado a mano dentro del Service Worker. Y ese Service Worker tenía un defecto de fondo: su activate borraba todas las cachés —incluida la que acababa de llenar install—, así que era imposible precachear un respaldo más rico. El respaldo mínimo siempre ganaba.

También había una consecuencia silenciosa: como la respuesta de respaldo se sirve en la URL de destino (no en /offline.html), la pantalla puede saber a dónde quería ir el usuario y devolverlo ahí al reconectar. Eso no se estaba usando.

Qué cambió​

  • Documento autónomo public/offline.html. Sin fuentes, iconos ni scripts externos: funciona con la red caída. Se precarga en install (con cache: 'reload') y activate ahora borra solo las cachés de versiones anteriores. Si el documento no estuviera disponible, queda un respaldo mínimo.
  • Sonar de sondeo real. Cada barrido del radar es un intento de reconexión con retroceso exponencial (2 → 4 → 8 → 15 → 30 s). El contador del centro, la cuenta atrás y la bitácora reflejan intentos reales: no hay animación de relleno.
  • Reconexión sin intervención. Se sondea al arrancar, al recuperar la red (online), al volver a la pestaña (visibilitychange) y cada N segundos según el retroceso. Al detectar el enlace, la pantalla lo anuncia y reabre la ruta conservada. R prueba de inmediato.
  • Telemetría local. Cuatro celdas leídas del propio equipo: copia de inventario (inventory_cache), cola de sincronización (unsyncedData), última baliza y sondeos. Si no hay copia, lo dice y explica cómo se crea.
  • «Ver datos guardados». Despliegue con buscador sobre la copia de inventario (SKU o nombre, sin distinguir mayúsculas ni tildes), con el stock bajo mínimo resaltado y el dato de antigüedad. Es lo único que el modo offline permite por diseño: solo lectura.
  • Misma pantalla en React. src/pages/offline.tsx reproduce el diseño para cuando se llega a /offline con la aplicación ya cargada.
  • Tema y accesibilidad. Honra la elección de tema guardada; role="status" solo en el mensaje de estado (la cuenta atrás no se anuncia cada segundo), foco visible, objetivos de 44 px, contraste AA en claro y oscuro, prefers-reduced-motion y prefers-contrast: more.

Por qué importa​

El modo offline estaba limitado a consultar inventario ya cargado. Pero si la pantalla no dice qué hay cargado ni cuándo se cargó, la restricción se siente como una avería. La Sala de Continuidad convierte esa espera en información útil —y en la seguridad de que el trabajo no se perdió— sin prometer nada que el sistema no pueda cumplir.

Archivos clave​

ArchivoRol
ccf-almacen-web/public/offline.htmlPantalla autónoma (sonar, telemetría, datos guardados)
ccf-almacen-web/public/sw.jsPrecarga y servicio del respaldo; limpieza de cachés por versión
ccf-almacen-web/src/pages/offline.tsxVersión React para la navegación interna
ccf-almacen-web/design.mdSección «Pantalla de continuidad (UX-003)»

Verificación​

Comprobado con un arnés sobre el HTML real (jsdom + fetch simulado): ruta conservada, telemetría de copia y cola, primer sondeo fallido con su línea de bitácora, apertura del panel con sus filas, búsqueda que filtra y la transición a «Enlace restablecido» al responder el servidor — 20 de 20 comprobaciones en verde. tsc y eslint limpios en los archivos tocados.