ATLAS/docs/guias/usuario-admin.md

# 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