O que Portfolio Buddy 2 - Contexto do Projeto faz?
Pilha Tecnológica
- Frontend: React 19, TypeScript, Vite
- UI: Tailwind CSS, shadcn/ui (apenas sistema de cores)
- Gráficos: Chart.js, react-chartjs-2, plug-ins chartjs (zoom, annotation, date adapter)
- Estado: React puro (useState, useMemo, useCallback)
- Utilitários de Dados: date-fns para manipulação de datas
- Backend: Supabase (PostgreSQL)
- Deploy: Cloudflare Pages
Propósito do Projeto
Ferramenta de análise de portfólio para investidores e traders de futuros para:
- Comparar estratégias de trading com ativos de referência (SPY, GLD)
- Calcular matrizes de correlação entre ativos (Spearman e Pearson)
- Analisar métricas de risco e desempenho (Sharpe, Sortino, Drawdown Máximo, etc.)
- Fazer upload de dados de trades via CSV e visualizar resultados
- Aplicar multiplicadores de contratos para ajustar métricas para trading de futuros
- Filtrar dados por intervalo de datas para análise por período específico
Problemas Conhecidos e Dívida Técnica
Dívida Técnica Atual
-
Dependência Não Utilizada: Recharts (11,5KB) instalado, mas nunca importado
- Deve ser removido do package.json
- Atualmente usando Chart.js
-
Componentes Acima do Tamanho Máximo: Violam o padrão de 200 linhas
- PortfolioSection.tsx (591 linhas) → precisa ser refatorado em subcomponentes
- App.tsx (351 linhas) → extrair seções em componentes
- MetricsTable.tsx (242 linhas) → melhorado, mas ainda acima do limite
-
Violações de TypeScript: 15 instâncias do tipo
any- usePortfolio.ts: 11 ocorrências em tipos de trade/métricas
- useMetrics.ts: 4 ocorrências em comparações de ordenação
- dataUtils.ts: 1 ocorrência na interface Metrics
Erros Conhecidos
- Erros de Upload no Supabase: Erros 500 intermitentes em uploads grandes
- Tratamento de erros melhorado adicionado no commit 9fb7fdb
- Verificar tratamento de erros nos hooks de upload
- Confirmar que os limites de linhas do plano gratuito não foram excedidos
Funcionalidades Recentes Adicionadas
- Cálculo do Índice Sortino (commits 258ba3a, 9f25040)
- Localização: Implementado inline em PortfolioSection.tsx (linhas 133-158)
- Estado de entrada da taxa livre de risco para taxa livre de risco especificada pelo usuário
- Desvio descendente anualizado usando fator sqrt(365)
- Cálculo corrigido da variância (divide pelo total de retornos, não apenas pelos negativos)
- Exibido na seção de estatísticas do portfólio (linha 535)
- Nota: NÃO está em dataUtils.ts - mantido no componente devido ao contexto do nível do portfólio
- Filtragem por Intervalo de Datas (commit 258ba3a)
- Filtrar dados do portfólio por data de início/fim
- Implementado no hook usePortfolio
- Ordenação Avançada Multi-Coluna (hook useSorting)
- Ordenar por múltiplas colunas com prioridade
- Lógica de comparação personalizada por coluna
Restrições Arquiteturais
- Limite de Componentes: Máximo de 200 linhas por componente (atualmente violado por 3 componentes)
- Padrão de Hooks: Hooks personalizados em
/src/hooks/ - Padrão de Utilitários: Funções puras em
/src/utils/ - Segurança de Tipos: TypeScript estrito, sem tipos
any(15 violações existem como dívida técnica) - Gerenciamento de Estado: Apenas hooks React puros - sem Zustand ou TanStack Query
Estrutura de Componentes Principais
src/
├── components/
│ ├── AnalyticsControls.tsx (alterna visualizações Métricas/Portfólio/Correlação)
│ ├── ContractInput.tsx (inputs de multiplicador de contrato)
│ ├── CorrelationHeatmap.tsx (visualização de correlação)
│ ├── CorrelationSection.tsx (wrapper de análise de correlação)
│ ├── CustomTooltip.tsx (dicas de gráfico)
│ ├── ErrorList.tsx (exibição de erros)
│ ├── Header.tsx (cabeçalho do aplicativo)
│ ├── MasterContractControl.tsx (aplicar valor de contrato a todos)
│ ├── MetricsTable.tsx (exibição e seleção de métricas)
│ ├── PortfolioSection.tsx (gráficos e análise do portfólio - 591 linhas!)
│ ├── SessionComplete.tsx (UI de conclusão)
│ ├── SortableHeader.tsx (cabeçalho de tabela com indicadores de ordenação)
│ ├── UploadedFilesList.tsx (lista de arquivos enviados)
│ └── UploadSection.tsx (upload de arquivos para Supabase)
├── hooks/
│ ├── useContractMultipliers.ts (gerenciar multiplicadores de contrato)
│ ├── useMetrics.ts (calcular métricas de trading)
│ ├── usePortfolio.ts (dados do portfólio e filtragem por data)
│ └── useSorting.ts (ordenação avançada multi-coluna)
└── utils/
└── dataUtils.ts (cálculos de métricas, parsing de CSV, correlações)
Contexto de Migração
Migrando 40 funcionalidades do aplicativo antigo (35/40 concluídas). Consulte a skill migration-tracker para detalhes.