Portfolio Buddy 2 - Contexte du Projet
Pile 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 de dates
- Backend : Supabase (PostgreSQL)
- Déploiement : Cloudflare Pages
Objectif du Projet
Outil d'analyse de portefeuille pour les investisseurs et traders de futures permettant de :
- Comparer les stratégies de trading aux actifs de référence (SPY, GLD)
- Calculer les matrices de corrélation entre actifs (Spearman et Pearson)
- Analyser les métriques de risque et de performance (Sharpe, Sortino, Drawdown max, etc.)
- Téléverser des données de trading via CSV et visualiser les résultats
- Appliquer des multiplicateurs de contrat pour ajuster les métriques au trading de futures
- Filtrer les données par plage de dates pour une analyse spécifique à une période
Problèmes Connus & Dette Technique
Dette Technique Actuelle
-
Dépendance inutilisée : Recharts (11,5 Ko) installé mais jamais importé
- Doit être supprimé du package.json
- Utilise actuellement Chart.js à la place
-
Composants surdimensionnés : Violent la norme des 200 lignes
- PortfolioSection.tsx (591 lignes) → nécessite une refactorisation 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 sur les gros téléversements
- Gestion d'erreurs améliorée ajoutée dans le commit 9fb7fdb
- Vérifier la gestion des erreurs 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 de Sortino (commits 258ba3a, 9f25040)
- Emplacement : Implémenté en ligne dans PortfolioSection.tsx (lignes 133-158)
- État d'entrée 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)
- Correction du calcul de variance (divise par le nombre total de rendements, pas seulement les négatifs)
- Affiché dans la section des statistiques du portefeuille (ligne 535)
- Remarque : PAS dans dataUtils.ts - conservé dans le composant en raison du contexte du niveau portefeuille
- Filtrage par Plage de Dates (commit 258ba3a)
- Filtrer les données de portefeuille par date de début/fin
- Implémenté dans le hook usePortfolio
- Tri Multicouche Avancé (hook useSorting)
- Trier par plusieurs colonnes avec priorité
- Logique de comparaison personnalisée par colonne
Contraintes Architecturales
- Limite de Composant : Max 200 lignes par composant (actuellement violé par 3 composants)
- Modèle de Hook : Hooks personnalisés dans
/src/hooks/ - Modèle d'Utilitaire : Fonctions pures dans
/src/utils/ - Sécurité des Types : TypeScript strict, aucun type
any(15 violations existent en tant que dette technique) - Gestion d'État : Hooks React uniquement - pas de Zustand ou TanStack Query
Structure des Composants Clés
src/
├── components/
│ ├── AnalyticsControls.tsx (basculer les vues Métriques/Portefeuille/Corrélation)
│ ├── ContractInput.tsx (saisie des multiplicateurs de contrat)
│ ├── CorrelationHeatmap.tsx (visualisation de la corrélation)
│ ├── CorrelationSection.tsx (wrapper d'analyse de corrélation)
│ ├── CustomTooltip.tsx (infobulles de graphique)
│ ├── 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 (UI de fin de session)
│ ├── 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 multicouche 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é. Peut être ajouté ultérieurement vianpx shadcn@latest add button, etc. - Flux de travail Git : Branches de fonctionnalités →
git checkout -b feature/name→ commit conventionnel (feat:,fix:,chore:) → PR vers main - Image de 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 plus de détails.