51d78bacf4
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.
143 lines
4.0 KiB
Markdown
143 lines
4.0 KiB
Markdown
# 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.
|