Portfolio Buddy 2 - Contexte du projet
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 pur (useState, useMemo, useCallback)
- Outils 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 contrats à terme permettant de :
- Comparer les stratégies de trading par rapport aux actifs de référence (SPY, GLD)
- Calculer les matrices de corrélation entre les actifs (Spearman et Pearson)
- Analyser les métriques de risque et de performance (Sharpe, Sortino, DD max, etc.)
- Télécharger des données de trading via CSV et visualiser les résultats
- Appliquer des multiplicateurs de contrat pour ajuster les métriques pour le trading de contrats à terme
- Filtrer les données par plage de dates pour une analyse spécifique à une période
Problèmes connus et dette technique
Dette technique actuelle
-
Dépendance inutilisée : Recharts (11.5 Ko) installé mais jamais importé
- Doit être supprimé de package.json
- Utilise actuellement 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 de type
any- usePortfolio.ts : 11 occurrences dans les types de trading/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échargement Supabase : Erreurs 500 intermittentes sur les gros téléchargements
- Gestion d'erreurs améliorée ajoutée dans le commit 9fb7fdb
- Vérifier la gestion des erreurs dans les hooks de téléchargement
- Vérifier que les limites de lignes ne sont pas dépassées sur le niveau 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 saisi par l'utilisateur
- Déviation à la baisse annualisée utilisant le facteur sqrt(365)
- Correction du calcul de la 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 de niveau 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 multicritères 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 Hook : Hooks personnalisés dans
/src/hooks/ - Modèle Utils : Fonctions pures dans
/src/utils/ - Sécurité des types : TypeScript strict, aucun type
any(15 violations existent comme dette technique) - Gestion d'état : Hooks React purs uniquement - pas de Zustand ni TanStack Query
Structure des composants clés
src/
├── composants/
│ ├── AnalyticsControls.tsx (basculer les vues Métriques/Portefeuille/Corrélation)
│ ├── ContractInput.tsx (saisies des multiplicateurs de contrat)
│ ├── CorrelationHeatmap.tsx (visualisation de la corrélation)
│ ├── CorrelationSection.tsx (wrapper d'analyse de corrélation)
│ ├── CustomTooltip.tsx (infobulles des 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 fin)
│ ├── SortableHeader.tsx (en-tête de tableau avec indicateurs de tri)
│ ├── UploadedFilesList.tsx (liste des fichiers téléchargés)
│ └── UploadSection.tsx (téléchargement 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 multicritères avancé)
└── utils/
└── dataUtils.ts (calculs de métriques, analyse CSV, corrélations)
Contexte de migration
Migration de 40 fonctionnalités de l'ancienne application (35/40 terminées). Voir le skill migration-tracker pour les détails.