nexo/agent-roadmap/phase/messaging-runtime/milestones/full-web-push-platform-contract.md
toki 9017482f4b test(messaging): 웹 알림 smoke 후속 작업을 정리한다
Web notification 상태 테스트와 후속 Web Push 스케치를 추가하고, 남은 test-host 작업을 agent-task plan으로 분리했다.
2026-06-07 19:55:45 +09:00

2.9 KiB

Milestone: Full Web Push platform 계약

위치

  • Roadmap: agent-roadmap/ROADMAP.md
  • Phase: agent-roadmap/phase/messaging-runtime/PHASE.md

목표

브라우저가 닫힌 상태에서도 수신되는 Full Web Push를 구현하기 전에, Flutter Web 앱, service worker, Mattermost core, push-proxy가 공유할 platform 계약을 정리한다. web_rn-v2 device token, VAPID/Firebase web config, service worker ownership, server/push-proxy platform 분기 범위를 민감값 없이 문서화한다.

상태

[스케치]

승격 조건

  • service worker 소유 경계가 packages/messaging_flutter, host app, 또는 별도 web scaffold 중 어디에 있는지 정리한다.
  • VAPID/Firebase web config는 tracked 문서에 원문 값을 남기지 않고 어떤 local/host 책임으로 주입할지 정리한다.
  • web_rn-v2 token 저장과 core/push-proxy platform 분기에서 Android/iOS/macOS token 계약을 깨지 않는 범위를 정리한다.
  • 구현 가능한 기능 Task와 검증 명령을 Milestone 문서에 확정한다.

구현 잠금

  • 상태: 잠금
  • 결정 필요:
    • service worker ownership과 host app integration 책임 경계를 정해야 한다.
    • VAPID/Firebase web config를 어느 환경 책임으로 주입할지 정해야 한다.

범위

  • Full Web Push service worker 등록과 notification click/open routing 계약
  • web_rn-v2 device token format, 저장, server registration 경계
  • Mattermost core push platform 상수와 push-proxy web target 후보
  • 민감값 없는 local/remote smoke evidence 기준

기능

Epic: [contract] Web Push 계약 스케치

브라우저 foreground 알림과 Full Web Push 구현 경계를 분리하고 후속 구현 계획으로 승격할 수 있는 계약 후보를 만든다.

  • [sw-boundary] service worker 소유권, 등록 위치, click/open routing 책임을 정리한다.
  • [token-platform] web_rn-v2 token format과 core/push-proxy platform 분기 후보를 정리한다.
  • [config-evidence] VAPID/Firebase web config 주입 방식과 민감값 없는 smoke evidence 기준을 정리한다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 없음
  • 리뷰 필요:
    • 사용자가 완료 결과를 확인했다
    • archive 이동을 승인했다
  • 리뷰 코멘트: 없음

범위 제외

  • Full Web Push 구현
  • 실제 VAPID key, Firebase web config, private host 값 기록
  • Mattermost webapp UI/Redux 알림 구현 복제
  • 제품 앱 UI 또는 앱별 메시징 화면 구현

작업 컨텍스트

  • 선행 작업: Flutter Web 알림
  • 관련 경로: packages/messaging_flutter/, apps/flutter-test/, services/core/, services/push-proxy/
  • 표준선(선택): foreground browser notification은 현 Milestone의 완료 범위로 두고, 브라우저 종료 상태 수신은 이 후보 Milestone에서 별도 계약으로 승격한다.