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>
245 lines
9.8 KiB
Markdown
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*
|