trading-platform/docs/02-definicion-modulos/OQI-010-llm-trading-integration/_MAP.md

id	title	type	project	updated_date
MAP-OQI-010	Mapa de OQI-010-llm-trading-integration	Index	trading-platform	2026-01-04

_MAP: OQI-010 - LLM Trading Integration

Ultima actualizacion: 2026-01-04 Estado: Planning Version: 1.0.0

---

Proposito

Esta epica implementa la integracion avanzada del LLM con fine-tuning para trading, incluyendo:

• Fine-tuning con estrategias AMD/ICT/SMC
• MCP Binance Connector
• Sistema de gestion de riesgo
• API de predicciones para frontend
• Persistencia y tracking de predicciones

---

Contenido del Directorio

OQI-010-llm-trading-integration/
├── README.md                        # Este archivo - descripcion de la epica
├── _MAP.md                          # Indice del modulo
│
├── requerimientos/                  # Documentos de requerimientos funcionales
│   ├── RF-LLM-001-fine-tuning.md        # Fine-tuning con estrategias
│   ├── RF-LLM-002-mcp-binance.md        # MCP Binance Connector
│   ├── RF-LLM-003-risk-management.md    # Sistema de gestion de riesgo
│   ├── RF-LLM-004-api-predictions.md    # API predicciones frontend
│   ├── RF-LLM-005-persistence.md        # Persistencia predicciones
│   ├── RF-LLM-006-confluence.md         # Analisis confluencia ML
│   ├── RF-LLM-007-websocket.md          # WebSocket real-time
│   ├── RF-LLM-008-tracking.md           # Tracking outcomes
│   ├── RF-LLM-009-dashboard.md          # Dashboard accuracy
│   └── RF-LLM-010-circuit-breaker.md    # Circuit breaker
│
├── especificaciones/                # Especificaciones tecnicas
│   ├── ET-LLM-001-arquitectura.md       # Arquitectura general
│   ├── ET-LLM-002-fine-tuning.md        # Pipeline fine-tuning
│   ├── ET-LLM-003-mcp-binance.md        # MCP Binance spec
│   ├── ET-LLM-004-risk-service.md       # Risk management service
│   ├── ET-LLM-005-predictions-api.md    # API endpoints
│   └── ET-LLM-006-database.md           # DDL y schemas
│
├── historias-usuario/               # User Stories
│   ├── US-LLM-001-mcp-binance.md
│   ├── US-LLM-002-fine-tuning-pipeline.md
│   ├── US-LLM-003-persistence-ddl.md
│   ├── US-LLM-004-ml-analysis.md
│   ├── US-LLM-005-risk-validation.md
│   ├── US-LLM-006-api-predictions.md
│   ├── US-LLM-007-websocket-realtime.md
│   ├── US-LLM-008-confluence-calc.md
│   ├── US-LLM-009-trade-execution.md
│   ├── US-LLM-010-outcome-tracking.md
│   ├── US-LLM-011-accuracy-metrics.md
│   ├── US-LLM-012-circuit-breaker.md
│   ├── US-LLM-013-production-tuning.md
│   ├── US-LLM-014-alerts.md
│   ├── US-LLM-015-monitoring-dashboard.md
│   └── US-LLM-016-integration-tests.md
│
└── implementacion/                  # Trazabilidad de implementacion
    └── TRACEABILITY.yml

---

Requerimientos Funcionales

ID	Nombre	Prioridad	SP	Estado
RF-LLM-001	Fine-tuning con estrategias	P0	13	Pendiente
RF-LLM-002	MCP Binance Connector	P0	8	Pendiente
RF-LLM-003	Sistema gestion de riesgo	P0	8	Pendiente
RF-LLM-004	API predicciones frontend	P0	5	Pendiente
RF-LLM-005	Persistencia predicciones	P1	5	Pendiente
RF-LLM-006	Analisis confluencia ML	P0	5	Pendiente
RF-LLM-007	WebSocket real-time	P1	5	Pendiente
RF-LLM-008	Tracking outcomes	P1	5	Pendiente
RF-LLM-009	Dashboard accuracy	P2	3	Pendiente
RF-LLM-010	Circuit breaker auto	P0	5	Pendiente

Total: 62 SP

---

Historias de Usuario por Sprint

Sprint 1: Infraestructura (21 SP)

ID	Historia	SP	Estado
US-LLM-001	MCP Binance Connector	8	Pendiente
US-LLM-002	Pipeline fine-tuning	8	Pendiente
US-LLM-003	DDL PostgreSQL	5	Pendiente

Sprint 2: Core Features (26 SP)

ID	Historia	SP	Estado
US-LLM-004	Analisis ML + explicacion	8	Pendiente
US-LLM-005	Validacion de riesgo	5	Pendiente
US-LLM-006	API predicciones	5	Pendiente
US-LLM-007	WebSocket predicciones	5	Pendiente
US-LLM-008	Calculo confluencia	3	Pendiente

Sprint 3: Integracion (21 SP)

ID	Historia	SP	Estado
US-LLM-009	Ejecucion MT4/Binance	8	Pendiente
US-LLM-010	Tracking outcomes	5	Pendiente
US-LLM-011	Metricas accuracy	5	Pendiente
US-LLM-012	Circuit breaker	3	Pendiente

Sprint 4: Optimizacion (21 SP)

ID	Historia	SP	Estado
US-LLM-013	Fine-tuning produccion	8	Pendiente
US-LLM-014	Alertas oportunidades	5	Pendiente
US-LLM-015	Dashboard monitoreo	5	Pendiente
US-LLM-016	Tests integracion	3	Pendiente

Total: 89 SP

---

Componentes Nuevos

1. MCP Binance Connector

• Ubicacion: apps/mcp-binance-connector/
• Puerto: 3606
• Tecnologia: Node.js + TypeScript + CCXT
• Documentacion: docs/01-arquitectura/MCP-BINANCE-CONNECTOR-SPEC.md

2. Risk Management Service

• Ubicacion: apps/llm-agent/src/services/risk_manager.py
• Funcionalidades: Position sizing, drawdown monitor, circuit breaker

3. Predictions API

• Ubicacion: apps/llm-agent/src/api/predictions.py
• Endpoints: REST + WebSocket
• Puerto: 3085

4. Fine-Tuning Pipeline

• Ubicacion: apps/llm-agent/fine_tuning/
• Dataset: JSONL con estrategias de trading
• Modelo: LoRA adapter para Llama 3 8B

---

DDL Nuevas Tablas

-- Schema: ml
CREATE TABLE ml.llm_predictions (...)
CREATE TABLE ml.prediction_outcomes (...)
CREATE TABLE ml.llm_decisions (...)
CREATE TABLE ml.risk_events (...)

Ver detalle en: docs/01-arquitectura/INTEGRACION-LLM-FINE-TUNING.md

---

Dependencias

Depende de:

• OQI-001: Autenticacion (Completado)
• OQI-006: ML Signals (Completado)
• OQI-007: LLM Agent base (Completado)

Habilita:

• OQI-004: Investment Accounts
• OQI-011: Auto-Trading (futuro)

---

Referencias

• README Epica
• Integracion LLM Fine-Tuning
• MCP Binance Spec
• Plan ML-LLM-Trading

---

Generado: 2026-01-04