alt/agent-ops/roadmap/milestones/backtest-engine-baseline.md

Backtest Engine Baseline

목표

정규화된 일봉 데이터를 사용해 전략 실행, portfolio state, result summary가 재현 가능한 backtest loop를 만든다. 이 milestone은 백테스트 기반을 ALT 확장의 중심축으로 고정한다.

단계

백테스트 루프

상태

계획

구현 잠금

• 상태: 해제
• 결정 필요: 없음

범위

• daily bar 기반 strategy execution skeleton
• deterministic backtest run lifecycle
• starting cash, ending equity, trades/positions summary
• result persistence and query
• fixture data 기반 검증

필수 기능

• [run-lifecycle] backtest run의 pending/running/succeeded/failed/canceled lifecycle이 있다.
• [strategy-port] strategy를 engine에 주입할 port 또는 interface가 있다.
• [portfolio-state] cash, position, equity를 계산하는 최소 portfolio state가 있다.
• [result-store] backtest result가 저장되고 조회된다.
• [fixture-test] fixture daily bars로 deterministic test가 통과한다.

완료 기준

• 동일한 fixture와 strategy 입력으로 동일한 result가 나온다.
• worker가 backtest 실행을 소유하고 API는 실행 요청/조회 경계만 담당한다.
• 결과가 contracts/client에서 조회 가능한 형태로 연결될 수 있다.
• bin/test와 bin/lint가 통과한다.

범위 제외

• 실시간 전략 실행
• paper/live order routing
• 고급 리스크 모델
• 고급 성과 분석 지표 전체

작업 컨텍스트

• 관련 경로: packages/domain/backtest/, services/worker/, packages/contracts/proto/alt/v1/backtest.proto
• 표준선(선택): Go는 Hexagonal Architecture, light CQRS, domain event 표현을 기본 설계 프레임으로 삼는다.
• 선행 작업: Korea Daily Data Foundation
• 후속 작업: Backtest Analysis Surface
• 확인 필요: 없음