alt/agent-ops/roadmap/milestones/flutter-operator-console.md

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
• 확인 필요: 없음