Saltar a contenido

0014. GPS en segundo plano durante una ruta activa y dentro de la jornada autorizada

Fecha: 2026-11-11 Estado: Propuesto Módulo(s) afectado(s): tracking de rutas, shared/ubicacion/ Modifica a: ADR 0011 — sólo en lo referido a ubicación en segundo plano para tracking de ruta

Contexto

El promotor necesita registrar su recorrido aunque minimice la app o bloquee la pantalla. La captura debe conservar el control manual y quedar limitada a la jornada autorizada, sin convertir el tracking en monitoreo permanente.

Decisión

La captura sólo comienza después de Iniciar ruta y se detiene al finalizarla o cuando termina la ventana laboral autorizada; fuera de esa ventana no se obtienen puntos nuevos. Se permite capturar en segundo plano mientras coincidan sesión manual activa y horario autorizado. La cadencia será adaptativa: aproximadamente 10 s en movimiento y 30–60 s en reposo; los puntos se guardan localmente, se suben en lotes cada 2 min y se vacía la cola antes de cerrar la ruta. Puntos válidos capturados dentro de la ventana pueden subirse después; aceptar esa carga tardía no habilita capturas nuevas fuera de horario.

El servidor es autoridad para decidir la ventana laboral; el origen exacto del horario y su zona horaria quedan abiertos. Se registra hora del dispositivo y recepción del servidor, sin confiar en el reloj del dispositivo ni en un empresa_id libre del cliente; la tolerancia ante desfases o manipulación queda por definir. empresa_id sigue siendo obligatorio y deriva del contexto autenticado autorizado.

La app debe explicar el uso, solicitar los permisos adecuados y hacer visible el tracking activo. Se validarán en equipos reales batería, precisión y comportamiento de Android/iOS; restricciones del sistema, terminación del proceso o permisos denegados pueden producir interrupciones. No se selecciona un paquete Flutter.

Alternativas descartadas

  • Captura sólo con la app visible — deja de registrar el recorrido al minimizarla o bloquear la pantalla.
  • Seguimiento continuo o inicio automático — excede la ruta iniciada expresamente y la jornada autorizada.
  • Confiar en el reloj del teléfono para definir el horario — el dispositivo no es una autoridad confiable para habilitar la captura.

Consecuencias

El permiso de ubicación en segundo plano y la configuración correspondiente de cada plataforma son requisito de producto; no garantizan ejecución ininterrumpida. Deben definirse la fuente/zona horaria laboral, tolerancias temporales y validarse precisión y consumo de batería antes de fijar el comportamiento operativo.


Esta modificación es parcial: agenda, check-in/check-out y sus reglas originales permanecen según el ADR 0011.