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)
- 分析風險指標和績效(夏普比率、索提諾比率、最大回撤等)
- 通過 CSV 上傳交易數據並可視化結果
- 應用合約乘數以調整指標以適應期貨交易
- 按日期範圍過濾數據以進行特定時期的分析
已知問題與技術債務
當前技術債務
-
未使用的依賴項:Recharts(11.5KB)已安裝但從未被導入
- 應從 package.json 中移除
- 目前使用的是 Chart.js
-
元件過大:違反 200 行標準
- PortfolioSection.tsx(591 行)→ 需要重構為子元件
- App.tsx(351 行)→ 將區塊提取到元件中
- MetricsTable.tsx(242 行)→ 已改進但仍超過限制
-
TypeScript 違規:15 處使用
any類型- usePortfolio.ts:交易/指標類型中出現 11 次
- useMetrics.ts:排序比較中出現 4 次
- dataUtils.ts:Metrics 介面中出現 1 次
已知錯誤
- Supabase 上傳錯誤:大文件上傳時偶爾出現 500 錯誤
- 在提交 9fb7fdb 中添加了增強的錯誤處理
- 檢查上傳 hook 中的錯誤處理
- 確認免費版的行數限制未被超出
近期新增功能
- 索提諾比率計算(提交 258ba3a、9f25040)
- 位置:在 PortfolioSection.tsx(第 133–158 行)中內聯實現
- 無風險利率輸入狀態,供用戶指定無風險利率
- 使用 sqrt(365) 因子的年化下行標準差
- 修正的變異數計算(除以總回報數,而不僅是負回報)
- 在投資組合統計部分顯示(第 535 行)
- 注意:不在 dataUtils.ts 中 – 由於投資組合級別的上下文而保留在元件中
- 日期範圍過濾(提交 258ba3a)
- 按開始/結束日期過濾投資組合數據
- 在 usePortfolio hook 中實現
- 進階多列排序(useSorting hook)
- 按優先級對多列進行排序
- 每列自定義比較邏輯
架構限制
- 元件限制:每個元件最多 200 行(目前有 3 個元件違規)
- Hook 模式:自定義 hooks 放置在
/src/hooks/ - 工具函數模式:純函數放置在
/src/utils/ - 型別安全:嚴格的 TypeScript,禁止使用
any類型(目前有 15 處違規作為技術債務) - 狀態管理:僅使用純 React hooks – 不使用 Zustand 或 TanStack Query
主要元件結構
src/
├── components/
│ ├── AnalyticsControls.tsx 切換 Metrics/Portfolio/Correlation 視圖
│ ├── 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 解析、相關性分析
遷移上下文
正在從舊應用程式遷移 40 項功能(已完成 35/40)。詳情請參閱 migration-tracker 技能。