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

9.8 KiB

Raw Permalink Blame History

id	title	type	status	priority	epic	project	version	created_date	updated_date
RF-PFM-007	Metas de Inversión	Requirement	Done	Alta	OQI-008	trading-platform	1.0.0	2025-12-05	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

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

template: retirement
typical_horizon: 20-30 años
suggested_allocation: conservative_to_aggressive_based_on_years
expected_return: 7%

Compra de Casa

template: home_purchase
typical_horizon: 3-10 años
suggested_allocation: moderate
expected_return: 5%

Educación

template: education
typical_horizon: 5-18 años
suggested_allocation: moderate_to_conservative
expected_return: 6%

Fondo de Emergencia

template: emergency_fund
typical_horizon: 6-12 meses
suggested_allocation: very_conservative
expected_return: 2%

Objetivo Personalizado

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

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

9.8 KiB Raw Permalink Blame History