용어 사전 (Glossary)

• Phase (페이즈) — 풀의 운영 단계. LIVE_TESTING(실시간 모의거래), LIVE_TRADING(실거래), LONGTERM_BACKTEST(장기 백테스트)로 나뉩니다.
• BacktestJob (백테스트 잡) — 장기 백테스트를 정의·실행·재개하는 DB 영속 작업 단위. 하나의 잡이 풀들을 생성하고 소유합니다.
• Override (오버라이드) — 한 잡 안에서 비교할 개별 전략 설정. 오버라이드 1개 = 풀 1개. 한 잡으로 여러 설정을 동시에 돌려 비교합니다 (multi-config, 다중 설정).
• Synthetic user_id (합성 사용자 ID) — bt:{jobId}:{overrideIndex} 형식. 실제 사용자가 아니라 잡이 풀을 소유함을 나타냅니다.
• Chunk (청크) — 백테스트 시간 구간을 1일 단위로 잘라 순차 처리하는 단위. 긴 구간에서 메모리 초과(OOM, Out Of Memory)를 막기 위함입니다.
• processed_until (처리 커서) — 어디까지 처리했는지 기록하는 시점. 중단·크래시 후 이 지점부터 재개(resume)합니다.
• Frozen strategy (고정 전략) — 실행 도중 설정이 바뀌지 않도록 잠근 전략(FixedStrategyManager). 모든 청크에서 동일 설정 → 재현성 보장.
• Closed-only PnL (청산 기준 손익) — 매도(SELL)가 일어난 포지션만 집계하는 실현 손익. 아직 안 판(ON_TRADE) 포지션의 미실현(unrealized) 손익은 제외됩니다.
• Promote (승격) — LIVE_TESTING 풀을 검증 후 LIVE_TRADING으로 올리는 동작. 백테스트에는 해당 경로가 없습니다.

라이브 Phase와의 차이 한눈에 보기

참고 — 대시보드 어디에도 안 보이는 BACK_TESTING(메모리 내 즉석 백테스트)은 영속되지 않고 재시작 시 사라집니다. LONGTERM_BACKTEST 는 이를 DB 영속·재개 가능 형태로 만든 것입니다.

① 생성 · 삭제 — 잡이 풀의 생애를 소유

• 풀은 오직 백테스트 잡으로만 만들어집니다. 잡 1개가 override 배열을 받아 override당 풀 1개를 생성하며, user_id 는 bt:{jobId}:{overrideIndex} 입니다.
• 잡을 삭제하면 그 잡이 만든 모든 풀과 trading_config 가 함께 cascade(연쇄) 삭제됩니다 — 고아 문서가 남지 않습니다.
• 대시보드의 + Pool / Pool Mgmt 는 LIVE_TESTING/LIVE_TRADING 만 다루므로 이 풀들은 거기서 보이지도, 편집되지도 않습니다.

② 실거래 엔진과의 완전 분리

• 실시간 거래 안 함 — 라이브 엔진은 LIVE_TRADING_PHASES(= LIVE_TESTING, LIVE_TRADING)에 속한 풀에만 kline(캔들) 이벤트를 흘립니다. LONGTERM_BACKTEST 는 여기 없어 RabbitMQ 실시간 캔들을 받지 않습니다.
• 설정 캐시 비참여 — 잡은 config-updated 이벤트를 emit(발행)하지 않아, 라이브 엔진의 설정 캐시에 잡 풀이 들어가지 않습니다.
• 자산 곡선 — 잡 완료 시 일괄 산출 — 시간별 equity(자산) 스냅샷 cron 은 라이브 phase 전용이라 백테스트 풀에는 돌지 않습니다. 대신 잡이 COMPLETED 될 때 테스트 구간 [from, until] 전체를 한 번에 계산해 기록하므로, 자산 곡선/NAV 지표가 라이브 풀과 동일하게 표시됩니다.
• 요약: 잡이 돌 때만 합성 kline 으로 포지션이 전진하고, 그 외 시간엔 완전히 멈춰 있습니다.

③ 자본 — 입출금·승격 차단

• 입금/출금 불가 — 자본 변경은 라이브 phase 화이트리스트(positive allowlist)에서만 허용됩니다. 백테스트 풀의 자본은 잡 생성 시점에 한 번 시드(seed)된 뒤 불변이라, 입출금 시도는 거부됩니다.
• 초기 자본은 잡 생성 시 주입 — 풀은 0 잔액으로 만들어진 뒤 백테스트 시작 시점 타임스탬프로 시드 입금됩니다. 사용자 지갑이 아니라 잡에 종속됩니다.
• 승격(Promote) 없음 — LIVE_TESTING→LIVE_TRADING 같은 진급 경로가 없습니다. 백테스트는 라이브 파이프라인과 분리된 종착 상태입니다.

④ 실행 방식 — 청크 전진 · 재개 · 비원자성

• 1일 청크로 전진 — 긴 구간을 1일씩 잘라 순차 처리하고, 처리한 구간의 데이터는 메모리에서 비워(slide) OOM 을 막습니다.
• processed_until 커서로 재개 — 어디까지 처리했는지 잡 문서에 기록합니다. 크래시·리스(lease) 상실 후 /run 재트리거 시 이 커서부터 이어서 실행됩니다.
• 마지막 청크는 비원자적(non-atomic) — standalone MongoDB(비 replica-set) 제약으로 트랜잭션을 쓰지 않습니다. 포지션 flush 후 커서 저장이 실패하면 재개 시 해당 청크를 다시 처리할 수 있습니다(의도적으로 단순성을 택한 트레이드오프, 비프로덕션 전용).

⑤ 다중 설정 — 한 잡으로 여러 설정 동시 비교

• 잡의 override 배열이 풀과 1:1 매핑됩니다. 모든 풀이 같은 잡 안에서 청크 단위로 함께 전진하므로, 같은 기간·같은 데이터로 여러 전략 설정을 공정하게 비교할 수 있습니다.
• 전략 설정(strategy_config)은 잡 override 에만 저장되고 TradingConfig 에는 들어가지 않습니다 → 실행 내내 동결되어 재현성이 보장됩니다.

⑥ 통계 해석 — 왜 Trades / PnL 이 0 으로 보이나

• 탭 배지의 Trades 와 +$0.00 은 청산된(매도 SELL 이 있는) 포지션만 집계합니다 (closed-only, 청산 기준).
• 백테스트 데이터 구간이 끝날 때까지 exit(청산) 조건이 trigger 되지 않은 포지션은 ON_TRADE(보유 중)로 남고, 0 · O3 처럼 "청산 0건 · 열린 포지션 3건"으로 표기됩니다. 미실현(unrealized) 손익은 합산에서 빠집니다.
• 백테스트 종료 시 열린 포지션을 강제 청산(mark-to-market)하지 않으므로, 진입만 하고 모두 미청산이면 Trades 0, 배지 +$0.00 이 정상입니다 — 버그가 아닙니다.
• Win Rate · Profit Factor · Sharpe 등 실현 손익 기반 지표는 청산 표본이 쌓여야 의미를 가집니다.