
Clean Beans 发送的部分推送示例。
尊重时区的定时发送 \
用户可以选择接收每日提醒的时间。Clean Beans 不会为每个用户单独安排任务。它每小时运行一个任务,并判断“现在是谁的那个时间?”1
数据库计划任务每小时调用一次函数
pg_cron 向 Supabase Edge Function 发出 HTTP 请求。它所需的服务密钥从 Supabase Vault 读取,因此永远不会出现在 SQL 中。2
函数找出本地时间匹配的用户
它加载所有开启了该提醒的用户,将当前时间转换为每位用户的时区,并保留所选时间正是现在的用户。
3
检查是否有内容可说
没有到期任务的用户不会收到推送。
4
为每位用户调用一次 OneSignal
每条推送的内容都不同,因此每条都是单独的请求。
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
逾期提醒:第二次、不一样的提醒 \
逾期提醒沿用同样的模式,只有两处不同。它在用户的摘要时间之后六小时触发,并且只统计确实已过期的任务。supabase/functions/send-overdue-reminders/index.ts
supabase/functions/send-overdue-reminders/index.ts
打扫提醒:一次请求发给多人 \
打扫提醒对每个人说的都是同样的内容,因此不需要为每个人单独请求。函数收集所有符合条件的用户 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 的工作方式相同,只有一个接收者。在动态界面中,成员点击室友会话上的 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 的请求是否携带有效令牌,但已登录用户的令牌与计划程序的令牌一样有效。如果没有进一步检查,任何用户都可以为所有人触发每日摘要,或冒用他人名义发送推送。因此,每个函数都自行决定允许谁调用它。
计划函数以一行代码开头:
supabase/functions/send-daily-digest/index.ts
supabase/functions/_shared/auth.ts
supabase/functions/send-kudos/index.ts
Create message API
所有渠道的定向、内容和计划。
富媒体
各平台推送通知中的图片。