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)
- 计算资产之间的相关性矩阵(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:1 处出现在 Metrics 接口中
已知错误
- Supabase 上传错误: 大文件上传时出现间歇性 500 错误
- 在提交 9fb7fdb 中增强了错误处理
- 检查上传 hooks 中的错误处理逻辑
- 确认免费层的行数限制未被超出
最近新增功能
- 索提诺比率计算(提交 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 技能。