14133175af
- Create DOCUMENTATION-STATUS.md with comprehensive audit of all docs sections - Create docs/_archive/ folder for obsolete documentation - Move resolved NOTA-DISCREPANCIA-PUERTOS to _archive/00-notas/ - Move deprecated backlog README to _archive/04-fase-backlog/ - Update 04-fase-backlog/README.md to reflect current state (DoR/DoD only) - Create implementacion/TRACEABILITY.yml for OQI-009-marketplace - Update _MAP.md v2.3.0 with accurate structure reflecting all 11 epics Key findings documented in DOCUMENTATION-STATUS.md: - 9 documentation sections analyzed - 6 complete, 2 partial, 1 deprecated - OQI-010-mt4-gateway marked as NO FUNCIONAL (15%) - Missing guias-desarrollo subfolders identified Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
137 lines
4.0 KiB
Markdown
137 lines
4.0 KiB
Markdown
---
|
|
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.
|