App móvil y API

La app obtiene la lista de zonas de tu organización desde el endpoint de geocercas móvil (autenticación con el mismo token JWT que el resto de la API móvil).

La configuración remota (/api/mobile/config) incluye el interruptor features.geofences: si está desactivado, la app no aplica reglas de geocerca aunque existan zonas en el servidor.

La app móvil Sentinel no llega con geocercas precargadas: las descarga del servidor cuando el operador inicia sesión. La autenticación usa el mismo JWT que el resto de la API móvil, así que si la sesión es válida la sincronización ocurre automáticamente. Esa elección arquitectónica garantiza que el operador siempre opera con la versión más reciente de las zonas, sin necesidad de actualizar la app.

La configuración remota expuesta en /api/mobile/config tiene un interruptor llamado features.geofences. Si está apagado, la app no aplica reglas de geocerca aunque haya zonas en el servidor: ni dibuja, ni evalúa, ni notifica. Esto permite desactivar geocercas globalmente para una organización sin tener que borrar zonas o redeployar la app. Útil en entornos de prueba o cuando estás migrando políticas.

Cuando la flag está activa, la app evalúa localmente la posición GPS del operador respecto de las geometrías sincronizadas. Esa evaluación local tiene dos virtudes: funciona offline (siempre que las zonas hayan sido sincronizadas previamente con red) y reduce latencia (el aviso en zona restringida es inmediato, no espera respuesta del servidor). El operador necesita haber concedido permisos de ubicación en el sistema operativo para que esto funcione.

Operativamente, la recomendación es: el operador abre la app al menos una vez con red al inicio del turno, para refrescar zonas y configuración. A partir de ahí puede operar offline por horas siempre que tenga GPS. Cualquier cambio de zona hecho durante el turno se sincronizará en la próxima ventana con red. Para operaciones de larga duración en zonas sin cobertura, planificar refrescos periódicos es parte del SOP.