NOTA: Discrepancia de Puertos Detectada

Fecha: 2025-12-08 Para: DevEnv-Agent De: Requirements-Analyst Urgencia: Media Proyecto: trading-platform

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

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.
Conflictos potenciales: Si otros proyectos del workspace usan los mismos puertos (5432, 6379, 3100), habra conflictos.
Confusion para desarrolladores: No esta claro cual es la fuente de verdad.

Acciones Recomendadas

Para DevEnv-Agent:

Verificar inventario de puertos del workspace completo
Decidir fuente de verdad: DEVENV-PORTS.md o .env.ports por proyecto
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:

/docs/01-arquitectura/INTEGRACION-LLM-LOCAL.md - Puertos 3602, 6385
/docs/01-arquitectura/INTEGRACION-METATRADER4.md - Puertos 3603, 5438, 6385
/docs/01-arquitectura/INTEGRACION-API-MASSIVE.md - Puertos 3604, 5438, 6385
/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.

3.0 KiB Raw Blame History