No enviar nunca el mismo recordatorio dos veces \
Los trabajos programados se reintentan. Un trabajo también puede ejecutarse dos veces por error. Sin protección, cada repetición envía otro push. Elidempotency_key de OneSignal resuelve esto. Si dos solicitudes llevan la misma clave, la segunda no se envía. La clave debe ser un UUID, y OneSignal la recuerda durante 30 días.
Una función programada no tiene dónde guardar una clave aleatoria entre ejecuciones, así que Clean Beans deriva la clave de lo que es el envío: su tipo, su destinatario y su fecha. El mismo envío produce siempre la misma clave.
supabase/functions/_shared/idempotency.ts
En un envío por lotes, la clave cubre todo el lote.
supabase/functions/send-cleaning-reminder/index.ts
Las claves de idempotencia funcionan en los endpoints Create message y Create custom events. Las solicitudes de Live Activity no las aceptan. Estas se identifican por su
activity_id.Dar a cada tipo de push su propio comportamiento \
Un recordatorio de limpieza que llega con dos horas de retraso es peor que no recibir ninguno. Los kudos son agradables de recibir, pero nunca urgentes. Clean Beans describe estas diferencias una sola vez, en un conjunto de perfiles de entrega, y aplica el adecuado a cada solicitud.supabase/functions/_shared/delivery.ts
El perfil
member_lapsed de la lista de tipos corresponde a un push enviado desde un webhook de Journey, que esta guía no trata.
Qué hace cada ajuste:
ttles el tiempo que se conserva un push para un dispositivo sin conexión. El recordatorio de limpieza dice “en 1 hora”, así que se descarta pasada una hora.thread_idyandroid_groupagrupan los push relacionados en la lista de notificaciones.ios_interruption_levelcontrola lo insistente que es un push.time_sensitivepuede atravesar los modos de concentración.passivellega en silencio.ios_relevance_scoreordena los push en el resumen de notificaciones de iOS. Clean Beans reserva1.0para los mensajes críticos y no envía ninguno.
time_sensitive si la app declara la capacidad.
app.json
Mostrar un número en el icono de la app \
Los dos push de tareas establecen la insignia del icono de la app con el número de su título.supabase/functions/send-overdue-reminders/index.ts

La insignia del icono de la app muestra cuántas tareas están vencidas.
SetTo, no Increase, porque la insignia es un recuento de tareas y no de notificaciones sin leer. El recordatorio de la tarde sustituye el número de la mañana.
El SDK de OneSignal borra la insignia automáticamente cada vez que se abre la app, así que la app no necesita código para restablecerla. Un push que llega mientras la app está abierta nunca muestra su insignia. Android no tiene una insignia numérica que se pueda establecer mediante la API.
Solicitudes idempotentes
Cómo funcionan las claves y cuánto duran.
Niveles de interrupción
Los modos de concentración y los cuatro niveles.
Insignias
Comportamiento de las insignias en cada plataforma.