trading-platform/docs/02-definicion-modulos/OQI-008-portfolio-manager/requerimientos/RF-PFM-007-metas-inversión.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

245 lines
9.8 KiB
Markdown

---
id: "RF-PFM-007"
title: "Metas de Inversión"
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-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*
*Trading Platform*