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
412
docs/guias/usuario-admin.md
Normal file
412
docs/guias/usuario-admin.md
Normal file
@@ -0,0 +1,412 @@
|
||||
# Manual del Administrador
|
||||
|
||||
Guia completa para administrar el sistema FlotillasGPS.
|
||||
|
||||
## Acceso al Sistema
|
||||
|
||||
### Iniciar Sesion
|
||||
|
||||
1. Abrir `https://flotillas.tudominio.com` en el navegador
|
||||
2. Ingresar email y contrasena
|
||||
3. Click en "Ingresar"
|
||||
|
||||
### Cambiar Contrasena
|
||||
|
||||
1. Click en tu nombre (esquina superior derecha)
|
||||
2. Seleccionar "Configuracion"
|
||||
3. En la seccion "Seguridad", click "Cambiar contrasena"
|
||||
4. Ingresar contrasena actual y nueva
|
||||
5. Click "Guardar"
|
||||
|
||||
---
|
||||
|
||||
## Dashboard Principal
|
||||
|
||||
El dashboard muestra un resumen de tu flota:
|
||||
|
||||
### KPIs Principales
|
||||
|
||||
- **Total Vehiculos**: Cantidad de vehiculos registrados
|
||||
- **En Ruta**: Vehiculos actualmente en movimiento
|
||||
- **Detenidos**: Vehiculos detenidos (motor encendido)
|
||||
- **Offline**: Vehiculos sin conexion
|
||||
- **Alertas**: Alertas pendientes de atencion
|
||||
|
||||
### Mapa Resumen
|
||||
|
||||
Muestra la ubicacion de todos los vehiculos. Click en un vehiculo para ver detalles.
|
||||
|
||||
### Alertas Recientes
|
||||
|
||||
Ultimas alertas generadas. Click en "Ver todas" para ir al centro de alertas.
|
||||
|
||||
### Actividad Reciente
|
||||
|
||||
Timeline de eventos del dia: viajes iniciados, entregas, cargas de combustible, etc.
|
||||
|
||||
---
|
||||
|
||||
## Gestion de Vehiculos
|
||||
|
||||
### Agregar Vehiculo
|
||||
|
||||
1. Ir a **Flota** > **Vehiculos**
|
||||
2. Click en **+ Agregar**
|
||||
3. Completar informacion:
|
||||
- **Nombre**: Identificador interno (ej: "Camion-01")
|
||||
- **Placa**: Numero de placa
|
||||
- **Marca/Modelo/Ano**: Datos del vehiculo
|
||||
- **Tipo**: Auto, Camioneta, Camion, Moto, etc.
|
||||
- **Grupo**: Asignar a un grupo (opcional)
|
||||
4. Click **Guardar**
|
||||
|
||||
### Asignar Dispositivo GPS
|
||||
|
||||
Despues de agregar el vehiculo:
|
||||
|
||||
1. En el detalle del vehiculo, ir a pestaña **Dispositivo**
|
||||
2. Click **Asignar dispositivo**
|
||||
3. Seleccionar tipo:
|
||||
- **Traccar**: GPS hardware tradicional
|
||||
- **App Movil**: Celular del conductor
|
||||
- **Meshtastic**: Dispositivo LoRa
|
||||
4. Ingresar identificador del dispositivo (IMEI o ID)
|
||||
5. Click **Guardar**
|
||||
|
||||
### Asignar Conductor
|
||||
|
||||
1. En el detalle del vehiculo, ir a pestaña **General**
|
||||
2. En "Conductor asignado", seleccionar de la lista
|
||||
3. Click **Guardar**
|
||||
|
||||
### Ver Ubicacion en Tiempo Real
|
||||
|
||||
1. Ir a **Mapa**
|
||||
2. Buscar el vehiculo en la lista lateral o en el mapa
|
||||
3. Click en el marcador para ver popup con:
|
||||
- Velocidad actual
|
||||
- Direccion aproximada
|
||||
- Estado del motor
|
||||
- Nivel de combustible (si disponible)
|
||||
|
||||
### Ver Historial de Viajes
|
||||
|
||||
1. En el detalle del vehiculo, ir a pestaña **Viajes**
|
||||
2. Seleccionar rango de fechas
|
||||
3. Click en un viaje para ver detalles
|
||||
4. Click **Replay** para reproducir el recorrido en el mapa
|
||||
|
||||
---
|
||||
|
||||
## Gestion de Conductores
|
||||
|
||||
### Agregar Conductor
|
||||
|
||||
1. Ir a **Flota** > **Conductores**
|
||||
2. Click **+ Agregar**
|
||||
3. Completar informacion:
|
||||
- Nombre y apellido
|
||||
- Telefono (usado para login en app)
|
||||
- Email (opcional)
|
||||
- Numero de licencia
|
||||
- Tipo de licencia
|
||||
- Vencimiento de licencia
|
||||
4. Click **Guardar**
|
||||
|
||||
### Generar Codigo de Acceso para App
|
||||
|
||||
1. En el detalle del conductor, click **Generar codigo**
|
||||
2. Se mostrara un codigo de 6 digitos
|
||||
3. Compartir con el conductor para que instale la app
|
||||
|
||||
### Ver Estadisticas del Conductor
|
||||
|
||||
En el detalle del conductor:
|
||||
|
||||
- **Km recorridos**: Este mes y total
|
||||
- **Score de eficiencia**: Basado en velocidad, frenados, aceleraciones
|
||||
- **Viajes completados**: Cantidad de viajes
|
||||
- **Tiempo en ruta**: Horas conduciendo
|
||||
- **Infracciones**: Excesos de velocidad, salidas de geocerca
|
||||
|
||||
---
|
||||
|
||||
## Centro de Alertas
|
||||
|
||||
### Tipos de Alertas
|
||||
|
||||
| Tipo | Severidad | Descripcion |
|
||||
|------|-----------|-------------|
|
||||
| Exceso de velocidad | Media | Vehiculo supero limite |
|
||||
| Salida de geocerca | Critica | Salio de zona permitida |
|
||||
| Entrada a geocerca restringida | Critica | Entro a zona prohibida |
|
||||
| Parada prolongada | Media | Detenido mas de X minutos |
|
||||
| Motor encendido detenido | Baja | Motor ON sin movimiento |
|
||||
| Bateria baja | Media | Bateria del GPS baja |
|
||||
| Vehiculo offline | Media | Sin señal por X minutos |
|
||||
| Frenado brusco | Baja | Desaceleracion fuerte |
|
||||
| Aceleracion brusca | Baja | Aceleracion fuerte |
|
||||
|
||||
### Atender una Alerta
|
||||
|
||||
1. Ir a **Alertas**
|
||||
2. Click en la alerta para ver detalles
|
||||
3. Revisar ubicacion en el mapa
|
||||
4. Opcionalmente, agregar una nota
|
||||
5. Click **Marcar como atendida**
|
||||
|
||||
### Configurar Reglas de Alertas
|
||||
|
||||
1. Ir a **Configuracion** > **Alertas**
|
||||
2. Ajustar parametros:
|
||||
- Velocidad maxima global
|
||||
- Tiempo de parada para alerta
|
||||
- Tiempo offline para alerta
|
||||
3. Activar/desactivar notificaciones por email
|
||||
|
||||
---
|
||||
|
||||
## Geocercas
|
||||
|
||||
Las geocercas son zonas geograficas que generan alertas cuando un vehiculo entra o sale.
|
||||
|
||||
### Crear Geocerca
|
||||
|
||||
1. Ir a **Control** > **Geocercas**
|
||||
2. Click **+ Nueva**
|
||||
3. En el mapa, dibujar la zona:
|
||||
- **Poligono**: Click en cada vertice, doble-click para cerrar
|
||||
- **Circulo**: Click en el centro, arrastrar para definir radio
|
||||
- **Rectangulo**: Click y arrastrar
|
||||
4. Configurar:
|
||||
- **Nombre**: Identificador de la zona
|
||||
- **Color**: Para visualizacion en mapa
|
||||
- **Alertar al entrar**: Si/No
|
||||
- **Alertar al salir**: Si/No
|
||||
- **Limite de velocidad**: Velocidad maxima dentro (opcional)
|
||||
- **Horario activo**: Dias y horas en que aplica
|
||||
5. Seleccionar vehiculos a los que aplica
|
||||
6. Click **Guardar**
|
||||
|
||||
### Tipos de Uso Comunes
|
||||
|
||||
- **Zona de operacion**: Alerta si el vehiculo SALE
|
||||
- **Zona restringida**: Alerta si el vehiculo ENTRA
|
||||
- **Clientes**: Detectar llegada/salida de clientes
|
||||
- **Zonas de velocidad**: Limite de velocidad en zonas escolares, etc.
|
||||
|
||||
---
|
||||
|
||||
## Video en Vivo
|
||||
|
||||
### Requisitos
|
||||
|
||||
- Camara compatible (dashcam con RTSP, DVR, camara IP)
|
||||
- Camara conectada a la red del vehiculo
|
||||
- Vehiculo con conexion de datos
|
||||
|
||||
### Agregar Camara
|
||||
|
||||
1. En el detalle del vehiculo, ir a pestaña **Video**
|
||||
2. Click **+ Agregar camara**
|
||||
3. Configurar:
|
||||
- **Nombre**: Ej. "Frontal", "Interior"
|
||||
- **Posicion**: Frontal, Trasera, Interior, etc.
|
||||
- **Tipo**: RTSP, ONVIF, etc.
|
||||
- **URL**: URL del stream (ej: rtsp://192.168.1.100/stream)
|
||||
- **Usuario/Contrasena**: Si requiere autenticacion
|
||||
4. Click **Probar conexion**
|
||||
5. Si funciona, click **Guardar**
|
||||
|
||||
### Ver Video en Vivo
|
||||
|
||||
1. Ir a **Video** > **En Vivo**
|
||||
2. Seleccionar layout (1, 2x2, 3x3, 4x4)
|
||||
3. Click en una celda para seleccionar camara
|
||||
4. Controles disponibles:
|
||||
- **Pantalla completa**: Maximizar camara
|
||||
- **Captura**: Tomar foto
|
||||
- **Grabar**: Iniciar grabacion manual
|
||||
|
||||
### Ver Grabaciones
|
||||
|
||||
1. Ir a **Video** > **Grabaciones**
|
||||
2. Filtrar por:
|
||||
- Vehiculo
|
||||
- Camara
|
||||
- Fecha y hora
|
||||
- Tipo (continua, evento, manual)
|
||||
3. Click en una grabacion para reproducir
|
||||
4. Descargar si es necesario
|
||||
|
||||
---
|
||||
|
||||
## Reportes
|
||||
|
||||
### Generar Reporte
|
||||
|
||||
1. Ir a **Reportes**
|
||||
2. Seleccionar tipo:
|
||||
- **Recorridos**: Km, tiempos, rutas
|
||||
- **Combustible**: Consumo, cargas, rendimiento
|
||||
- **Conductores**: Desempeno, infracciones
|
||||
- **Alertas**: Resumen de incidentes
|
||||
- **Mantenimiento**: Servicios realizados y pendientes
|
||||
- **Ejecutivo**: Resumen general
|
||||
3. Configurar parametros:
|
||||
- Periodo (hoy, semana, mes, personalizado)
|
||||
- Vehiculos (todos o seleccion)
|
||||
- Formato (PDF, Excel, CSV)
|
||||
4. Click **Generar**
|
||||
5. Descargar cuando este listo
|
||||
|
||||
### Programar Reportes Automaticos
|
||||
|
||||
1. Ir a **Reportes** > **Programados**
|
||||
2. Click **+ Programar**
|
||||
3. Seleccionar tipo y parametros
|
||||
4. Configurar frecuencia:
|
||||
- Diario (hora)
|
||||
- Semanal (dia y hora)
|
||||
- Mensual (dia del mes)
|
||||
5. Ingresar emails de destinatarios
|
||||
6. Click **Guardar**
|
||||
|
||||
---
|
||||
|
||||
## Mantenimiento
|
||||
|
||||
### Tipos de Mantenimiento
|
||||
|
||||
Configurar en **Configuracion** > **Tipos de Mantenimiento**:
|
||||
|
||||
- Cambio de aceite (cada X km o X dias)
|
||||
- Rotacion de llantas
|
||||
- Revision de frenos
|
||||
- Afinacion
|
||||
- Revision general
|
||||
|
||||
### Programar Mantenimiento
|
||||
|
||||
1. En detalle del vehiculo, ir a pestaña **Mantenimiento**
|
||||
2. Click **+ Programar**
|
||||
3. Seleccionar tipo de servicio
|
||||
4. Ingresar:
|
||||
- Fecha programada o Km programado
|
||||
- Taller/Proveedor
|
||||
- Costo estimado
|
||||
- Notas
|
||||
5. Click **Guardar**
|
||||
|
||||
### Registrar Servicio Realizado
|
||||
|
||||
1. En el mantenimiento programado, click **Completar**
|
||||
2. Ingresar:
|
||||
- Fecha real
|
||||
- Odometro actual
|
||||
- Costo real
|
||||
- Notas del servicio
|
||||
- Adjuntar factura (opcional)
|
||||
3. Click **Guardar**
|
||||
|
||||
El sistema programara automaticamente el siguiente servicio segun los intervalos configurados.
|
||||
|
||||
---
|
||||
|
||||
## Combustible
|
||||
|
||||
### Registrar Carga
|
||||
|
||||
Los conductores pueden registrar cargas desde la app. Tambien puedes hacerlo manualmente:
|
||||
|
||||
1. En detalle del vehiculo, ir a pestaña **Combustible**
|
||||
2. Click **+ Registrar carga**
|
||||
3. Ingresar:
|
||||
- Litros
|
||||
- Precio por litro
|
||||
- Odometro
|
||||
- Estacion (opcional)
|
||||
4. Click **Guardar**
|
||||
|
||||
### Ver Consumo y Rendimiento
|
||||
|
||||
En la pestaña **Combustible** del vehiculo:
|
||||
|
||||
- Grafico de consumo mensual
|
||||
- Rendimiento promedio (km/L)
|
||||
- Comparativa con otros vehiculos
|
||||
- Historial de cargas
|
||||
|
||||
---
|
||||
|
||||
## Mensajes a Conductores
|
||||
|
||||
### Enviar Mensaje
|
||||
|
||||
1. En detalle del conductor, click **Enviar mensaje**
|
||||
2. O ir a **Comunicacion** > **Mensajes**
|
||||
3. Seleccionar conductor(es)
|
||||
4. Escribir mensaje
|
||||
5. Click **Enviar**
|
||||
|
||||
El conductor recibira notificacion push en la app.
|
||||
|
||||
### Ver Respuestas
|
||||
|
||||
Los mensajes y respuestas aparecen como conversacion en el detalle del conductor.
|
||||
|
||||
---
|
||||
|
||||
## Configuracion del Sistema
|
||||
|
||||
### General
|
||||
|
||||
- **Zona horaria**: Importante para reportes correctos
|
||||
- **Unidades**: Kilometros/Millas, Litros/Galones
|
||||
- **Moneda**: Para costos de combustible y mantenimiento
|
||||
|
||||
### Alertas
|
||||
|
||||
- Velocidad maxima global
|
||||
- Tiempo de parada para alerta
|
||||
- Tiempo offline para alerta
|
||||
- Notificaciones por email
|
||||
|
||||
### Retencion de Datos
|
||||
|
||||
- Ubicaciones detalladas: X dias
|
||||
- Videos: X dias
|
||||
- Alertas: X dias
|
||||
|
||||
---
|
||||
|
||||
## Backup y Restauracion
|
||||
|
||||
### Backup Manual
|
||||
|
||||
```bash
|
||||
ssh admin@servidor
|
||||
/opt/flotillas/scripts/backup.sh
|
||||
```
|
||||
|
||||
Los backups se guardan en `/opt/flotillas/backups/`
|
||||
|
||||
### Restaurar Backup
|
||||
|
||||
```bash
|
||||
/opt/flotillas/scripts/restore.sh /opt/flotillas/backups/db_20260121.sql.gz
|
||||
```
|
||||
|
||||
### Backups Automaticos
|
||||
|
||||
Se ejecutan diariamente a las 3:00 AM. Se mantienen los ultimos 7 dias.
|
||||
|
||||
---
|
||||
|
||||
## Soporte
|
||||
|
||||
Para problemas tecnicos:
|
||||
|
||||
1. Revisar [Solucion de Problemas](troubleshooting.md)
|
||||
2. Revisar logs: `journalctl -u flotillas-api -f`
|
||||
3. Contactar soporte tecnico
|
||||
Reference in New Issue
Block a user