alt/agent-roadmap/archive/phase/operator-surface/PHASE.md

# Phase: 운영 표면

## 상태

[완료]

## 목표

Flutter 실화면 전에 API 서버 중심 proto-socket rail과 CLI/YAML/log/test fixture 기반 command-first operator workflow를 안정화한다. KIS live data, worker storage, market status, backtest 실행/결과 확인을 화면 없이 반복 가능하게 만들고, 운영 항목과 상태 key가 충분히 표면화되면 후순위 `운영 UI` Phase로 넘긴다.

## Milestone 흐름

완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다.
완료, 검토중, 진행중, 계획 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.

- [완료] API-Centered Proto-Socket Rail
  - 경로: `agent-roadmap/archive/phase/operator-surface/milestones/api-centered-proto-socket-rail.md`
  - 요약: API 서버를 control plane으로 두고 client-api, api-worker 내부 통신을 proto-socket과 ALT protobuf contracts로 통일한다.
- [완료] Operator Runtime Reliability Refactor
  - 경로: `agent-roadmap/archive/phase/operator-surface/milestones/operator-runtime-refactor.md`
  - 요약: Flutter operator console/headless validation 전에 API-worker lifecycle, worker execution wiring, capability reporting, client bootstrap, 원격 테스트 룰을 정리한다.
- [완료] Flutter Operator Console UX Plan
  - 경로: `agent-roadmap/archive/phase/operator-surface/milestones/flutter-operator-console.md`
  - 요약: terminal형 콘솔이 아니라 dashboard/control surface라는 제품 의미, headless 검증 우선 원칙, 상태 정책, wireframe gate, validation handoff를 정리했다.
- [완료] Operator Headless Workflow Validation
  - 경로: `agent-roadmap/archive/phase/operator-surface/milestones/operator-headless-workflow-validation.md`
  - 요약: Flutter 화면 없이 terminal/YAML 기반 운영 시나리오로 market data와 backtest 조회/실행 결과를 먼저 검증한다.
- [완료] Operator Client API/Core Integration Validation
  - 경로: `agent-roadmap/archive/phase/operator-surface/milestones/operator-client-api-core-integration.md`
  - 요약: Flutter 실화면 전에 client core/provider/repository 경계에서 API socket 연결과 기본 market/backtest 호출을 검증했다.
- [완료] KIS Live Data Collection Pipeline
  - 경로: `agent-roadmap/archive/phase/operator-surface/milestones/kis-live-data-collection-pipeline.md`
  - 요약: Flutter 실화면 전에 KIS 실 API 기반 한국장 일봉 수집, worker import/storage, `StorageBarSource` 입력 조회 경계까지 검증한다.
- [완료] Command-First Operator Workflow
  - 경로: `agent-roadmap/archive/phase/operator-surface/milestones/command-first-operator-workflow.md`
  - 요약: Flutter 실화면을 보류하고 KIS live data, worker storage, market status, backtest 실행/결과 확인을 CLI/YAML/log 중심의 반복 가능한 operator workflow로 묶는다.

## Phase 경계

- 이 Phase는 Flutter 화면이 아니라 API/client 통신 rail, CLI/YAML/log 기반 운영 command surface, UI handoff evidence에 집중한다.
- 별도 TypeScript web app, 고급 charting 전체, mobile app store 배포 설정은 제외한다.
- API 서버를 operator-facing control plane으로 두고, client와 worker는 API를 기준으로 proto-socket rail에 연결한다.
- 운영 기능은 화면 구현 전에 CLI, terminal output, YAML scenario, log, test fixture 같은 headless 경로로 구성과 결과를 먼저 검증한다.
- Flutter 실화면 구현은 후순위 `운영 UI` Phase에서만 다룬다.
- client skeleton과 bootstrap convention, Riverpod/go_router, push notification은 `운영 UI` Phase에서 다룬다.