Portfolio Buddy 2 - Projektkontext
Tech-Stack
- Frontend: React 19, TypeScript, Vite
- UI: Tailwind CSS, shadcn/ui (nur Farbsystem)
- Diagramme: Chart.js, react-chartjs-2, chartjs-plugins (zoom, annotation, date-adapter)
- Zustand: Reines React (useState, useMemo, useCallback)
- Daten-Hilfsmittel: date-fns für Datumsmanipulation
- Backend: Supabase (PostgreSQL)
- Bereitstellung: Cloudflare Pages
Projektzweck
Portfolio-Analyse-Tool für Anleger und Futures-Händler:
- Vergleich von Handelsstrategien mit Benchmark-Assets (SPY, GLD)
- Berechnung von Korrelationsmatrizen zwischen Assets (Spearman & Pearson)
- Analyse von Risikokennzahlen und Performance (Sharpe, Sortino, Max DD, etc.)
- Hochladen von Handelsdaten per CSV und Visualisierung der Ergebnisse
- Anwenden von Kontrakt-Multiplikatoren zur Anpassung der Metriken für Futures-Handel
- Filtern von Daten nach Datumsbereich für zeitraumspezifische Analysen
Bekannte Probleme & Technische Schulden
Aktuelle Technische Schulden
-
Nicht verwendete Abhängigkeit: Recharts (11,5 KB) installiert, aber nie importiert
- Sollte aus package.json entfernt werden
- Stattdessen wird Chart.js verwendet
-
Überdimensionierte Komponenten: Verstoßen gegen die 200-Zeilen-Grenze
- PortfolioSection.tsx (591 Zeilen) → muss in Unterkomponenten refaktorisiert werden
- App.tsx (351 Zeilen) → Abschnitte in Komponenten auslagern
- MetricsTable.tsx (242 Zeilen) → verbessert, aber immer noch über dem Limit
-
TypeScript-Verstöße: 15 Instanzen von
any-Typ- usePortfolio.ts: 11 Vorkommen in Handels-/Metrik-Typen
- useMetrics.ts: 4 Vorkommen in Sortiervergleichen
- dataUtils.ts: 1 Vorkommen in Metrics-Interface
Bekannte Fehler
- Supabase-Upload-Fehler: Gelegentliche 500-Fehler bei großen Uploads
- Verbesserte Fehlerbehandlung in Commit 9fb7fdb hinzugefügt
- Fehlerbehandlung in Upload-Hooks prüfen
- Überprüfen, ob Zeilengrenzen im Free-Tier nicht überschritten werden
Kürzlich hinzugefügte Funktionen
- Sortino-Ratio-Berechnung (Commits 258ba3a, 9f25040)
- Ort: Direkt in PortfolioSection.tsx implementiert (Zeilen 133-158)
- Eingabestatus für risikofreien Zinssatz vom Benutzer
- Annualisierte Abwärtsabweichung mit sqrt(365)-Faktor
- Korrigierte Varianzberechnung (dividiert durch alle Renditen, nicht nur negative)
- Angezeigt im Portfolio-Statistikbereich (Zeile 535)
- Hinweis: NICHT in dataUtils.ts – aufgrund des Portfolio-Level-Kontexts in der Komponente belassen
- Datumsbereichsfilterung (Commit 258ba3a)
- Portfolio-Daten nach Start-/Enddatum filtern
- Implementiert im usePortfolio-Hook
- Erweiterte Multi-Column-Sortierung (useSorting-Hook)
- Sortieren nach mehreren Spalten mit Priorität
- Benutzerdefinierte Vergleichslogik pro Spalte
Architekturbeschränkungen
- Komponentenlimit: Max. 200 Zeilen pro Komponente (aktuell von 3 Komponenten verletzt)
- Hook-Muster: Benutzerdefinierte Hooks in
/src/hooks/ - Utils-Muster: Reine Funktionen in
/src/utils/ - Typsicherheit: Strenges TypeScript, keine
any-Typen (15 Verstöße als technische Schulden) - Zustandsverwaltung: Nur reine React-Hooks – kein Zustand oder TanStack Query
Wichtige Komponentenstruktur
src/
├── components/
│ ├── AnalyticsControls.tsx (Umschalten der Ansichten Metriken/Portfolio/Korrelation)
│ ├── ContractInput.tsx (Eingabe von Kontrakt-Multiplikatoren)
│ ├── CorrelationHeatmap.tsx (Korrelationsvisualisierung)
│ ├── CorrelationSection.tsx (Wrapper für Korrelationsanalyse)
│ ├── CustomTooltip.tsx (Diagramm-Tooltips)
│ ├── ErrorList.tsx (Fehleranzeige)
│ ├── Header.tsx (App-Header)
│ ├── MasterContractControl.tsx (Kontraktwert auf alle anwenden)
│ ├── MetricsTable.tsx (Metrikanzeige & Auswahl)
│ ├── PortfolioSection.tsx (Portfolio-Diagramme & Analyse - 591 Zeilen!)
│ ├── SessionComplete.tsx (Abschluss-UI)
│ ├── SortableHeader.tsx (Tabellenkopf mit Sortierindikatoren)
│ ├── UploadedFilesList.tsx (Liste der hochgeladenen Dateien)
│ └── UploadSection.tsx (Datei-Upload zu Supabase)
├── hooks/
│ ├── useContractMultipliers.ts (Kontrakt-Multiplikatoren verwalten)
│ ├── useMetrics.ts (Handelsmetriken berechnen)
│ ├── usePortfolio.ts (Portfolio-Daten & Datumsfilterung)
│ └── useSorting.ts (erweiterte Multi-Column-Sortierung)
└── utils/
└── dataUtils.ts (Metrikberechnungen, CSV-Parsing, Korrelationen)
Wichtige Konventionen
- Pfad-Alias:
@/zeigt aufsrc/– für alle internen Importe verwenden - shadcn-ui: Nur Farb-Tokens – CSS-Variablen in
src/index.css, keine tatsächlichen shadcn-Komponenten installiert. Könnten später vianpx shadcn@latest add buttonusw. hinzugefügt werden. - Git-Workflow: Feature-Branches →
git checkout -b feature/name→ konventionelle Commits (feat:,fix:,chore:) → PR zu main - Community-Branding: 5minfutures.com Trading-Community; Skool-Logo in Assets; GoHighLevel-Formular eingebettet
Migrationskontext
Migration von 40 Funktionen aus der alten App (90% abgeschlossen). Siehe Skill migration-tracker für Details.