# RF-PFM-007: Metas de Inversión

**Épica:** OQI-008 - Portfolio Manager
**Versión:** 1.0
**Fecha:** 2025-12-05
**Estado:** Planificado
**Prioridad:** P2 - Medio

---

## Descripción

El sistema debe permitir al usuario definir metas financieras y hacer seguimiento del progreso hacia esas metas, incluyendo simulaciones y sugerencias para alcanzarlas.

---

## Requisitos Funcionales

### RF-PFM-007.1: Crear Meta de Inversión
- El usuario debe poder crear metas con:
  - Nombre de la meta (ej: "Retiro", "Casa", "Educación")
  - Monto objetivo
  - Fecha objetivo
  - Monto inicial (opcional)
  - Contribución mensual planeada
- El sistema debe validar que la meta sea alcanzable
- El usuario debe poder vincular una cuenta a la meta

### RF-PFM-007.2: Seguimiento de Progreso
- El sistema debe mostrar progreso actual vs objetivo
- El sistema debe mostrar proyección a fecha objetivo
- El sistema debe indicar si está "on track" o "behind"
- El sistema debe mostrar gráfico de progreso
- El sistema debe considerar rendimiento esperado

### RF-PFM-007.3: Simulaciones
- El sistema debe simular escenarios:
  - Optimista (mayor rendimiento)
  - Base (rendimiento promedio)
  - Pesimista (menor rendimiento)
- El usuario debe poder ajustar contribución y ver impacto
- El sistema debe mostrar probabilidad de alcanzar la meta

### RF-PFM-007.4: Sugerencias
- El sistema debe sugerir ajustes para cumplir la meta
- Sugerencias: aumentar contribución, extender plazo, ajustar objetivo
- El sistema debe sugerir portfolio adecuado para el horizonte
- Alertar si el portfolio actual no es apropiado para la meta

### RF-PFM-007.5: Notificaciones
- Notificar progreso mensual
- Alertar si la meta se desvía significativamente
- Celebrar hitos alcanzados (25%, 50%, 75%)
- Recordar hacer contribuciones

---

## Criterios de Aceptación

```gherkin
Feature: Metas de Inversión

Scenario: Crear meta de inversión
  Given soy usuario Pro/Premium
  When creo una nueva meta
  And ingreso:
    | Campo | Valor |
    | Nombre | Retiro |
    | Monto objetivo | $500,000 |
    | Fecha objetivo | 2045 |
    | Contribución mensual | $1,000 |
  Then la meta se crea correctamente
  And veo proyección de si la alcanzaré
  And veo sugerencias si es necesario

Scenario: Ver progreso de meta
  Given tengo meta de inversión activa
  When accedo a "Mis Metas"
  Then veo progreso actual ($75,000 de $500,000)
  And veo gráfico de proyección
  And veo si estoy "on track" o no

Scenario: Simular escenarios
  Given tengo meta creada
  When veo simulación de escenarios
  Then veo proyección optimista, base y pesimista
  And veo probabilidad de alcanzar la meta
  And puedo ajustar contribución y ver nuevo resultado

Scenario: Recibir sugerencia
  Given mi meta está "behind" del objetivo
  When el sistema analiza mi situación
  Then recibo sugerencia: "Aumenta contribución a $1,200/mes"
  Or recibo sugerencia: "Extiende plazo 2 años"
  And veo impacto de cada opción
```

---

## Reglas de Negocio

| Regla | Descripción |
|-------|-------------|
| RN-001 | Metas disponibles para Pro/Premium |
| RN-002 | Máximo 5 metas activas |
| RN-003 | Rendimiento esperado default: 7% anual |
| RN-004 | Inflación considerada: 3% anual |
| RN-005 | Horizonte mínimo: 1 año |
| RN-006 | Contribución mínima: $50/mes |

---

## Tipos de Metas Predefinidas

### Retiro
```yaml
template: retirement
typical_horizon: 20-30 años
suggested_allocation: conservative_to_aggressive_based_on_years
expected_return: 7%
```

### Compra de Casa
```yaml
template: home_purchase
typical_horizon: 3-10 años
suggested_allocation: moderate
expected_return: 5%
```

### Educación
```yaml
template: education
typical_horizon: 5-18 años
suggested_allocation: moderate_to_conservative
expected_return: 6%
```

### Fondo de Emergencia
```yaml
template: emergency_fund
typical_horizon: 6-12 meses
suggested_allocation: very_conservative
expected_return: 2%
```

### Objetivo Personalizado
```yaml
template: custom
typical_horizon: user_defined
suggested_allocation: user_defined
expected_return: user_defined
```

---

## Wireframe

```
┌─────────────────────────────────────────────────────────────────────────┐
│ Mis Metas de Inversión                                [+ Nueva Meta]   │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 🎯 Retiro                                              [On Track ✓] │ │
│ │                                                                      │ │
│ │ Progreso: $75,000 de $500,000 (15%)                                 │ │
│ │ ████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  15%               │ │
│ │                                                                      │ │
│ │ Fecha objetivo: 2045 (20 años restantes)                            │ │
│ │ Contribución: $1,000/mes                                            │ │
│ │ Rendimiento esperado: 7% anual                                      │ │
│ │                                                                      │ │
│ │ Proyección al 2045: $520,000 ✓                                      │ │
│ │                                                                      │ │
│ │ [Ver Detalles] [Editar] [Simular]                                   │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 🏠 Enganche Casa                                   [Behind ⚠️]       │ │
│ │                                                                      │ │
│ │ Progreso: $25,000 de $100,000 (25%)                                 │ │
│ │ ██████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  25%               │ │
│ │                                                                      │ │
│ │ Fecha objetivo: 2028 (3 años restantes)                             │ │
│ │ Contribución: $1,500/mes                                            │ │
│ │                                                                      │ │
│ │ Proyección al 2028: $85,000 ⚠️ ($15,000 corto)                      │ │
│ │                                                                      │ │
│ │ 💡 Sugerencia: Aumenta a $2,000/mes para alcanzar la meta          │ │
│ │                                                                      │ │
│ │ [Ver Detalles] [Editar] [Simular]                                   │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Simulación de Escenarios                                            │ │
│ │                                                                      │ │
│ │           Optimista (10%)    Base (7%)    Pesimista (4%)            │ │
│ │ 2045:     $680,000 ✓         $520,000 ✓   $380,000 ⚠️               │ │
│ │                                                                      │ │
│ │ Probabilidad de alcanzar $500k: 72%                                 │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘
```

---

## Dependencias

### Épicas Requeridas
- **OQI-004:** Cuentas de inversión
- **OQI-008:** Portfolio Manager

---

## Especificaciones Técnicas Relacionadas

- [ET-PFM-007: Motor de Metas](../especificaciones/ET-PFM-007-motor-metas.md)

---

## Historias de Usuario Relacionadas

- US-PFM-013: Crear meta de inversión
- US-PFM-014: Ver progreso de metas

---

*Documento de requerimientos - Sistema NEXUS*
*OrbiQuant IA Trading Platform*
