Contexte du Projet Portfolio Buddy 2
Stack Technique
- Frontend : React 19, TypeScript, Vite
- UI : Tailwind CSS, shadcn/ui (système de couleurs uniquement)
- Graphiques : Chart.js, react-chartjs-2, plugins chartjs (zoom, annotation, adaptateur de date)
- État : React simple (useState, useMemo, useCallback)
- Utilitaires de données : date-fns pour la manipulation des dates
- Backend : Supabase (PostgreSQL)
- Déploiement : Cloudflare Pages
Objectif du Projet
Outil d'analyse de portefeuille pour investisseurs et traders de futures afin de :
- Comparer des stratégies de trading par rapport à des actifs de référence (SPY, GLD)
- Calculer des matrices de corrélation entre actifs (Spearman & Pearson)
- Analyser les métriques de risque et de performance (Sharpe, Sortino, Max DD, etc.)
- Importer des données de trading via CSV et visualiser les résultats
- Appliquer des multiplicateurs de contrat pour ajuster les métriques de trading de futures
- Filtrer les données par plage de dates pour une analyse par période spécifique
Problèmes Connus & Dette Technique
Dette Technique Actuelle
-
Dépendance Inutilisée : Recharts (11.5 Ko) installée mais jamais importée
- Devrait être supprimée de package.json
- On utilise Chart.js à la place
-
Composants Surdimensionnés : Violent la norme des 200 lignes
- PortfolioSection.tsx (591 lignes) → nécessite un refactoring en sous-composants
- App.tsx (351 lignes) → extraire les sections en composants
- MetricsTable.tsx (242 lignes) → amélioré mais toujours au-dessus de la limite
-
Violations TypeScript : 15 instances du type
any- usePortfolio.ts : 11 occurrences dans les types de trades/métriques
- useMetrics.ts : 4 occurrences dans les comparaisons de tri
- dataUtils.ts : 1 occurrence dans l'interface Metrics
Bugs Connus
- Erreurs de Téléversement Supabase : Erreurs 500 intermittentes lors de gros téléversements
- Gestion d'erreur améliorée ajoutée dans le commit 9fb7fdb
- Vérifier la gestion d'erreur dans les hooks de téléversement
- Vérifier que les limites de lignes ne sont pas dépassées sur le plan gratuit
Fonctionnalités Récentes Ajoutées
- Calcul du Ratio Sortino (commits 258ba3a, 9f25040)
- Emplacement : Implémenté en ligne dans PortfolioSection.tsx (lignes 133-158)
- État du taux sans risque pour un taux sans risque spécifié par l'utilisateur
- Déviation à la baisse annualisée utilisant le facteur sqrt(365)
- Calcul de variance corrigé (divise par le nombre total de rendements, pas seulement les négatifs)
- Affiché dans la section des statistiques du portefeuille (ligne 535)
- Note : PAS dans dataUtils.ts - conservé dans le composant en raison du contexte global du portefeuille
- Filtrage par Plage de Dates (commit 258ba3a)
- Filtrer les données du portefeuille par date de début/fin
- Implémenté dans le hook usePortfolio
- Tri Multi-Colonnes Avancé (hook useSorting)
- Trier par plusieurs colonnes avec priorité
- Logique de comparaison personnalisée par colonne
Contraintes Architecturales
- Limite de Composants : Maximum 200 lignes par composant (actuellement violé par 3 composants)
- Pattern Hooks : Hooks personnalisés dans
/src/hooks/ - Pattern Utils : Fonctions pures dans
/src/utils/ - Sécurité des Types : TypeScript strict, pas de types
any(15 violations existent comme dette technique) - Gestion d'État : Hooks React simples uniquement - pas de Zustand ou TanStack Query
Structure des Composants Clés
src/
├── components/
│ ├── AnalyticsControls.tsx (bascule des vues Métriques/Portefeuille/Corrélation)
│ ├── ContractInput.tsx (entrées de multiplicateurs de contrat)
│ ├── CorrelationHeatmap.tsx (visualisation de corrélation)
│ ├── CorrelationSection.tsx (wrapper d'analyse de corrélation)
│ ├── CustomTooltip.tsx (infobulles de graphiques)
│ ├── ErrorList.tsx (affichage des erreurs)
│ ├── Header.tsx (en-tête de l'application)
│ ├── MasterContractControl.tsx (appliquer la valeur du contrat à tous)
│ ├── MetricsTable.tsx (affichage et sélection des métriques)
│ ├── PortfolioSection.tsx (graphiques et analyse du portefeuille - 591 lignes!)
│ ├── SessionComplete.tsx (interface de complétion)
│ ├── SortableHeader.tsx (en-tête de tableau avec indicateurs de tri)
│ ├── UploadedFilesList.tsx (liste des fichiers téléversés)
│ └── UploadSection.tsx (téléversement de fichiers vers Supabase)
├── hooks/
│ ├── useContractMultipliers.ts (gérer les multiplicateurs de contrat)
│ ├── useMetrics.ts (calculer les métriques de trading)
│ ├── usePortfolio.ts (données du portefeuille et filtrage par date)
│ └── useSorting.ts (tri multi-colonnes avancé)
└── utils/
└── dataUtils.ts (calculs de métriques, analyse CSV, corrélations)
Conventions Clés
- Alias de chemin :
@/correspond àsrc/— utilisez-le pour toutes les importations internes - shadcn-ui : Jetons de couleur uniquement — variables CSS dans
src/index.css, aucun composant shadcn réel installé. Vous pouvez en ajouter plus tard vianpx shadcn@latest add button, etc. - Flux de travail Git : Branches de fonctionnalités →
git checkout -b feature/nom→ commit conventionnel (feat:,fix:,chore:) → PR vers main - Marque communautaire : Communauté de trading 5minfutures.com ; logo Skool dans les assets ; formulaire GoHighLevel intégré
Contexte de Migration
Migration de 40 fonctionnalités de l'ancienne application (achevée à 90%). Voir la compétence migration-tracker pour les détails.