- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Agregados documentos de arquitectura y planes Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
459 lines
13 KiB
Markdown
459 lines
13 KiB
Markdown
# Analisis Consolidado - Fase 1
|
|
## Trading Platform - Estado Actual y Plan de Desarrollo
|
|
|
|
**Fecha:** 2026-01-07
|
|
**Ejecutor:** Claude Opus 4.5 (Technical Lead)
|
|
**Framework:** NEXUS v4.0 + SIMCO v2.5
|
|
|
|
---
|
|
|
|
## 1. RESUMEN EJECUTIVO
|
|
|
|
### 1.1 Estado General del Proyecto
|
|
|
|
| Aspecto | Estado | Completitud |
|
|
|---------|--------|-------------|
|
|
| **Backend (Express.js)** | Funcional | 70% |
|
|
| **Frontend (React)** | Funcional | 90% |
|
|
| **ML Engine (FastAPI)** | Parcial | 75% |
|
|
| **LLM Agent (FastAPI)** | Funcional | 85% |
|
|
| **Trading Agents** | Funcional | 78% |
|
|
| **MCP/MT4 Integration** | Completado | 90% |
|
|
| **Database (PostgreSQL)** | Completado | 95% |
|
|
| **Testing E2E** | Pendiente | 10% |
|
|
| **Documentacion** | Buena | 80% |
|
|
|
|
**Estado Global: MVP Funcional - 95% de Fase 2 (Integracion y Testing)**
|
|
|
|
### 1.2 Metricas Clave
|
|
|
|
```
|
|
Lineas de codigo total: ~130,000 LOC
|
|
Archivos fuente: ~400 archivos
|
|
Tablas de BD: 77 tablas en 10 schemas
|
|
Modelos ML entrenados: 111 modelos
|
|
Tools LLM: 34 clases implementadas
|
|
Epicas completadas: 7 de 9 (78%)
|
|
```
|
|
|
|
---
|
|
|
|
## 2. ANALISIS POR COMPONENTE
|
|
|
|
### 2.1 BACKEND (Express.js + TypeScript)
|
|
|
|
**Ubicacion:** `/apps/backend/`
|
|
**LOC:** ~35,832 lineas
|
|
**Estado:** 70% Completado
|
|
|
|
#### Modulos Completados (8/11)
|
|
| Modulo | LOC | Tests | Estado |
|
|
|--------|-----|-------|--------|
|
|
| Auth | 6,063 | 3 specs | COMPLETADO |
|
|
| Trading | 6,819 | 3 specs | COMPLETADO |
|
|
| Education | 4,795 | 0 specs | COMPLETADO |
|
|
| Investment | 3,358 | 3 specs | COMPLETADO |
|
|
| Payments | 2,585 | 0 specs | COMPLETADO |
|
|
| Portfolio | 1,643 | 1 spec | COMPLETADO |
|
|
| LLM | 819 | 0 specs | COMPLETADO |
|
|
| Core | 2,133 | - | COMPLETADO |
|
|
|
|
#### Modulos Parciales (3/11)
|
|
| Modulo | LOC | Problema | Accion Requerida |
|
|
|--------|-----|----------|------------------|
|
|
| ML | 1,791 | Servicios incompletos | Implementar ml-integration.service.ts |
|
|
| Agents | 863 | Solo delegacion basica | Agregar logica de orquestacion |
|
|
| Admin | 431 | Solo rutas definidas | Implementar controllers |
|
|
|
|
#### Gaps Criticos Backend
|
|
1. **ml-integration.service.ts** - Solo 100 LOC (solo tipos), falta implementacion
|
|
2. **Auth en endpoints** - `/trading/paper/*` y `/investment/*` sin auth middleware
|
|
3. **Users module** - Solo 64 LOC, sin implementacion
|
|
4. **Testing** - Sin E2E tests, sin integration tests
|
|
|
|
---
|
|
|
|
### 2.2 FRONTEND (React 18 + Vite)
|
|
|
|
**Ubicacion:** `/apps/frontend/`
|
|
**LOC:** ~18,400 lineas
|
|
**Estado:** 90% Completado
|
|
|
|
#### Modulos por Estado
|
|
| Modulo | LOC | Produccion | Gaps |
|
|
|--------|-----|------------|------|
|
|
| Trading | 3,723 | Si | WebSocket para real-time |
|
|
| Backtesting | 2,223 | Si | Optimizacion parametros |
|
|
| Education | 2,522 | Si | Certificados PDF |
|
|
| ML Dashboard | 2,339 | Si | - |
|
|
| Auth | 1,402 | Si | - |
|
|
| Admin | 1,583 | Si | - |
|
|
| Payments | 729 | Si | Metered billing |
|
|
| Assistant | 648 | Si | Streaming respuestas |
|
|
| Investment | 722 | No | Necesita backend |
|
|
| Dashboard | 77 | No | Stub |
|
|
| Settings | 89 | No | Stub |
|
|
|
|
#### Gaps Criticos Frontend
|
|
1. **WebSocket real-time** - Trading usa polling, necesita WS
|
|
2. **Certificados PDF** - API existe pero no genera/descarga
|
|
3. **Dark mode** - No implementado
|
|
4. **Investment module** - Sin backend conectado
|
|
|
|
---
|
|
|
|
### 2.3 ML ENGINE (FastAPI + Python)
|
|
|
|
**Ubicacion:** `/apps/ml-engine/`
|
|
**LOC:** ~28,523 lineas
|
|
**Estado:** 75% Completado
|
|
|
|
#### Modelos Implementados
|
|
| Modelo | LOC | Precision | Estado |
|
|
|--------|-----|-----------|--------|
|
|
| AMDDetector | 570 | ~75% | COMPLETADO |
|
|
| RangePredictor | 690 | R^2 NEGATIVO | PROBLEMA |
|
|
| TPSLClassifier | 658 | ~68% | COMPLETADO |
|
|
| AttentionModel | 667 | ~60% | COMPLETADO |
|
|
| NeuralGating | 853 | - | COMPLETADO |
|
|
| AssetMetamodel | 787 | - | COMPLETADO |
|
|
|
|
#### Pipelines
|
|
| Pipeline | LOC | Estado |
|
|
|----------|-----|--------|
|
|
| Phase2Pipeline | 604 | COMPLETADO |
|
|
| HierarchicalPipeline | 723 | COMPLETADO |
|
|
| SymbolTimeframeTrainer | 917 | COMPLETADO |
|
|
| AttentionTrainer | 591 | COMPLETADO |
|
|
|
|
#### Gaps Criticos ML Engine
|
|
1. **RangePredictor R^2 NEGATIVO** - Modelos peor que baseline
|
|
2. **API no funcional** - Modelos no cargan en startup
|
|
3. **Backtesting** - Win rate 42.1% (muy bajo)
|
|
4. **Sin validacion OOS** - Reportes no muestran metricas out-of-sample
|
|
|
|
---
|
|
|
|
### 2.4 LLM AGENT (FastAPI + Python)
|
|
|
|
**Ubicacion:** `/apps/llm-agent/`
|
|
**LOC:** ~8,000+ lineas
|
|
**Estado:** 85% Completado
|
|
|
|
#### Tools Implementados (34 clases)
|
|
| Categoria | Tools | Estado |
|
|
|-----------|-------|--------|
|
|
| Market Data | 3 | COMPLETADO |
|
|
| Portfolio | 3 | COMPLETADO |
|
|
| Trading | 3 | PARCIAL (live trading pendiente) |
|
|
| MT4 | 7 | COMPLETADO |
|
|
| ML Analysis | 5 | COMPLETADO |
|
|
| Auto-Trading | 2 | COMPLETADO |
|
|
| Strategy | 5 | COMPLETADO |
|
|
| Education | 2 | COMPLETADO |
|
|
|
|
#### Fine-tuning Pipeline
|
|
| Componente | Estado |
|
|
|------------|--------|
|
|
| QLoRA Config | COMPLETADO |
|
|
| Training Scripts | COMPLETADO |
|
|
| Dataset Generation | COMPLETADO |
|
|
| Evaluation | COMPLETADO |
|
|
|
|
#### Gaps Criticos LLM Agent
|
|
1. **Live Trading** - ExecuteTradeTool sin ejecucion real
|
|
2. **Persistencia** - Decisiones solo en memoria
|
|
3. **MCPOrchestrator** - Solo 100 LOC (incompleto)
|
|
4. **Rate Limiting** - No implementado
|
|
|
|
---
|
|
|
|
### 2.5 TRADING AGENTS (FastAPI + Python)
|
|
|
|
**Ubicacion:** `/apps/trading-agents/`
|
|
**LOC:** ~6,000+ lineas
|
|
**Estado:** 78% Completado
|
|
|
|
#### Agentes
|
|
| Agente | Perfil | Target Mensual | Max Drawdown | Estado |
|
|
|--------|--------|----------------|--------------|--------|
|
|
| Atlas | Conservador | 3-5% | 5% | COMPLETADO |
|
|
| Orion | Moderado | 5-10% | 10% | COMPLETADO |
|
|
| Nova | Agresivo | 10%+ | 20% | COMPLETADO |
|
|
|
|
#### Estrategias
|
|
| Estrategia | Agentes | Estado |
|
|
|------------|---------|--------|
|
|
| Mean Reversion | Atlas | COMPLETADO |
|
|
| Grid Trading | Atlas | COMPLETADO |
|
|
| Trend Following | Orion, Nova | COMPLETADO |
|
|
| Momentum | Orion, Nova | COMPLETADO |
|
|
| Scalping | Nova | PENDIENTE |
|
|
| Breakout | - | PENDIENTE |
|
|
|
|
#### Gaps Criticos Trading Agents
|
|
1. **Scalping/Breakout** - No implementados
|
|
2. **WebSocket Signals** - Usa polling
|
|
3. **Persistencia BD** - No almacena trades
|
|
4. **Testing** - 0% coverage
|
|
|
|
---
|
|
|
|
### 2.6 MCP/MT4 INTEGRATION
|
|
|
|
**Ubicaciones:**
|
|
- `/apps/mcp-mt4-connector/` (TypeScript)
|
|
- `/apps/mt4-gateway/` (Python)
|
|
- `/apps/mcp-binance-connector/` (TypeScript)
|
|
|
|
**Estado:** 90% Completado
|
|
|
|
#### Componentes
|
|
| Componente | Puerto | Tools | Estado |
|
|
|------------|--------|-------|--------|
|
|
| MCP MT4 Connector | 3605 | 6 | COMPLETADO |
|
|
| MT4 Gateway | 8090 | - | COMPLETADO |
|
|
| MCP Binance | 3606 | 7 | COMPLETADO |
|
|
|
|
#### Gaps Criticos MCP
|
|
1. **EA Bridge** - No documentado, dependencia externa
|
|
2. **Autenticacion** - Endpoints publicos
|
|
3. **Rate Limiting** - No implementado
|
|
|
|
---
|
|
|
|
### 2.7 DATABASE (PostgreSQL 16)
|
|
|
|
**Ubicacion:** `/apps/database/`
|
|
**LOC:** ~898 lineas SQL
|
|
**Estado:** 95% Completado
|
|
|
|
#### Schemas
|
|
| Schema | Tablas | Funciones | Estado |
|
|
|--------|--------|-----------|--------|
|
|
| auth | 11 | 4 | COMPLETADO |
|
|
| education | 14 | 8 | COMPLETADO |
|
|
| trading | 10 | 4 | COMPLETADO |
|
|
| investment | 7 | 0 | COMPLETADO |
|
|
| financial | 10 | 4+ | COMPLETADO |
|
|
| ml | 9 | 1 | COMPLETADO |
|
|
| llm | 5 | 0 | PARCIAL (pgvector) |
|
|
| audit | 7 | 0 | COMPLETADO |
|
|
| market_data | 4 | 2 | COMPLETADO |
|
|
| **TOTAL** | **77** | **23+** | - |
|
|
|
|
#### Datos Historicos
|
|
- 10 anos de datos OHLCV
|
|
- 3.9M registros 5m
|
|
- 1.3M registros 15m
|
|
- 6 activos: XAUUSD, EURUSD, BTCUSD, GBPUSD, USDJPY, AUDUSD
|
|
|
|
#### Gaps Criticos Database
|
|
1. **RLS no habilitado** - Multi-tenant sin politicas
|
|
2. **pgvector opcional** - Tabla embeddings no funcional sin extension
|
|
|
|
---
|
|
|
|
## 3. MATRIZ DE GAPS PRIORITARIOS
|
|
|
|
### 3.1 Prioridad CRITICA (Bloquean produccion)
|
|
|
|
| # | Componente | Gap | Impacto | Esfuerzo |
|
|
|---|------------|-----|---------|----------|
|
|
| 1 | ML Engine | RangePredictor R^2 negativo | Predicciones inutiles | 3-5 dias |
|
|
| 2 | ML Engine | API no carga modelos | ML no operativo | 1 dia |
|
|
| 3 | Backend | ml-integration.service incompleto | Sin senales ML | 2 dias |
|
|
| 4 | LLM Agent | MCPOrchestrator incompleto | Sin portfolio consolidado | 2 dias |
|
|
|
|
### 3.2 Prioridad ALTA (Funcionalidad limitada)
|
|
|
|
| # | Componente | Gap | Impacto | Esfuerzo |
|
|
|---|------------|-----|---------|----------|
|
|
| 5 | Backend | Auth en paper trading endpoints | Seguridad | 1 dia |
|
|
| 6 | Frontend | WebSocket real-time | UX degradado | 2 dias |
|
|
| 7 | Trading Agents | Scalping strategy | Nova incompleto | 3 dias |
|
|
| 8 | LLM Agent | Live trading execution | No operable | 2 dias |
|
|
| 9 | Trading Agents | Persistencia BD | Sin historial | 2 dias |
|
|
| 10 | Database | RLS policies | Multi-tenant inseguro | 1 dia |
|
|
|
|
### 3.3 Prioridad MEDIA (Mejoras)
|
|
|
|
| # | Componente | Gap | Impacto | Esfuerzo |
|
|
|---|------------|-----|---------|----------|
|
|
| 11 | Backend | Testing E2E | Calidad | 3 dias |
|
|
| 12 | Frontend | Certificados PDF | Feature faltante | 2 dias |
|
|
| 13 | ML Engine | Validacion OOS | Confianza modelos | 2 dias |
|
|
| 14 | LLM Agent | Rate limiting | Seguridad API | 1 dia |
|
|
| 15 | MCP | Autenticacion Bearer | Seguridad | 1 dia |
|
|
|
|
---
|
|
|
|
## 4. PLAN DE DESARROLLO PROPUESTO
|
|
|
|
### SPRINT 1: Estabilizacion ML (Semana 1)
|
|
|
|
**Objetivo:** Resolver problemas criticos de ML Engine
|
|
|
|
| Tarea | Asignee | Dias | Dependencias |
|
|
|-------|---------|------|--------------|
|
|
| Fix RangePredictor (feature engineering) | ML-SPECIALIST | 3 | - |
|
|
| Implementar auto-load modelos en API | ML-SPECIALIST | 1 | - |
|
|
| Validacion OOS completa | ML-SPECIALIST | 2 | Fix RangePredictor |
|
|
| Tests unitarios ML | ML-SPECIALIST | 1 | - |
|
|
|
|
**Entregables:**
|
|
- RangePredictor con R^2 > 0
|
|
- API ML funcional con modelos cargados
|
|
- Reporte de validacion OOS
|
|
|
|
---
|
|
|
|
### SPRINT 2: Integracion Backend (Semana 2)
|
|
|
|
**Objetivo:** Completar servicios de integracion
|
|
|
|
| Tarea | Asignee | Dias | Dependencias |
|
|
|-------|---------|------|--------------|
|
|
| Implementar ml-integration.service.ts | BACKEND | 2 | Sprint 1 |
|
|
| Auth middleware en paper trading | BACKEND | 1 | - |
|
|
| Completar agents.service.ts | BACKEND | 1 | - |
|
|
| Implementar users module | BACKEND | 1 | - |
|
|
|
|
**Entregables:**
|
|
- Backend 100% funcional
|
|
- Endpoints protegidos
|
|
- Modulo de usuarios operativo
|
|
|
|
---
|
|
|
|
### SPRINT 3: LLM y Trading Agents (Semana 3)
|
|
|
|
**Objetivo:** Completar funcionalidades de agentes
|
|
|
|
| Tarea | Asignee | Dias | Dependencias |
|
|
|-------|---------|------|--------------|
|
|
| Completar MCPOrchestrator | LLM-SPECIALIST | 2 | - |
|
|
| Implementar live trading execution | LLM-SPECIALIST | 2 | MCPOrchestrator |
|
|
| Implementar Scalping strategy | TRADING-SPECIALIST | 2 | - |
|
|
| Persistencia BD en Trading Agents | BACKEND | 2 | - |
|
|
|
|
**Entregables:**
|
|
- Portfolio consolidado funcional
|
|
- Live trading operativo
|
|
- Scalping strategy para Nova
|
|
- Historial de trades en BD
|
|
|
|
---
|
|
|
|
### SPRINT 4: Frontend y UX (Semana 4)
|
|
|
|
**Objetivo:** Mejorar experiencia de usuario
|
|
|
|
| Tarea | Asignee | Dias | Dependencias |
|
|
|-------|---------|------|--------------|
|
|
| WebSocket real-time en Trading | FRONTEND | 2 | - |
|
|
| Streaming respuestas LLM | FRONTEND | 1 | - |
|
|
| Certificados PDF education | FRONTEND | 2 | - |
|
|
| Investment module conectado | FRONTEND | 2 | Sprint 2 |
|
|
|
|
**Entregables:**
|
|
- Trading con precios en tiempo real
|
|
- Chat con streaming
|
|
- Certificados descargables
|
|
- Investment funcional
|
|
|
|
---
|
|
|
|
### SPRINT 5: Seguridad y Testing (Semana 5)
|
|
|
|
**Objetivo:** Hardening para produccion
|
|
|
|
| Tarea | Asignee | Dias | Dependencias |
|
|
|-------|---------|------|--------------|
|
|
| Habilitar RLS en PostgreSQL | DBA | 1 | - |
|
|
| Rate limiting en APIs | BACKEND | 1 | - |
|
|
| Autenticacion MCP servers | BACKEND | 1 | - |
|
|
| E2E Testing suite | QA | 3 | Sprints 1-4 |
|
|
|
|
**Entregables:**
|
|
- RLS habilitado en tablas criticas
|
|
- APIs con rate limiting
|
|
- MCP con auth Bearer
|
|
- Suite E2E > 80% cobertura
|
|
|
|
---
|
|
|
|
## 5. DEPENDENCIAS ENTRE COMPONENTES
|
|
|
|
```
|
|
Database (PostgreSQL)
|
|
|
|
|
+---> Backend (Express.js)
|
|
| |
|
|
| +---> Frontend (React)
|
|
| |
|
|
| +---> ML Engine (FastAPI)
|
|
| | |
|
|
| | +---> Trading Agents (FastAPI)
|
|
| | |
|
|
| | +---> LLM Agent (FastAPI)
|
|
| | |
|
|
| | +---> MCP MT4 Connector
|
|
| | | |
|
|
| | | +---> MT4 Gateway
|
|
| | | |
|
|
| | | +---> EA Bridge (EXTERNO)
|
|
| | |
|
|
| | +---> MCP Binance Connector
|
|
| |
|
|
| +---> Data Service (FastAPI)
|
|
|
|
|
+---> Ollama (LLM Local)
|
|
```
|
|
|
|
---
|
|
|
|
## 6. RIESGOS IDENTIFICADOS
|
|
|
|
| Riesgo | Probabilidad | Impacto | Mitigacion |
|
|
|--------|--------------|---------|------------|
|
|
| ML models overfitting | Alta | Alto | Walk-forward validation riguroso |
|
|
| EA Bridge no disponible | Media | Alto | Documentar dependencia, crear mock |
|
|
| Latencia MCP-MT4 | Media | Medio | Connection pooling, cache |
|
|
| Costos API LLM | Baja | Medio | Ollama local como default |
|
|
| Data leakage ML | Media | Alto | Auditar features, gaps temporales |
|
|
|
|
---
|
|
|
|
## 7. METRICAS DE EXITO
|
|
|
|
### KPIs de Desarrollo
|
|
- Todos los gaps CRITICOS resueltos
|
|
- Cobertura de tests > 60%
|
|
- Tiempo de respuesta API < 200ms (p95)
|
|
|
|
### KPIs de ML
|
|
- RangePredictor R^2 > 0.15
|
|
- Win rate backtesting > 55%
|
|
- Precision AMD > 70%
|
|
|
|
### KPIs de Produccion
|
|
- Uptime > 99.5%
|
|
- Error rate < 1%
|
|
- Latencia trading < 500ms
|
|
|
|
---
|
|
|
|
## 8. PROXIMOS PASOS INMEDIATOS
|
|
|
|
1. **Aprobar plan de desarrollo** con stakeholders
|
|
2. **Iniciar Sprint 1** - Fix ML Engine
|
|
3. **Documentar EA Bridge** - Dependencia critica externa
|
|
4. **Setup CI/CD** - Para testing automatizado
|
|
|
|
---
|
|
|
|
**Documento generado:** 2026-01-07
|
|
**Version:** 1.0.0
|
|
**Autor:** Technical Lead (Claude Opus 4.5)
|