# 01-CONTEXTO.md - OQI-006 ML Utility Panels

## Identificacion

| Campo | Valor |
|-------|-------|
| ID Tarea | TASK-2026-01-26-OQI-006-ML-UTILITY-PANELS |
| Epic | OQI-006 Señales ML |
| Proyecto | trading-platform |
| Tipo | FEATURE |
| Prioridad | MEDIA |

---

## Contexto del Proyecto

### Trading Platform
Plataforma de trading con módulo de señales ML que utiliza múltiples modelos de predicción. El módulo OQI-006 maneja:
- Predicciones de dirección del mercado
- Análisis ICT (Inner Circle Trader)
- Ensemble de modelos
- Backtesting y métricas

### Estado Previo del Módulo
- **Progreso anterior:** 60%
- **Componentes existentes:** 12 (11 implementados + 1 página)
- **Gaps identificados:** 3 componentes utilitarios listados en inventario pero no encontrados

---

## Vinculacion con Epic

### OQI-006: Señales ML

**Objetivo:** Sistema de señales ML con múltiples modelos de predicción, incluyendo:
- Visualización de predicciones
- Análisis de confianza
- Comparación de modelos
- Configuración de ensemble
- Análisis ICT avanzado

**Componentes Existentes:**
- AMDPhaseIndicator, PredictionCard, SignalsTimeline
- AccuracyMetrics, ICTAnalysisCard, EnsembleSignalCard
- ConfidenceMeter, SignalPerformanceTracker
- ModelAccuracyDashboard, BacktestResultsVisualization

---

## Justificacion de la Tarea

### Problema Identificado
1. **ModelSelector** - No hay forma de cambiar entre modelos ML en la UI
2. **EnsemblePanel** - No hay configuración de pesos del ensemble
3. **ICTAnalysisPanel** - No hay control de parámetros ICT

### Solucion Propuesta
Crear 3 componentes utilitarios que permitan:
1. Seleccionar y comparar modelos ML
2. Configurar pesos y método de votación del ensemble
3. Ajustar parámetros de análisis ICT

---

## Alcance

### Incluido
- Componentes frontend React/TypeScript
- Exportación de tipos TypeScript
- 3 variantes para ModelSelector (dropdown, tabs, cards)
- Secciones colapsables para ICTAnalysisPanel
- Actualización de inventarios

### Excluido
- Backend endpoints (ya existentes)
- Integración con store (responsabilidad del usuario)
- Tests unitarios
- Persistencia de configuración

---

## Referencias

- README.md del módulo ML: `apps/frontend/src/modules/ml/README.md`
- Inventario: `orchestration/inventarios/FRONTEND_INVENTORY.yml`
- ET Specs: `docs/02-definicion-modulos/OQI-006-ml-signals/especificaciones/`
