alt/agent-roadmap/phase/trading-expansion/milestones/paper-trading-command-workflow.md

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 범위