ATLAS/docs/ESTADO-PROYECTO.md

Estado del Proyecto ATLAS

Ultima actualizacion: 2026-01-25 Servidor: ATLAS-GPS (192.168.10.212) Dominio: https://atlas.consultoria-as.com

---

Resumen de Instalacion

El sistema ATLAS fue instalado y configurado exitosamente con los siguientes componentes:

Servicios Activos

Servicio	Puerto	Estado	Descripcion
atlas-api	8000	✅ Activo	Backend FastAPI
Frontend (Vite)	3000	✅ Activo	React + TypeScript
PostgreSQL	5432	✅ Activo	Base de datos + TimescaleDB
Redis	6379	✅ Activo	Cache y sesiones
Traccar	5055, 8082	✅ Activo	Servidor GPS
MediaMTX	8554, 8888, 8889	✅ Activo	Streaming de video
Mosquitto	1883	✅ Activo	MQTT Broker
Cloudflared	-	✅ Activo	Tunnel a Cloudflare

Credenciales

Las credenciales se encuentran en: /root/atlas-credentials.txt

Usuario admin: admin@atlas.com
Base de datos: atlas_db

---

Cambios Realizados

Backend (FastAPI)

Nuevos Archivos Creados:

• backend/app/api/v1/combustible.py - Gestion de cargas de combustible
• backend/app/api/v1/pois.py - Puntos de interes
• backend/app/api/v1/mantenimiento.py - Gestion de mantenimientos
• backend/app/api/v1/video.py - Camaras y streaming
• backend/app/api/v1/configuracion.py - Configuracion del sistema

Endpoints Agregados:

Vehiculos:

• GET /vehiculos/all - Lista todos los vehiculos (sin paginacion)
• GET /vehiculos/fleet/stats - Estadisticas de la flota
• GET /vehiculos/ubicaciones/actuales - Ubicaciones actuales

Conductores:

• GET /conductores/all - Lista todos los conductores
• GET /conductores/disponibles - Conductores sin vehiculo asignado

Geocercas:

• GET /geocercas/all - Lista todas las geocercas activas

Alertas:

• GET /alertas/configuracion - Configuracion de alertas
• PUT /alertas/configuracion - Actualizar configuracion

Viajes:

• GET /viajes/activos - Viajes en curso
• POST /viajes/iniciar - Iniciar viaje manualmente

Reportes:

• GET /reportes/stats - Estadisticas de reportes
• GET /reportes/templates - Plantillas disponibles
• POST /reportes/preview - Previsualizar reporte
• GET /reportes/programados - Reportes programados
• POST /reportes/programar - Programar nuevo reporte

Combustible:

• GET /combustible - Listar cargas
• GET /combustible/stats - Estadisticas
• GET /combustible/{id} - Detalle de carga

POIs:

• GET /pois - Listar POIs
• GET /pois/all - Todos los POIs activos
• POST /pois - Crear POI
• GET /pois/{id} - Detalle de POI

Mantenimiento:

• GET /mantenimiento - Listar mantenimientos
• GET /mantenimiento/proximos - Proximos mantenimientos
• GET /mantenimiento/vencidos - Mantenimientos vencidos
• POST /mantenimiento - Crear mantenimiento

Video:

• GET /video/camaras - Listar camaras
• GET /video/camaras/{id} - Detalle de camara

Configuracion:

• GET /configuracion - Obtener configuracion
• PATCH /configuracion - Actualizar configuracion

Frontend (React + Vite)

Correcciones Realizadas:

1. Autenticacion (client.ts, auth.ts, types/index.ts)

   • Corregido manejo de tokens: access_token/refresh_token (snake_case)
   • El backend devuelve snake_case, el frontend esperaba camelCase

2. API de Vehiculos (vehiculos.ts)

   • listAll() ahora usa /vehiculos/all en lugar de /vehiculos
   • Esto evita el error de paginacion cuando se espera un array

3. Componentes de Graficos

   • KPICard.tsx - Corregido export (named + default)
   • FuelGauge.tsx - Corregido export
   • LineChart.tsx - Corregido export
   • BarChart.tsx - Corregido export

4. Pagina Combustible (Combustible.tsx)

   • Cambiado FuelGauge por CircularGauge (el componente correcto para size numerico)

Infraestructura

1. Servicios Systemd

   • Renombrado adan-api.service → atlas-api.service
   • Renombrado adan-web.service → atlas-web.service

2. Cloudflare Tunnel

   • Configurado para atlas.consultoria-as.com
   • Rutas: / → :3000, /api/* → :8000, /ws/* → :8000

3. Base de Datos

   • PostgreSQL 15 con TimescaleDB habilitado
   • Usuario admin creado manualmente en la tabla usuarios

---

Problemas Conocidos / Pendientes

1. WebSocket no conecta

WebSocket connection to 'wss://atlas.consultoria-as.com/ws' failed

Causa probable: El endpoint de WebSocket no esta configurado en el backend o el tunnel de Cloudflare no lo soporta correctamente.

Solucion pendiente: Verificar la configuracion de WebSocket en el backend y/o configurar WebSocket en Cloudflare.

2. Frontend en modo desarrollo

El frontend esta corriendo con vite preview en lugar de un servidor de produccion como Nginx.

Solucion recomendada:

# Instalar y configurar Nginx
sudo apt install nginx
# Copiar build a /var/www/atlas
sudo cp -r /opt/atlas/frontend/dist/* /var/www/atlas/
# Configurar Nginx como proxy

3. Pagina de Combustible

La pagina funciona pero muestra "Sin datos" porque no hay registros en la base de datos.

4. Datos de prueba

No hay datos de prueba en el sistema (vehiculos, conductores, etc.)

Para agregar datos de prueba:

cd /opt/atlas/backend
source venv/bin/activate
python -c "from app.core.database import init_db; import asyncio; asyncio.run(init_db())"

---

Comandos Utiles

Ver estado de servicios

systemctl status atlas-api atlas-frontend cloudflared traccar redis postgresql

Ver logs del API

journalctl -u atlas-api -f

Reiniciar servicios

systemctl restart atlas-api
pkill -f "vite preview" && cd /opt/atlas/frontend && nohup pnpm vite preview --host 0.0.0.0 --port 3000 &

Reconstruir frontend

cd /opt/atlas/frontend
pnpm vite build

Acceder a la base de datos

sudo -u postgres psql atlas_db

Ver credenciales

cat /root/atlas-credentials.txt

---

Archivos de Configuracion Importantes

Archivo	Descripcion
/opt/atlas/backend/.env	Variables de entorno del backend
/opt/atlas/frontend/.env	Variables de entorno del frontend
/etc/systemd/system/atlas-api.service	Servicio del API
/etc/postgresql/15/main/postgresql.conf	Config de PostgreSQL
/etc/redis/redis.conf	Config de Redis
/opt/traccar/conf/traccar.xml	Config de Traccar

---

Proximos Pasos Recomendados

1. Configurar Nginx para servir el frontend en produccion
2. Resolver problema de WebSocket
3. Agregar datos de prueba (vehiculos, conductores, dispositivos)
4. Configurar dispositivos GPS reales en Traccar
5. Configurar camaras de video
6. Configurar backups automaticos
7. Configurar SSL/HTTPS local (si se accede sin tunnel)
8. Revisar y ajustar permisos de usuario en la base de datos

---

Repositorio Git

• URL: http://192.168.10.150:3000/consultoria-as/ATLAS.git
• Branch: main
• Ultimo commit: docs: Update API reference with all new endpoints

Para continuar el desarrollo:

cd /opt/atlas
git pull origin main