App del conductor

La app Android de Recua es el sitio donde el conductor opera durante el dia: ve sus portes, marca llegadas, recoge firmas y sube fotos. Esta diseñada para usarse con guantes, sol directo y a velocidad de camión — no para sentarse a leer documentos.

Descargar la app

La app esta en recua.app/android (link directo al APK firmado) o en la Play Store cuando este publicada. En empresas con flota propia, los conductores la instalan una sola vez en su movil personal o de empresa. No necesita Google Account.

Entrar la primera vez

Cada conductor entra con su código y su PIN de 4 a 6 dígitos. Estos los das tu desde Conductores en el admin. Mira Conductores para crear el alta.

Tras 5 intentos fallidos, la app bloquea ese código durante 15 minutos. El mensaje en pantalla indica cuanto tiempo queda. Si un conductor olvida el PIN, entra al admin y en su ficha pulsa "Restablecer PIN" — se genera uno nuevo que le entregas en persona.

Hoy: la jornada de un solo vistazo

Al entrar la app aterriza en Hoy. Es el feed vertical de portes pendientes y en curso del dia, en orden cronologico.

• El porte activo (cargando / en transito / descargando) aparece expandido arriba con el siguiente paso del flujo guiado como CTA.
• Los siguientes portes del dia se ven como filas compactas debajo: hora de carga, ciudad origen → destino y estado.
• La barra superior pequeña en mono dice donde estas: "Próxima carga · Mercabarna" o "En ruta · Carmona".

Si la oficina asigna un porte por teléfono mientras el conductor mira Hoy, basta deslizar hacia abajo para refrescar.

El flujo guiado del porte

Cada porte sigue una secuencia. La app muestra un único CTA con el siguiente paso, no un panel lleno de botones. La transicion entre estados deja sello de hora, GPS y evento para la oficina.

• Asignado → "He llegado a carga"
• Cargando → firma del cargador → "Marcar en ruta"
• En ruta → "He llegado a descarga"
• Descargando → firma del destinatario → "Marcar entregado"
• Entregado → POD enviado automaticamente al cliente

El conductor solo decide una cosa por momento. No tiene que recordar si firmar antes o despues de empezar la carga; la app le pide la firma del cargador en el sitio correcto.

Pasar el movil al cliente para firmar

Cuando llega el momento de firmar el cargador o el destinatario, la app entra automaticamente en modo cliente:

• Cabecera con marca RECUA · CMR-X para que el cliente sepa que no es un chat ni una nota suelta.
• Titular grande en Fraunces: "Confirma la recepción de la mercancía".
• Resumen del porte (de quien a quien, mercancia).
• Canvas de firma grande.
• Un solo boton azafrán: "Confirmar firma".

El conductor entrega el movil. El cliente firma. Vuelve al conductor con el porte ya actualizado.

Foto, reserva e incidencia

Estas acciones viven en un menú de tres puntos junto al CTA, no como botones aparte. Solo se accede a ellas cuando hace falta — no estorban al flujo principal.

• Hacer foto: para documentar el estado de la mercancia, daños visibles en la carga o el albaran del cliente.
• Anotar reserva (art. 8 CMR): si el conductor recoge mercancia visiblemente dañada o sin cumplir condiciones, lo anota como reserva firmada. Esto protege al transportista.
• Registrar incidencia: para eventos que requieren atencion de oficina (averia, retencion en aduana, accidente). El admin recibe notificacion.

Cuando no hay red

La app sigue funcionando sin red. Cada evento (llegada, firma, foto, reserva) se mete en una cola local y se sube cuando recupera señal. Una insignia pequeña en la cabecera muestra cuántos envíos quedan pendientes.

El conductor no tiene que hacer nada — la sincronizacion es automatica.

Mapa y navegacion turn-by-turn

Cada porte tiene un boton "Abrir en el mapa" que arranca un navegador turn-by-turn embebido en la propia app, sin abrir Waze ni Google Maps. Lo que verá el conductor:

• Ruta truck calculada por Valhalla (motor open-source corriendo en nuestra infra self-host, no en una instancia publica compartida). Respeta restricciones de altura, peso, anchura y longitud del vehiculo si las tienes definidas en Vehiculos. Si la ficha del vehiculo no tiene dimensiones, usa los defaults legales españoles (4 m alto, 2.55 m ancho, 16.5 m largo, 40 t).
• Banner superior con la proxima maniobra: icono (gire a la derecha, salida de rotonda, etc.), distancia ("EN 200 M") y texto ("Tome la salida hacia A-7").
• Banner secundario mas pequeño con la subsiguiente maniobra para que anticipes el proximo giro antes de hacer el actual.
• Voz en español que anuncia las maniobras cuando faltan entre 100 y 500 m. El conductor puede silenciarla con el boton altavoz si prefiere conducir sin sonido.
• Snap-to-road para que la flecha del chofer se mueva suave por el eje de la carretera en vez de saltar con el jitter del GPS.
• Recalculo automatico si el conductor se desvia mas de 100 m durante 10 segundos sostenidos (throttle 30 s entre recalculos para no martillear el motor).
• Mapa heading-up con tilt 45° y zoom 16 mientras estas en modo seguimiento. Toca el mapa para entrar en modo libre y pan/zoom como en Google Maps; pulsa el boton de centrado para volver a seguimiento.
• Cobertura geografica: Espana y Portugal a fecha actual. Para rutas a Francia o resto de UE, el conductor recibe error y se ofrece "Abrir en Google Maps" como fallback de cortesia.

Limitaciones honestas

• OSM en España es decente pero no perfecto. Pueblos pequeños, poligonos industriales recientes y señales locales puntuales pueden no estar en el mapa. La ruta es una buena guia, no infalible. El conductor sigue siendo responsable de mirar las señales reales.
• ZBE / Zonas de Bajas Emisiones (Madrid Central, Barcelona Centro) no estan completamente codificadas en OSM. Si el vehiculo no puede entrar a un centro restringido, Valhalla puede meter por ahi.
• Sin telemática real del vehiculo: la app respeta las dimensiones de la ficha en BD. Si el conductor cambia de remolque ese dia y no se ha actualizado la ficha, las restricciones que aplique el routing pueden no coincidir con el camion real.

Si en algun momento el motor self-host no responde (caida del homelab, mantenimiento), el conductor ve un boton "Abrir en Google Maps" como fallback. Pulsa y se envia la direccion al sistema de mapas del telefono — Waze, Maps o el que tenga instalado.

Gastos

Desde el tab Yo → Gastos, el conductor puede registrar tickets de peaje, gasoil o dietas. Foto + importe + tipo. El gasto queda asociado al porte activo (si lo hay) o sin asociar para que el admin lo vincule despues.

Mas detalle en Gastos.

Problema en la app: hola@recua.app. Si es urgente (fallo en cabina), llama al telefono que tienes en el correo de bienvenida.