rckrdmrd/trading-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
c1b5081208
trading-platform/docs/02-definicion-modulos/OQI-003-trading-charts/historias-usuario/US-TRD-001-ver-chart.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

6.9 KiB
Raw Blame History

id title type status priority epic story_points created_date updated_date
US-TRD-001 Ver Chart de un Simbolo User Story Done Alta OQI-003 5 2025-12-05 2026-01-04

US-TRD-001: Ver Chart de un Símbolo

Metadata

Campo Valor
ID US-TRD-001
Épica OQI-003 - Trading y Charts
Módulo trading
Prioridad P0
Story Points 5
Sprint Sprint 3
Estado Pendiente
Asignado a Por asignar

Historia de Usuario

Como trader/inversor, quiero ver un gráfico de velas de un activo específico, para analizar el comportamiento del precio y tomar decisiones de trading.

Descripción Detallada

El usuario debe poder acceder a la página de trading y visualizar un chart profesional de velas japonesas (candlestick) para cualquier símbolo disponible en la plataforma. El chart debe mostrar datos históricos y actualizarse en tiempo real.

Mockups/Wireframes

┌─────────────────────────────────────────────────────────────────┐
│  BTCUSDT   $97,234.50   +2.34% ▲                               │
├─────────────────────────────────────────────────────────────────┤
│  [1m] [5m] [15m] [1h] [4h] [1D] [1W]    [Indicators ▼]        │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│    ████                                                         │
│    ████  ████                    ████                           │
│    ████  ████                    ████  ████                     │
│    ████  ████  ████              ████  ████  ████               │
│          ████  ████  ████        ████  ████  ████  ████         │
│                ████  ████  ████        ████  ████  ████ ████    │
│                      ████  ████              ████  ████ ████    │
│                            ████                    ████ ████    │
│                                                         ████    │
│                                                                  │
├─────────────────────────────────────────────────────────────────┤
│  ▓▓▓  ▓▓▓▓  ▓▓▓  ▓▓▓▓▓  ▓▓▓  ▓▓▓▓  ▓▓▓  ▓▓▓▓▓  ▓▓▓  ▓▓  VOLUME│
└─────────────────────────────────────────────────────────────────┘

Criterios de Aceptación

Escenario 1: Ver chart por defecto

DADO que el usuario está autenticado
Y navega a la página de trading
CUANDO la página carga
ENTONCES se muestra el chart de BTCUSDT (símbolo por defecto)
Y el timeframe es 1h por defecto
Y se muestran al menos 168 velas históricas
Y se muestra el panel de volumen debajo

Escenario 2: Cambiar símbolo

DADO que el usuario está viendo un chart
CUANDO selecciona otro símbolo del dropdown (ej: ETHUSDT)
ENTONCES el chart se actualiza con datos de ETHUSDT
Y se mantiene el timeframe seleccionado
Y el header muestra el nuevo símbolo y precio

Escenario 3: Actualización en tiempo real

DADO que el usuario está viendo un chart
CUANDO pasa 1 segundo
ENTONCES la última vela se actualiza con el precio actual
Y el precio en el header se actualiza
Y el porcentaje de cambio se recalcula

Escenario 4: Información en tooltip

DADO que el usuario está viendo un chart
CUANDO pasa el cursor sobre una vela
ENTONCES se muestra un tooltip con:
  - Fecha y hora
  - Open, High, Low, Close
  - Volumen
  - Cambio porcentual de la vela

Criterios Adicionales

  • El chart debe cargar en menos de 2 segundos
  • El chart debe ser responsive y funcionar en mobile
  • Colores de velas: Verde para alcista, Rojo para bajista
  • Crosshair debe seguir el cursor
  • Logo watermark de Trading Platform en esquina

Tareas Técnicas

Backend:

  • BE-TRD-001: Crear endpoint GET /trading/candles/:symbol
  • BE-TRD-002: Implementar servicio de conexión con Binance API
  • BE-TRD-003: Implementar caché de datos con Redis (TTL: 60s)

Frontend:

  • FE-TRD-001: Instalar y configurar Lightweight Charts
  • FE-TRD-002: Crear componente TradingChart.tsx
  • FE-TRD-003: Crear componente ChartHeader.tsx
  • FE-TRD-004: Crear tradingStore con Zustand
  • FE-TRD-005: Implementar conexión WebSocket para updates

Tests:

  • TEST-TRD-001: Test unitario de transformación de datos
  • TEST-TRD-002: Test de integración del endpoint candles
  • TEST-TRD-003: Test E2E de carga del chart

Dependencias

Depende de:

  • US-AUTH-001: Autenticación - Estado: ✅ Completado

Bloquea:

  • US-TRD-002: Cambiar timeframe
  • US-TRD-003: Agregar indicador

Notas Técnicas

Endpoints involucrados:

Método Endpoint Descripción
GET /trading/candles/:symbol Obtener velas históricas
WS /trading/stream/:symbol Stream de actualizaciones

Entidades/Tablas:

  • No requiere persistencia (datos de API externa)

Componentes UI:

  • TradingChart: Componente principal del gráfico
  • ChartHeader: Header con símbolo, precio, cambio
  • TimeframeSelector: Selector de intervalos
  • VolumePanel: Panel de barras de volumen

Definition of Ready (DoR)

  • Historia claramente escrita (quién, qué, por qué)
  • Criterios de aceptación definidos
  • Story points estimados
  • Dependencias identificadas
  • Sin bloqueadores
  • Diseño/mockup disponible
  • API spec disponible

Definition of Done (DoD)

  • Código implementado según criterios
  • Tests unitarios escritos y pasando
  • Tests de integración pasando
  • Code review aprobado
  • Documentación actualizada
  • QA aprobado
  • Desplegado en ambiente de pruebas

Historial de Cambios

Fecha Cambio Autor
2025-12-05 Creación Requirements-Analyst

Creada por: Requirements-Analyst Fecha: 2025-12-05 Última actualización: 2025-12-05