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 (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 스킬을 참조하세요.