FlotillasGPS - Sistema completo de monitoreo de flotillas GPS
Sistema completo para monitoreo y gestion de flotas de vehiculos con: - Backend FastAPI con PostgreSQL/TimescaleDB - Frontend React con TypeScript y TailwindCSS - App movil React Native con Expo - Soporte para dispositivos GPS, Meshtastic y celulares - Video streaming en vivo con MediaMTX - Geocercas, alertas, viajes y reportes - Autenticacion JWT y WebSockets en tiempo real Documentacion completa y guias de usuario incluidas.
This commit is contained in:
FlotillasGPS Developer
332
docs/guias/usuario-conductor.md
Normal file
332
docs/guias/usuario-conductor.md
Normal file
@@ -0,0 +1,332 @@
|
||||
# Manual del Conductor - App FlotillasGPS
|
||||
|
||||
Guia completa para usar la aplicacion movil de FlotillasGPS.
|
||||
|
||||
## Instalacion de la App
|
||||
|
||||
### Android
|
||||
|
||||
1. Abrir Play Store
|
||||
2. Buscar "FlotillasGPS Conductor"
|
||||
3. Instalar la aplicacion
|
||||
4. Abrir la app
|
||||
|
||||
### iPhone
|
||||
|
||||
1. Abrir App Store
|
||||
2. Buscar "FlotillasGPS 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 **FlotillasGPS**
|
||||
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 |
|
||||
Reference in New Issue
Block a user