# Milestone: Paper Trading Readiness

## 위치

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

## 목표

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

## 상태

[계획]

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] paper trading에서 사용할 초기 주문/체결 모델의 정밀도를 결정한다.
  - [ ] paper trading을 일봉 기반으로 시작할지, 분봉/실시간 가격까지 요구할지 결정한다.

## 범위

- 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

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

- [ ] [paper-account] paper account와 portfolio state가 있다.
- [ ] [virtual-orders] 가상 주문과 체결 모델이 있다.
- [ ] [risk-guard] 최소 risk guard skeleton이 있다.
- [ ] [strategy-run] 전략을 paper execution loop에서 실행할 수 있다.
- [ ] [paper-monitor] API/command workflow에서 paper state를 모니터링할 수 있다.

## 완료 기준

- [ ] paper trading이 실제 broker 주문 없이 독립적으로 동작한다.
- [ ] backtest engine과 공유할 개념과 분리할 개념이 문서화되어 있다.
- [ ] 실거래 adapter가 들어와도 paper flow를 뒤집지 않는 경계가 있다.
- [ ] 관련 테스트와 `bin/test`가 통과한다.

## 완료 리뷰

- 상태: 없음
- 요청일: 없음
- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
- 리뷰 필요:
  - [ ] 사용자가 완료 결과를 확인했다
  - [ ] archive 이동을 승인했다
- 리뷰 코멘트: 없음

## 범위 제외

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

## 작업 컨텍스트

- 관련 경로: `services/worker/`, `services/api/`, `apps/cli/`, `packages/domain/`
- 표준선(선택): 실거래는 paper trading 안정화 뒤에 연며, UI는 paper command workflow로 반복 운영 항목과 상태 key가 정리된 뒤에만 연다.
- 선행 작업: Command-First Operator Workflow
- 후속 작업: Paper Trading Command Workflow, US Market Expansion, Live Trading Boundary, Flutter Operator Console MVP
- 확인 필요: paper order/fill 정밀도와 데이터 시간 단위