Portfolio Buddy 2 - Projektkontext
Technologie-Stack
- Frontend: React 19, TypeScript, Vite
- UI: Tailwind CSS, shadcn/ui (nur Farbsystem)
- Diagramme: Chart.js, react-chartjs-2, chartjs Plugins (Zoom, Annotation, Datumsadapter)
- Zustandsverwaltung: Reines React (useState, useMemo, useCallback)
- Daten-Hilfsfunktionen: date-fns für Datumsmanipulation
- Backend: Supabase (PostgreSQL)
- Bereitstellung: Cloudflare Pages
Projektzweck
Portfolio-Analyse-Tool für Investoren und Futures-Händler zum:
- Vergleichen von Handelsstrategien mit Benchmark-Assets (SPY, GLD)
- Berechnen von Korrelationsmatrizen zwischen Assets (Spearman & Pearson)
- Analysieren von Risikokennzahlen und Performance (Sharpe, Sortino, Max DD, usw.)
- Hochladen von Handelsdaten per CSV und Visualisieren der Ergebnisse
- Anwenden von Kontraktmultiplikatoren zur Anpassung von Metriken für den 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
- Verwendet stattdessen Chart.js
-
Überdimensionierte Komponenten: Verstoßen gegen die 200-Zeilen-Norm
- 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 des Typs
any- usePortfolio.ts: 11 Vorkommen in Handels-/Metriktypen
- useMetrics.ts: 4 Vorkommen in Sortiervergleichen
- dataUtils.ts: 1 Vorkommen im Metrik-Interface
Bekannte Fehler
- Supabase-Upload-Fehler: Gelegentliche 500-Fehler bei großen Uploads
- Verbesserte Fehlerbehandlung in Commit 9fb7fdb hinzugefügt
- Fehlerbehandlung in Upload-Hooks überprüfen
- Sicherstellen, dass Zeilenlimits im kostenlosen Tarif nicht überschritten werden
Kürzlich hinzugefügte Funktionen
- Sortino-Ratio-Berechnung (Commits 258ba3a, 9f25040)
- Ort: Inline in PortfolioSection.tsx implementiert (Zeilen 133-158)
- Risikofreier Zinssatz-Input für benutzerdefinierten risikofreien Zinssatz
- Annualisierte Abwärtsabweichung mit sqrt(365)-Faktor
- Korrigierte Varianzberechnung (dividiert durch alle Renditen, nicht nur negative)
- Im Portfolio-Statistikbereich angezeigt (Zeile 535)
- Hinweis: NICHT in dataUtils.ts - aufgrund des Portfolio-Kontexts in der Komponente belassen
- Datumsbereichsfilterung (Commit 258ba3a)
- Portfolio-Daten nach Start-/Enddatum filtern
- Im usePortfolio-Hook implementiert
- Erweiterte Mehrspaltensortierung (useSorting-Hook)
- Nach mehreren Spalten mit Priorität sortieren
- Benutzerdefinierte Vergleichslogik pro Spalte
Architekturbeschränkungen
- Komponentenlimit: Max. 200 Zeilen pro Komponente (derzeit 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 vorhanden) - Zustandsverwaltung: Nur reine React-Hooks - kein Zustand oder TanStack Query
Wichtige Komponentenstruktur
src/
├── components/
│ ├── AnalyticsControls.tsx (Umschalter für Metriken/Portfolio/Korrelationsansichten)
│ ├── ContractInput.tsx (Kontraktmultiplikator-Eingaben)
│ ├── CorrelationHeatmap.tsx (Korrelationsvisualisierung)
│ ├── CorrelationSection.tsx (Wrapper für Korrelationsanalyse)
│ ├── CustomTooltip.tsx (Diagramm-Tooltips)
│ ├── ErrorList.tsx (Fehleranzeige)
│ ├── Header.tsx (App-Kopfzeile)
│ ├── 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 hochgeladener Dateien)
│ └── UploadSection.tsx (Datei-Upload nach Supabase)
├── hooks/
│ ├── useContractMultipliers.ts (Verwaltung von Kontraktmultiplikatoren)
│ ├── useMetrics.ts (Berechnung von Handelsmetriken)
│ ├── usePortfolio.ts (Portfoliodaten & Datumsfilterung)
│ └── useSorting.ts (erweiterte Mehrspaltensortierung)
└── utils/
└── dataUtils.ts (Metrikberechnungen, CSV-Parsing, Korrelationen)
Migrationskontext
Migration von 40 Funktionen aus der alten App (35/40 abgeschlossen). Siehe migration-tracker-Skill für Details.