trading-platform/docs/00-notas/NOTA-DISCREPANCIA-PUERTOS-2025-12-08.md
rckrdmrd c1b5081208 feat(ml): Complete FASE 11 - BTCUSD update and comprehensive documentation alignment
ML Engine Updates:
- Updated BTCUSD with Polygon API data (2024-2025): 215,699 new records
- Re-trained all ML models: Attention (R²: 0.223), Base, Metamodel (87.3% confidence)
- Backtest results: +176.71R profit with aggressive_filter strategy

Documentation Consolidation:
- Created docs/99-analisis/_MAP.md index with 13 new analysis documents
- Consolidated inventories: removed duplicates from orchestration/inventarios/
- Updated ML_INVENTORY.yml with BTCUSD metrics and training results
- Added execution reports: FASE11-BTCUSD, correction issues, alignment validation

Architecture & Integration:
- Updated all module documentation with NEXUS v3.4 frontmatter
- Fixed _MAP.md indexes across all folders
- Updated orchestration plans and traces

Files: 229 changed, 5064 insertions(+), 1872 deletions(-)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 09:31:29 -06:00

4.0 KiB

id title type project version updated_date status
NOTA-DISCREPANCIA-PUERTOS-2025-12-08 Discrepancia de Puertos - RESUELTA Documentation trading-platform 2.0.0 2026-01-07 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:

  • docker-compose.yml
  • apps/*/\*.env.example (5 archivos)
  • apps/ml-engine/config/database.yaml
  • apps/frontend/src/services/*.ts (4 archivos)
  • 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:

  • /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.