trading-platform/docs/02-definicion-modulos/OQI-007-llm-agent/historias-usuario/US-LLM-003-analisis-simbolo.md
rckrdmrd a7cca885f0 feat: Major platform documentation and architecture updates
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>
2026-01-07 05:33:35 -06:00

163 lines
3.9 KiB
Markdown

---
id: "US-LLM-003"
title: "Solicitar Análisis de Símbolo"
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-003: Solicitar Análisis de Símbolo
**Épica:** OQI-007 - LLM Strategy Agent
**Sprint:** TBD
**Story Points:** 8
**Prioridad:** P0 - Crítico
---
## Historia de Usuario
**Como** trader que usa OrbiQuant
**Quiero** pedirle al Copilot que analice un símbolo específico
**Para** obtener un análisis técnico completo que me ayude a tomar decisiones
---
## Criterios de Aceptación
### AC-1: Análisis técnico básico
```gherkin
Given soy usuario autenticado
When pregunto "Analiza AAPL" o "¿Qué opinas de AAPL?"
Then el agente responde con:
| Sección | Contenido |
| Precio actual | Con cambio 24h |
| Tendencia | Dirección y fuerza |
| Soportes | Niveles identificados |
| Resistencias | Niveles identificados |
| Indicadores | RSI, MACD, BB con interpretación |
| Conclusión | Sesgo alcista/bajista/neutral |
```
### AC-2: Análisis con múltiples timeframes
```gherkin
Given pregunto por un análisis
When pido "Analiza TSLA en todos los timeframes"
Then el agente muestra análisis de:
- Corto plazo (1h)
- Medio plazo (4h)
- Largo plazo (1d)
And cada timeframe tiene sus indicadores
```
### AC-3: Análisis fundamental (solo acciones)
```gherkin
Given soy usuario Pro o Premium
When pregunto "Dame el análisis fundamental de MSFT"
Then el agente incluye:
| Métrica | Información |
| P/E Ratio | Valor y comparación sector |
| Revenue | Crecimiento |
| EPS | Valor y tendencia |
| Próximos earnings | Fecha si aplica |
| Rating analistas | Buy/Hold/Sell |
```
### AC-4: Análisis de crypto
```gherkin
Given pregunto por análisis de crypto
When digo "Analiza BTC/USD"
Then el agente incluye análisis técnico
And NO incluye análisis fundamental
And incluye métricas on-chain relevantes (si disponibles)
And incluye fear & greed index
```
### AC-5: Disclaimer obligatorio
```gherkin
Given solicito cualquier tipo de análisis
When el agente responde
Then siempre incluye disclaimer de riesgo
And el disclaimer indica que no es asesoría financiera
```
### AC-6: Datos en tiempo real
```gherkin
Given pido análisis de un símbolo
When el agente obtiene datos
Then los datos tienen máximo 15 segundos de antigüedad
And muestra timestamp del último precio
```
---
## Formato de Respuesta Esperado
```markdown
## Análisis de AAPL - Apple Inc.
### Precio Actual
$185.50 (+2.3%) | Vol: 45M | 🕐 15:30 ET
### Tendencia
📈 **Alcista** - Precio sobre SMA 20 y 50, momentum positivo
### Niveles Clave
| Soportes | Resistencias |
|----------|--------------|
| $180 (fuerte) | $188 (inmediata) |
| $175 | $192 |
| $170 | $200 |
### Indicadores Técnicos
- **RSI (14):** 62 - Neutral con sesgo alcista
- **MACD:** Positivo, histograma creciente
- **Bollinger:** Precio en banda superior, tendencia fuerte
### Conclusión
AAPL muestra fortaleza técnica con momentum positivo.
Vigilar resistencia en $188 para confirmación de breakout.
⚠️ *Este análisis es informativo. No constituye asesoría financiera.*
```
---
## Notas Técnicas
- El agente usa tool `get_price` para precio actual
- Usa tool `get_indicators` para indicadores técnicos
- Usa tool `get_fundamentals` para datos fundamentales
- Cache de datos: 5 segundos para precio, 60 segundos para indicadores
- Indicadores calculados: RSI, MACD, BB, SMA (20, 50, 200), EMA, ATR
---
## Dependencias
- RF-LLM-002.1: Análisis Técnico
- RF-LLM-002.2: Análisis Fundamental
- ET-LLM-002: Agente de Análisis
---
## Definición de Done
- [ ] Análisis técnico completo implementado
- [ ] Análisis fundamental para acciones
- [ ] Manejo de crypto sin fundamentales
- [ ] Formato de respuesta consistente
- [ ] Disclaimers incluidos
- [ ] Tests E2E
- [ ] QA aprobado
---
*Historia de usuario - Sistema NEXUS*
*OrbiQuant IA Trading Platform*