workspace-v1/projects/trading-platform/docs/00-notas/NOTA-DISCREPANCIA-PUERTOS-2025-12-08.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

99 lines
3.0 KiB
Markdown

# 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
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.