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 파싱, 상관관계)
주요 규칙
- 경로 별칭:
@/는src/에 매핑됨 — 모든 내부 임포트에 사용 - shadcn-ui: 색상 토큰만 사용 — CSS 변수는
src/index.css에 있으며, 실제 shadcn 컴포넌트는 설치되지 않음. 나중에npx shadcn@latest add button등으로 추가 가능 - Git 워크플로우: 기능 브랜치 →
git checkout -b feature/name→ 컨벤셔널 커밋 (feat:,fix:,chore:) → main으로 PR - 커뮤니티 브랜딩: 5minfutures.com 트레이딩 커뮤니티; assets에 Skool 로고; GoHighLevel 폼 내장
마이그레이션 컨텍스트
기존 앱에서 40개 기능을 마이그레이션 중 (90% 완료). 자세한 내용은 migration-tracker 스킬을 참조하세요.