--- id: "RF-PFM-001" title: "Dashboard de Portfolio" type: "Requirement" status: "Done" priority: "Alta" epic: "OQI-008" project: "trading-platform" version: "1.0.0" created_date: "2025-12-05" updated_date: "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 ```gherkin 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 - [ET-PFM-001: Arquitectura Dashboard](../especificaciones/ET-PFM-001-arquitectura-dashboard.md) - [ET-PFM-002: Cálculo de Métricas](../especificaciones/ET-PFM-002-calculo-metricas.md) --- ## 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*