trading-platform/docs/02-definicion-modulos/OQI-007-llm-agent/historias-usuario/US-LLM-010-paper-trading-chat.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

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*
*OrbiQuant IA Trading Platform*