# Milestone: Paper Trading Readiness

## 위치

- Roadmap: `agent-roadmap/ROADMAP.md`
- Phase: `agent-roadmap/phase/trading-expansion/PHASE.md`

## 목표

실거래 전에 전략 실행, 가상 주문, 포지션, 리스크 흐름을 paper trading 경계에서 검증한다. 백테스트 기반을 실시간 또는 준실시간 실행 흐름으로 확장할 때 뒤집지 않을 adapter 경계를 만든다.

## 상태

[완료]

## 구현 잠금

- 상태: 해제
- 결정 필요: 없음
- 결정 내용:
  - [x] 초기 주문/체결 모델은 일봉 MVP 기준으로 시작한다. market order는 다음 bar open 체결, limit order는 다음 bar의 high/low crossing 기반 체결로 두며 fee/slippage는 config 기본값 0으로 둔다.
  - [x] paper trading은 일봉 기반으로 시작한다. 분봉/실시간 가격 요구는 후속 Milestone에서 별도 확장한다.

## 범위

- paper account/portfolio state
- virtual order and fill model
- strategy execution scheduling
- risk guard skeleton
- API/command monitoring surface

## 기능

### Epic: [paper-trading] Paper trading readiness

실거래 전 전략 실행, 가상 주문, 포지션, 리스크 검증 흐름을 묶는다.

- [x] [paper-account] paper account와 portfolio state가 있으며, backtest engine과 공유할 개념과 paper-only 개념이 문서화되어 있다.
- [x] [virtual-orders] 가상 주문과 체결 모델이 있으며, 실제 broker 주문 없이 독립적으로 동작한다.
- [x] [risk-guard] 최소 risk guard skeleton이 있으며, 실거래 adapter가 들어와도 paper flow를 뒤집지 않는 경계가 있다.
- [x] [strategy-run] 전략을 paper execution loop에서 실행할 수 있다.
- [x] [paper-monitor] API/command workflow에서 paper state를 모니터링할 수 있다. 검증: 관련 테스트와 `bin/test`가 통과한다.

## 완료 리뷰

- 상태: 승인됨
- 요청일: 2026-06-05
- 완료 근거:
  - 커밋 `aaf1af6`에서 paper account/order/fill/risk/strategy runtime과 API/CLI state monitoring surface가 연결되었다.
  - 관련 구현은 `packages/domain/backtest`, `services/worker/internal/papertrading`, `services/api/internal/socket`, `services/worker/internal/socket`, `apps/cli/internal/operator`에 반영되어 있다.
  - 2026-06-05 local `bin/test` 통과.
- 리뷰 필요:
  - [x] 사용자가 완료 결과를 확인했다
  - [x] archive 이동을 승인했다
- 리뷰 코멘트: 2026-06-05 사용자 요청으로 완료 승인 및 archive 이동을 반영했다.

## 범위 제외

- 실거래 주문 제출
- broker 계좌 잔고 실시간 동기화
- 고급 리스크 엔진

## 작업 컨텍스트

- 관련 경로: `services/worker/`, `services/api/`, `apps/cli/`, `packages/domain/`
- 표준선(선택): 실거래는 paper trading 안정화 뒤에 연며, UI는 paper command workflow로 반복 운영 항목과 상태 key가 정리된 뒤에만 연다.
- 현재 작업: Paper Trading Readiness 구현은 커밋 `aaf1af6` 기준 완료되어 archive로 이동되었다.
- 구현 표준선: paper trading MVP는 일봉 bar 기반이다. market order는 다음 bar open, limit order는 다음 bar high/low crossing으로 체결하며, fee/slippage는 config 기본값 0에서 시작한다.
- 선행 작업: Command-First Operator Workflow
- 후속 작업: Paper Trading Command Workflow, US Market Expansion, Live Trading Boundary, Flutter Operator Console MVP
- 확인 필요: 없음; order/fill 정밀도와 분봉/실시간 가격 확장은 후속 Milestone에서 다룬다.
