Portfolio Buddy 2 - 프로젝트 컨텍스트
기술 스택
- 프론트엔드: React 19, TypeScript, Vite
- UI: Tailwind CSS, shadcn/ui (색상 시스템만 사용)
- 차트: Chart.js, react-chartjs-2, chartjs 플러그인 (zoom, annotation, date adapter)
- 상태 관리: Plain React (useState, useMemo, useCallback)
- 데이터 유틸: date-fns (날짜 조작)
- 백엔드: Supabase (PostgreSQL)
- 배포: Cloudflare Pages
프로젝트 목적
투자자 및 선물 트레이더를 위한 포트폴리오 분석 도구:
- 트레이딩 전략과 벤치마크 자산(SPY, GLD) 비교
- 자산 간 상관관계 행렬 계산 (Spearman & Pearson)
- 위험 지표 및 성과 분석 (Sharpe, Sortino, Max DD 등)
- CSV를 통한 트레이드 데이터 업로드 및 결과 시각화
- 선물 트레이딩을 위한 계약 승수 적용으로 지표 조정
- 기간별 분석을 위한 날짜 범위 필터링
알려진 이슈 및 기술 부채
현재 기술 부채
-
사용하지 않는 의존성: Recharts (11.5KB) 설치되었지만 import되지 않음
- 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줄)
- 사용자 지정 무위험 수익률을 위한 risk-free rate 입력 상태
- sqrt(365) 계수를 사용한 연간화된 하방 편차
- 수정된 분산 계산 (전체 수익률로 나누며, 음수만 계산하지 않음)
- 포트폴리오 통계 섹션에 표시 (535줄)
- 참고: dataUtils.ts에 없음 - 포트폴리오 레벨 컨텍스트로 인해 컴포넌트에 유지
- 날짜 범위 필터링 (커밋 258ba3a)
- 시작/종료 날짜로 포트폴리오 데이터 필터링
- usePortfolio 훅에 구현
- 고급 다중 컬럼 정렬 (useSorting 훅)
- 우선순위로 여러 컬럼 정렬
- 컬럼별 사용자 지정 비교 로직
아키텍처 제약
- 컴포넌트 제한: 컴포넌트당 최대 200줄 (현재 3개 컴포넌트 위반)
- 훅 패턴:
/src/hooks/에 사용자 정의 훅 - 유틸 패턴:
/src/utils/에 순수 함수 - 타입 안전성: 엄격한 TypeScript,
any타입 없음 (기술 부채로 15건 위반) - 상태 관리: Plain 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/로 매핑 — 모든 내부 import에 사용 - shadcn-ui: 색상 토큰만 사용 — CSS 변수는
src/index.css에, 실제 shadcn 컴포넌트는 설치되지 않음.npx shadcn@latest add button등으로 나중에 추가 가능 - Git 워크플로우: 기능 브랜치 →
git checkout -b feature/name→ 컨벤셔널 커밋 (feat:,fix:,chore:) → PR to main - 커뮤니티 브랜딩: 5minfutures.com 트레이딩 커뮤니티; assets에 Skool 로고; GoHighLevel 폼 내장
마이그레이션 컨텍스트
40개 기능을 이전 앱에서 마이그레이션 중 (90% 완료). 자세한 내용은 migration-tracker 스킬 참조.