Portfolio Buddy 2 - Contexto del Proyecto
Stack Tecnológico
- Frontend: React 19, TypeScript, Vite
- UI: Tailwind CSS, shadcn/ui (solo sistema de colores)
- Gráficos: Chart.js, react-chartjs-2, plugins de chartjs (zoom, annotation, date adapter)
- Estado: React plano (useState, useMemo, useCallback)
- Utilidades de datos: date-fns para manipulación de fechas
- Backend: Supabase (PostgreSQL)
- Despliegue: Cloudflare Pages
Propósito del Proyecto
Herramienta de análisis de carteras para inversores y traders de futuros que permite:
- Comparar estrategias de trading vs activos de referencia (SPY, GLD)
- Calcular matrices de correlación entre activos (Spearman y Pearson)
- Analizar métricas de riesgo y rendimiento (Sharpe, Sortino, Max DD, etc.)
- Subir datos de trading mediante CSV y visualizar resultados
- Aplicar multiplicadores de contrato para ajustar métricas en trading de futuros
- Filtrar datos por rango de fechas para análisis en periodos específicos
Problemas Conocidos y Deuda Técnica
Deuda Técnica Actual
-
Dependencia no utilizada: Recharts (11.5KB) instalada pero nunca importada
- Debe eliminarse de package.json
- Actualmente se usa Chart.js en su lugar
-
Componentes sobredimensionados: Violan el estándar de 200 líneas
- PortfolioSection.tsx (591 líneas) → necesita refactorización en subcomponentes
- App.tsx (351 líneas) → extraer secciones en componentes
- MetricsTable.tsx (242 líneas) → mejorado pero aún supera el límite
-
Violaciones de TypeScript: 15 instancias del tipo
any- usePortfolio.ts: 11 apariciones en tipos de trade/métricas
- useMetrics.ts: 4 apariciones en comparaciones de ordenación
- dataUtils.ts: 1 aparición en la interfaz Metrics
Errores Conocidos
- Errores de subida a Supabase: Errores 500 intermitentes en subidas grandes
- Se añadió manejo de errores mejorado en el commit 9fb7fdb
- Verificar el manejo de errores en los hooks de subida
- Comprobar que no se excedan los límites de filas en el plan gratuito
Funcionalidades Añadidas Recientemente
- Cálculo del Ratio Sortino (commits 258ba3a, 9f25040)
- Ubicación: Implementado directamente en PortfolioSection.tsx (líneas 133-158)
- Estado de entrada de tasa libre de riesgo especificada por el usuario
- Desviación a la baja anualizada usando el factor sqrt(365)
- Cálculo de varianza corregido (divide entre rendimientos totales, no solo negativos)
- Mostrado en la sección de estadísticas de la cartera (línea 535)
- Nota: NO está en dataUtils.ts - se mantiene en el componente por el contexto de la cartera
- Filtrado por Rango de Fechas (commit 258ba3a)
- Filtrar datos de la cartera por fecha de inicio/fin
- Implementado en el hook usePortfolio
- Ordenación Avanzada Multi-Columna (hook useSorting)
- Ordenar por múltiples columnas con prioridad
- Lógica de comparación personalizada por columna
Restricciones Arquitectónicas
- Límite de Componentes: Máximo 200 líneas por componente (actualmente violado por 3 componentes)
- Patrón de Hooks: Hooks personalizados en
/src/hooks/ - Patrón de Utilidades: Funciones puras en
/src/utils/ - Seguridad de Tipos: TypeScript estricto, sin tipos
any(15 violaciones existen como deuda técnica) - Gestión de Estado: Solo hooks de React plano - sin Zustand ni TanStack Query
Estructura de Componentes Clave
src/
├── components/
│ ├── AnalyticsControls.tsx (alternar vistas de Métricas/Cartera/Correlación)
│ ├── ContractInput.tsx (entradas de multiplicador de contrato)
│ ├── CorrelationHeatmap.tsx (visualización de correlación)
│ ├── CorrelationSection.tsx (envoltorio de análisis de correlación)
│ ├── CustomTooltip.tsx (tooltips de gráficos)
│ ├── ErrorList.tsx (visualización de errores)
│ ├── Header.tsx (encabezado de la aplicación)
│ ├── MasterContractControl.tsx (aplicar valor de contrato a todos)
│ ├── MetricsTable.tsx (visualización y selección de métricas)
│ ├── PortfolioSection.tsx (gráficos y análisis de cartera - ¡591 líneas!)
│ ├── SessionComplete.tsx (UI de finalización)
│ ├── SortableHeader.tsx (encabezado de tabla con indicadores de ordenación)
│ ├── UploadedFilesList.tsx (lista de archivos subidos)
│ └── UploadSection.tsx (subida de archivos a Supabase)
├── hooks/
│ ├── useContractMultipliers.ts (gestionar multiplicadores de contrato)
│ ├── useMetrics.ts (calcular métricas de trading)
│ ├── usePortfolio.ts (datos de cartera y filtrado por fecha)
│ └── useSorting.ts (ordenación avanzada multi-columna)
└── utils/
└── dataUtils.ts (cálculos de métricas, análisis de CSV, correlaciones)
Contexto de Migración
Migrando 40 funcionalidades de la aplicación anterior (35/40 completadas). Consulta el skill migration-tracker para más detalles.