# Phase: 운영 표면

## 상태

[진행중]

## 목표

Flutter client를 ALT의 공식 operator surface로 삼아 market data 상태와 backtest 실행 및 결과를 조회할 수 있게 한다. 먼저 API 서버 중심의 proto-socket 내부 통신 rail을 정리하고, 화면 없이 CLI/YAML/log/test fixture로 운영 흐름을 검증한 뒤 wireframe이 준비된 경우에만 Flutter 실화면 구현으로 넘어간다. 이 Phase에서는 web/mobile/desktop 단일 UI 표면을 유지하면서 API와 generated contract 기준을 맞추고, push notification은 별도 후속 Milestone으로 분리한다.

## 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/phase/operator-surface/milestones/kis-live-data-collection-pipeline.md`
  - 요약: Flutter 실화면 전에 KIS 실 API 기반 한국장 일봉 수집, worker import/storage, backtest 입력 경계까지 검증한다.
- [보류] Flutter Operator Console MVP
  - 경로: `agent-roadmap/phase/operator-surface/milestones/flutter-operator-console-mvp.md`
  - 요약: headless 운영 검증과 화면 wireframe 승인 뒤에만 Flutter에서 market data, backtest run, result를 조회하고 실행 요청할 수 있는 MVP 화면을 구현한다.
- [스케치] Flutter Push Notification Boundary
  - 경로: `agent-roadmap/phase/operator-surface/milestones/flutter-push-notification-boundary.md`
  - 요약: push notification을 operator console 본작업에서 분리하고, Firebase/platform channel 등 외부 protocol 경계를 후속 작업으로 정리한다.

## Phase 경계

- 이 Phase는 Flutter client의 운영 화면과 API/client 통신 표면에 집중한다.
- 별도 TypeScript web app, 고급 charting 전체, mobile app store 배포 설정은 제외한다.
- API 서버를 operator-facing control plane으로 두고, client와 worker는 API를 기준으로 proto-socket rail에 연결한다.
- UI는 generated/mapped contracts와 proto-socket client layer를 기준으로 API와 통신한다.
- 운영 기능은 화면 구현 전에 CLI, terminal output, YAML scenario, log, test fixture 같은 headless 경로로 구성과 결과를 먼저 검증한다.
- Flutter 실화면 구현은 headless 검증 완료와 wireframe 준비/승인을 구현 잠금 해제 조건으로 둔다.
- client skeleton과 bootstrap convention은 외부 client integration 프로젝트 산출물을 추후 반영하되, Riverpod/go_router와 API client boundary는 이 Phase의 Flutter 표면 안에서 명시한다.
- push notification은 현재 operator console 범위에서 제외하고 `Flutter Push Notification Boundary` Milestone으로 분리한다.