プッシュ通知

プッシュ通知は Web Push Protocol と VAPID (Voluntary Application Server Identification) を使用して、ブラウザにネイティブ通知を送信します。

アーキテクチャ

サブスクリプション登録

VAPID 公開鍵の取得

Bell RPC: getVapidKey()
→ { publicKey: string }

ブラウザでのサブスクリプション

// Service Worker 登録
const registration = await navigator.serviceWorker.ready;

// Push サブスクリプション作成
const subscription = await registration.pushManager.subscribe({
  userVisibleOnly: true,
  applicationServerKey: urlBase64ToUint8Array(publicKey)
});

// サーバーに登録
const { endpoint, keys } = subscription.toJSON();
await registerPushDevice({
  shopId,
  endpoint,
  p256dh: keys.p256dh,
  auth: keys.auth,
  deviceName: navigator.userAgent,
  registeredBy: userId,
  registeredByName: userName
});

サブスクリプションデータ

フィールド	説明
`endpoint`	Push Service のエンドポイント URL
`p256dh`	クライアント公開鍵（P-256 DH）
`auth`	認証シークレット
`deviceName`	デバイス名（UserAgent）
`registeredBy`	登録者のユーザー ID

通知送信

送信フロー

HTTP レスポンスの処理

ステータス	処理
201	送信成功
410 Gone	サブスクリプション削除（ブラウザで解除済み）
429	リトライ対象（レート制限）
5xx	リトライ対象（サーバーエラー）

スケジュール送信

PUSH メッセージは予約送信が可能です。

Bell RPC: sendPushMessage({
  targetUserId, targetType, title, body,
  url?, priority?, scheduledAt, createdBy
})

スケジューリングロジック

条件	動作
`scheduledAt` が8時間以内	即座にキューへ投入（delaySeconds 付き）
`scheduledAt` が8時間以降	DB に保存、Cron でキューイング

Cron トリガー（毎時0分）が scheduledAt <= NOW + 8h の未送信メッセージを検出してキューに投入します。

デバイス管理

店舗 PUSH デバイス

店舗ごとに複数の PUSH デバイスを登録できます。

Bell RPC: registerShopPushDevice({ shopId, endpoint, p256dh, auth, ... })
Bell RPC: removeShopPushDevice({ id })
Bell RPC: updateShopPushCategories({ id, categories })

汎用 PUSH サブスクリプション

ユーザー単位の PUSH サブスクリプション管理です。

Bell RPC: subscribe({ userId, userType, endpoint, p256dh, auth, ... })
Bell RPC: unsubscribe({ endpoint })
Bell RPC: listSubscriptions({ userId })
Bell RPC: updateSubscriptionSettings({ id, settings })
Bell RPC: deleteSubscription({ id })

テスト通知

各デバイスにテスト通知を送信できます。

Bell RPC: sendShopTestNotification({
  shopId,
  channel: 'push',
  targetId: subscriptionId
})