
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
기한 초과 알림: 두 번째, 다른 방식의 알림 \
기한 초과 알림은 같은 패턴을 두 가지만 바꿔 재사용합니다. 사용자의 요약 시간 6시간 후에 실행되며, 기한이 확실히 지난 작업만 셉니다.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
모든 채널의 타겟팅, 콘텐츠, 예약.
리치 미디어
플랫폼별 푸시 알림 이미지.