# Epicas y Historias de Usuario - OQI-006 ML Signals

**Version:** 1.0.0
**Fecha:** 2025-12-05
**Modulo:** OQI-006-ml-signals

---

## Descripcion General

Este directorio contiene la documentacion formal de epicas e historias de usuario para el modulo de Senales ML de OrbiQuant IA, con enfoque en la estrategia AMD (Accumulation-Manipulation-Distribution) y modelos ML avanzados.

---

## Epicas

### OQI-006A - Estrategia AMD y Modelos ML Avanzados

| Aspecto | Valor |
|---------|-------|
| **Archivo** | `EPICA-OQI-006A-ESTRATEGIA-AMD-ML.md` |
| **Story Points** | 89 SP |
| **Historias** | 11 |
| **Prioridad** | P0 |
| **Estado** | Ready |

**Resumen:**
Implementacion completa de la estrategia AMD como motor central de deteccion de fases de mercado, junto con modelos ML especializados (AMDDetector, LiquidityHunter, StrategyOrchestrator) para generar senales de alta probabilidad.

**Modelos ML:**
- AMDDetector (clasificador de fases)
- RangePredictor (extendido con features AMD)
- TPSLClassifier (stacking mejorado)
- LiquidityHunter (detector de sweeps)
- StrategyOrchestrator (meta-modelo de confluence)

---

## Historias de Usuario

### Directorio: `historias-usuario/`

| ID | Titulo | SP | Prioridad | Sprint | Estado |
|----|--------|-----|-----------|--------|--------|
| US-ML-020 | Ver Fase AMD Actual | 8 | P0 | 8 | Ready |
| US-ML-021 | Alertas de Cambio de Fase | 5 | P0 | 8 | Ready |
| US-ML-022 | Zonas de Liquidez (BSL/SSL) | 8 | P0 | 9 | Ready |
| US-ML-023 | Senales Filtradas por Fase | 5 | P0 | 9 | Ready |
| US-ML-024 | Score de Confluencia | 8 | P0 | 9 | Ready |
| US-ML-025 | Predicciones Mejoradas AMD | 13 | P1 | 10 | Ready |
| US-ML-026 | Order Blocks y FVG | 8 | P1 | 10 | Ready |
| US-ML-027 | Integracion ICT/SMC | 13 | P1 | 10 | Ready |
| US-ML-028 | Backtesting AMD | 8 | P2 | 11 | Ready |
| US-ML-029 | Monitoring de Modelos | 5 | P1 | 11 | Ready |
| US-ML-030 | Reentrenamiento Automatico | 8 | P2 | 11 | Ready |

### Historias Detalladas Disponibles

1. **US-ML-020-ver-fase-amd.md**
   - Visualizacion de fase AMD actual
   - Indicador con confianza y duracion
   - Historial de fases

2. **US-ML-022-zonas-liquidez.md**
   - Zonas BSL/SSL en chart
   - Deteccion de sweeps
   - Probabilidad de visita

3. **US-ML-024-score-confluencia.md**
   - Score multi-factor (0-100)
   - Desglose por componentes
   - Personalizacion de pesos

4. **US-ML-027-integracion-ict-smc.md**
   - Killzones (London, NY, Asian)
   - Zonas OTE (Fibonacci)
   - Estructura BOS/CHOCH

---

## Roadmap de Sprints

```
Sprint 8 (2 semanas)
├── US-ML-020: Ver fase AMD [8 SP]
├── US-ML-021: Alertas cambio fase [5 SP]
└── Total: 13 SP

Sprint 9 (2 semanas)
├── US-ML-022: Zonas liquidez [8 SP]
├── US-ML-023: Senales filtradas [5 SP]
├── US-ML-024: Score confluencia [8 SP]
└── Total: 21 SP

Sprint 10 (2 semanas)
├── US-ML-025: Predicciones AMD [13 SP]
├── US-ML-026: Order Blocks/FVG [8 SP]
├── US-ML-027: ICT/SMC [13 SP]
└── Total: 34 SP

Sprint 11 (2 semanas)
├── US-ML-028: Backtesting [8 SP]
├── US-ML-029: Monitoring [5 SP]
├── US-ML-030: Reentrenamiento [8 SP]
└── Total: 21 SP

TOTAL EPICA: 89 SP (8 semanas)
```

---

## Dependencias

### Internas
- OQI-001 (Auth): Completado
- OQI-003 (Trading Charts): En progreso
- TradingAgent Phase 2: Completado

### Externas
- OQI-007 (LLM Agent): Bloqueado por esta epica
- OQI-008 (Portfolio Manager): Bloqueado por esta epica

---

## Documentacion Relacionada

| Tipo | Ubicacion |
|------|-----------|
| Estrategia AMD | `../estrategias/ESTRATEGIA-AMD-COMPLETA.md` |
| Estrategia ICT/SMC | `../estrategias/ESTRATEGIA-ICT-SMC.md` |
| Modelos ML | `../estrategias/MODELOS-ML-DEFINICION.md` |
| Features/Targets | `../estrategias/FEATURES-TARGETS-ML.md` |
| Pipeline | `../estrategias/PIPELINE-ORQUESTACION.md` |
| TradingAgent | `[LEGACY: apps/ml-engine - migrado desde TradingAgent]/` |

---

## Metricas de Exito

| Metrica | Baseline | Target |
|---------|----------|--------|
| AMD Accuracy (per class) | N/A | >65% |
| Directional Accuracy | 70% | >85% |
| Win Rate | 50% | >60% |
| Profit Factor | 1.2 | >2.0 |
| Max Drawdown | 15% | <10% |
| Latencia E2E | N/A | <1,200ms |

---

## Contacto

**Equipo:** Trading Platform - ML Engineering
**Requirements Analyst:** Requirements-Analyst Agent
**Trading Strategist:** Trading-Strategist Agent

---

**Creado por:** Requirements-Analyst
**Fecha:** 2025-12-05
**Ultima actualizacion:** 2025-12-05
