10 de noviembre de 2026 / 7 min de lectura
Offline-first sin fingir: lo que aprendí en CERTIA y Biomed CMMS
Precachear el app shell es fácil. Lo difícil es decidir qué se puede leer sin red, qué escrituras se permiten y cómo no perder datos por el camino.
En CERTIA el registro se hace en el sitio: dossiers de seguridad eléctrica, evidencia fotográfica y auditorías. En Biomed CMMS el escenario es parecido pero más grande: técnicos moviéndose entre equipos con cobertura irregular. En los dos casos, «la web cargará cuando haya internet» no era una respuesta válida.
Primero separa lectura de escritura
La regla que mejor funcionó en Biomed fue simple: la interfaz abre siempre, las lecturas de `/api` se sirven desde caché si la red falla, y las escrituras requieren conexión. Un técnico puede consultar el historial de un equipo en el pasillo, pero no puede dejar un cambio a medias sin que el sistema se entere. Hay un banner que lo dice explícitamente: guardar cambios requiere conexión.
// Estrategia real del service worker de Biomed: red primero, caché como respaldo.
registerRoute(
/\/api\//,
new NetworkFirst({
cacheName: 'api-lecturas',
networkTimeoutSeconds: 5,
expiration: { maxEntries: 120, maxAgeSeconds: 60 * 60 * 24 },
}),
);Ese `networkTimeoutSeconds` importa más de lo que parece. Sin un timeout corto, una red que «casi funciona» deja la pantalla esperando. Con él, la app responde igual; solo cambia de dónde viene el dato.
El almacenamiento local no es la fuente de verdad
- CERTIA guarda dossiers y fotos pendientes en IndexedDB (`certia-offline`, con outbox) y los envía a la API Fastify al recuperar red.
- Biomed mantiene SQLite local con `better-sqlite3` y Drizzle encima, con la puerta abierta a PostgreSQL si el centro crece.
- En los dos casos, la interfaz deja claro cuándo estás viendo información en caché y cuándo un cambio sigue pendiente.
Offline no es «guardar en localStorage y rezar». Es saber qué dato puede estar desactualizado y decirlo en pantalla.
Lo que no intenté
No quise conflictos de edición complejos entre varios clientes. Las escrituras vuelven a la API y punto. Es una decisión aburrida, pero evita el peor bug posible: dos personas creyendo que guardaron la misma orden de trabajo.