rckrdmrd
a7cca885f0
Changes include: - Updated architecture documentation - Enhanced module definitions (OQI-001 to OQI-008) - ML integration documentation updates - Trading strategies documentation - Orchestration and inventory updates - Docker configuration updates 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
201 lines
6.5 KiB
Markdown
201 lines
6.5 KiB
Markdown
---
|
|
id: "MAP-OQI-010"
|
|
title: "Mapa de OQI-010-llm-trading-integration"
|
|
type: "Index"
|
|
project: "trading-platform"
|
|
updated_date: "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
|
|
|
|
```sql
|
|
-- 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](./README.md)
|
|
- [Integracion LLM Fine-Tuning](../../01-arquitectura/INTEGRACION-LLM-FINE-TUNING.md)
|
|
- [MCP Binance Spec](../../01-arquitectura/MCP-BINANCE-CONNECTOR-SPEC.md)
|
|
- [Plan ML-LLM-Trading](../../../orchestration/planes/PLAN-ML-LLM-TRADING.md)
|
|
|
|
---
|
|
|
|
**Generado:** 2026-01-04
|