toki/alt
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
alt/agent-roadmap/phase/operator-surface/PHASE.md
toki c4a457c5c4 docs(agent-ops): domain rule과 로드맵을 operator reliability refactor에 맞게 갱신한다 
API domain에 workerclient proxy와 handler responsibility를 추가하고,
worker domain에 backtest engine, storage, provider, socket surface를 명시한다.
Client domain에 socket integration과 push integration 경계를 보강한다.
Operations domain에 agent-test/local과 bin 명령어를 포함하며,
operations domain table에 agent-test/local 경계를 추가한다.

로드맵에 Operator Runtime Reliability Refactor Milestone를 추가하고
현재 활성 Milestone으로 설정하여 Flutter Operator Console 전에
선행할 작업으로 변경한다.
2026-05-31 06:53:24 +09:00

3.8 KiB
Raw Blame History

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/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/phase/operator-surface/milestones/flutter-operator-console.md
    • 요약: terminal형 콘솔이 아니라 dashboard/control surface라는 제품 의미를 정하되, 실화면 구현 전 headless 검증 우선 원칙과 wireframe gate를 먼저 정의한다.
  • [계획] Operator Headless Workflow Validation
    • 경로: agent-roadmap/phase/operator-surface/milestones/operator-headless-workflow-validation.md
    • 요약: Flutter 화면 없이 terminal/YAML 기반 운영 시나리오로 market data와 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으로 분리한다.