alt/agent-roadmap/phase/operator-surface/milestones/operator-headless-workflow-validation.md

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 시나리오 승인 전에는 구현 잠금을 유지한다.