Ne jamais envoyer deux fois le même rappel \
Les tâches planifiées sont relancées. Une tâche peut aussi être exécutée deux fois par erreur. Sans protection, chaque répétition envoie un push de plus. L’idempotency_key de OneSignal résout ce problème. Si deux requêtes portent la même clé, la seconde n’est pas envoyée. La clé doit être un UUID, et OneSignal la conserve pendant 30 jours.
Une fonction planifiée n’a nulle part où conserver une clé aléatoire entre deux exécutions. Clean Beans dérive donc la clé de ce qu’est l’envoi : son type, son destinataire et sa date. Le même envoi produit toujours la même clé.
supabase/functions/_shared/idempotency.ts
Pour un envoi par lots, la clé couvre l’ensemble du lot.
supabase/functions/send-cleaning-reminder/index.ts
Les clés d’idempotence fonctionnent sur les endpoints Create message et Create custom events. Les requêtes Live Activity ne les acceptent pas. Celles-ci sont identifiées par leur
activity_id.Donner à chaque type de push son propre comportement \
Un rappel de ménage qui arrive avec deux heures de retard est pire que pas de rappel du tout. Les kudos sont agréables à recevoir mais jamais urgents. Clean Beans décrit ces différences une seule fois, dans un ensemble de profils de livraison, et applique le bon profil à chaque requête.supabase/functions/_shared/delivery.ts
Le profil
member_lapsed de la liste des types correspond à un push envoyé depuis un webhook de Journey, que ce guide ne couvre pas.
Ce que fait chaque paramètre :
ttlest la durée pendant laquelle un push est conservé pour un appareil hors ligne. Le rappel de ménage annonce « dans 1 heure », il est donc abandonné au bout d’une heure.thread_idetandroid_groupregroupent les push liés dans la liste des notifications.ios_interruption_levelcontrôle l’insistance d’un push.time_sensitivepeut passer outre les modes Concentration.passivearrive sans bruit.ios_relevance_scoreclasse les push dans le résumé des notifications iOS. Clean Beans réserve1.0aux messages critiques et n’en envoie aucun.
time_sensitive que si l’application déclare cette capacité.
app.json
Afficher un nombre sur l’icône de l’application \
Les deux push de tâches définissent le badge de l’icône de l’application sur le nombre indiqué dans leur titre.supabase/functions/send-overdue-reminders/index.ts

Le badge de l'icône de l'application indique le nombre de tâches en retard.
SetTo est utilisé, et non Increase, car le badge compte des tâches et non des notifications non lues. Le rappel de l’après-midi remplace le nombre du matin.
Le SDK OneSignal efface automatiquement le badge à chaque ouverture de l’application, l’application n’a donc besoin d’aucun code pour le réinitialiser. Un push qui arrive pendant que l’application est ouverte n’affiche jamais son badge. Android n’a pas de badge numérique que l’API puisse définir.
Requêtes idempotentes
Fonctionnement des clés et durée de conservation.
Niveaux d'interruption
Les modes Concentration et les quatre niveaux.
Badges
Comportement des badges sur chaque plateforme.