iop/agent-roadmap/archive/phase/control-plane-portal-ops/PHASE.md

Phase: Control Plane과 Client 운영

상태

[완료]

목표

여러 Edge를 연결하고 관찰하며 Edge 설정 변경, 명령 전달, 이벤트 수신을 담당하는 중앙 제어면과 Flutter client 운영면을 구축한다.

Milestone 흐름

완료 또는 폐기된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획 또는 보류 Milestone은 이 Phase 하위 milestones/ 경로를 가리킨다. 완료, 검토중, 진행중, 계획 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.

• [완료] Flutter-first Client 마이그레이션

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/flutter-first-portal-migration.md
  • 요약: Next.js apps/web scaffold를 제거하고 apps/client Flutter 앱, Flutter Web compose 배포 흐름, Client-Control Plane proto-socket WS hello 기반을 세웠다.

• [완료] Edge-local Dev Config와 바이너리 중심 실행 루프

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/edge-local-dev-config-runtime.md
  • 요약: Control Plane이 없는 동안 edge.yaml을 테스트용 source of truth로 삼고, config 템플릿 생성, effective environment 출력, Node register/bootstrap 출력, setup, smoke test를 iop-edge command 중심으로 모은다.

• [완료] Nexo 알림/메시지 Smoke 정합성

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/nexo-notification-message-smoke-alignment.md
  • 요약: ../nomadcode의 server-generated signed push smoke evidence와 IOP apps/client의 Nexo messaging 소비 설정 차이를 선행 게이트로 정리하고 archive했다.

• [폐기] Client Integration Clone Adoption

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/client-integration-clone-adoption.md
  • 요약: NomadCode Flutter client clone adoption은 별도 프로젝트에서 진행하기로 하여 IOP active roadmap에서 제외했다.

• [완료] Edge Command와 Control Plane 운영 경계

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/edge-command-control-plane-ops-boundary.md
  • 요약: iop-edge local/field fallback과 Control Plane 기본 운영면의 책임 경계, shared Edge operation 분류 기준, 사용자 가이드 갱신 범위를 확정한다.

• [완료] Control Plane-Edge Wire Baseline

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/control-plane-edge-wire-baseline.md
  • 요약: Control Plane과 Edge가 proto-socket 기반 IOP Wire Protocol로 연결되는 최소 통신 레일, status snapshot, node lifecycle event relay, service boundary를 완료하고 archive했다.

• [완료] Embeddable IOP Console Workbench

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/embeddable-iop-console-workbench.md
  • 요약: packages/flutter/iop_console 패키지, left rail shell, agent panel, standalone app mount, controller/config injection, execution/logs 영역, 독립 package test/analyze 검증을 완료하고 archive했다.

• [완료] Control Plane과 Client

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/control-plane-client.md
  • 요약: 여러 Edge를 연결하고 관찰하며 Edge 설정 변경, 명령 전달, 이벤트 수신을 담당하는 중앙 제어면과 Flutter client 운영면을 구축한다.

• [완료] 정책, 이력, 감사

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/policy-history-audit.md
  • 요약: 권한, 정책, 실행 이력, 감사 로그를 제품 운영에 필요한 수준으로 확장하고, 공통 audit schema evidence까지 확정했다.

• [완료] Multi-Edge 운영

  • 경로: agent-roadmap/archive/phase/control-plane-portal-ops/milestones/multi-edge-operations.md
  • 요약: 여러 Edge group을 관찰하고 운영하는 fleet-level 기능을 구축한다.

Phase 경계

• Control Plane은 Node를 직접 스케줄링하지 않고 Edge를 통해 관찰/제어한다.
• Flutter client는 IOP 자체 운영 UI/UX이며 NomadCode 전용 shell로 만들지 않는다.
• IOP 관리 UI는 standalone application shell과 embeddable package 경계를 분리해 NomadCode 같은 host가 선택적으로 포함할 수 있게 한다.
• Multi-Edge 운영은 Edge의 로컬 상태 소유권을 침범하지 않는 범위에서 확장한다.
• NomadCode Flutter client 복제/표준화 작업은 별도 프로젝트 범위로 분리하고, IOP Phase에서는 필요한 경우 확정 산출물만 후속 Milestone으로 반영한다.