cointrader/docs/plans/2026-03-06-multi-symbol-dashboard-design.md

Multi-Symbol Dashboard Design

배경

멀티심볼 트레이딩(XRP, TRX, DOGE) 지원 이후 대시보드가 단일 심볼 기준으로 되어있어 수정 필요. 봇 로그 형식 통일, 파서/DB/API/UI 전체 레이어 변경.

접근 방식

A안 채택: 기존 단일 DB에 symbol 컬럼 추가. 대시보드 DB는 로그 파싱으로 재생성 가능하므로 초기화 비용 없음.

1. 봇 로그 수정

모든 핵심 로그에 [SYMBOL] 프리픽스를 일관되게 추가.

변경 대상 (src/bot.py):

• 신호: {signal} | 현재가: → [{self.symbol}] 신호: ...
• {signal} 진입: 가격= → [{self.symbol}] {signal} 진입: ...
• 기존 포지션 복구: → [{self.symbol}] 기존 포지션 복구: ...
• 기준 잔고 설정: → [{self.symbol}] 기준 잔고 설정: ...
• 포지션 청산(...) → [{self.symbol}] 포지션 청산(...)
• OI=..., OI변화율=... → [{self.symbol}] OI=... (debug→info로 변경 또는 그대로 debug 유지)

변경 대상 (src/user_data_stream.py):

• 청산 감지({reason}): → [{self.symbol}] 청산 감지({reason}): ...

이미 [{self.symbol}]이 있는 로그는 그대로 유지.

2. Log Parser (log_parser.py)

정규식 변경

모든 패턴에 \[(?P<symbol>\w+)\] 프리픽스 추가:

"signal": re.compile(
    r"(?P<ts>\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})"
    r".*\[(?P<symbol>\w+)\] 신호: (?P<signal>\w+) \| 현재가: (?P<price>[\d.]+) USDT"
),

상태 추적 멀티심볼 대응

• _current_position: dict → _current_positions: dict[str, dict] (심볼별)
• _pending_candle: dict → _pending_candles: dict[str, dict[str, dict]] (심볼별 타임스탬프별)
• _bot_config["symbol"] 제거, 정규식에서 심볼 직접 파싱

핸들러 변경

_handle_entry: symbol을 정규식에서 직접 받음. 중복 체크를 symbol+direction 기준으로.

_handle_close: WHERE status='OPEN' AND symbol=?로 해당 심볼만 닫음.

bot_status 키 형식

• 심볼별: {symbol}:current_price, {symbol}:position_status, {symbol}:current_signal 등
• 전역: balance, ml_threshold 그대로

3. DB 스키마 변경

candles 테이블

CREATE TABLE candles (
    id              INTEGER PRIMARY KEY AUTOINCREMENT,
    symbol          TEXT    NOT NULL,
    ts              TEXT    NOT NULL,
    price           REAL    NOT NULL,
    signal          TEXT,
    adx             REAL,
    oi              REAL,
    oi_change       REAL,
    funding_rate    REAL,
    UNIQUE(symbol, ts)
);
CREATE INDEX idx_candles_symbol_ts ON candles(symbol, ts);

daily_pnl 테이블

CREATE TABLE daily_pnl (
    symbol          TEXT    NOT NULL,
    date            TEXT    NOT NULL,
    cumulative_pnl  REAL    DEFAULT 0,
    trade_count     INTEGER DEFAULT 0,
    wins            INTEGER DEFAULT 0,
    losses          INTEGER DEFAULT 0,
    last_updated    TEXT,
    PRIMARY KEY(symbol, date)
);

trades 테이블

기존 symbol 컬럼 있음. DEFAULT 'XRPUSDT' 제거, 파서에서 항상 명시적으로 심볼 전달.

bot_status 테이블

스키마 변경 없음. 키 네이밍만 {symbol}:{key} 형태로 변경.

마이그레이션

_init_db()에서 DROP TABLE IF EXISTS → 재생성. 기존 데이터는 로그 재파싱으로 복구.

4. API (dashboard_api.py)

모든 엔드포인트에 symbol 쿼리 파라미터 추가. 없으면 전체.

변경 엔드포인트

엔드포인트	변경
GET /api/position	심볼별 OPEN 포지션 목록 반환. {"positions": [...], "bot": {...}}
GET /api/trades	?symbol= 필터 추가
GET /api/stats	?symbol= 필터 추가
GET /api/daily	?symbol= 필터 추가
GET /api/candles	?symbol= 필수 파라미터

새 엔드포인트

GET /api/symbols → {"symbols": ["XRPUSDT", "TRXUSDT", "DOGEUSDT"]}

bot_status에서 {symbol}:last_start 키가 있는 심볼 목록 반환.

5. UI (App.jsx)

헤더

• "XRP/USDT" 하드코딩 제거 → Live · 3 symbols
• 오픈 포지션 카드를 심볼별 복수 표시 (가로 나열)

심볼 필터 탭

기존 탭(Overview/Trades/Chart) 위에 심볼 필터 추가: ALL | XRP | TRX | DOGE

• /api/symbols에서 동적 생성
• ALL: 전체 합산, 개별 심볼: 해당 심볼만

Overview 탭

• ALL: 전체 합산 StatCard + 일별 PnL + 최근 거래(심볼 뱃지 표시)
• 개별 심볼: 해당 심볼만

Trades 탭

• 선택된 심볼로 필터링

Chart 탭

• ALL 선택 시 첫 번째 심볼 자동 선택 (캔들은 심볼별)
• 차트 제목 동적: {SYMBOL}/USDT 15m 가격

데이터 페칭

• fetchAll에서 선택된 심볼을 쿼리 파라미터로 전달
• 심볼 변경 시 즉시 리페치

6. 변경 범위 요약

레이어	파일	변경
봇	src/bot.py	로그에 [SYMBOL] 프리픽스 추가
봇	src/user_data_stream.py	청산 로그에 [SYMBOL] 프리픽스 추가
파서	dashboard/api/log_parser.py	정규식, 상태 추적, 핸들러 멀티심볼 대응
API	dashboard/api/dashboard_api.py	symbol 파라미터, /api/symbols
UI	dashboard/ui/src/App.jsx	심볼 필터 탭, 복수 포지션, 동적 헤더

봇 이미지와 대시보드 이미지 모두 재빌드 필요.