TQQQ 밸류 리밸런싱 투자 추적 대시보드. Google Sheets 데이터를 기반으로 포트폴리오 상태, 매매 시그널, 매수/매도 포인트를 실시간 추적합니다.

trakit/
├── backend/          # FastAPI 백엔드 (Python)
├── frontend/         # React 프론트엔드 (Vite + JSX)
├── data/             # 로컬 CSV/TSV 데이터 (fallback)
├── agents/           # 에이전트별 상세 문서
│   ├── backend.md    # 백엔드 에이전트
│   ├── frontend.md   # 프론트엔드 에이전트
│   ├── cicd.md       # CI/CD 에이전트
│   └── pencil.md     # 디자인 에이전트
├── docs/
│   └── api-spec.md   # API 상세 명세
└── start.sh          # 동시 실행 스크립트

./start.sh
# 대시보드: http://localhost:5173
# API 문서: http://localhost:8000/docs

docker compose up --build -d
# 대시보드: http://localhost
# API: http://localhost:8000

프론트엔드는 항상 /api 상대경로로 API를 호출합니다. 환경별 프록시가 백엔드로 라우팅합니다.

Docker 배포 시 vite.config.js의 proxy 설정은 사용되지 않습니다. npm run build로 정적 파일을 생성하고, nginx가 서빙 + API 프록시를 담당합니다.

• 포트폴리오 추적: 주차별 평가금, Pool, 총 자산 추적 (이전 주차 대비 보유량 변동 표시)
• 리밸런싱 밴드: 최소/최대 밴드 기반 매매 시점 판단
• 실시간 TQQQ 가격: yfinance SDK 기반, KST 21시~06시 20초 자동 갱신 (config API 기반)
• 실시간 환율: USD/KRW 환율 외부 API 조회, KST 17시 이후 하루 1회 갱신
• 매매 시그널: BUY/SELL/HOLD 자동 판정 및 추천 메시지
• 매수/매도 포인트: 기준 단수 자동 계산 (백엔드), 지정가 매수/매도 테이블
• 차트: 평가금 차트 + 주당 가격 이동선 (recharts)
• 주차 네비게이션: 고정 너비 라벨 + 버튼형 ◀▶ 화살표
• 목표 달성률: 실시간 환율 기반 10억원 목표 진행률
• 후원: 헤더 + 하단 카드에 계좌번호 복사 기능
• 모바일 반응형: 태블릿/모바일 화면 자동 레이아웃 조정

• Backend Agent - API 서버, 서비스 레이어, 데이터 로딩
• Frontend Agent - React 컴포넌트, 차트, 상태 관리
• CI/CD Agent - Docker 빌드, 배포, 환경별 프록시 설정
• Pencil Agent - UI 디자인 명세 (.pen)
• API 명세 - 11개 엔드포인트 상세 스펙

• Backend: Python 3.11, FastAPI, pandas, yfinance
• Frontend: React 18, Vite, recharts
• Data: Google Sheets CSV export, Yahoo Finance API
• Infra: Docker Compose, nginx (리버스 프록시), AWS NLB
• Design: Pencil (.pen)