Flujo de rutas móviles

Propuesta documental de captura GPS, ingestión y composición del mapa. Las zonas distinguen los datos de tracking de los datos comerciales que siguen bajo propiedad de sus servicios CRM.

PROPUESTA · NO APROBADA

Ciclo móvil · orden de operaciones

Check-in/check-out viaja aparte del lote GPS.

Iniciar ruta

Acción manual. La API crea la sesión y devuelve tracking_session_id.

El ID correlaciona; no autoriza.

Muestrear GPS

~10 s en movimiento; 30–60 s en reposo, sólo con ruta activa y horario autorizado.

La app mantiene la cola local; no toma muestras nuevas fuera de ventana.

Enviar lotes

Aproximadamente cuatro muestras cada 2 min; a 10 s de cadencia son 12.

Una muestra válida en cola puede cargarse más tarde.

Registrar visita

Check-in/check-out se envía de inmediato a la API de visitas de svc-fuerza-ventas.

Incluye referencia de sesión; no espera ni entra al lote GPS. La ruta HTTP no está documentada.

Finalizar ruta

Primero se vacían los puntos GPS pendientes; luego se solicita el cierre de sesión.

Acción manual; la captura ya cesa al salir de la ventana autorizada.

Zonas de propiedad y flujo de datos

Composición mediante APIs propietarias; sin joins entre bases.

App móvil CRM

Inicio/cierre manualCola localGPS adaptativo

La app envía unos cuatro puntos por lote cada dos minutos, vacía los pendientes antes del cierre y permite la carga tardía de puntos tomados dentro del horario.

La cadencia, permisos y ejecución en segundo plano deben validarse en dispositivos reales. El lote reduce solicitudes, no el muestreo ni la energía que consume el GPS.

API y almacenamiento de tracking

La API crea/cierra sesiones, recibe lotes y consulta puntos. empresa_id es obligatorio en cada sesión y punto lógico; se deriva y autoriza desde el contexto de autenticación confiable, nunca desde un valor libre del cliente.

tracking_session_id identifica la sesión pero no concede autorización. Todas las operaciones aplican el tenant confiable.

MongoDB time-series · recomendación propuesta

Sesiones y puntos guardan empresa_id. El consumidor interno autorizado lo suministra; la API autentica y autoriza al caller y aplica el tenant como predicado obligatorio en cada operación. La app móvil deriva su ámbito del contexto autenticado, no de un campo libre. Las respuestas incluyen empresa_id. MongoDB no aplica PostgreSQL RLS: es una excepción de tracking a la política transversal CRM, pendiente de reconciliación y aprobación. Si RLS de base es obligatorio, PostgreSQL particionado con RLS sigue siendo la alternativa.

No almacenar aquí: cliente_id, prospecto_id, nombres o identificación de clientes, visitas, pedidos ni actividades.

Servicios propietarios CRM

svc-fuerza-ventas

Es propietario de visitas/check-in/check-out, pedidos y actividades. Recibe la referencia tracking_session_id y persiste su empresa_id en su almacenamiento CRM protegido por RLS.

Una sesión puede relacionarse con varias visitas. La validación servicio-a-servicio de sesión es opcional, pendiente y sólo de lectura si se adopta.

svc-clientes

Conserva la propiedad de clientes y locales; el mapa los obtiene mediante su API.

Mapa CRM · composición

Consulta puntos de ruta en la API de tracking, visitas/pedidos/actividades en svc-fuerza-ventas y clientes/locales en svc-clientes.

Una ruta puede relacionarse con muchas visitas por tracking_session_id. Cada API autoriza bajo el contexto de empresa correspondiente.

Sin acceso directo a bases de datos y sin copias de datos comerciales a tracking.

Contratos ilustrativos de tracking

Propuestos para discusión; no son endpoints aprobados.

Visitas: el check-in/check-out se envía de inmediato a la API propietaria de svc-fuerza-ventas. No se documentó una ruta HTTP para esa operación, por lo que no se inventa una URL.

Volumen y costo de transporte

Estimación para un turno activo de 8 horas por dispositivo.

2.880 puntos10 s de muestreo durante 8 horas.
≈240 solicitudesLotes de 2 min con muestreo continuo de 10 s (12 puntos por lote).
≈91,7 % menosSolicitudes HTTP frente a 2.880 envíos individuales, no puntos almacenados.

En reposo, 30–60 s produce aproximadamente 2–4 puntos por lote de 2 min y reduce las muestras. Los lotes reducen solicitudes, no el almacenamiento de puntos ni la energía del muestreo GPS. El retraso de hasta 2 min en la frescura del mapa es un intercambio propuesto para historial, no un SLA de tiempo real aprobado.