consultoria-as/ATLAS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
ATLAS/docs/ESTADO-PROYECTO.md
ATLAS Admin cb08396847 docs: Add project status document for continuity 
- Document all services and their status
- List all backend endpoints added
- Document frontend fixes made
- List known issues and pending tasks
- Add useful commands reference
- Add next steps recommendations

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 04:38:55 +00:00

249 lines
7.0 KiB
Markdown
Raw Permalink Blame History

# 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:**
```bash
# 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:**
```bash
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
```bash
systemctl status atlas-api atlas-frontend cloudflared traccar redis postgresql
```
### Ver logs del API
```bash
journalctl -u atlas-api -f
```
### Reiniciar servicios
```bash
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
```bash
cd /opt/atlas/frontend
pnpm vite build
```
### Acceder a la base de datos
```bash
sudo -u postgres psql atlas_db
```
### Ver credenciales
```bash
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:
```bash
cd /opt/atlas
git pull origin main
```
Reference in New Issue View Git Blame Copy Permalink