
Clean Beansが送信するプッシュの例。
タイムゾーンを考慮したスケジュール送信 \
ユーザーは毎日のリマインダーを受け取る時刻を選びます。Clean Beansはユーザーごとにジョブをスケジュールしません。1時間ごとに1つのジョブを実行し、「今がその時刻に当たるのは誰か」を判定します。1
データベースのスケジュールが1時間ごとに関数を呼び出す
pg_cronがSupabase Edge FunctionにHTTPリクエストを送ります。必要なサービスキーはSupabase Vaultから読み取るため、SQLに現れることはありません。2
関数がローカル時刻の一致するユーザーを見つける
そのリマインダーをオンにしている全員を読み込み、現在時刻を各ユーザーのタイムゾーンに変換し、選択した時刻が今であるユーザーを残します。
3
伝える内容があるか確認する
期限のタスクがないユーザーにはプッシュを送りません。
4
ユーザーごとにOneSignalを1回呼び出す
各プッシュの内容は異なるため、それぞれ個別のリクエストになります。
supabase/migrations/006_cron_daily_digest.sql
supabase/functions/send-daily-digest/index.ts
supabase/functions/send-daily-digest/index.ts
...DELIVERY.daily_digest、idempotency_key、バッジのフィールドについては信頼性が高く適切に動作するプッシュで説明しています。data.typeフィールドにより、アプリはプッシュがタップされたときにどの画面を開くかを判断します。ディープリンクと通知のクリックを参照してください。
タイトルと本文はタスクから組み立てるため、プッシュの内容が具体的になります。
supabase/functions/send-daily-digest/index.ts
期限切れリマインダー:2回目の、異なる後押し \
期限切れリマインダーは同じパターンを2点だけ変えて再利用します。ユーザーのダイジェスト時刻の6時間後に送信され、期限を厳密に過ぎたタスクだけを数えます。supabase/functions/send-overdue-reminders/index.ts
supabase/functions/send-overdue-reminders/index.ts
掃除リマインダー:多数のユーザーに1回のリクエスト \
掃除リマインダーは全員に同じ内容を伝えるため、1人ずつリクエストする必要はありません。関数は対象となるすべてのユーザーIDを集め、バッチで送信します。supabase/functions/send-cleaning-reminder/index.ts
セッション完了:アプリからトリガーされるプッシュ \
誰かが掃除セッションを終えると、世帯のほかのメンバーに通知されます。アプリはAPIキーを持ってはいけないため、このプッシュを自分で送信できません。代わりにバックエンド関数を呼び出し、その関数がプッシュを送信します。src/lib/database.ts
supabase/functions/session-completed/index.ts
supabase/functions/session-completed/index.ts

送信者のアバターを表示するために展開したセッション完了のプッシュ。
Kudos:ある人から別の人へ \
Kudosも同じ仕組みで、受信者が1人だけです。アクティビティ画面でメンバーが同居人のセッションのSend Kudosをタップしてメッセージを選ぶと、アプリがsend-kudos関数を呼び出します。

同居人の掃除セッションに送るkudosのメッセージを選ぶ。
supabase/functions/send-kudos/index.ts
参加承認:データベースからトリガーされるプッシュ \
世帯への参加をリクエストした人は、管理者の承認を待ちます。承認されると、そのメンバーシップ行がpendingからactiveに変わります。この変更に対するデータベーストリガーが関数を呼び出し、関数が参加できたことを本人に伝えます。
トリガーをデータベースに置くことで、どのような方法で承認されてもプッシュが送信され、アプリ側にはコードが必要ありません。
supabase/migrations/027_join_approved_trigger.sql
supabase/functions/join-approved/index.ts
呼び出し元を確認する \
Supabaseはedge functionへのリクエストに有効なトークンが含まれていることを検証しますが、サインイン中のユーザーのトークンもスケジューラーのトークンと同じく有効です。追加の確認がなければ、どのユーザーでも全員分のデイリーダイジェストをトリガーしたり、他人の名前でプッシュを送信したりできてしまいます。そのため、各関数は誰に呼び出しを許可するかを自ら判断します。
スケジュールされた関数は、次の1行から始まります。
supabase/functions/send-daily-digest/index.ts
supabase/functions/_shared/auth.ts
supabase/functions/send-kudos/index.ts
Create message API
すべてのチャネルのターゲティング、コンテンツ、スケジュール。
リッチメディア
各プラットフォームでのプッシュ通知の画像。