대시보드
봇이 활성화된 직후 가장 먼저 들어가는 화면입니다. 자산군별 P&L 요약, equity curve, 오픈 포지션, 최근 거래, 봇 제어 패널이 한 페이지에 모여 있습니다.
📸 대시보드 메인 화면 (추후 자동 캡처 예정)
화면 구성
대시보드는 5개의 위젯으로 구성됩니다.
| 위젯 | 위치 | 설명 |
|---|---|---|
| AssetClassFilter | 헤더 우측 | All / Crypto / US / KR 4단 토글 |
| StatsGrid | 상단 | Equity, 일일 P&L, 오픈 포지션, 트레이드, 승률 등 카드 |
| EquityChart | 중간 | 시계열 자산 곡선 (자동 갱신 1초) |
| OpenPositions / RecentTrades | 좌·우 2열 | 오픈 포지션과 최근 5건 거래 |
| RegimeBadge / BotControl | 하단 좌·우 | 시장 레짐 배지 + 봇 시작/중지 버튼 |
자식 페이지
- 전체 화면 / 위젯 구성 — 위젯별 상세 동작과 새로고침 주기
- PnL 카드 해석 — 자산군별 P&L 분리 표시 규칙
- 자산군 필터 — All / Crypto / US / KR 토글 사용법
API 연동
대시보드는 다음 4개 엔드포인트를 1초 간격으로 폴링합니다.
| Method | Path | 용도 |
|---|---|---|
| GET | /api/dashboard/summary | StatsGrid + RegimeBadge |
| GET | /api/dashboard/equity | EquityChart |
| GET | /api/positions | OpenPositions |
| GET | /api/trades?page=1&limit=5 | RecentTrades |
asset_class 쿼리 파라미터(all/crypto/us_equity/kr_equity)가 모든 호출에 자동 전달됩니다.
자주 묻는 질문
Q. 대시보드 숫자가 0이에요.
A. 봇이 실행 중이 아니거나 거래소 키가 등록되지 않은 상태일 수 있습니다. 우측 하단 BotControl 패널에서 상태를 확인하고, Settings → Exchange Keys에서 키를 추가하세요.
Q. 새로고침이 안 됩니다.
A. WebSocket 미연결 시 1초 폴링이 자동 fallback으로 동작합니다. 브라우저 콘솔에서 wss://... 연결 오류를 확인하세요.