# Milestone: Paper Trading Command Workflow

## 위치

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

## 목표

`Paper Trading Readiness`에서 정의한 paper account, virtual order/fill, position, risk guard를 Flutter 화면 없이 CLI/YAML/log 중심의 반복 가능한 command workflow로 검증한다. paper trading 기능이 충분히 표면화되고 운영자가 어떤 상태와 액션을 반복해서 보는지 정리된 뒤에만 UI 후보로 넘긴다.

## 상태

[계획]

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] `Paper Trading Readiness`가 완료되어 paper account/order/fill/position/risk 경계가 준비되었다.
  - [ ] command workflow에서 검증할 첫 paper trading scenario 범위를 정한다.

## 범위

- paper account/portfolio 상태 조회 command
- virtual order submit/cancel/fill simulation command 또는 YAML scenario
- position/risk guard 상태 조회 command
- paper execution loop smoke
- paper trading command output의 machine-readable status/evidence key 정리
- UI MVP로 넘길 paper trading 화면 후보와 보류 항목 분리

## 기능

### Epic: [paper-cmd] Paper trading command workflow

paper trading을 화면 없이 반복 검증하고, 나중에 UI로 올릴 운영 항목을 command evidence로 먼저 정리한다.

- [ ] [paper-status-command] paper account, portfolio, position 상태를 command로 조회할 수 있다. 검증: status command 또는 scenario가 account/position/risk key를 출력한다.
- [ ] [paper-order-command] virtual order submit/cancel/fill simulation을 command로 실행할 수 있다. 검증: order lifecycle scenario가 order id, status transition, fill summary를 출력한다.
- [ ] [paper-risk-command] 최소 risk guard 결과를 command workflow에서 확인할 수 있다. 검증: 허용/차단 case가 typed status/error key로 구분된다.
- [ ] [paper-loop-smoke] paper execution loop를 fixture 또는 fake market data로 smoke 실행할 수 있다. 검증: loop command가 run id, terminal status, position/equity summary를 출력한다.
- [ ] [paper-ui-handoff] paper trading에서 화면에 올릴 후보와 아직 command로만 둘 항목을 분리한다. 검증: handoff 문서가 command, expected output key, 반복 운영 여부, UI defer 사유를 기록한다.

## 완료 리뷰

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

## 범위 제외

- Flutter 실화면 구현
- 실거래 주문 제출
- broker 계좌 잔고 실시간 동기화
- 고급 리스크 엔진
- production 자동 execution

## 작업 컨텍스트

- 관련 경로: `apps/cli/`, `apps/cli/testdata/operator/`, `services/worker/`, `services/api/`, `packages/domain/`
- 표준선(선택): paper trading은 실거래 전 검증 경계이며, 먼저 command workflow로 반복 운영성과 상태 key를 확인한다.
- 표준선(선택): UI는 command workflow에서 반복되는 status/action/evidence key가 정리된 뒤에만 후보로 올린다.
- 선행 작업: Paper Trading Readiness
- 후속 작업: US Market Expansion, Live Trading Boundary, Flutter Operator Console MVP
- 확인 필요: Paper Trading Readiness 완료 후 첫 command scenario 범위