toki/alt
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
alt/agent-roadmap/phase/operator-surface/milestones/flutter-operator-console-mvp.md
toki 8c3c4ba5a2 feat: operator surface phase updates, worker backtest/kis live client, binary utilities 
- Add bin/kis-paper-daily-smoke and bin/kis-sops-env utilities
- Update agent-roadmap for operator surface phase
- Add worker backtest bar source and Kis live client
- Update KIS live secret configuration and documentation
- Refine worker datacheck and daily chart price providers
2026-06-03 12:10:48 +09:00

3.9 KiB
Raw Blame History

Milestone: Flutter Operator Console MVP

위치

  • Roadmap: agent-roadmap/ROADMAP.md
  • Phase: agent-roadmap/phase/operator-surface/PHASE.md

목표

승인된 Flutter Operator Console UX Plan과 Operator Headless Workflow Validation 결과를 기준으로 Flutter client에 operator dashboard MVP를 구현한다. 화면은 headless 검증으로 확인된 운영 흐름과 준비된 wireframe을 따라가며, terminal UI나 고급 charting이 아니라 반복 운영에 필요한 조회/실행 표면을 우선한다.

상태

[보류]

구현 잠금

  • 상태: 잠금
  • 결정 필요: 아래 체크리스트
    • Operator Headless Workflow Validation이 완료되어 화면 없이 대표 운영 흐름을 검증했다.
    • Operator Client API/Core Integration Validation이 완료되어 Flutter 실화면 없이 client core에서 기본 API 호출을 검증했다.
    • KIS Live Data Collection Pipeline이 완료되어 실제 KIS provider 수집과 worker import/storage/StorageBarSource 입력 조회 경계가 검증되었다.
    • 화면 wireframe 또는 동등한 화면 정의 산출물이 준비되었고 사용자가 승인했다.

범위

  • Flutter feature-first 화면 구조
  • socket connection state 표시
  • backtest run list/detail/result 조회
  • start backtest request form과 unavailable/error 응답 표시
  • market data import/status 조회
  • responsive web/mobile/desktop navigation

기능

Epic: [operator-mvp] Flutter operator console MVP

headless 검증과 wireframe 승인을 거친 운영 흐름만 실제 Flutter 화면과 provider 경계로 옮긴다.

  • [connect-state] client가 API socket 연결 상태를 표시한다. 검증: Flutter test가 연결/끊김 상태 표시를 검증한다.
  • [backtest-list] backtest run 목록을 조회하고 표시한다. 검증: generated/mapped contracts 기반 repository/provider test가 목록 응답을 화면 model로 전달한다.
  • [backtest-detail] backtest run detail과 result를 표시한다. 검증: detail/result 상태별 widget test가 통과한다.
  • [start-run] operator가 backtest 실행을 요청하고 unavailable/error 응답을 이해 가능한 상태로 본다. 검증: request form과 typed error response test가 통과한다.
  • [market-status] market data import/status를 조회할 수 있다. 검증: market status provider/widget test가 통과한다.
  • [responsive-nav] web/mobile/desktop target에서 기본 navigation이 작동한다. 검증: 주요 viewport별 navigation smoke 또는 widget test가 통과한다.
  • [repo-checks] bin/test, bin/lint, bin/build가 통과한다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 아직 기능 Task와 검증이 충족되지 않았다.
  • 리뷰 필요:
    • 사용자가 완료 결과를 확인했다
    • archive 이동을 승인했다
  • 리뷰 코멘트: 없음

범위 제외

  • UI 기획 없이 임의로 화면 깊이를 확정하는 작업
  • headless 검증 없이 dashboard layout, chart, form 흐름을 먼저 구현하는 작업
  • wireframe 승인 없이 실화면을 구현하는 작업
  • 별도 TypeScript web app
  • 고급 charting 전체
  • push notification
  • mobile app store 배포 설정

작업 컨텍스트

  • 관련 경로: apps/client/, packages/contracts/, services/api/
  • 표준선(선택): go_router는 화면 이동/URL 구조, Riverpod은 API client/socket state/feature state 주입을 담당한다. UI는 AltSocketClient provider와 generated/mapped contracts boundary를 통해 API만 바라본다.
  • 선행 작업: Flutter Operator Console UX Plan, Operator Headless Workflow Validation, Operator Client API/Core Integration Validation, KIS Live Data Collection Pipeline, wireframe 승인
  • 후속 작업: Flutter Push Notification Boundary
  • 확인 필요: headless 검증과 client API/core 연결 검증은 완료되었고, KIS live data collection pipeline과 wireframe 승인 전에는 구현 잠금을 유지한다.