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)
- Zustand: Reines React (useState, useMemo, useCallback)
- Datenhilfsprogramme: date-fns für Datumsmanipulation
- Backend: Supabase (PostgreSQL)
- Bereitstellung: Cloudflare Pages
Projektzweck
Portfolio-Analyse-Tool für Investoren und Futures-Trader zum:
- Vergleichen von Handelsstrategien mit Benchmark-Assets (SPY, GLD)
- Berechnen von Korrelationsmatrizen zwischen Assets (Spearman & Pearson)
- Analysieren von Risikometriken 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 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ß 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 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 überprüfen
- Sicherstellen, dass Zeilengrenzen 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-Eingabestatus für benutzerdefinierten risikofreien Zinssatz
- Annualisierte Abwärtsabweichung mit sqrt(365)-Faktor
- Korrigierte Varianzberechnung (dividiert durch Gesamtrenditen, nicht nur negative)
- Angezeigt im Portfolio-Statistikbereich (Zeile 535)
- Hinweis: NICHT in dataUtils.ts - aufgrund des Portfolio-Kontexts in der Komponente belassen
- Datumsbereichsfilterung (Commit 258ba3a)
- Portfoliodaten nach Start-/Enddatum filtern
- Implementiert im usePortfolio-Hook
- Erweiterte Mehrfachspaltensortierung (useSorting-Hook)
- Sortieren nach mehreren Spalten mit Priorität
- Benutzerdefinierte Vergleichslogik pro Spalte
Architektonische Einschränkungen
- Komponentenlimit: Maximal 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 bestehen als technische Schulden) - Zustandsverwaltung: Nur einfache React-Hooks - kein Zustand oder TanStack Query
Wichtige Komponentenstruktur
src/
├── components/
│ ├── AnalyticsControls.tsx (Umschalten der Ansichten Metriken/Portfolio/Korrelation)
│ ├── ContractInput.tsx (Eingaben für Kontraktmultiplikatoren)
│ ├── 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 zu Supabase)
├── hooks/
│ ├── useContractMultipliers.ts (Verwaltung von Kontraktmultiplikatoren)
│ ├── useMetrics.ts (Berechnung von Handelsmetriken)
│ ├── usePortfolio.ts (Portfoliodaten & Datumsfilterung)
│ └── useSorting.ts (erweiterte Mehrfachspaltensortierung)
└── 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→ konventioneller Commit (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.