# INICIO RÁPIDO - CONFIGURACIÓN DE PUERTOS

**Configuración completada el:** 2025-12-05

---

## ARCHIVOS IMPORTANTES

### 1. Configuración de Puertos
📄 **`.env.ports`** - Definición centralizada de todos los puertos

### 2. Docker Compose
🐳 **`docker-compose.yml`** - Orquestación completa de servicios

### 3. Documentación
📚 **`docs/95-guias-desarrollo/PUERTOS-SERVICIOS.md`** - Guía completa

### 4. Scripts de Verificación
🔧 **`scripts/check-ports.sh`** - Verificar estado de puertos

### 5. Configuración del Proyecto
⚙️ **`orchestration/environment/PROJECT-ENV-CONFIG.yml`** - Config centralizada

---

## PUERTOS ASIGNADOS (QUICK REFERENCE)

```
┌─────────────────────────────────────────────────────────┐
│                   FRONTEND SERVICES                      │
├─────────────────────────────────────────────────────────┤
│  Frontend Web (React)          →  3100                  │
│  Frontend Admin (futuro)       →  3101                  │
│  Frontend Preview (Vite)       →  4173                  │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│                   BACKEND SERVICES                       │
├─────────────────────────────────────────────────────────┤
│  Backend API (Express)         →  4000                  │
│  Backend WebSocket             →  4001                  │
│  Backend Webhooks              →  4002                  │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│                   PYTHON SERVICES                        │
├─────────────────────────────────────────────────────────┤
│  ML Engine (FastAPI)           →  5000                  │
│  Data Service                  →  5001                  │
│  LLM Agent (futuro)            →  5002                  │
│  Portfolio Manager (futuro)    →  5003                  │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│                   INFRASTRUCTURE                         │
├─────────────────────────────────────────────────────────┤
│  PostgreSQL                    →  5432  ✓ ACTIVO        │
│  Redis                         →  6379  ✓ ACTIVO        │
└─────────────────────────────────────────────────────────┘
```

---

## COMANDOS ESENCIALES

### Verificar Estado de Puertos
```bash
bash scripts/check-ports.sh
```

### Iniciar Todo con Docker
```bash
docker-compose up -d
```

### Ver Logs
```bash
docker-compose logs -f
```

### Verificar Puertos Ocupados
```bash
ss -tuln | grep LISTEN
```

### Verificar un Puerto Específico
```bash
lsof -i :4000
```

---

## ESTADO ACTUAL

### ✅ Servicios Activos
- PostgreSQL en puerto 5432
- Redis en puerto 6379

### ⚠️ Puertos Ocupados (No usar)
- 3000 - Ya en uso por otro servicio
- 8000 - Ya en uso por otro servicio

### 🔄 Servicios Por Configurar
1. **Backend API**: Actualizar de puerto 3000 → 4000
2. **Frontend Web**: Actualizar de puerto 5173 → 3100
3. **ML Engine**: Confirmar puerto 5000
4. **Data Service**: Configurar puerto 5001

---

## PRÓXIMOS PASOS

### 1. Actualizar Backend
```bash
cd apps/backend
# Editar .env
PORT=4000
```

### 2. Actualizar Frontend
```bash
cd apps/frontend
# Editar vite.config.ts
server.port = 3100
```

### 3. Probar Docker Compose
```bash
docker-compose up -d
docker-compose logs -f
```

### 4. Verificar Conectividad
```bash
curl http://localhost:4000/health
curl http://localhost:5000/health
```

---

## URLs DE ACCESO RÁPIDO

| Servicio | URL |
|----------|-----|
| Frontend | http://localhost:3100 |
| Backend API | http://localhost:4000/api/v1 |
| Backend Health | http://localhost:4000/health |
| ML Engine Docs | http://localhost:5000/docs |
| PgAdmin | http://localhost:5050 |

---

## TROUBLESHOOTING RÁPIDO

### Puerto ya en uso
```bash
# Ver qué está usando el puerto
lsof -i :4000

# Matar proceso
kill -9 $(lsof -t -i :4000)
```

### Docker no levanta
```bash
# Ver logs
docker-compose logs backend

# Reiniciar servicio
docker-compose restart backend

# Reconstruir
docker-compose up -d --build backend
```

### Variables de entorno no cargan
```bash
# Verificar que existe .env
ls -la apps/backend/.env

# Ver variables
cat apps/backend/.env | grep PORT
```

---

## DOCUMENTACIÓN COMPLETA

Para información detallada, ver:
- **`docs/95-guias-desarrollo/PUERTOS-SERVICIOS.md`**

---

**¿Preguntas?** Revisar la documentación completa o ejecutar `bash scripts/check-ports.sh`
