---
id: "NOTA-DISCREPANCIA-PUERTOS-2025-12-08"
title: "Discrepancia de Puertos - RESUELTA"
type: "Documentation"
project: "trading-platform"
version: "2.0.0"
updated_date: "2026-01-07"
status: "RESUELTO"
---

# NOTA: Discrepancia de Puertos - RESUELTA

**Fecha Original:** 2025-12-08
**Fecha Resolución:** 2026-01-07
**Para:** DevEnv-Agent
**De:** Requirements-Analyst / Claude Code
**Urgencia:** ~~Media~~ RESUELTA
**Proyecto:** trading-platform

## RESOLUCIÓN (2026-01-07)

La discrepancia ha sido resuelta alineando todos los archivos con la fuente de verdad oficial:
- **Fuente de verdad:** `/home/isem/workspace-v1/control-plane/registries/ports.registry.yml`

### Puertos Oficiales Aplicados:
| Servicio | Puerto |
|----------|--------|
| Frontend | 3080 |
| Backend | 3081 |
| WebSocket | 3082 |
| ML Engine | 3083 |
| Data Service | 3084 |
| LLM Agent | 3085 |
| Trading Agents | 3086 |

### Archivos Actualizados:
- [x] `docker-compose.yml`
- [x] `apps/*/\*.env.example` (5 archivos)
- [x] `apps/ml-engine/config/database.yaml`
- [x] `apps/frontend/src/services/*.ts` (4 archivos)
- [x] `orchestration/inventarios/MASTER_INVENTORY.yml`

---

## Historial Original (para referencia)

---

## Descripcion del Problema

Se ha detectado una discrepancia entre la configuracion local de puertos del proyecto y la politica centralizada del workspace.

### Archivo Local: `.env.ports`

El archivo `/home/isem/workspace/projects/trading-platform/.env.ports` (fechado 2025-12-05) define:

| Servicio | Puerto Local |
|----------|--------------|
| Frontend Web | 3100 |
| Frontend Admin | 3101 |
| Backend API | 4000 |
| Backend WS | 4001 |
| ML Engine | 5000 |
| Data Service | 5001 |
| LLM Agent | 5002 |
| PostgreSQL | 5432 |
| Redis | 6379 |

### Politica Centralizada: `DEVENV-PORTS.md`

El archivo `/home/isem/workspace/core/devtools/environment/DEVENV-PORTS.md` define para trading-platform:

| Servicio | Puerto Politica |
|----------|-----------------|
| Backend | 3600 |
| Frontend | 5179 |
| Database | 5438 |
| Redis | 6385 |

---

## Impacto

1. **Documentacion inconsistente:** Los nuevos documentos de integracion (LLM, MT4, API Massive) han sido corregidos para usar la politica, pero `.env.ports` sigue con valores antiguos.

2. **Conflictos potenciales:** Si otros proyectos del workspace usan los mismos puertos (5432, 6379, 3100), habra conflictos.

3. **Confusion para desarrolladores:** No esta claro cual es la fuente de verdad.

---

## Acciones Recomendadas

### Para DevEnv-Agent:

1. **Verificar inventario de puertos** del workspace completo
2. **Decidir fuente de verdad:** DEVENV-PORTS.md o .env.ports por proyecto
3. **Actualizar `.env.ports`** del proyecto trading-platform para alinear con politica

### Mapping Propuesto:

```
Servicio Local          Puerto Antiguo → Puerto Nuevo (Politica)
============================================================
FRONTEND_WEB_PORT       3100           → 5179
BACKEND_API_PORT        4000           → 3600
ML_ENGINE_PORT          5000           → 3601
LLM_AGENT_PORT          5002           → 3602
TRADING_SERVICE_PORT    (nuevo)        → 3603
DATA_SERVICE_PORT       5001           → 3604
POSTGRES_PORT           5432           → 5438 (compartido)
REDIS_PORT              6379           → 6385
```

---

## Documentos Afectados (Ya Corregidos)

Los siguientes documentos han sido actualizados para usar la politica:

- [x] `/docs/01-arquitectura/INTEGRACION-LLM-LOCAL.md` - Puertos 3602, 6385
- [x] `/docs/01-arquitectura/INTEGRACION-METATRADER4.md` - Puertos 3603, 5438, 6385
- [x] `/docs/01-arquitectura/INTEGRACION-API-MASSIVE.md` - Puertos 3604, 5438, 6385
- [x] `/docs/02-definicion-modulos/OQI-006-ml-signals/estrategias/ALCANCES-FASE-1-PRIORIZADOS.md` - Tabla de puertos completa

---

## Archivos Pendientes de Actualizacion

- [ ] `.env.ports` - Requiere decision de DevEnv-Agent
- [ ] `docker-compose.*.yaml` - Actualizar cuando se generen
- [ ] Archivos de configuracion existentes en `/src`

---

**Nota:** Esta discrepancia no bloquea el desarrollo de Fase 1, pero debe resolverse antes de deployment para evitar conflictos.