
Clean Beans : le tableau de bord, une session de ménage et le planning hebdomadaire.
Ce que fait Clean Beans \
Un foyer ajoute ses pièces, et l’application les transforme en une liste de tâches de ménage avec des fréquences raisonnables. Un générateur de planning répartit ces tâches sur la semaine en fonction du temps dont dispose chaque personne. Les membres lancent des sessions de ménage, cochent des tâches, enchaînent des séries quotidiennes, s’envoient des kudos et s’affrontent dans un classement hebdomadaire. Le ménage est partagé, récurrent et soumis à des échéances, ce qui le rend adapté à presque tous les types de messages : rappels, actualités sociales, comptes à rebours, récapitulatifs et accompagnement.Pourquoi ce guide existe \
Utilisez-le pour répondre à trois questions :- Quelle fonctionnalité OneSignal convient à quelle tâche ? Chaque page part de quelque chose que l’application devait faire, puis montre la fonctionnalité qui le fait.
- Où va le code ? Une partie du travail revient à l’application, une partie à votre backend et une partie au tableau de bord OneSignal. Chaque exemple précise laquelle.
- Qu’est-ce qui peut mal tourner ? Les avertissements et notes de chaque page consignent ce qui a été appris en la mettant en production. Un paramètre,
collapse_id, a été essayé puis retiré, et Push fiable et bien maîtrisé explique pourquoi.
Comment le lire \
Le guide est un ensemble de pages, une par sujet. Vous n’avez pas besoin de les lire dans l’ordre. Configuration du SDK et identité utilisateur est la base de tout le reste. Ensuite, chaque page est autonome. La plupart des fonctionnalités sont présentées de la même manière :- Ce que voit l’utilisateur, généralement avec une capture d’écran.
- Comment ça fonctionne, sous forme d’une courte séquence indiquant qui fait quoi.
- Le code, tiré de l’application. Le titre de chaque bloc de code est le fichier dont il provient.
- Configuration du tableau de bord, lorsque la fonctionnalité doit être configurée dans OneSignal.
Le code est réel, mais les identifiants sont remplacés par des valeurs fictives comme
YOUR_ONESIGNAL_APP_ID et YOUR_PROJECT_REF. Les fichiers longs sont réduits aux lignes importantes. Une ligne contenant uniquement // ... indique où du code a été omis.Comment les éléments s’articulent \
L’External ID relie les trois. Clean Beans le définit sur l’ID utilisateur Supabase à la connexion, afin que le backend puisse s’adresser à n’importe qui à l’aide d’un ID qu’il stocke déjà.

L'application, le backend et le tableau de bord communiquent chacun avec OneSignal. L'External ID les rattache à un même utilisateur.
Carte des fonctionnalités \
Ce dont vous avez besoin \
- Une application OneSignal avec le push configuré pour iOS et Android, ainsi que l’e-mail et le SMS. Consultez Configuration des canaux.
- Une application Expo compilée avec EAS Build. Le SDK OneSignal nécessite du code natif, Expo Go ne suffit donc pas. Consultez Configuration du SDK Expo.
- Votre App ID et une App API key. Consultez Clés et ID.
- Un backend capable d’exécuter du code selon une planification et en réponse à des requêtes. Clean Beans utilise Supabase Edge Functions avec
pg_cron. Les mêmes principes s’appliquent à n’importe quel backend.
Principes qui ont fait leurs preuves \
- Définissez d’abord l’External ID. Presque toutes les fonctionnalités présentées ici en dépendent. Utilisez un ID que votre backend stocke déjà.
- Placez chaque tâche au bon endroit. L’application gère l’appareil et l’utilisateur connecté. Le backend gère les planifications et les changements de données. Le tableau de bord contient tout ce que vous voulez modifier sans nouvelle version.
- Vérifiez avant d’envoyer. Chaque envoi du backend vérifie les préférences de l’utilisateur et confirme qu’il y a quelque chose d’utile à dire.
- Rendez les envois planifiés rejouables. Une clé d’idempotence construite à partir du type, du destinataire et de la date transforme une nouvelle tentative en opération sans effet.
- Routez selon un type, pas une URL. Un champ
data.typepermet aux anciennes notifications de continuer à fonctionner lorsque les écrans changent. - Vérifiez ce que vous disent les appelants. Une fonction qui envoie des messages doit d’abord confirmer les faits dans votre propre base de données.