---
id: "RF-INV-001"
title: "Catalogo de Productos de Inversion"
type: "Requirement"
status: "Done"
priority: "Alta"
epic: "OQI-004"
project: "trading-platform"
version: "1.0.0"
created_date: "2025-12-05"
updated_date: "2026-01-04"
---

# RF-INV-001: Catálogo de Productos de Inversión

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | RF-INV-001 |
| **Épica** | OQI-004 - Cuentas de Inversión |
| **Tipo** | Requerimiento Funcional |
| **Prioridad** | P0 |
| **Story Points** | 8 |
| **Estado** | Aprobado |
| **Última actualización** | 2025-12-05 |

---

## Descripción

El sistema debe proporcionar un catálogo de productos de inversión gestionados por agentes de IA, cada uno con un perfil de riesgo específico, estrategia de trading, y métricas de rendimiento histórico.

---

## Productos Definidos

### 1. Atlas (Conservador)

| Característica | Valor |
|----------------|-------|
| **Perfil de Riesgo** | Conservador |
| **Target Mensual** | 3-5% |
| **Max Drawdown** | 5% |
| **Inversión Mínima** | $100 USD |
| **Estrategia** | Mean reversion + Grid trading |
| **Activos** | BTC, ETH (solo majors) |
| **Frecuencia** | 2-5 trades/día |
| **Color/Tema** | Azul / Escudo |

### 2. Orion (Moderado)

| Característica | Valor |
|----------------|-------|
| **Perfil de Riesgo** | Moderado |
| **Target Mensual** | 5-10% |
| **Max Drawdown** | 10% |
| **Inversión Mínima** | $500 USD |
| **Estrategia** | Trend following + Breakouts |
| **Activos** | Top 10 por market cap |
| **Frecuencia** | 5-15 trades/día |
| **Color/Tema** | Naranja / Estrellas |

### 3. Nova (Agresivo)

| Característica | Valor |
|----------------|-------|
| **Perfil de Riesgo** | Agresivo |
| **Target Mensual** | 10%+ |
| **Max Drawdown** | 20% |
| **Inversión Mínima** | $1,000 USD |
| **Estrategia** | Momentum + Altcoin rotation |
| **Activos** | Top 50 + nuevos listings |
| **Frecuencia** | 15-30 trades/día |
| **Color/Tema** | Púrpura / Supernova |

---

## Funcionalidades Requeridas

### RF-INV-001.1: Listado de Productos

- El sistema debe mostrar todos los productos disponibles
- Cada producto debe mostrar:
  - Nombre y descripción
  - Perfil de riesgo (badge visual)
  - Target de rendimiento mensual
  - Drawdown máximo
  - Inversión mínima
  - Rendimiento histórico (últimos 30 días)
- Los productos deben ordenarse por nivel de riesgo

### RF-INV-001.2: Detalle de Producto

- Página individual por producto con:
  - Descripción detallada de la estrategia
  - Gráfico de rendimiento histórico
  - Estadísticas de performance
  - Lista de activos operados
  - Términos y condiciones
  - CTA para abrir cuenta

### RF-INV-001.3: Métricas de Rendimiento

El sistema debe calcular y mostrar:

| Métrica | Descripción |
|---------|-------------|
| Rendimiento 24h | % ganancia/pérdida últimas 24 horas |
| Rendimiento 7d | % ganancia/pérdida últimos 7 días |
| Rendimiento 30d | % ganancia/pérdida últimos 30 días |
| Max Drawdown Real | Mayor pérdida desde máximo histórico |
| Sharpe Ratio | Rendimiento ajustado por riesgo |
| Win Rate | % de trades ganadores |
| Profit Factor | Ganancias brutas / Pérdidas brutas |

### RF-INV-001.4: Disponibilidad por Plan

| Plan | Atlas | Orion | Nova |
|------|-------|-------|------|
| Free | Visualización | Visualización | Visualización |
| Basic | ✅ Disponible | ❌ | ❌ |
| Pro | ✅ Disponible | ✅ Disponible | ❌ |
| Premium | ✅ Disponible | ✅ Disponible | ✅ Disponible |

---

## Reglas de Negocio

1. **RN-001**: Un usuario solo puede tener una cuenta activa por producto
2. **RN-002**: El usuario debe tener email verificado para abrir cuenta
3. **RN-003**: El usuario debe aceptar términos y condiciones específicos del producto
4. **RN-004**: Los rendimientos mostrados no garantizan resultados futuros (disclaimer obligatorio)
5. **RN-005**: El rendimiento histórico se calcula sobre cuentas reales, no backtest

---

## Criterios de Aceptación

```gherkin
Escenario: Usuario visualiza catálogo de productos
DADO que el usuario está autenticado
CUANDO accede a /investment/products
ENTONCES ve los 3 productos de inversión
Y cada producto muestra nombre, perfil de riesgo, target y rendimiento 30d
Y los productos están ordenados por nivel de riesgo (bajo a alto)

Escenario: Usuario visualiza detalle de producto
DADO que el usuario está en el catálogo
CUANDO hace click en un producto específico
ENTONCES ve la página de detalle con toda la información
Y ve el gráfico de rendimiento histórico
Y ve las estadísticas de performance
Y ve el botón de abrir cuenta (si tiene plan compatible)

Escenario: Producto bloqueado por plan
DADO que el usuario tiene plan Basic
CUANDO visualiza el producto Nova
ENTONCES el botón de abrir cuenta está deshabilitado
Y muestra mensaje "Upgrade a Premium para acceder"
Y muestra link para ver planes
```

---

## Datos de Ejemplo

```json
{
  "products": [
    {
      "id": "uuid-atlas",
      "name": "Atlas",
      "slug": "atlas",
      "tagline": "El Guardián",
      "description": "Estrategia conservadora enfocada en preservar capital con rendimientos estables.",
      "riskProfile": "conservative",
      "targetMonthly": { "min": 3, "max": 5 },
      "maxDrawdown": 5,
      "minInvestment": 100,
      "currency": "USD",
      "strategy": "Mean reversion + Grid trading",
      "assets": ["BTC", "ETH"],
      "tradingFrequency": "2-5 trades/día",
      "performance": {
        "return24h": 0.12,
        "return7d": 0.85,
        "return30d": 3.42,
        "sharpeRatio": 2.1,
        "winRate": 68.5,
        "profitFactor": 1.8
      },
      "color": "#3B82F6",
      "icon": "shield",
      "requiredPlans": ["basic", "pro", "premium"]
    }
  ]
}
```

---

## Dependencias

- **OQI-001**: Autenticación (verificar plan del usuario)
- **OQI-005**: Pagos (upgrade de plan)

---

## Referencias

- [US-INV-001: Ver productos de inversión](../historias-usuario/US-INV-001-ver-productos.md)
- [ET-INV-002: API REST](../especificaciones/ET-INV-002-api.md)

---

**Autor:** Requirements-Analyst
**Fecha:** 2025-12-05
