# Milestone: Operator Headless Workflow Validation

## 위치

- Roadmap: `agent-roadmap/ROADMAP.md`
- Phase: `agent-roadmap/phase/operator-surface/PHASE.md`

## 목표

Flutter 화면 없이 ALT 운영 흐름을 terminal/YAML/log/test fixture 기반으로 먼저 검증한다. market data와 backtest 조회/실행 경로가 화면 없이도 구성, 실행, 결과 확인이 가능해진 뒤에만 operator dashboard 화면 구현 후보로 넘긴다.

## 상태

[계획]

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] `Flutter Operator Console UX Plan`의 headless-first 시나리오와 결과 확인 기준을 승인한다.

## 범위

- YAML 또는 동등한 파일 기반 operator scenario 정의
- CLI/terminal entrypoint에서 scenario 실행 또는 조회
- market data status/import 결과 확인
- backtest list/detail/result/start 요청 결과 확인
- unavailable/error/disconnected 결과의 machine-readable 또는 grep 가능한 출력
- 화면 구현 전 검증 evidence 산출 방식

## 기능

### Epic: [headless-op] Headless operator workflow validation

운영 화면을 만들기 전에 같은 API/worker 경계를 화면 없이 검증한다.

- [ ] [scenario-format] operator scenario를 YAML 또는 동등한 파일 형식으로 표현한다. 검증: 예시 scenario가 parser 또는 dry-run 검증을 통과한다.
- [ ] [terminal-run] terminal에서 scenario를 실행하거나 대표 조회를 수행할 수 있다. 검증: CLI 또는 script가 exit code와 요약 출력을 남긴다.
- [ ] [market-check] market data status/import 관련 결과를 화면 없이 확인할 수 있다. 검증: fixture 또는 local smoke가 상태 출력을 확인한다.
- [ ] [backtest-check] backtest list/detail/result/start 관련 결과를 화면 없이 확인할 수 있다. 검증: fixture 또는 local smoke가 성공/실패 결과를 확인한다.
- [ ] [error-output] unavailable/error/disconnected 상태가 화면 없이도 판별 가능한 출력으로 남는다. 검증: typed error 또는 상태 코드 출력 테스트가 통과한다.
- [ ] [handoff] Flutter 화면 MVP로 넘길 수 있는 검증 evidence와 남은 wireframe 의존성을 정리한다.

## 완료 리뷰

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

## 범위 제외

- Flutter 실화면 구현
- dashboard layout, chart, form visual design 확정
- push notification
- production 운영 자동화

## 작업 컨텍스트

- 관련 경로: `apps/cli/`, `bin/`, `services/api/`, `services/worker/`, `packages/contracts/`
- 표준선(선택): 화면 구현보다 CLI/YAML/headless smoke를 먼저 만들고, 결과는 exit code와 machine-readable 또는 grep 가능한 출력으로 남긴다.
- 선행 작업: Flutter Operator Console UX Plan
- 후속 작업: Flutter Operator Console MVP
- 확인 필요: UX Plan의 headless 시나리오 승인 전에는 구현 잠금을 유지한다.