consultoria-as/ATLAS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
51d78bacf41cea943a646dcf6705151c10ae75a3
ATLAS/docs/guias/usuario-admin.md
FlotillasGPS Developer 51d78bacf4 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.
2026-01-21 08:18:00 +00:00

9.8 KiB
Raw Blame History

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

ssh admin@servidor
/opt/flotillas/scripts/backup.sh

Los backups se guardan en /opt/flotillas/backups/

Restaurar Backup

/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
  2. Revisar logs: journalctl -u flotillas-api -f
  3. Contactar soporte tecnico
Reference in New Issue View Git Blame Copy Permalink