413 lines
9.8 KiB
Markdown
413 lines
9.8 KiB
Markdown
# Manual del Administrador
|
|
|
|
Guia completa para administrar el sistema ADAN.
|
|
|
|
## Acceso al Sistema
|
|
|
|
### Iniciar Sesion
|
|
|
|
1. Abrir `https://adan.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/adan/scripts/backup.sh
|
|
```
|
|
|
|
Los backups se guardan en `/opt/adan/backups/`
|
|
|
|
### Restaurar Backup
|
|
|
|
```bash
|
|
/opt/adan/scripts/restore.sh /opt/adan/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 adan-api -f`
|
|
3. Contactar soporte tecnico
|