e59aa2a742
## Backend Changes - Add new API endpoints: combustible, pois, mantenimiento, video, configuracion - Fix vehiculos endpoint to return paginated response with items array - Add /vehiculos/all endpoint for non-paginated list - Add /geocercas/all endpoint - Add /alertas/configuracion GET/PUT endpoints - Add /viajes/activos and /viajes/iniciar endpoints - Add /reportes/stats, /reportes/templates, /reportes/preview endpoints - Add /conductores/all and /conductores/disponibles endpoints - Update router.py to include all new modules ## Frontend Changes - Fix authentication token handling (snake_case vs camelCase) - Update vehiculosApi.listAll to use /vehiculos/all - Fix FuelGauge component usage in Combustible page - Fix chart component exports (named + default exports) - Update API client for proper token refresh ## Infrastructure - Rename services from ADAN to ATLAS - Configure Cloudflare tunnel for atlas.consultoria-as.com - Update systemd service files - Configure PostgreSQL with TimescaleDB - Configure Redis, Mosquitto, Traccar, MediaMTX ## Documentation - Update installation guides - Update API reference - Rename all ADAN references to ATLAS Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
6.7 KiB
6.7 KiB
Manual del Conductor - App ATLAS
Guia completa para usar la aplicacion movil de ATLAS.
Instalacion de la App
Android
- Abrir Play Store
- Buscar "ATLAS Conductor"
- Instalar la aplicacion
- Abrir la app
iPhone
- Abrir App Store
- Buscar "ATLAS Conductor"
- Instalar la aplicacion
- Abrir la app
Primer Inicio de Sesion
Obtener Codigo de Acceso
Tu administrador te proporcionara:
- Tu numero de telefono registrado
- Un codigo de acceso de 6 digitos
Iniciar Sesion
- Abrir la app
- Ingresar tu numero de telefono
- Ingresar el codigo de 6 digitos
- Tocar Ingresar
Permisos Necesarios
La app te pedira permisos. Es importante aceptarlos todos:
| Permiso | Para que se usa |
|---|---|
| Ubicacion (siempre) | Enviar tu posicion aunque la app este cerrada |
| Notificaciones | Recibir mensajes del administrador |
| Camara | Tomar fotos de tickets (opcional) |
IMPORTANTE: Sin el permiso de ubicacion "siempre", la app no puede rastrear tu posicion correctamente.
Pantalla Principal
Al abrir la app veras:
Estado del Vehiculo
- Nombre del vehiculo asignado
- Estado de conexion GPS (verde = enviando)
- Placa
Boton de Viaje
- INICIAR VIAJE: Toca para comenzar un viaje
- EN VIAJE: Muestra que estas en ruta
Resumen del Dia
- Kilometros recorridos hoy
- Tiempo en ruta
- Numero de viajes
- Tu score de eficiencia
Iniciar un Viaje
- En la pantalla principal, toca INICIAR VIAJE
- Confirma el inicio
- La app comenzara a registrar tu recorrido
Durante el viaje:
- Tu ubicacion se envia cada 10 segundos
- El administrador puede ver tu posicion en tiempo real
- Se registran velocidad, paradas y ruta
Durante el Viaje
Ver el Mapa
La pantalla de viaje muestra:
- Tu ubicacion actual (punto azul)
- Tu ruta recorrida (linea)
- Proxima parada si hay ruta asignada
Registrar una Parada
Cuando hagas una parada:
- Toca PARADA
- Selecciona el tipo:
- Comida/Descanso
- Carga de combustible
- Entrega a cliente
- Problema mecanico
- Trafico
- Otro
- Agrega notas si es necesario
- Toca CONFIRMAR
La parada queda registrada con:
- Hora de inicio
- Ubicacion
- Tipo de parada
Cuando reanudes, toca CONTINUAR VIAJE.
Cargar Combustible
Cuando cargues combustible:
- Durante una parada, selecciona Carga de combustible
- O desde el menu, toca Combustible
- Ingresa los datos:
- Litros: Cantidad cargada
- Precio por litro: Costo
- Odometro: Kilometraje actual
- Estacion: Nombre (opcional)
- Toca FOTO para fotografiar el ticket
- Toca GUARDAR
Esto ayuda al administrador a:
- Calcular el rendimiento del vehiculo
- Llevar control de gastos
- Detectar consumos anomalos
Finalizar Viaje
Cuando llegues a tu destino final:
- Toca FINALIZAR VIAJE
- Confirma la finalizacion
- Se guardara el resumen:
- Distancia total
- Tiempo de viaje
- Paradas realizadas
Mensajes
Ver Mensajes
- Toca el icono de mensajes o la notificacion
- Veras la lista de mensajes del administrador
- Toca un mensaje para leerlo completo
Los mensajes no leidos aparecen con punto rojo
Tipos de mensajes comunes:
- Cambios de ruta
- Instrucciones especiales
- Recordatorios
- Avisos importantes
Emergencia (SOS)
En caso de emergencia:
- Toca el boton EMERGENCIA o SOS
- Manten presionado por 3 segundos
- Se enviara automaticamente:
- Tu ubicacion exacta
- Alerta al administrador
- Marca de tiempo
El administrador recibira una notificacion inmediata.
Cuando usar el SOS:
- Accidente
- Robo o asalto
- Emergencia medica
- Vehiculo descompuesto en zona peligrosa
- Cualquier situacion de peligro
Contacto de emergencia
La app muestra el numero de telefono de emergencia de tu empresa. Puedes tocarlo para llamar directamente.
Mi Perfil
Ver mis Estadisticas
- Toca Perfil en la barra inferior
- Veras:
- Tu score de eficiencia (1-5 estrellas)
- Km recorridos este mes
- Viajes completados
- Porcentaje de entregas a tiempo
Que afecta mi Score
| Positivo | Negativo |
|---|---|
| Entregas a tiempo | Excesos de velocidad |
| Conduccion suave | Frenados bruscos |
| Respetar limites | Aceleraciones fuertes |
| Registrar paradas | Desvios de ruta |
Configuracion de la App
Ajustes disponibles
- Toca Perfil > Configuracion
| Opcion | Descripcion |
|---|---|
| Notificaciones | Activar/desactivar alertas |
| Tema | Claro u oscuro |
| Sonidos | Sonidos de notificacion |
| Idioma | Espanol/Ingles |
Permisos de Ubicacion
Si tienes problemas con el GPS:
- Ir a Configuracion del telefono
- Buscar la app ATLAS
- Tocar Permisos
- Asegurar que Ubicacion este en Siempre permitir
Uso sin Conexion a Internet
La app funciona aunque no tengas internet:
- Tu ubicacion se sigue registrando
- Los datos se guardan en el telefono
- Cuando vuelvas a tener conexion, se envian automaticamente
Maximo almacenamiento offline: 1000 ubicaciones (~3 horas de viaje)
Consejos para Mejor Funcionamiento
Bateria
La app usa aproximadamente 5% de bateria por hora. Para optimizar:
- Mantener el telefono cargado en el vehiculo
- No cerrar la app manualmente
- No usar ahorradores de bateria que cierren apps
GPS
Para mejor precision:
- Colocar el telefono donde vea el cielo (parabrisas)
- No cubrir el telefono
- Mantener GPS activado
Datos Moviles
Consumo aproximado: 5 MB por dia de uso continuo.
Preguntas Frecuentes
La app no envia mi ubicacion
- Verificar permiso de ubicacion "Siempre"
- Verificar que GPS este activado
- Verificar conexion a internet
- Reiniciar la app
No recibo mensajes
- Verificar permiso de notificaciones
- Verificar que la app no este en ahorro de bateria
- Verificar conexion a internet
El boton de viaje no aparece
Puede que no tengas un vehiculo asignado. Contacta a tu administrador.
Olvide mi codigo de acceso
Contacta a tu administrador para que genere un nuevo codigo.
Como cambio de vehiculo
Tu administrador debe reasignarte desde el sistema web.
Soporte
Si tienes problemas con la app:
- Intenta reiniciar la app
- Verifica tu conexion a internet
- Contacta a tu administrador
Resumen Rapido
| Accion | Como hacerlo |
|---|---|
| Iniciar viaje | Pantalla principal > INICIAR VIAJE |
| Registrar parada | Durante viaje > PARADA |
| Cargar combustible | Durante parada > Combustible |
| Finalizar viaje | Durante viaje > FINALIZAR |
| Ver mensajes | Icono mensajes o notificacion |
| Emergencia | Boton SOS (mantener 3 seg) |
| Ver estadisticas | Perfil |