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.

README.md

@@ -0,0 +1,142 @@
+# 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.