Migración a PWA

Contexto

Base existente en HTML/CSS, con necesidad de mejorar experiencia de uso y portabilidad en distintos contextos de acceso.

Objetivo

Habilitar instalación, offline baseline, consistencia de carga y control de actualización sin rehacer toda la base existente.

Qué se implementó

• Web App Manifest: definición de identidad, íconos, modo de visualización y acceso instalable.
• Service Worker: capa de control para interceptar solicitudes y gestionar comportamiento offline.
• Cache strategy (offline baseline): reglas de caché por recurso para mantener disponibilidad básica.
• Criterios de instalación: validación de requisitos y comportamiento esperado al instalar.

Decisiones clave

• Scope del Service Worker acotado al caso para reducir riesgo de interferir con rutas no objetivo.
• Caché por tipo de recurso: estáticos con mayor persistencia y datos dinámicos con refresco más agresivo.
• Actualización controlada con estrategia stale/refresh para balancear continuidad y versión vigente.
• Compatibilidad progresiva: experiencia funcional en navegadores modernos y fallback sin bloquear uso.

Riesgos y mitigaciones

• Contenido obsoleto: mitigado con invalidación selectiva y políticas de expiración por recurso.
• Actualización invisible para usuarios: mitigada con control de versión y recarga en ventana de cambio.
• Almacenamiento limitado en dispositivo: mitigado con priorización de assets críticos y limpieza periódica.

Limitaciones conscientes

• No se realizó reescritura completa de frontend para evitar ampliar alcance sin validación previa.
• No se implementó sincronización avanzada offline para mantener complejidad operativa bajo control.
• No se prometió mejora de performance sin baseline e instrumentación de medición definidos.

Entregables

• manifest.json
• service-worker.js
• checklist de pruebas
• notas técnicas (resumen)

Lo que haríamos distinto hoy

• Definir baseline con medición desde el día 1
• Instrumentación mínima (eventos de instalación/uso)
• Estrategia de actualización más explícita
• Instrumentación mínima desde día 1 (eventos + baseline) para defender decisiones con datos.