«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 eninstall(concache: 'reload') yactivateahora 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.Rprueba 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.tsxreproduce el diseño para cuando se llega a/offlinecon 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-motionyprefers-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
| Archivo | Rol |
|---|---|
ccf-almacen-web/public/offline.html | Pantalla autónoma (sonar, telemetría, datos guardados) |
ccf-almacen-web/public/sw.js | Precarga y servicio del respaldo; limpieza de cachés por versión |
ccf-almacen-web/src/pages/offline.tsx | Versión React para la navegación interna |
ccf-almacen-web/design.md | Secció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.