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

10 KiB

Raw Permalink Blame History

id	title	type	status	priority	epic	project	version	created_date	updated_date
RF-PFM-006	Reportes Fiscales	Requirement	Done	Alta	OQI-008	trading-platform	1.0.0	2025-12-05	2026-01-04

RF-PFM-006: Reportes Fiscales

Épica: OQI-008 - Portfolio Manager Versión: 1.0 Fecha: 2025-12-05 Estado: Planificado Prioridad: P1 - Alto

Descripción

El sistema debe generar reportes fiscales que ayuden al usuario a cumplir con sus obligaciones tributarias, incluyendo cálculo de ganancias/pérdidas de capital, dividendos recibidos y documentación para declaración de impuestos.

Requisitos Funcionales

RF-PFM-006.1: Reporte de Ganancias/Pérdidas

El sistema debe calcular ganancias/pérdidas realizadas
Distinguir entre corto plazo (<1 año) y largo plazo (>1 año)
Mostrar costo base y precio de venta
Calcular ganancia/pérdida neta del período
Permitir seleccionar método de cálculo (FIFO, LIFO, identificación específica)

RF-PFM-006.2: Reporte de Dividendos

El sistema debe listar todos los dividendos recibidos
Clasificar dividendos: ordinarios vs calificados
Mostrar total de dividendos por período
Incluir dividendos de acciones y de ETFs

RF-PFM-006.3: Reporte Anual de Impuestos

Generar reporte consolidado del año fiscal
Incluir sección de ganancias/pérdidas de capital
Incluir sección de dividendos
Incluir sección de intereses (si aplica)
Formato compatible con formularios fiscales

RF-PFM-006.4: Tax-Loss Harvesting (Premium)

El sistema debe identificar posiciones con pérdida
Sugerir ventas para compensar ganancias
Calcular ahorro fiscal estimado
Alertar de regla de wash sale (30 días)
Mostrar impacto en portfolio

RF-PFM-006.5: Exportación de Reportes

Exportar a PDF para archivo
Exportar a CSV para tax software
Exportar formato compatible con SAT (México)
Incluir toda la documentación de soporte

Criterios de Aceptación

Feature: Reportes Fiscales

Scenario: Generar reporte de ganancias/pérdidas
  Given tengo ventas realizadas en el año
  When genero "Reporte de Ganancias/Pérdidas 2025"
  Then veo lista de todas las ventas
  And cada venta muestra:
    | Campo | Ejemplo |
    | Fecha compra | 15/03/2025 |
    | Fecha venta | 05/12/2025 |
    | Símbolo | AAPL |
    | Cantidad | 10 |
    | Costo base | $1,750 |
    | Precio venta | $1,855 |
    | Ganancia | $105 |
    | Plazo | Largo |
  And veo totales de corto y largo plazo

Scenario: Ver oportunidades de tax-loss harvesting
  Given soy usuario Premium
  And tengo posiciones con pérdida
  And tengo ganancias realizadas en el año
  When veo "Oportunidades Tax-Loss Harvesting"
  Then veo posiciones con pérdida no realizada
  And veo ahorro fiscal estimado si las vendo
  And veo alerta de wash sale si aplica

Scenario: Exportar reporte para declaración
  Given generé mi reporte fiscal anual
  When selecciono "Exportar para SAT"
  Then se descarga archivo en formato compatible
  And incluye todos los datos necesarios
  And incluye documentación de soporte

Reglas de Negocio

Regla	Descripción
RN-001	Reportes fiscales disponibles para Pro/Premium
RN-002	Método de costo base default: FIFO
RN-003	Largo plazo: >365 días de tenencia
RN-004	Wash sale: No recomprar mismo activo en 30 días
RN-005	Tax-loss harvesting solo Premium
RN-006	Considerar zona horaria del usuario para fechas

Formato de Reporte

Sección de Ganancias de Capital

## Ganancias y Pérdidas de Capital 2025

### Resumen
| Categoría | Ganancias | Pérdidas | Neto |
|-----------|-----------|----------|------|
| Corto Plazo | $2,500 | -$800 | $1,700 |
| Largo Plazo | $5,200 | -$1,200 | $4,000 |
| **Total** | $7,700 | -$2,000 | **$5,700** |

### Detalle de Transacciones

| Fecha Compra | Fecha Venta | Símbolo | Cant. | Costo | Venta | G/P | Plazo |
|--------------|-------------|---------|-------|-------|-------|-----|-------|
| 15/03/2024 | 05/12/2025 | AAPL | 10 | $1,750 | $1,855 | +$105 | L |
| 20/07/2025 | 15/11/2025 | TSLA | 5 | $1,300 | $1,200 | -$100 | C |
...

Sección de Dividendos

## Dividendos Recibidos 2025

### Resumen
| Tipo | Total |
|------|-------|
| Dividendos Calificados | $450.00 |
| Dividendos Ordinarios | $125.00 |
| **Total** | **$575.00** |

### Detalle
| Fecha | Símbolo | Tipo | Monto |
|-------|---------|------|-------|
| 15/03/2025 | AAPL | Calificado | $75.00 |
| 15/06/2025 | MSFT | Calificado | $82.00 |
...

Wireframe

┌─────────────────────────────────────────────────────────────────────────┐
│ Reportes Fiscales                                         [Premium]     │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│ Año Fiscal: [2025 ▾]                    [Generar Reporte] [Exportar ▾] │
│                                                                          │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Resumen Fiscal 2025                                                  │ │
│ │                                                                      │ │
│ │  ┌────────────────────┐  ┌────────────────────┐                     │ │
│ │  │ GANANCIAS CAPITAL  │  │    DIVIDENDOS      │                     │ │
│ │  │     $5,700         │  │      $575          │                     │ │
│ │  │  Neto (G-P)        │  │   Total recibido   │                     │ │
│ │  └────────────────────┘  └────────────────────┘                     │ │
│ │                                                                      │ │
│ │  Desglose Ganancias de Capital:                                     │ │
│ │  • Corto plazo: $1,700 (tasa ordinaria)                             │ │
│ │  • Largo plazo: $4,000 (tasa preferencial)                          │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 💡 Tax-Loss Harvesting Oportunidades                    [Premium]   │ │
│ │                                                                      │ │
│ │ Posiciones con pérdida no realizada:                                │ │
│ │                                                                      │ │
│ │ Símbolo   │ Pérdida    │ Ahorro Est.  │ Wash Sale │ Acción          │ │
│ │ TSLA      │ -$500      │ ~$125        │ ✓ OK      │ [Vender]        │ │
│ │ COIN      │ -$300      │ ~$75         │ ⚠️ 15 días│ [Ver más]       │ │
│ │                                                                      │ │
│ │ Ahorro fiscal potencial total: ~$200                                │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Reportes Disponibles                                                │ │
│ │                                                                      │ │
│ │ 📄 Ganancias/Pérdidas de Capital          [Generar] [⬇️]            │ │
│ │ 📄 Reporte de Dividendos                  [Generar] [⬇️]            │ │
│ │ 📄 Reporte Consolidado Anual              [Generar] [⬇️]            │ │
│ │ 📄 Formato SAT (México)                   [Generar] [⬇️]            │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘

Dependencias

Épicas Requeridas

OQI-004: Historial de transacciones
OQI-008: Portfolio Manager

Especificaciones Técnicas Relacionadas

ET-PFM-006: Motor de Reportes Fiscales

Historias de Usuario Relacionadas

US-PFM-012: Generar reporte fiscal anual

Notas Legales

Disclaimer: Los reportes fiscales generados son informativos y de apoyo. El usuario es responsable de verificar la información con un profesional fiscal y cumplir con las regulaciones locales.

Documento de requerimientos - Sistema NEXUS Trading Platform

10 KiB Raw Permalink Blame History