# Flutter Operator Console

## 목표

Flutter client를 ALT의 공식 UI client로 삼아 market data 상태, backtest run, result를 조회하고 실행 요청할 수 있는 operator console을 만든다. 별도 TypeScript web app은 기본 경로로 두지 않는다.

## 단계

운영 표면

## 상태

계획

## 구현 잠금

- 상태: 해제
- 결정 필요: 없음

## 범위

- Flutter feature-first 화면 구조
- socket connection state
- backtest run list/detail
- start backtest request form
- market data import/status view
- responsive web/mobile/desktop navigation

## 필수 기능

- [ ] [connect-state] client가 API socket 연결 상태를 표시한다.
- [ ] [backtest-list] backtest run 목록을 조회하고 표시한다.
- [ ] [backtest-detail] backtest run detail과 result를 표시한다.
- [ ] [start-run] operator가 backtest 실행을 요청할 수 있다.
- [ ] [market-status] market data import/status를 조회할 수 있다.
- [ ] [responsive-nav] web/mobile/desktop target에서 기본 navigation이 작동한다.

## 완료 기준

- [ ] Flutter test가 주요 화면 shell과 상태 표시를 검증한다.
- [ ] client는 generated/mapped contracts를 통해 API와 통신한다.
- [ ] presentation widget에 production endpoint 가정이 hard-code되지 않는다.
- [ ] `bin/test`, `bin/lint`, `bin/build`가 통과한다.

## 범위 제외

- 별도 TypeScript web app
- 고급 charting 전체
- push notification
- mobile app store 배포 설정

## 작업 컨텍스트

- 관련 경로: `apps/client/`, `packages/contracts/`, `services/api/`
- 표준선(선택): Flutter는 feature-first Clean Architecture와 Riverpod을 기본 설계 프레임으로 삼는다.
- 선행 작업: Socket Session Loop, Backtest Analysis Surface
- 후속 작업: Paper Trading Readiness
- 확인 필요: 없음