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