iop/agent-roadmap/phase/control-plane-portal-ops/PHASE.md
toki 1fe368ad2c refactor: portal → client 앱 리팩토링 및 제어플랫폼 와이어 클라이언트 명명 변경
- apps/portal 디렉터리를 apps/client로 리팩터링
- ControlPlaneWireClient → WireClient 명명 변경
- 관련_proto import 정렬, struct protobuf 생성 제거
- README, docker-compose, 스크립트 등 일관성 개선
2026-05-28 20:24:45 +09:00

2.9 KiB

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 중심으로 모은다.
  • [계획] Client Integration Clone Adoption

    • 경로: agent-roadmap/phase/control-plane-portal-ops/milestones/client-integration-clone-adoption.md
    • 요약: NomadCode client 표준을 IOP client에 복제하기 위한 모듈명, bootstrap, proto-socket, Mattermost push host integration 기준을 정리한다.
  • [계획] Control Plane과 Client

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

    • 경로: agent-roadmap/phase/control-plane-portal-ops/milestones/policy-history-audit.md
    • 요약: 권한, 정책, 실행 이력, 감사 로그를 제품 운영에 필요한 수준으로 확장한다.
  • [계획] Multi-Edge 운영

    • 경로: agent-roadmap/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로 만들지 않는다.
  • Multi-Edge 운영은 Edge의 로컬 상태 소유권을 침범하지 않는 범위에서 확장한다.
  • ../nomadcode에서 정리한 client 표준을 복제할 때는 제품 feature 전체가 아니라 client skeleton, integration boundary, bootstrap convention, 문서화된 handoff 기준만 가져온다.