Define disparadores, destinatarios, contenido, preferencias, temporización, accesibilidad y controles de usuario para notificaciones push. Esta referencia fija el límite de adopción, el comportamiento ante fallos y la evidencia observable, dejando configurables los límites específicos del entorno.
Estado del paquete: contexto de referencia listo para revisión humana. El contrato y los escenarios de prueba están completos, pero no se afirma que una implementación adoptante los haya superado.
Decisión
Para las notificaciones push, adoptar una intención de notificación duradera identificada independientemente de los intentos del proveedor. Definir un recorrido de usuario determinista con estado visible, elecciones reversibles cuando sea posible, entrada preservada y recuperación accesible. Este paquete es un contrato de referencia: el equipo adoptante debe elegir límites numéricos, proveedores, jurisdicciones y responsables operativos basándose en la evidencia de su propio entorno.
Alcance
- Los actores, entradas, salidas, estados, versiones de políticas o esquemas y resultados visibles externamente descritos por este bloque UX de notificaciones push.
- Interfaces primarias y alternativas, trabajo en segundo plano, cachés, integraciones, rutas de soporte y evidencia que puedan ejercer el mismo límite.
- Configuración específica de adopción, despliegue, recuperación y responsabilidades de verificación necesarias para aplicar la referencia de forma segura.
Fuera de este bloque
- Elegir un proveedor universal, marco, jurisdicción, umbral numérico, periodo de retención u objetivo de nivel de servicio para todos los adoptantes.
- Afirmar que los escenarios empaquetados se han ejecutado contra una implementación descendente o que esta referencia otorga certificación legal, de seguridad o accesibilidad.
Contrato
- Crear una intención de notificación con destinatario, propósito, versión de plantilla, localización, programación, sensibilidad e identidad de deduplicación.
- Aplicar el estado verificado del destinatario, preferencias de canal, horas de silencio y supresiones legales o de producto inmediatamente antes del envío.
- Rastrear estados distintos: en cola, intentado, aceptado, entregado cuando sea observable, fallido, suprimido y cancelado.
- Limitar reintentos por proveedor y preservar la misma identidad de intención para que un canal de respaldo no pueda crear acciones duplicadas del usuario.
- Mostrar progreso solo mientras el trabajo esté realmente pendiente y evitar activaciones duplicadas sin ocultar la intención comprometida del usuario.
- Usar mensajes simples y específicos de acción que distingan validación, permiso, conectividad, conflicto y fallo terminal.
- Tratar los tokens de dispositivo como datos de enrutamiento rotativos con alcance a app, entorno, estado del usuario y proveedor; eliminar tokens inválidos de forma determinista.
- Las cargas útiles de notificación no revelan contenido sensible en un dispositivo bloqueado a menos que una política explícita del producto y elección del usuario lo permitan.
Guía de implementación
- Prototipar los recorridos más largos, vacíos, lentos, sin conexión, denegados y con tecnología asistiva antes de fijar el diseño del camino feliz.
- Modelar entradas, salidas, actores, estados, invariantes, efectos secundarios y evidencia de notificaciones push antes de seleccionar detalles de marco o proveedor.
- Almacenar la versión aplicable del contrato o política de notificaciones push con el estado material para que migraciones, reproducción y decisiones de soporte sean atribuibles.
- Introducir el recorrido detrás de un despliegue controlado, comparar resultados esperados y observados, y mantener una ruta de recuperación probada hasta completar la evidencia de adopción.
Manejo de fallos y salvaguardas
- Fallos permanentes de dirección o política suprimen intentos adicionales; fallos transitorios usan reintentos limitados y luego un estado terminal visible para el operador.
- El estado inválido o contradictorio de notificaciones push es rechazado o puesto en cuarentena; la implementación nunca adivina un valor que amplíe autoridad o duplique un efecto.
- Los reintentos son limitados y usan identidad duradera; tras agotarse, el trabajo alcanza un estado terminal inspeccionable con un responsable accountable.
Verificación y operaciones
- Completar el recorrido con teclado, tacto, lector de pantalla, vista estrecha, red retardada y un error recuperable del servidor.
- Monitorizar éxito, denegación, fallo de validación, fallo de dependencia, agotamiento de reintentos y recuperación por versión de contrato sin dimensiones sensibles de la carga útil.
- Reejecutar conjuntos de pruebas positivas y negativas emparejadas tras cambios en política, esquema, dependencia, migración o límite y preservar la evidencia resultante.
Suposiciones de adopción
- Los nombres y valores en el ejemplo son un conjunto concreto, no valores predeterminados universales; los adoptantes los reemplazan mediante evidencia documentada y propiedad.
- El sistema adoptante puede proporcionar identidad autenticada, versiones duraderas de operación o registro, telemetría limitada y un camino controlado para cambios.
Los ejemplos con apariencia ejecutable en este paquete son conjuntos de pruebas y contratos de aceptación. Ejecute el validador de colección para verificar estructura y metadatos, luego traduzca y ejecute los escenarios en el repositorio destino antes de registrar evidencia de implementación.