Portfolio Buddy 2 - プロジェクトコンテキスト は何をしますか?
テクノロジースタック
- フロントエンド: React 19, TypeScript, Vite
- UI: Tailwind CSS, shadcn/ui(カラーパレットのみ)
- チャート: Chart.js, react-chartjs-2, chartjsプラグイン(zoom, annotation, date adapter)
- 状態管理: プレーンなReact(useState, useMemo, useCallback)
- データユーティリティ: date-fns(日付操作)
- バックエンド: Supabase(PostgreSQL)
- デプロイ: Cloudflare Pages
プロジェクトの目的
投資家と先物トレーダーのためのポートフォリオ分析ツール。以下の機能を提供します。
- 取引戦略とベンチマーク資産(SPY、GLD)の比較
- 資産間の相関行列の計算(Spearman & Pearson)
- リスク指標とパフォーマンスの分析(Sharpe、Sortino、最大ドローダウンなど)
- 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でエラーハンドリングを強化
- アップロードフックのエラーハンドリングを確認
- 無料枠の行上限を超えていないか確認
最近追加された機能
- Sortino比率計算(コミット 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 (完了画面)
│ ├── SortableHeader.tsx (ソートインジケータ付きテーブルヘッダー)
│ ├── UploadedFilesList.tsx (アップロード済みファイルのリスト)
│ └── UploadSection.tsx (Supabaseへのファイルアップロード)
├── hooks/
│ ├── useContractMultipliers.ts (契約乗数の管理)
│ ├── useMetrics.ts (取引指標の計算)
│ ├── usePortfolio.ts (ポートフォリオデータと日付フィルタリング)
│ └── useSorting.ts (高度なマルチカラムソート)
└── utils/
└── dataUtils.ts (指標計算、CSV解析、相関)
移行コンテキスト
旧アプリから40の機能を移行中(35/40完了)。詳細は migration-tracker スキルを参照。