Portfolio Buddy 2 - プロジェクトコンテキスト
テクノロジースタック
- フロントエンド: React 19、TypeScript、Vite
- UI: Tailwind CSS、shadcn/ui(カラーシステムのみ)
- チャート: Chart.js、react-chartjs-2、chartjsプラグイン(ズーム、アノテーション、日付アダプター)
- 状態管理: プレーンなReact(useState、useMemo、useCallback)
- データユーティリティ: date-fns(日付操作)
- バックエンド: Supabase(PostgreSQL)
- デプロイ: Cloudflare Pages
プロジェクトの目的
投資家および先物トレーダーのためのポートフォリオ分析ツール。以下のことを行います:
- 取引戦略とベンチマーク資産(SPY、GLD)を比較
- 資産間の相関行列(スピアマン相関とピアソン相関)を計算
- リスク指標とパフォーマンス(シャープレシオ、ソルティノレシオ、最大ドローダウンなど)を分析
- CSVで取引データをアップロードし、結果を可視化
- 先物取引の指標調整のための契約乗数を適用
- 特定期間分析のための日付範囲フィルタリング
既知の問題と技術的負債
現在の技術的負債
-
未使用の依存関係: Recharts(11.5KB)がインストールされているが、インポートされていない
- package.json から削除すべき
- 現在は Chart.js を使用中
-
巨大なコンポーネント: 200行の標準を超えている
- PortfolioSection.tsx(591行)→ サブコンポーネントにリファクタリングが必要
- App.tsx(351行)→ セクションをコンポーネントに分割
- MetricsTable.tsx(242行)→ 改善されたが、まだ制限超過
-
TypeScript違反:
any型が15件存在- usePortfolio.ts: 取引/指標タイプで11件
- useMetrics.ts: ソート比較で4件
- dataUtils.ts: Metricsインターフェースで1件
既知のバグ
- Supabaseアップロードエラー: 大規模アップロード時に断続的な500エラーが発生
- コミット 9fb7fdb でエラーハンドリングを強化
- アップロードフックのエラーハンドリングを確認
- 無料枠の行制限を超過していないか確認
最近追加された機能
- ソルティノレシオ計算(コミット 258ba3a、9f25040)
- 場所: PortfolioSection.tsx にインライン実装(133〜158行目)
- ユーザー指定のリスクフリーレートのための入力状態
- sqrt(365) 係数を使用した年率化下方偏差
- 修正された分散計算(負のリターンだけでなく全リターンで除算)
- ポートフォリオ統計セクションに表示(535行目)
- 注意: dataUtils.ts にはない - ポートフォリオレベルのコンテキストのためコンポーネント内に保持
- 日付範囲フィルタリング(コミット 258ba3a)
- 開始日/終了日でポートフォリオデータをフィルタリング
- usePortfolio フックに実装
- 高度なマルチカラムソート(useSorting フック)
- 優先順位付きの複数列ソート
- カラムごとのカスタム比較ロジック
アーキテクチャ上の制約
- コンポーネント制限: コンポーネントあたり最大200行(現在3つのコンポーネントが違反)
- フックパターン: カスタムフックは
/src/hooks/に配置 - ユーティリティパターン: 純粋関数は
/src/utils/に配置 - 型安全性: 厳格なTypeScript、
any型は使用禁止(技術的負債として15件の違反が存在) - 状態管理: プレーンなReactフックのみ - Zustand や TanStack Query は使用しない
主要コンポーネント構造
src/
├── components/
│ ├── AnalyticsControls.tsx (指標/ポートフォリオ/相関ビューの切り替え)
│ ├── ContractInput.tsx (契約乗数入力)
│ ├── CorrelationHeatmap.tsx (相関の可視化)
│ ├── CorrelationSection.tsx (相関分析ラッパー)
│ ├── CustomTooltip.tsx (チャートツールチップ)
│ ├── ErrorList.tsx (エラー表示)
│ ├── Header.tsx (アプリヘッダー)
│ ├── MasterContractControl.tsx (すべてに契約値を適用)
│ ├── MetricsTable.tsx (指標表示と選択)
│ ├── PortfolioSection.tsx (ポートフォリオチャートと分析 - 591行!)
│ ├── SessionComplete.tsx (完了UI)
│ ├── SortableHeader.tsx (ソートインジケーター付きテーブルヘッダー)
│ ├── UploadedFilesList.tsx (アップロード済みファイルのリスト)
│ └── UploadSection.tsx (Supabaseへのファイルアップロード)
├── hooks/
│ ├── useContractMultipliers.ts (契約乗数の管理)
│ ├── useMetrics.ts (取引指標の計算)
│ ├── usePortfolio.ts (ポートフォリオデータと日付フィルタリング)
│ └── useSorting.ts (高度なマルチカラムソート)
└── utils/
└── dataUtils.ts (指標計算、CSV解析、相関)
主要な規約
- パスエイリアス:
@/はsrc/にマッピング — すべての内部インポートで使用 - shadcn-ui: カラートークンのみ —
src/index.css内のCSS変数、実際のshadcnコンポーネントは未インストール。後でnpx shadcn@latest add buttonなどで追加可能 - Gitワークフロー: 機能ブランチ →
git checkout -b feature/name→ 従来のコミットメッセージ(feat:、fix:、chore:) → mainへのPR - コミュニティブランディング: 5minfutures.com 取引コミュニティ;Skoolロゴをアセットに;GoHighLevelフォームを埋め込み
移行コンテキスト
古いアプリからの40機能の移行(90%完了)。詳細は migration-tracker スキルを参照。