trading-platform/docs/02-definicion-modulos/OQI-007-llm-agent/historias-usuario/US-LLM-010-paper-trading-chat.md
rckrdmrd c1b5081208 feat(ml): Complete FASE 11 - BTCUSD update and comprehensive documentation alignment
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>
2026-01-07 09:31:29 -06:00

172 lines
3.4 KiB
Markdown

---
id: "US-LLM-010"
title: "Crear Órdenes de Paper Trading vía Chat"
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-010: Crear Órdenes de Paper Trading vía Chat
**Épica:** OQI-007 - LLM Strategy Agent
**Sprint:** TBD
**Story Points:** 8
**Prioridad:** P0 - Crítico
---
## Historia de Usuario
**Como** usuario Pro o Premium con paper trading habilitado
**Quiero** crear órdenes de paper trading desde el chat
**Para** ejecutar estrategias rápidamente sin cambiar de pantalla
---
## Criterios de Aceptación
### AC-1: Crear orden de mercado
```gherkin
Given soy usuario Pro/Premium
And tengo paper trading habilitado
When digo "Compra 10 acciones de AAPL"
Then el agente prepara la orden
And muestra resumen antes de ejecutar
And pide confirmación
When confirmo
Then la orden se crea
And veo confirmación con detalles
```
### AC-2: Crear orden límite
```gherkin
Given quiero comprar a precio específico
When digo "Compra TSLA a $240"
Then el agente crea orden límite
And muestra precio actual vs mi límite
And explica cuándo se ejecutaría
```
### AC-3: Orden con stop loss
```gherkin
Given quiero orden con protección
When digo "Compra AAPL con stop en $180"
Then el agente crea orden + stop loss
And muestra ambos niveles
And calcula riesgo de la posición
```
### AC-4: Confirmación obligatoria
```gherkin
Given solicito crear una orden
When el agente prepara la orden
Then siempre muestra resumen:
- Símbolo y acción (buy/sell)
- Cantidad y tipo de orden
- Precio estimado
- Costo total
And requiere confirmación explícita
And NO ejecuta sin confirmación
```
### AC-5: Restricción por plan
```gherkin
Given soy usuario Free
When intento crear orden de paper trading
Then el agente indica que requiere plan Pro
And muestra opción de upgrade
And NO permite crear la orden
```
### AC-6: Ver y cancelar órdenes
```gherkin
Given tengo órdenes pendientes
When pregunto "¿Cuáles son mis órdenes pendientes?"
Then el agente lista mis órdenes
When digo "Cancela la orden de AAPL"
Then el agente cancela la orden
And confirma la cancelación
```
---
## Flujo de Confirmación
```markdown
## Confirmar Orden 📋
**Acción:** COMPRA
**Símbolo:** AAPL - Apple Inc.
**Cantidad:** 10 acciones
**Tipo:** Market Order
**Precio estimado:** ~$185.50
**Costo total:** ~$1,855.00
---
⚠️ Esta es una orden de PAPER TRADING (simulada)
¿Confirmas esta orden?
[✅ Confirmar] [❌ Cancelar]
```
---
## Respuesta Post-Ejecución
```markdown
## Orden Ejecutada ✅
**ID:** paper-12345
**Status:** Filled
**Símbolo:** AAPL
**Cantidad:** 10 acciones
**Precio:** $185.48
**Total:** $1,854.80
**Timestamp:** 15:45:32 ET
Tu posición actual en AAPL: 10 acciones @ $185.48
```
---
## Notas Técnicas
- Tool: `create_paper_order`
- Tool: `cancel_paper_order`
- Tool: `get_pending_orders`
- Confirmación obligatoria antes de ejecutar
- Solo paper trading, nunca órdenes reales
- Rate limit: 10 órdenes/minuto
---
## Dependencias
- RF-LLM-005.5: Herramienta Paper Trading
- ET-LLM-005: Arquitectura Tools
- OQI-003: Paper Trading System
---
## Definición de Done
- [ ] Crear órdenes market/limit
- [ ] Confirmación obligatoria
- [ ] Cancelar órdenes
- [ ] Ver órdenes pendientes
- [ ] Restricción por plan
- [ ] Tests E2E
- [ ] QA aprobado
---
*Historia de usuario - Sistema NEXUS*
*Trading Platform*