rckrdmrd/trading-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
trading-platform/docs/02-definicion-modulos/OQI-008-portfolio-manager/requerimientos/RF-PFM-001-dashboard-portfolio.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

8.7 KiB
Raw Permalink Blame History

id title type status priority epic project version created_date updated_date
RF-PFM-001 Dashboard de Portfolio Requirement Done Alta OQI-008 trading-platform 1.0.0 2025-12-05 2026-01-04

RF-PFM-001: Dashboard de Portfolio

Épica: OQI-008 - Portfolio Manager Versión: 1.0 Fecha: 2025-12-05 Estado: Planificado Prioridad: P0 - Crítico

Descripción

El sistema debe proporcionar un dashboard centralizado donde el usuario pueda ver todas sus posiciones, rendimiento general, métricas clave y alertas de su portfolio de inversiones.

Requisitos Funcionales

RF-PFM-001.1: Vista General del Portfolio

  • El dashboard debe mostrar valor total del portfolio
  • El dashboard debe mostrar P&L total (ganancia/pérdida)
  • El dashboard debe mostrar P&L del día
  • El dashboard debe mostrar % de cambio diario y total
  • El dashboard debe mostrar distribución por tipo de activo

RF-PFM-001.2: Lista de Posiciones

  • El usuario debe ver todas sus posiciones abiertas
  • Cada posición debe mostrar: símbolo, cantidad, precio promedio, P&L
  • Las posiciones deben poder ordenarse por columna
  • Las posiciones deben poder filtrarse por tipo (acciones, crypto, etc.)
  • Se debe mostrar % de cada posición respecto al portfolio total

RF-PFM-001.3: Métricas de Rendimiento

  • El dashboard debe mostrar rendimiento histórico (1d, 1w, 1m, 3m, 1y)
  • El dashboard debe mostrar comparación con benchmark (S&P 500)
  • El dashboard debe mostrar volatilidad del portfolio
  • El dashboard debe mostrar Sharpe ratio (Premium)
  • El dashboard debe mostrar máximo drawdown

RF-PFM-001.4: Gráfico de Rendimiento

  • El usuario debe ver gráfico de valor del portfolio en el tiempo
  • El gráfico debe ser interactivo (zoom, hover)
  • El gráfico debe permitir cambiar timeframe
  • El gráfico debe poder superponerse con benchmark
  • El gráfico debe mostrar eventos importantes (depósitos, retiros)

RF-PFM-001.5: Alertas de Portfolio

  • El dashboard debe mostrar alertas de posiciones con pérdida significativa
  • El dashboard debe alertar de alta concentración en un activo
  • El dashboard debe alertar de margen bajo (si aplica)
  • El dashboard debe mostrar oportunidades de rebalanceo

Criterios de Aceptación

Feature: Dashboard de Portfolio

Scenario: Ver resumen del portfolio
  Given soy usuario con posiciones activas
  When accedo al Dashboard de Portfolio
  Then veo el valor total de mi portfolio
  And veo P&L total y del día
  And veo la lista de mis posiciones
  And veo gráfico de rendimiento

Scenario: Ordenar posiciones
  Given estoy viendo mis posiciones
  When hago clic en el header "P&L"
  Then las posiciones se ordenan por P&L
  And puedo alternar ascendente/descendente

Scenario: Ver métricas avanzadas
  Given soy usuario Premium
  When veo la sección de métricas
  Then veo Sharpe ratio
  And veo Sortino ratio
  And veo correlación con mercado

Reglas de Negocio

Regla Descripción
RN-001 Actualización de precios cada 15 segundos
RN-002 Métricas avanzadas (Sharpe, Sortino) solo Premium
RN-003 Benchmark default: S&P 500
RN-004 Alerta de concentración si posición > 30% del portfolio
RN-005 Historial de rendimiento limitado a 1 año (Free), ilimitado (Pro+)

Dependencias

Épicas Requeridas

  • OQI-001: Autenticación
  • OQI-003: Datos de mercado
  • OQI-004: Cuentas de inversión

Datos Requeridos

  • Posiciones del usuario
  • Precios en tiempo real
  • Historial de transacciones
  • Datos de benchmark

Mockups/Wireframes

┌─────────────────────────────────────────────────────────────────────────┐
│ Portfolio Dashboard                               [🔔] [⚙️] [Depositar] │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌────────────────────┐ ┌────────────────────┐ ┌────────────────────┐   │
│  │   VALOR TOTAL      │ │    P&L TOTAL       │ │    P&L HOY         │   │
│  │   $45,230.50       │ │   +$5,230.50       │ │   +$320.40         │   │
│  │                    │ │   +13.1%           │ │   +0.71%           │   │
│  └────────────────────┘ └────────────────────┘ └────────────────────┘   │
│                                                                          │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │                     Rendimiento del Portfolio                       │ │
│  │    📈 [Gráfico interactivo de línea]                               │ │
│  │                                                                     │ │
│  │    $45k ─────────────────────────────────────╱                     │ │
│  │    $40k ─────────────────────────────╱──────╱                      │ │
│  │    $35k ─────────────────────╱──────╱                              │ │
│  │         ─────────────────────────────────────────                  │ │
│  │         Ene   Feb   Mar   Abr   May   Jun   Jul                    │ │
│  │                                                                     │ │
│  │    [1D] [1W] [1M] [3M] [6M] [1Y] [All]    ☑️ vs S&P 500           │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ Mis Posiciones                                    [Filtrar ▾]      │ │
│  ├────────────┬─────────┬───────────┬───────────┬──────────┬─────────┤ │
│  │ Símbolo    │ Cant.   │ Precio    │ Valor     │ P&L      │ % Port  │ │
│  ├────────────┼─────────┼───────────┼───────────┼──────────┼─────────┤ │
│  │ AAPL       │ 50      │ $185.50   │ $9,275    │ +$525    │ 20.5%   │ │
│  │ TSLA       │ 20      │ $245.30   │ $4,906    │ -$100    │ 10.8%   │ │
│  │ BTC/USD    │ 0.5     │ $42,500   │ $21,250   │ +$2,500  │ 47.0%   │ │
│  │ ...        │         │           │           │          │         │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘

Especificaciones Técnicas Relacionadas

Historias de Usuario Relacionadas

  • US-PFM-001: Ver resumen del portfolio
  • US-PFM-002: Ver lista de posiciones

Documento de requerimientos - Sistema NEXUS Trading Platform