# FlotillasGPS - Sistema de Monitoreo de Flotillas

Sistema completo de monitoreo de flotillas vehiculares con rastreo GPS en tiempo real, video streaming, y app movil para conductores.

## Caracteristicas Principales

- **Rastreo GPS en Tiempo Real**: Actualizacion cada 10 segundos con visualizacion en mapa
- **Video Streaming**: Camaras en vivo con WebRTC/HLS, grabacion de eventos
- **App Movil para Conductores**: Envio de ubicacion, registro de paradas, combustible
- **Sistema de Alertas**: Exceso de velocidad, geocercas, paradas prolongadas
- **Soporte Meshtastic**: Rastreo en zonas sin cobertura celular (experimental)
- **Reportes Automatizados**: PDF/Excel de recorridos, combustible, conductores
- **Mantenimiento Predictivo**: Programacion y recordatorios de servicios

## Arquitectura

```
                    Cloudflare Tunnel (HTTPS)
                           |
        +------------------+------------------+
        |                                     |
   Frontend (React)                    Backend (FastAPI)
        |                                     |
        +------------------+------------------+
                           |
              +------------+------------+
              |            |            |
         PostgreSQL     Redis      MediaMTX
         TimescaleDB              (Video)
              |
         +----+----+
         |         |
      Traccar    MQTT
       (GPS)   (Meshtastic)
```

## Stack Tecnologico

| Componente | Tecnologia |
|------------|------------|
| Backend | Python 3.11 + FastAPI |
| Frontend | React 18 + TypeScript + TailwindCSS |
| App Movil | React Native |
| Base de Datos | PostgreSQL 15 + TimescaleDB |
| Cache | Redis |
| GPS Server | Traccar |
| Video | MediaMTX |
| Mensajeria | Mosquitto MQTT |

## Requisitos del Sistema

### Minimos (1-10 vehiculos)
- CPU: 2 cores
- RAM: 4 GB
- Disco: 40 GB SSD + 500 GB HDD (videos)

### Recomendados (10-20 vehiculos)
- CPU: 4 cores
- RAM: 8 GB
- Disco: 60 GB SSD + 2 TB HDD (videos)

## Instalacion Rapida

```bash
# Clonar repositorio
git clone https://git.consultoria-as.com/tu-usuario/flotillas-gps.git
cd flotillas-gps

# Ejecutar instalador
sudo ./deploy/scripts/install.sh
```

El script instalara y configurara automaticamente todos los componentes.

## Estructura del Proyecto

```
flotillas-gps/
├── backend/          # API FastAPI
├── frontend/         # Dashboard React
├── mobile/           # App React Native
├── deploy/           # Scripts de despliegue
│   ├── scripts/      # install.sh, backup.sh, etc.
│   ├── services/     # Archivos systemd
│   └── ...
└── docs/             # Documentacion
    ├── guias/        # Guias de usuario
    └── arquitectura/ # Documentacion tecnica
```

## Documentacion

- [Guia de Instalacion](docs/guias/instalacion.md)
- [Configuracion del Sistema](docs/guias/configuracion.md)
- [Manual del Administrador](docs/guias/usuario-admin.md)
- [Manual del Conductor](docs/guias/usuario-conductor.md)
- [Referencia de API](docs/guias/api-reference.md)
- [Configuracion Meshtastic](docs/guias/meshtastic.md)
- [Configuracion de Video](docs/guias/video-streaming.md)
- [Solucion de Problemas](docs/guias/troubleshooting.md)

## Accesos por Defecto

Despues de la instalacion:

- **Dashboard**: https://tu-dominio.com
- **API Docs**: https://tu-dominio.com/api/docs
- **GPS Port**: TCP 5055

Las credenciales se generan durante la instalacion y se muestran al final.

## Comandos Utiles

```bash
# Ver estado de servicios
systemctl status flotillas-api flotillas-web traccar mediamtx

# Ver logs
journalctl -u flotillas-api -f

# Backup manual
/opt/flotillas/scripts/backup.sh

# Actualizar
/opt/flotillas/scripts/update.sh
```

## Seguridad

- Autenticacion JWT con refresh tokens
- Cloudflare WAF y DDoS protection
- Firewall UFW (solo puerto 5055 abierto)
- Datos sensibles encriptados
- Logs de auditoria

## Licencia

Propietario - Todos los derechos reservados

## Soporte

Para soporte tecnico, contactar al administrador del sistema.