App Driver para conductores

Alcance

WheelLab Driver es la herramienta de trabajo de los conductores. Muestra las recogidas y entregas asignadas en orden de ruta, permite escanear el QR de cada llanta, inspeccionarla con fotos, recoger la firma y registrar incidencias o notas de voz. Si se pierde la cobertura, las acciones se guardan y se envían al volver, sin duplicarse. La ubicación solo se comparte mientras el conductor está en servicio, para que el taller y el cliente vean su llegada. La app está en prueba cerrada en Google Play; la versión 1.1.0, revisada contra el CRM actual y probada de punta a punta, está preparada para subir.

Funciones principales

• Ruta del día. Recogidas y entregas asignadas en el orden de ruta que optimiza el CRM, con dirección, contacto e instrucciones de cada parada, apertura directa en la app de navegación y un modo conducción que avisa al llegar.
• Recogida con QR, inspección y firma. El conductor escanea el QR de cada llanta, registra los daños de cada una con fotos y recoge el nombre y la firma de quien entrega. La llegada al taller se confirma con el mismo escáner y se puede deshacer durante cinco segundos.
• Entrega con prueba de servicio. Al entregar se registran receptor, documento, fotos y firma. En las órdenes de particulares la app precarga el importe pendiente que calcula el CRM y permite registrar el cobro si se hace en ese momento.
• Fotos selladas. Cada foto lleva grabada una marca con ciudad, fecha y hora, precisión del GPS y número de orden, y la posición se guarda junto a la foto y la firma. Si no hay GPS, la foto se sube igualmente sin la marca de posición.
• Trabajo sin cobertura. La jornada y el detalle de cada orden se guardan en el móvil. Lo que se hace sin red espera en una cola que se envía al recuperar la conexión sin duplicar nada; lo que falla de forma definitiva se puede reintentar o descartar.
• Ubicación solo en servicio. La ubicación se comparte únicamente con la jornada activa y una notificación fija «En servicio». Se envía cada 5 segundos en marcha o al moverse más de 25 metros, y la app nunca pide el permiso de ubicación permanente.
• Chat, incidencias y avisos. Chat por orden con el taller y el partner, con fotos; notas de voz e incidencias con fotos desde la recogida o la entrega. Las asignaciones nuevas llegan como notificación urgente y, al tocarla, abren la orden.
• Acceso con PIN y biometría. Entrada con teléfono y PIN, con huella o reconocimiento facial comprobados en el propio dispositivo. Tras varios PIN erróneos el servidor bloquea el acceso durante 15 minutos, y la sesión se renueva sola sin volver a pedir el PIN.

Arquitectura

App Flutter

Jornada, recogida, entrega, inspección, incidencias, chat y estadísticas · go_router y estado por pantalla · Escáner QR con mobile_scanner · Mapas con flutter_map y Google Static Maps

Servicios en el móvil

Cliente HTTP dio con renovación de token y reintentos · Cola de acciones persistente con UUID como clave de idempotencia · Caché de la jornada y de la ruta · Servicio en primer plano con un isolate que envía el GPS

Paquete compartido

wheellab_shared, común con la app Partner · Tokens de marca, temas claro y oscuro y animaciones · Interceptor de reintentos y utilidades JWT

API del CRM

Rutas /driver para jornada, recogidas, entregas, inspecciones e incidencias · Recepción de la posición en /tracking/location · Chat por WebSocket · Ruta optimizada con Google Routes API

Servicios externos

Firebase Cloud Messaging y Crashlytics · Google Play, pista de prueba cerrada

Tecnologías

Backend

JWT

Móvil

Flutter, Dart, Firebase, Google Play

Infraestructura

GitHub Actions

Integraciones

Google Maps Platform, OpenStreetMap

Resultados medidos

• 28 de 28 funciones del conductor superadas en la prueba de punta a punta, con push, llegada al taller y entrega en producción. Fuente: Matriz E2E de la auditoría de las apps (docs/auditoria-2026-10/E2E_MATRIZ.md) · 2026-10-21