
Clean Beans: el panel, una sesión de limpieza y el turno semanal.
Qué hace Clean Beans \
Un hogar añade sus habitaciones y la app las convierte en una lista de tareas de limpieza con frecuencias razonables. Un generador de turnos reparte esas tareas a lo largo de la semana para ajustarse al tiempo disponible de cada persona. Los miembros realizan sesiones de limpieza, marcan tareas, acumulan rachas diarias, se envían kudos y compiten en una clasificación semanal. La limpieza es compartida, recurrente y con plazos, lo que la hace ideal para casi cualquier tipo de mensaje: recordatorios, novedades sociales, cuentas atrás, resúmenes y orientación.Por qué existe esta guía \
Úsala para responder tres preguntas:- ¿Qué función de OneSignal encaja con cada tarea? Cada página parte de algo que la app necesitaba hacer y luego muestra la función que lo hace.
- ¿Dónde va el código? Parte del trabajo corresponde a la app, parte a tu backend y parte al panel de OneSignal. Cada ejemplo indica cuál.
- ¿Qué sale mal? Las advertencias y notas de cada página recogen lo que se aprendió al publicarlo. Un ajuste,
collapse_id, se probó y luego se eliminó, y Push fiable y bien comportado explica por qué.
Cómo leerla \
La guía es un conjunto de páginas, una por tema. No necesitas leerlas en orden. Configuración del SDK e identidad del usuario es la base de todo lo demás. Después, cada página es independiente. La mayoría de las funciones se presentan de la misma manera:- Lo que ve el usuario, normalmente con una captura de pantalla.
- Cómo funciona, como una breve secuencia de quién hace qué.
- El código, tomado de la app. El título de cada bloque de código es el archivo del que procede.
- Configuración del panel, cuando la función necesita configurarse en OneSignal.
El código es real, pero los identificadores se sustituyen por marcadores de posición como
YOUR_ONESIGNAL_APP_ID y YOUR_PROJECT_REF. Los archivos largos se recortan a las líneas importantes. Una línea que solo contiene // ... marca dónde se omitió código.Cómo encajan las piezas \
El External ID conecta los tres. Clean Beans lo establece con el ID de usuario de Supabase al iniciar sesión, de modo que el backend puede dirigirse a cualquier persona con un ID que ya almacena.

La app, el backend y el panel se comunican con OneSignal. El External ID los vincula a un mismo usuario.
Mapa de funciones \
Qué necesitas \
- Una app de OneSignal con push configurado para iOS y Android, y con email y SMS configurados. Consulta Configuración de canales.
- Una app de Expo compilada con EAS Build. El SDK de OneSignal necesita código nativo, así que Expo Go no es suficiente. Consulta Configuración del SDK de Expo.
- Tu App ID y una App API key. Consulta Claves e IDs.
- Un backend que pueda ejecutar código de forma programada y en respuesta a solicitudes. Clean Beans usa Supabase Edge Functions con
pg_cron. Los mismos patrones se aplican a cualquier backend.
Principios que funcionaron \
- Establece primero el External ID. Casi todas las funciones de esta guía dependen de él. Usa un ID que tu backend ya almacene.
- Pon cada tarea donde corresponde. La app gestiona el dispositivo y el usuario que ha iniciado sesión. El backend gestiona las programaciones y los cambios de datos. El panel contiene todo lo que quieras cambiar sin una nueva versión.
- Comprueba antes de enviar. Cada envío del backend comprueba las preferencias del usuario y confirma que hay algo que merezca la pena decir.
- Haz que los envíos programados sean repetibles. Una clave de idempotencia construida a partir del tipo, el destinatario y la fecha convierte un reintento en una operación sin efecto.
- Enruta por tipo, no por URL. Un campo
data.typemantiene funcionando las notificaciones antiguas cuando cambian las pantallas. - Verifica lo que te dicen quienes llaman. Una función que envía mensajes debe confirmar primero los datos en tu propia base de datos.