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>
333 lines
6.7 KiB
Markdown
333 lines
6.7 KiB
Markdown
# Manual del Conductor - App ATLAS
|
|
|
|
Guia completa para usar la aplicacion movil de ATLAS.
|
|
|
|
## Instalacion de la App
|
|
|
|
### Android
|
|
|
|
1. Abrir Play Store
|
|
2. Buscar "ATLAS Conductor"
|
|
3. Instalar la aplicacion
|
|
4. Abrir la app
|
|
|
|
### iPhone
|
|
|
|
1. Abrir App Store
|
|
2. Buscar "ATLAS Conductor"
|
|
3. Instalar la aplicacion
|
|
4. 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
|
|
|
|
1. Abrir la app
|
|
2. Ingresar tu numero de telefono
|
|
3. Ingresar el codigo de 6 digitos
|
|
4. 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
|
|
|
|
1. En la pantalla principal, toca **INICIAR VIAJE**
|
|
2. Confirma el inicio
|
|
3. 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:
|
|
|
|
1. Toca **PARADA**
|
|
2. Selecciona el tipo:
|
|
- Comida/Descanso
|
|
- Carga de combustible
|
|
- Entrega a cliente
|
|
- Problema mecanico
|
|
- Trafico
|
|
- Otro
|
|
3. Agrega notas si es necesario
|
|
4. Toca **CONFIRMAR**
|
|
|
|
La parada queda registrada con:
|
|
- Hora de inicio
|
|
- Ubicacion
|
|
- Tipo de parada
|
|
|
|
Cuando reanudes, toca **CONTINUAR VIAJE**.
|
|
|
|
---
|
|
|
|
## Cargar Combustible
|
|
|
|
Cuando cargues combustible:
|
|
|
|
1. Durante una parada, selecciona **Carga de combustible**
|
|
2. O desde el menu, toca **Combustible**
|
|
3. Ingresa los datos:
|
|
- **Litros**: Cantidad cargada
|
|
- **Precio por litro**: Costo
|
|
- **Odometro**: Kilometraje actual
|
|
- **Estacion**: Nombre (opcional)
|
|
4. Toca **FOTO** para fotografiar el ticket
|
|
5. 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:
|
|
|
|
1. Toca **FINALIZAR VIAJE**
|
|
2. Confirma la finalizacion
|
|
3. Se guardara el resumen:
|
|
- Distancia total
|
|
- Tiempo de viaje
|
|
- Paradas realizadas
|
|
|
|
---
|
|
|
|
## Mensajes
|
|
|
|
### Ver Mensajes
|
|
|
|
1. Toca el icono de mensajes o la notificacion
|
|
2. Veras la lista de mensajes del administrador
|
|
3. 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:
|
|
|
|
1. Toca el boton **EMERGENCIA** o **SOS**
|
|
2. **Manten presionado por 3 segundos**
|
|
3. 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
|
|
|
|
1. Toca **Perfil** en la barra inferior
|
|
2. 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
|
|
|
|
1. 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:
|
|
|
|
1. Ir a **Configuracion** del telefono
|
|
2. Buscar la app **ATLAS**
|
|
3. Tocar **Permisos**
|
|
4. 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
|
|
|
|
1. Verificar permiso de ubicacion "Siempre"
|
|
2. Verificar que GPS este activado
|
|
3. Verificar conexion a internet
|
|
4. Reiniciar la app
|
|
|
|
### No recibo mensajes
|
|
|
|
1. Verificar permiso de notificaciones
|
|
2. Verificar que la app no este en ahorro de bateria
|
|
3. 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:
|
|
|
|
1. Intenta reiniciar la app
|
|
2. Verifica tu conexion a internet
|
|
3. 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 |
|