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 chartjs (zoom, anotación, adaptador de fechas)
- 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 cartera para inversores y traders de futuros para:
- 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, DD Máximo, etc.)
- Subir datos de trading mediante CSV y visualizar resultados
- Aplicar multiplicadores de contratos para ajustar métricas en trading de futuros
- Filtrar datos por rango de fechas para análisis específico por período
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
-
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 por encima del límite
-
Violaciones de TypeScript: 15 instancias del tipo
any- usePortfolio.ts: 11 ocurrencias en tipos de trade/métricas
- useMetrics.ts: 4 ocurrencias en comparaciones de ordenación
- dataUtils.ts: 1 ocurrencia en la interfaz Metrics
Errores Conocidos
- Errores de Subida a Supabase: Errores 500 intermitentes en subidas grandes
- Manejo de errores mejorado añadido en el commit 9fb7fdb
- Verificar el manejo de errores en los hooks de subida
- Verificar que los límites de filas no se excedan en el plan gratuito
Características Recientes Añadidas
- Cálculo del Ratio Sortino (commits 258ba3a, 9f25040)
- Ubicación: Implementado inline en PortfolioSection.tsx (líneas 133-158)
- Estado de entrada de tasa libre de riesgo para tasa especificada por el usuario
- Desviación a la baja anualizada usando factor sqrt(365)
- Cálculo de varianza corregido (divide por rendimientos totales, no solo negativos)
- Mostrado en la sección de estadísticas de cartera (línea 535)
- Nota: NO está en dataUtils.ts - mantenido en el componente debido al contexto de nivel de cartera
- Filtrado por Rango de Fechas (commit 258ba3a)
- Filtrar datos de 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(existen 15 violaciones como deuda técnica) - Gestión de Estado: Solo hooks de React planos - sin Zustand ni TanStack Query
Estructura de Componentes Clave
src/
├── components/
│ ├── AnalyticsControls.tsx (alternar vistas Métricas/Cartera/Correlación)
│ ├── ContractInput.tsx (entradas de multiplicadores de contratos)
│ ├── 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 app)
│ ├── 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 contratos)
│ ├── 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 CSV, correlaciones)
Convenciones Clave
- Alias de ruta:
@/mapea asrc/— úselo para todas las importaciones internas - shadcn-ui: Solo tokens de color — variables CSS en
src/index.css, sin componentes shadcn instalados. Podrían añadirse más tarde mediantenpx shadcn@latest add button, etc. - Flujo de trabajo Git: Ramas de características →
git checkout -b feature/nombre→ commit convencional (feat:,fix:,chore:) → PR a main - Marca comunitaria: Comunidad de trading 5minfutures.com; logotipo de Skool en assets; formulario GoHighLevel embebido
Contexto de Migración
Migrando 40 características desde la app antigua (90% completado). Vea la habilidad migration-tracker para más detalles.