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

Phase: 메시징 런타임 표준화

상태

[계획]

목표

알림만 떼어낸 기능이 아니라, 여러 앱이 사용할 수 있는 메시징/알림 런타임 계약을 정리한다. Mattermost server/webapp/push-proxy는 upstream-followable runtime으로 두고, Flutter 플러그인은 nexo-owned embedded SDK로 역할을 명확히 나눈다. 앱별 채널 분기와 호환 API를 제품 기능으로 다룰 수 있게 만든다.

Milestone 흐름

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

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

Phase 경계

• 계약이 중복되기 전까지 별도 contract 패키지를 만들지 않고, server API와 plugin public API 문서로 관리한다.
• packages/messaging_flutter는 앱별 알림 구현을 대체하는 nexo-owned embedded SDK 책임을 가진다.
• packages/messaging_flutter/android는 Mattermost mobile code를 계속 merge하는 대상이 아니라, server/push 계약과 Android/FCM platform 변화를 추적한다.
• services/core는 upstream-followable server/webapp/push-proxy runtime 책임을 가진다.
• services/core/webapp은 기본 메시지 앱/reference front로 유지할 수 있지만, Flutter SDK 소비 앱 책임과 섞지 않는다.