rckrdmrd
c1b5081208
ML Engine Updates: - Updated BTCUSD with Polygon API data (2024-2025): 215,699 new records - Re-trained all ML models: Attention (R²: 0.223), Base, Metamodel (87.3% confidence) - Backtest results: +176.71R profit with aggressive_filter strategy Documentation Consolidation: - Created docs/99-analisis/_MAP.md index with 13 new analysis documents - Consolidated inventories: removed duplicates from orchestration/inventarios/ - Updated ML_INVENTORY.yml with BTCUSD metrics and training results - Added execution reports: FASE11-BTCUSD, correction issues, alignment validation Architecture & Integration: - Updated all module documentation with NEXUS v3.4 frontmatter - Fixed _MAP.md indexes across all folders - Updated orchestration plans and traces Files: 229 changed, 5064 insertions(+), 1872 deletions(-) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
150 lines
3.5 KiB
Markdown
150 lines
3.5 KiB
Markdown
---
|
|
id: "US-LLM-004"
|
|
title: "Ver Predicciones ML Explicadas"
|
|
type: "User Story"
|
|
status: "Done"
|
|
priority: "Media"
|
|
epic: "OQI-007"
|
|
project: "trading-platform"
|
|
story_points: 3
|
|
created_date: "2025-12-05"
|
|
updated_date: "2026-01-04"
|
|
---
|
|
|
|
# US-LLM-004: Ver Predicciones ML Explicadas
|
|
|
|
**Épica:** OQI-007 - LLM Strategy Agent
|
|
**Sprint:** TBD
|
|
**Story Points:** 5
|
|
**Prioridad:** P0 - Crítico
|
|
|
|
---
|
|
|
|
## Historia de Usuario
|
|
|
|
**Como** usuario Pro o Premium
|
|
**Quiero** ver las predicciones del modelo ML explicadas en lenguaje natural
|
|
**Para** entender qué predice el modelo y por qué, y usarlo en mis decisiones
|
|
|
|
---
|
|
|
|
## Criterios de Aceptación
|
|
|
|
### AC-1: Ver predicción ML básica
|
|
```gherkin
|
|
Given soy usuario Pro o Premium
|
|
When pregunto "¿Qué dice el ML sobre AAPL?"
|
|
Then el agente responde con:
|
|
| Campo | Contenido |
|
|
| Predicción | Dirección (bullish/bearish/neutral) |
|
|
| Confianza | Porcentaje de confianza |
|
|
| Horizonte | Timeframe de la predicción |
|
|
| Explicación | Por qué el modelo predice esto |
|
|
```
|
|
|
|
### AC-2: Explicación de features
|
|
```gherkin
|
|
Given pido detalles de la predicción ML
|
|
When pregunto "¿Por qué el ML predice eso?"
|
|
Then el agente explica las principales features
|
|
And muestra qué indicadores influyeron más
|
|
And traduce los términos técnicos a lenguaje simple
|
|
```
|
|
|
|
### AC-3: Restricción por plan
|
|
```gherkin
|
|
Given soy usuario Free
|
|
When pregunto "¿Qué dice el ML sobre TSLA?"
|
|
Then el agente responde que las señales ML requieren plan Pro
|
|
And muestra opción de upgrade
|
|
And NO muestra predicciones
|
|
```
|
|
|
|
### AC-4: Precisión histórica
|
|
```gherkin
|
|
Given pido información sobre el modelo
|
|
When pregunto "¿Qué tan preciso es el ML?"
|
|
Then el agente muestra precisión histórica del modelo
|
|
And explica qué significa el porcentaje
|
|
And incluye disclaimer sobre rendimiento pasado
|
|
```
|
|
|
|
### AC-5: Combinación con análisis técnico
|
|
```gherkin
|
|
Given pido análisis completo
|
|
When digo "Analiza NVDA con señales ML"
|
|
Then el agente combina:
|
|
- Análisis técnico tradicional
|
|
- Predicción ML con explicación
|
|
- Conclusión que integra ambos
|
|
```
|
|
|
|
---
|
|
|
|
## Formato de Respuesta Esperado
|
|
|
|
```markdown
|
|
## Señales ML para AAPL 🤖
|
|
|
|
### Predicción
|
|
📈 **Alcista** con 72% de confianza
|
|
|
|
### Horizonte
|
|
Próximas 4 horas
|
|
|
|
### Por qué el modelo predice esto
|
|
El modelo detecta:
|
|
1. **Momentum positivo** - RSI y MACD alineados
|
|
2. **Volumen creciente** - Indica interés comprador
|
|
3. **Patrón de precio** - Consolidación sobre soporte
|
|
|
|
### Features Principales
|
|
| Feature | Peso | Valor Actual |
|
|
|---------|------|--------------|
|
|
| RSI momentum | 23% | Positivo |
|
|
| Volume profile | 18% | Acumulación |
|
|
| Price pattern | 15% | Bullish flag |
|
|
|
|
### Precisión Histórica
|
|
El modelo ha tenido 68% de precisión en predicciones
|
|
similares para AAPL en los últimos 30 días.
|
|
|
|
⚠️ *Las predicciones ML son herramientas de apoyo, no garantías.
|
|
El rendimiento pasado no garantiza resultados futuros.*
|
|
```
|
|
|
|
---
|
|
|
|
## Notas Técnicas
|
|
|
|
- Tool: `get_ml_signals` para obtener predicción
|
|
- Tool: `get_ml_features` para explicación detallada (Premium)
|
|
- Integración con ML Engine (OQI-006)
|
|
- Cache de predicciones: 60 segundos
|
|
- Solo disponible para símbolos soportados por el modelo
|
|
|
|
---
|
|
|
|
## Dependencias
|
|
|
|
- RF-LLM-002.4: Integración con Señales ML
|
|
- ET-LLM-002: Agente de Análisis
|
|
- OQI-006: ML Signals
|
|
|
|
---
|
|
|
|
## Definición de Done
|
|
|
|
- [ ] Integración con ML Engine
|
|
- [ ] Explicación en lenguaje natural
|
|
- [ ] Restricción por plan
|
|
- [ ] Precisión histórica mostrada
|
|
- [ ] Disclaimers incluidos
|
|
- [ ] Tests E2E
|
|
- [ ] QA aprobado
|
|
|
|
---
|
|
|
|
*Historia de usuario - Sistema NEXUS*
|
|
*Trading Platform*
|