nexo/agent-ops/roadmap/phase/messaging-runtime/PHASE.md

Phase: 메시징 런타임 표준화

상태

[계획]

목표

알림만 떼어낸 기능이 아니라, 여러 앱이 사용할 수 있는 메시징/알림 런타임 계약을 정리한다. 서버 core와 Flutter 플러그인의 역할을 명확히 나누고, 앱별 채널 분기와 호환 API를 제품 기능으로 다룰 수 있게 만든다.

Milestone 흐름

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

• [계획] 메시징 계약 표준화
  • 경로: agent-ops/roadmap/phase/messaging-runtime/milestones/messaging-contract.md
  • 요약: 서버와 Flutter 플러그인이 공유할 메시징/알림 API, 이벤트, 저장 계약을 정리한다.
• [계획] 알림 파이프라인 고도화
  • 경로: agent-ops/roadmap/phase/messaging-runtime/milestones/notification-pipeline.md
  • 요약: FCM, ACK, inline reply, dismiss, open routing을 안정된 플러그인 책임으로 만든다.
• [스케치] 멀티앱 채널 모델
  • 경로: agent-ops/roadmap/phase/messaging-runtime/milestones/multi-app-channel.md
  • 요약: 추가 앱이 생길 때 사용 채널만 늘려 분기할 수 있는 서비스 모델을 검토한다.

Phase 경계

• 계약이 중복되기 전까지 별도 contract 패키지를 만들지 않고, server API와 plugin public API 문서로 관리한다.
• packages/messaging_flutter는 앱별 알림 구현을 대체하는 공통 플러그인 책임을 가진다.
• services/core는 메시징 서버와 push-proxy 연동 책임을 가지며, client UI 책임을 갖지 않는다.