ATLAS/README.md

ADAN - Sistema de Monitoreo de flotillas

Sistema completo de monitoreo de adan 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

# Clonar repositorio
git clone https://git.consultoria-as.com/tu-usuario/adan.git
cd adan

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

El script instalara y configurara automaticamente todos los componentes.

Estructura del Proyecto

adan/
├── 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
• Configuracion del Sistema
• Manual del Administrador
• Manual del Conductor
• Referencia de API
• Configuracion Meshtastic
• Configuracion de Video
• Solucion de Problemas

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

# Ver estado de servicios
systemctl status adan-api adan-web traccar mediamtx

# Ver logs
journalctl -u adan-api -f

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

# Actualizar
/opt/adan/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.