[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure

- Move 7 non-standard folders to _archive/
- Create 5 missing obligatory files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: CONSUMER (L2)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-01-24 14:38:26 -06:00
parent 0b666e155b
commit 8293938cbe
34 changed files with 778 additions and 219 deletions

1
mcp-auth Submodule

@ -0,0 +1 @@
Subproject commit a9de3e4331d8edc5d84fdb55e6bbbed194b58456

1
mcp-binance-connector Submodule

@ -0,0 +1 @@
Subproject commit fa75326bba8d50029a05e2d76d36c6ad4a915d63

1
mcp-investment Submodule

@ -0,0 +1 @@
Subproject commit ce711aa6d4675d433c190b79137560045681e9e1

1
mcp-mt4-connector Submodule

@ -0,0 +1 @@
Subproject commit 980e56de20cb65198ab3a87b507f23eaba8f2982

1
mcp-predictions Submodule

@ -0,0 +1 @@
Subproject commit 486bfa167073467927e402d951ae925c35e5efef

1
mcp-products Submodule

@ -0,0 +1 @@
Subproject commit 2521b63c6ddfd62888fc247ce9e8164a513dd091

1
mcp-vip Submodule

@ -0,0 +1 @@
Subproject commit 41952f8985a491b723844308230863ec5e7154d3

1
mcp-wallet Submodule

@ -0,0 +1 @@
Subproject commit 733e1a45818a6cbacdc2dd6f1800ff8ba650db4e

View File

@ -0,0 +1,116 @@
# ═══════════════════════════════════════════════════════════════════════════════
# DEPENDENCY-GRAPH.yml - Trading Platform
# ═══════════════════════════════════════════════════════════════════════════════
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Estándar: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
# Propósito: Grafo de dependencias del proyecto
# Fecha: 2026-01-24
#
# ═══════════════════════════════════════════════════════════════════════════════
metadata:
proyecto: trading-platform
version: "1.0.0"
ultima_actualizacion: "2026-01-24"
# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS UPSTREAM (de quién depende)
# ─────────────────────────────────────────────────────────────────────────────
upstream:
- proyecto: workspace-v2
tipo: orchestration
que_hereda:
- directivas SIMCO
- principios
- templates
- perfiles de agentes
- proyecto: template-saas
tipo: patterns
que_hereda:
- auth patterns
- multi-tenancy
- api structure
- frontend structure
# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS DOWNSTREAM (quién depende de este)
# ─────────────────────────────────────────────────────────────────────────────
downstream: []
# CONSUMER no tiene proyectos que dependan de él
# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS EXTERNAS
# ─────────────────────────────────────────────────────────────────────────────
external:
apis:
- nombre: Polygon.io
tipo: market_data
critico: true
- nombre: MetaAPI
tipo: trading_gateway
critico: true
- nombre: Stripe
tipo: payment_provider
critico: true
infraestructura:
- nombre: PostgreSQL
version: "16+"
uso: database
- nombre: Redis
uso: cache_sessions
# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS INTERNAS (entre módulos del proyecto)
# ─────────────────────────────────────────────────────────────────────────────
internal:
apps:
frontend:
depende_de:
- mcp-auth
- mcp-predictions
- mcp-products
- mcp-vip
- ml-engine
mcp-auth:
depende_de:
- database
mcp-predictions:
depende_de:
- database
- ml-engine
- data-service
mcp-products:
depende_de:
- database
mcp-vip:
depende_de:
- database
- stripe_api
ml-engine:
depende_de:
- database
- data-service
data-service:
depende_de:
- polygon_api
mt4-gateway:
depende_de:
- metaapi
- ml-engine

View File

@ -0,0 +1,109 @@
# ═══════════════════════════════════════════════════════════════════════════════
# MAPA-DOCUMENTACION.yml - Trading Platform
# ═══════════════════════════════════════════════════════════════════════════════
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Estándar: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
# Propósito: Mapa de documentación del proyecto
# Fecha: 2026-01-24
#
# ═══════════════════════════════════════════════════════════════════════════════
metadata:
proyecto: trading-platform
version: "1.0.0"
ultima_actualizacion: "2026-01-24"
# ─────────────────────────────────────────────────────────────────────────────
# DOCUMENTACIÓN ORCHESTRATION
# ─────────────────────────────────────────────────────────────────────────────
orchestration:
root:
- archivo: _MAP.md
proposito: "Mapa de navegación"
- archivo: _inheritance.yml
proposito: "Define herencia del proyecto"
- archivo: BOOTLOADER.md
proposito: "Protocolo de arranque NEXUS"
- archivo: CONTEXT-MAP.yml
proposito: "Mapa de contexto por nivel"
- archivo: PROJECT-PROFILE.yml
proposito: "Perfil y metadata del proyecto"
- archivo: PROJECT-STATUS.md
proposito: "Estado actual del proyecto"
- archivo: PROXIMA-ACCION.md
proposito: "Checkpoint de sesión"
- archivo: DEPENDENCY-GRAPH.yml
proposito: "Grafo de dependencias"
- archivo: TRACEABILITY.yml
proposito: "Trazabilidad del proyecto"
- archivo: MAPA-DOCUMENTACION.yml
proposito: "Este archivo - mapa de docs"
carpetas:
00-guidelines:
- CONTEXTO-PROYECTO.md
- HERENCIA-DIRECTIVAS.md
- HERENCIA-SIMCO.md
- PROJECT-STATUS.md
inventarios:
- MASTER_INVENTORY.yml
trazas:
- TRAZA-TAREAS-DATABASE.md
- TRAZA-TAREAS-BACKEND.md
- TRAZA-TAREAS-FRONTEND.md
directivas:
- DIRECTIVA-ARQUITECTURA-HIBRIDA.md
- DIRECTIVA-ML-SERVICES.md
- DIRECTIVA-POLITICA-CARGA-LIMPIA.md
- DIRECTIVA-STACK-TECNOLOGICO.md
_archive:
nota: "Carpetas movidas por reestructuración SIMCO"
contenido:
- 06-subagentes/
- agents/
- analisis/
- environment/
- estados/
- planes/
- reportes/
# ─────────────────────────────────────────────────────────────────────────────
# DOCUMENTACIÓN DEL PROYECTO (docs/)
# ─────────────────────────────────────────────────────────────────────────────
docs:
ubicacion: projects/trading-platform/docs/
contenido:
- README.md
- architecture/
- api/
- guides/
# ─────────────────────────────────────────────────────────────────────────────
# HERENCIA DE DOCUMENTACIÓN
# ─────────────────────────────────────────────────────────────────────────────
herencia:
workspace:
- orchestration/directivas/simco/
- orchestration/directivas/principios/
- orchestration/agents/perfiles/
template_saas:
- patterns/auth
- patterns/api-structure

View File

@ -0,0 +1,107 @@
# ═══════════════════════════════════════════════════════════════════════════════
# TRACEABILITY.yml - Trading Platform
# ═══════════════════════════════════════════════════════════════════════════════
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Estándar: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
# Propósito: Trazabilidad del proyecto
# Fecha: 2026-01-24
#
# ═══════════════════════════════════════════════════════════════════════════════
metadata:
proyecto: trading-platform
version: "1.0.0"
ultima_actualizacion: "2026-01-24"
# ─────────────────────────────────────────────────────────────────────────────
# HISTORIAL DE CAMBIOS SIGNIFICATIVOS
# ─────────────────────────────────────────────────────────────────────────────
historial:
- fecha: "2026-01-24"
tipo: restructure
descripcion: "Reestructuración de orchestration/ según SIMCO-ESTANDAR-ORCHESTRATION v1.0.0"
archivos_afectados:
- _archive/ (nuevo, contiene carpetas movidas)
- _inheritance.yml (nuevo)
- _MAP.md (nuevo)
- DEPENDENCY-GRAPH.yml (nuevo)
- TRACEABILITY.yml (nuevo)
- MAPA-DOCUMENTACION.yml (nuevo)
agente: "Claude Code"
- fecha: "2026-01-04"
tipo: init
descripcion: "Configuración inicial de orchestration para trading-platform"
archivos_afectados:
- CONTEXT-MAP.yml
- PROJECT-PROFILE.yml
- PROXIMA-ACCION.md
agente: "Claude Code"
# ─────────────────────────────────────────────────────────────────────────────
# ÉPICAS Y ESTADO
# ─────────────────────────────────────────────────────────────────────────────
epicas:
- id: OQI-001
nombre: fundamentos-auth
estado: 70%
ultima_actualizacion: "2026-01-24"
- id: OQI-002
nombre: educativo
estado: 30%
ultima_actualizacion: "2026-01-24"
- id: OQI-003
nombre: trading-charts
estado: 40%
ultima_actualizacion: "2026-01-24"
- id: OQI-004
nombre: cuentas-inversion
estado: 35%
ultima_actualizacion: "2026-01-24"
- id: OQI-005
nombre: pagos-stripe
estado: 50%
ultima_actualizacion: "2026-01-24"
- id: OQI-006
nombre: senales-ml
estado: 60%
ultima_actualizacion: "2026-01-24"
- id: OQI-007
nombre: llm-strategy-agent
estado: 25%
ultima_actualizacion: "2026-01-24"
- id: OQI-008
nombre: portfolio-manager
estado: 20%
ultima_actualizacion: "2026-01-24"
- id: OQI-009
nombre: mt4-gateway
estado: 15%
ultima_actualizacion: "2026-01-24"
# ─────────────────────────────────────────────────────────────────────────────
# PROPAGACIONES RECIBIDAS
# ─────────────────────────────────────────────────────────────────────────────
propagaciones_recibidas: []
# Registrar aquí propagaciones desde template-saas
# ─────────────────────────────────────────────────────────────────────────────
# TRAZAS
# ─────────────────────────────────────────────────────────────────────────────
ubicacion_trazas:
database: trazas/TRAZA-TAREAS-DATABASE.md
backend: trazas/TRAZA-TAREAS-BACKEND.md
frontend: trazas/TRAZA-TAREAS-FRONTEND.md

149
orchestration/_MAP.md Normal file
View File

@ -0,0 +1,149 @@
# _MAP.md - Trading Platform Orchestration
**Nivel:** CONSUMER (L2)
**Estándar:** SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
**Actualizado:** 2026-01-24
---
## ESTRUCTURA ESTANDARIZADA
```
orchestration/
├── 📄 ARCHIVOS ROOT (10 obligatorios)
│ ├── _MAP.md <- ESTE ARCHIVO - Mapa de navegación
│ ├── _inheritance.yml <- Define herencia (CONSUMER)
│ ├── BOOTLOADER.md <- Protocolo de arranque NEXUS
│ ├── CONTEXT-MAP.yml <- Mapa de contexto por nivel
│ ├── PROJECT-PROFILE.yml <- Perfil y metadata del proyecto
│ ├── PROJECT-STATUS.md <- Estado actual del proyecto
│ ├── PROXIMA-ACCION.md <- Checkpoint de sesión
│ ├── DEPENDENCY-GRAPH.yml <- Grafo de dependencias
│ ├── TRACEABILITY.yml <- Trazabilidad del proyecto
│ └── MAPA-DOCUMENTACION.yml <- Mapa de documentación
├── 📁 00-guidelines/ <- [OBLIGATORIO] Guidelines del proyecto
│ ├── CONTEXTO-PROYECTO.md <- Variables y configuración
│ ├── HERENCIA-DIRECTIVAS.md <- Herencia de directivas
│ ├── HERENCIA-SIMCO.md <- Herencia SIMCO
│ └── PROJECT-STATUS.md <- Estado (legacy)
├── 📁 inventarios/ <- [OBLIGATORIO] Inventarios
│ └── MASTER_INVENTORY.yml <- Inventario maestro
├── 📁 trazas/ <- [OBLIGATORIO] Trazas por capa
│ ├── TRAZA-TAREAS-DATABASE.md <- Trazas DDL/Database
│ ├── TRAZA-TAREAS-BACKEND.md <- Trazas Backend
│ └── TRAZA-TAREAS-FRONTEND.md <- Trazas Frontend
├── 📁 directivas/ <- [OPCIONAL] Directivas específicas
│ ├── DIRECTIVA-ARQUITECTURA-HIBRIDA.md
│ ├── DIRECTIVA-ML-SERVICES.md
│ ├── DIRECTIVA-POLITICA-CARGA-LIMPIA.md
│ └── DIRECTIVA-STACK-TECNOLOGICO.md
└── 📁 _archive/ <- [HISTÓRICO] Carpetas movidas
├── 06-subagentes/
├── agents/
├── analisis/
├── environment/
├── estados/
├── planes/
└── reportes/
```
---
## NAVEGACIÓN RÁPIDA
### Arranque de Sesión
1. `BOOTLOADER.md` - Protocolo de arranque NEXUS
2. `PROXIMA-ACCION.md` - Estado actual y siguiente paso
3. `PROJECT-STATUS.md` - Estado general del proyecto
### Contexto del Proyecto
1. `PROJECT-PROFILE.yml` - Perfil completo (stack, módulos, servicios)
2. `CONTEXT-MAP.yml` - Mapa de contexto por nivel
3. `00-guidelines/CONTEXTO-PROYECTO.md` - Variables y configuración
### Herencia y Dependencias
1. `_inheritance.yml` - Define de quién hereda (CONSUMER)
2. `DEPENDENCY-GRAPH.yml` - Grafo de dependencias internas/externas
3. `TRACEABILITY.yml` - Historial y trazabilidad
### Inventarios y Trazas
1. `inventarios/MASTER_INVENTORY.yml` - Inventario maestro
2. `trazas/` - Trazas por capa (DATABASE, BACKEND, FRONTEND)
### Directivas Específicas
1. `directivas/DIRECTIVA-STACK-TECNOLOGICO.md` - Stack híbrido TS + Python
2. `directivas/DIRECTIVA-ML-SERVICES.md` - Servicios ML
3. `directivas/DIRECTIVA-ARQUITECTURA-HIBRIDA.md` - Arquitectura
---
## HERENCIA
```
workspace-v2/orchestration/
└──> template-saas/
└──> trading-platform/ (CONSUMER)
└──> No exporta (CONSUMER)
```
**Hereda de:**
- `workspace-v2/orchestration/` - Directivas SIMCO, principios, templates
- `projects/template-saas/` - Patrones auth, multi-tenancy, api-structure
---
## ARCHIVO HISTÓRICO (_archive/)
Carpetas movidas durante reestructuración SIMCO-ESTANDAR-ORCHESTRATION v1.0.0:
| Carpeta | Contenido | Motivo |
|---------|-----------|--------|
| `06-subagentes/` | Delegaciones | No estándar para CONSUMER |
| `agents/` | Perfiles de agentes | Heredar de workspace |
| `analisis/` | Análisis de gaps | Histórico |
| `environment/` | Configuración env | Histórico |
| `estados/` | Estados de subagentes | Histórico |
| `planes/` | Planes de desarrollo | Histórico |
| `reportes/` | Reportes de ejecución | Histórico |
**Nota:** El contenido de `_archive/` se conserva para referencia histórica.
Consultar si se necesita información de versiones anteriores.
---
## VALIDACIÓN DE CUMPLIMIENTO
### Archivos Root (10/10)
- [x] `_MAP.md`
- [x] `_inheritance.yml`
- [x] `BOOTLOADER.md`
- [x] `CONTEXT-MAP.yml`
- [x] `PROJECT-PROFILE.yml`
- [x] `PROJECT-STATUS.md`
- [x] `PROXIMA-ACCION.md`
- [x] `DEPENDENCY-GRAPH.yml`
- [x] `TRACEABILITY.yml`
- [x] `MAPA-DOCUMENTACION.yml`
### Carpetas (3/3)
- [x] `00-guidelines/` + `CONTEXTO-PROYECTO.md`
- [x] `inventarios/` + `MASTER_INVENTORY.yml`
- [x] `trazas/`
### _inheritance.yml
- [x] `tipo: CONSUMER`
- [x] `hereda_de:` definido
- [x] `exporta_a: []` (vacío)
---
*Estructura conforme a SIMCO-ESTANDAR-ORCHESTRATION v1.0.0*

View File

@ -1,219 +1,219 @@
# =============================================================================
# PROJECT-ENV-CONFIG.yml - TRADING-PLATFORM
# =============================================================================
# Proyecto: TRADING-PLATFORM - Plataforma de Trading Trading Platform
# Actualizado: 2025-12-05
# Referencia: ~/workspace/core/devtools/environment/DEV-ENVIRONMENT-REGISTRY.yml
# Configuración de puertos: /home/isem/workspace/projects/trading-platform/.env.ports
# =============================================================================
project:
name: "TRADING_PLATFORM"
slug: "trading-platform"
description: "Plataforma de Trading con IA y ML para análisis de mercados"
status: "active-development"
port_block: 3100
version: "0.1.0"
# =============================================================================
# PUERTOS DE SERVICIOS
# =============================================================================
ports:
# Frontend Services
frontend_web: 3100 # Aplicación React principal
frontend_admin: 3101 # Panel admin (futuro)
frontend_preview: 4173 # Vite preview
# Backend Services (Node.js)
backend_api: 4000 # Express API REST
backend_ws: 4001 # WebSocket server
backend_webhooks: 4002 # Webhooks endpoint
# Python Services
ml_engine: 5000 # ML predictions (FastAPI)
data_service: 5001 # Data sync service
llm_agent: 5002 # LLM agent API (futuro)
portfolio_manager: 5003 # Portfolio manager (futuro)
# Infrastructure
postgres: 5432 # PostgreSQL principal
postgres_test: 5433 # PostgreSQL testing
redis: 6379 # Redis cache/queues
mysql_legacy: 3306 # MySQL temporal (migración)
# CI/CD & Monitoring
jenkins: 8080 # Jenkins CI/CD
jenkins_agent: 50000 # Jenkins agents
prometheus: 9090 # Métricas (opcional)
grafana: 3200 # Dashboards (opcional)
# Dev Tools
pgadmin: 5050 # PostgreSQL admin
mailhog_smtp: 1025 # Email testing SMTP
mailhog_web: 8025 # Email testing UI
# =============================================================================
# DATABASE
# =============================================================================
database:
host: "localhost"
port: 5432
name: "trading_trading"
user: "trading_user"
# password: Ver archivo .env local
schemas:
- users # Usuarios y autenticación
- market_data # Datos de mercado
- trading # Señales y operaciones
- education # Contenido educativo
- investment # Cuentas de inversión
- payments # Suscripciones Stripe
- broker_integration # Integración brokers
- data_sources # Fuentes de datos
# =============================================================================
# REDIS
# =============================================================================
redis:
host: "localhost"
port: 6379
uses:
- sessions
- cache
- message_queues
- rate_limiting
# =============================================================================
# URLs DE ACCESO
# =============================================================================
urls:
frontend_web: "http://localhost:3100"
frontend_admin: "http://localhost:3101"
backend_api: "http://localhost:4000/api/v1"
backend_health: "http://localhost:4000/health"
backend_ws: "ws://localhost:4001"
ml_engine: "http://localhost:5000"
ml_engine_docs: "http://localhost:5000/docs"
data_service: "http://localhost:5001"
pgadmin: "http://localhost:5050"
mailhog: "http://localhost:8025"
# =============================================================================
# ARCHIVOS DE CONFIGURACIÓN
# =============================================================================
env_files:
ports: ".env.ports" # Configuración centralizada de puertos
backend: "apps/backend/.env"
frontend: "apps/frontend/.env"
ml_engine: "apps/ml-engine/.env"
data_service: "apps/data-service/.env"
docker: "docker-compose.yml"
# =============================================================================
# STACK TECNOLÓGICO
# =============================================================================
stack:
backend: "Express + TypeScript"
frontend: "React + TypeScript + Vite"
database: "PostgreSQL 15"
cache: "Redis 7"
ml_engine: "FastAPI + Python + scikit-learn"
data_service: "Python AsyncIO + APScheduler"
llm_agent: "FastAPI + LangChain (futuro)"
orchestration: "Docker Compose"
ci_cd: "Jenkins (planeado)"
# =============================================================================
# MÓDULOS DEL PROYECTO
# =============================================================================
modules:
- name: "OQI-001-authentication"
status: "active"
description: "Sistema de autenticación multi-factor"
- name: "OQI-002-education"
status: "active"
description: "Plataforma educativa de trading"
- name: "OQI-003-trading-charts"
status: "active"
description: "Visualización de charts y señales"
- name: "OQI-004-investment-accounts"
status: "active"
description: "Gestión de cuentas de inversión"
- name: "OQI-005-payments-stripe"
status: "active"
description: "Suscripciones con Stripe"
- name: "OQI-006-ml-engine"
status: "active"
description: "Motor de predicciones ML"
- name: "OQI-007-llm-agent"
status: "planned"
description: "Asistente inteligente con LLM"
- name: "OQI-008-portfolio-manager"
status: "planned"
description: "Gestión de portafolios"
# =============================================================================
# INTEGRACIONES EXTERNAS
# =============================================================================
integrations:
- name: "Polygon.io"
purpose: "Datos de mercado en tiempo real"
type: "REST API"
- name: "Massive API"
purpose: "Datos históricos de forex"
type: "REST API"
- name: "MetaAPI.cloud"
purpose: "Conexión a MT4/MT5"
type: "Cloud API"
- name: "Stripe"
purpose: "Procesamiento de pagos"
type: "REST API + Webhooks"
port: 4002
- name: "Claude AI / OpenAI"
purpose: "LLM para asistente"
type: "REST API"
status: "planned"
# =============================================================================
# NOTAS
# =============================================================================
notes: |
CONFIGURACIÓN ACTUALIZADA - 2025-12-05
Cambios realizados:
- Puertos reorganizados para evitar conflictos con puertos 3000 y 8000 ya en uso
- Frontend movido de 5173 a 3100 para consistencia
- Backend movido de 3000 a 4000 para evitar conflicto
- ML Engine en 5000 (ya configurado)
- Data Service en 5001
- Todos los servicios documentados en docs/95-guias-desarrollo/PUERTOS-SERVICIOS.md
Archivos creados:
- .env.ports - Configuración centralizada de puertos
- docker-compose.yml - Orquestación completa
- docs/95-guias-desarrollo/PUERTOS-SERVICIOS.md - Documentación detallada
Estado del proyecto:
- PostgreSQL: Activo en puerto 5432
- Redis: Activo en puerto 6379
- Backend: Requiere actualización de puerto en .env
- Frontend: Requiere actualización de puerto en vite.config
- ML Engine: Configurado en 5000 (correcto)
- Data Service: Configurado en 5001 (nuevo)
Próximos pasos:
1. Actualizar archivos .env de cada servicio con nuevos puertos
2. Testear docker-compose up -d
3. Verificar conectividad entre servicios
4. Actualizar CI/CD cuando se implemente Jenkins
# =============================================================================
# PROJECT-ENV-CONFIG.yml - TRADING-PLATFORM
# =============================================================================
# Proyecto: TRADING-PLATFORM - Plataforma de Trading Trading Platform
# Actualizado: 2025-12-05
# Referencia: ~/workspace/core/devtools/environment/DEV-ENVIRONMENT-REGISTRY.yml
# Configuración de puertos: /home/isem/workspace/projects/trading-platform/.env.ports
# =============================================================================
project:
name: "TRADING_PLATFORM"
slug: "trading-platform"
description: "Plataforma de Trading con IA y ML para análisis de mercados"
status: "active-development"
port_block: 3100
version: "0.1.0"
# =============================================================================
# PUERTOS DE SERVICIOS
# =============================================================================
ports:
# Frontend Services
frontend_web: 3100 # Aplicación React principal
frontend_admin: 3101 # Panel admin (futuro)
frontend_preview: 4173 # Vite preview
# Backend Services (Node.js)
backend_api: 4000 # Express API REST
backend_ws: 4001 # WebSocket server
backend_webhooks: 4002 # Webhooks endpoint
# Python Services
ml_engine: 5000 # ML predictions (FastAPI)
data_service: 5001 # Data sync service
llm_agent: 5002 # LLM agent API (futuro)
portfolio_manager: 5003 # Portfolio manager (futuro)
# Infrastructure
postgres: 5432 # PostgreSQL principal
postgres_test: 5433 # PostgreSQL testing
redis: 6379 # Redis cache/queues
mysql_legacy: 3306 # MySQL temporal (migración)
# CI/CD & Monitoring
jenkins: 8080 # Jenkins CI/CD
jenkins_agent: 50000 # Jenkins agents
prometheus: 9090 # Métricas (opcional)
grafana: 3200 # Dashboards (opcional)
# Dev Tools
pgadmin: 5050 # PostgreSQL admin
mailhog_smtp: 1025 # Email testing SMTP
mailhog_web: 8025 # Email testing UI
# =============================================================================
# DATABASE
# =============================================================================
database:
host: "localhost"
port: 5432
name: "trading_trading"
user: "trading_user"
# password: Ver archivo .env local
schemas:
- users # Usuarios y autenticación
- market_data # Datos de mercado
- trading # Señales y operaciones
- education # Contenido educativo
- investment # Cuentas de inversión
- payments # Suscripciones Stripe
- broker_integration # Integración brokers
- data_sources # Fuentes de datos
# =============================================================================
# REDIS
# =============================================================================
redis:
host: "localhost"
port: 6379
uses:
- sessions
- cache
- message_queues
- rate_limiting
# =============================================================================
# URLs DE ACCESO
# =============================================================================
urls:
frontend_web: "http://localhost:3100"
frontend_admin: "http://localhost:3101"
backend_api: "http://localhost:4000/api/v1"
backend_health: "http://localhost:4000/health"
backend_ws: "ws://localhost:4001"
ml_engine: "http://localhost:5000"
ml_engine_docs: "http://localhost:5000/docs"
data_service: "http://localhost:5001"
pgadmin: "http://localhost:5050"
mailhog: "http://localhost:8025"
# =============================================================================
# ARCHIVOS DE CONFIGURACIÓN
# =============================================================================
env_files:
ports: ".env.ports" # Configuración centralizada de puertos
backend: "apps/backend/.env"
frontend: "apps/frontend/.env"
ml_engine: "apps/ml-engine/.env"
data_service: "apps/data-service/.env"
docker: "docker-compose.yml"
# =============================================================================
# STACK TECNOLÓGICO
# =============================================================================
stack:
backend: "Express + TypeScript"
frontend: "React + TypeScript + Vite"
database: "PostgreSQL 15"
cache: "Redis 7"
ml_engine: "FastAPI + Python + scikit-learn"
data_service: "Python AsyncIO + APScheduler"
llm_agent: "FastAPI + LangChain (futuro)"
orchestration: "Docker Compose"
ci_cd: "Jenkins (planeado)"
# =============================================================================
# MÓDULOS DEL PROYECTO
# =============================================================================
modules:
- name: "OQI-001-authentication"
status: "active"
description: "Sistema de autenticación multi-factor"
- name: "OQI-002-education"
status: "active"
description: "Plataforma educativa de trading"
- name: "OQI-003-trading-charts"
status: "active"
description: "Visualización de charts y señales"
- name: "OQI-004-investment-accounts"
status: "active"
description: "Gestión de cuentas de inversión"
- name: "OQI-005-payments-stripe"
status: "active"
description: "Suscripciones con Stripe"
- name: "OQI-006-ml-engine"
status: "active"
description: "Motor de predicciones ML"
- name: "OQI-007-llm-agent"
status: "planned"
description: "Asistente inteligente con LLM"
- name: "OQI-008-portfolio-manager"
status: "planned"
description: "Gestión de portafolios"
# =============================================================================
# INTEGRACIONES EXTERNAS
# =============================================================================
integrations:
- name: "Polygon.io"
purpose: "Datos de mercado en tiempo real"
type: "REST API"
- name: "Massive API"
purpose: "Datos históricos de forex"
type: "REST API"
- name: "MetaAPI.cloud"
purpose: "Conexión a MT4/MT5"
type: "Cloud API"
- name: "Stripe"
purpose: "Procesamiento de pagos"
type: "REST API + Webhooks"
port: 4002
- name: "Claude AI / OpenAI"
purpose: "LLM para asistente"
type: "REST API"
status: "planned"
# =============================================================================
# NOTAS
# =============================================================================
notes: |
CONFIGURACIÓN ACTUALIZADA - 2025-12-05
Cambios realizados:
- Puertos reorganizados para evitar conflictos con puertos 3000 y 8000 ya en uso
- Frontend movido de 5173 a 3100 para consistencia
- Backend movido de 3000 a 4000 para evitar conflicto
- ML Engine en 5000 (ya configurado)
- Data Service en 5001
- Todos los servicios documentados en docs/95-guias-desarrollo/PUERTOS-SERVICIOS.md
Archivos creados:
- .env.ports - Configuración centralizada de puertos
- docker-compose.yml - Orquestación completa
- docs/95-guias-desarrollo/PUERTOS-SERVICIOS.md - Documentación detallada
Estado del proyecto:
- PostgreSQL: Activo en puerto 5432
- Redis: Activo en puerto 6379
- Backend: Requiere actualización de puerto en .env
- Frontend: Requiere actualización de puerto en vite.config
- ML Engine: Configurado en 5000 (correcto)
- Data Service: Configurado en 5001 (nuevo)
Próximos pasos:
1. Actualizar archivos .env de cada servicio con nuevos puertos
2. Testear docker-compose up -d
3. Verificar conectividad entre servicios
4. Actualizar CI/CD cuando se implemente Jenkins

View File

@ -0,0 +1,70 @@
# ═══════════════════════════════════════════════════════════════════════════════
# _inheritance.yml - Trading Platform
# ═══════════════════════════════════════════════════════════════════════════════
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Estándar: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
# Propósito: Define herencia del proyecto
# Fecha: 2026-01-24
#
# ═══════════════════════════════════════════════════════════════════════════════
# ─────────────────────────────────────────────────────────────────────────────
# TIPO DE PROYECTO
# ─────────────────────────────────────────────────────────────────────────────
tipo: CONSUMER
version: "1.0.0"
subtipo: INTEGRATES
# ─────────────────────────────────────────────────────────────────────────────
# HERENCIA
# ─────────────────────────────────────────────────────────────────────────────
hereda_de:
- workspace-v2/orchestration/
- projects/template-saas/
# CONSUMERS no exportan
exporta_a: []
# ─────────────────────────────────────────────────────────────────────────────
# PATRONES HEREDADOS
# ─────────────────────────────────────────────────────────────────────────────
patrones_heredados:
de_template_saas:
- auth
- multi-tenancy
- api-structure
- frontend-structure
# ─────────────────────────────────────────────────────────────────────────────
# MÓDULOS PROPIOS
# ─────────────────────────────────────────────────────────────────────────────
modulos_propios:
- ml-engine
- trading-signals
- charts-visualization
- portfolio-management
- mt4-gateway
# ─────────────────────────────────────────────────────────────────────────────
# REGLAS DE SINCRONIZACIÓN
# ─────────────────────────────────────────────────────────────────────────────
regla_sincronizacion: |
Recibir cambios de template-saas según SLA definido.
Security fixes: Aplicar en 24h.
Bug fixes: Aplicar en 72h.
Features: Evaluar relevancia para trading platform.
# ─────────────────────────────────────────────────────────────────────────────
# NOTAS
# ─────────────────────────────────────────────────────────────────────────────
notas:
- "Proyecto CONSUMER con integración selectiva de template-saas"
- "Stack híbrido TypeScript + Python para componentes ML"
- "No exporta patrones a otros proyectos"