Ir al contenido
Quiet Social

Sincronización automática

Esta documentación está traducida del francés. Si ambas versiones difieren, prevalece la versión francesa.

Cada guardado o eliminación de un modelo pone en cola un job que alinea el post remoto con el modelo: lo envía, lo sustituye mientras no haya salido, lo cancela, o no hace nada si el post no ha cambiado.

Lo que la dispara

Cada guardado o eliminación del modelo (eliminación suave incluida) pone en cola un job SyncSocialPost, en queue.connection y queue.name, una vez confirmada la transacción, salvo si sync vale false. El job lleva el tipo y la clave del modelo, nunca el modelo: lee el modelo tal como está en el momento en que se ejecuta, sin ámbitos globales, y un modelo eliminado de forma suave cuenta como eliminado.

Solo los eventos de Eloquent la disparan: Article::query()->update([...]) o una eliminación masiva no sincronizan nada.

La tabla de decisión

El job compara el post que describe el modelo con lo que ya ha enviado, mediante una huella del post. La tabla se lee de arriba abajo: decide la primera fila que se aplica. «Forzado» designa publishToSocial(); «mismo post» significa una huella sin cambios.

Situación Efecto
modelo eliminado, o condición falsa (salvo forzado) el post activo se cancela si no ha salido
datos inválidos (enlace, etiqueta, portada, texto…) vínculo rejected y SocialPostRejected, una vez por error
error de configuración, o rechazo que un nuevo intento no resolverá SocialPostFailed, notificado con report()
fecha de publicación más antigua que ignore_older_than (salvo forzado) nada, se registra en el log
todas las redes omitidas el post activo se cancela si no ha salido
ninguna red con un destino capaz de publicar nada, se registra en el log; el post activo se deja
modelo eliminado o condición falsa, con un vínculo creating se busca por su referencia: se cancela si se encuentra, si no se cierra (superseded)
un vínculo creating, mismo post, horario futuro, menos de 23 horas el intento se reenvía con su propia clave
un vínculo creating en los demás casos (post cambiado, horario pasado, clave caducada) se busca por su referencia: se completa si se encuentra, si no se cierra (superseded) y el post se envía de nuevo
post activo, mismo post (no forzado) nada
post activo, mismo post, forzado se reenvía solo si se canceló o falló en Quiet Social
post activo que aún no ha salido, post cambiado se cancela, y se envía el nuevo
post activo cancelado, fallido o eliminado en Quiet Social, post cambiado se envía uno nuevo
post activo que ya salió (o está saliendo), post cambiado no se envía nada; SocialPostOutdated
último vínculo rejected, mismo post (no forzado) nada: se rechazaría de nuevo
último vínculo cancelado en Quiet Social, mismo post (no forzado) nada: alguien lo decidió así
último vínculo baseline, mismo post (no forzado) nada: el post ya existía cuando llegó el paquete
tres fallos seguidos, mismo post (no forzado) nada, se registra en el log
en cualquier otro caso el post se envía (enseguida, o programado)

Un post «no ha salido» mientras Quiet Social lo tiene en draft, pending_approval, approved o scheduled. «Está saliendo» en queued o processing, y «ha salido» una vez published o partially_published.

La huella cubre lo que describe el modelo: textos, títulos, enlace, etiquetas, imagen y texto alternativo, marca, modo, destinos declarados (sin las redes omitidas) y fecha de publicación tal como está escrita. Una portada en archivo entra en ella por su ruta, su tamaño y su fecha de modificación. Una conexión que vuelve no cambia la huella: esta se basa en los destinos declarados, no en los destinos disponibles en ese momento.

Enviar sin publicar dos veces

Enviar escribe primero el vínculo (creating, con una clave de idempotencia, el horario efectivo y la marca), luego llama a la API, y después completa el vínculo con su respuesta. Un vínculo creating es un intento que se quedó sin respuesta: una respuesta perdida, un fallo del proceso.

  • El nuevo intento de un mismo post, todavía programado en el futuro y dentro de las 23 horas, reenvía la misma clave y el mismo cuerpo: la API responde con la publicación que ya creó en lugar de crear una segunda.
  • En caso contrario (el post ha cambiado, el horario del intento ha pasado, o la API, que guarda una clave 24 horas, ha podido olvidarla), reenviar la clave arriesgaría un segundo post: la publicación se busca por su referencia, en la marca para la que salió el intento. Si se encuentra, completa el vínculo; si no, el vínculo se cierra (superseded) y el post vuelve a salir.

Las fechas de los vínculos se guardan en la zona horaria de tu aplicación, sea cual sea la de la respuesta de la API.

Cada vínculo nuevo recibe una clave nueva: un post cancelado y luego reenviado idéntico se crea realmente de nuevo.

Las publicaciones manuales

Las publicaciones enviadas a mano (el constructor manual, una pantalla del plugin de Filament) se vinculan sin huella. La sincronización nunca las cancela ni las sustituye.

El bloqueo y la caché

Cada sincronización toma un bloqueo sobre su modelo (social:sync:{type}:{key}) en tu caché por defecto, lo espera lock_wait segundos, y vuelve a ponerse en cola cuando no lo obtiene. Esta caché debe admitir bloqueos y estar compartida por todos los procesos, tanto servidores web como workers: Redis, Memcached o la caché en base de datos. La caché array, o una caché file en varios servidores, deja que dos sincronizaciones del mismo modelo escriban a la vez.

Una ráfaga de guardados pone varios jobs en cola: se ejecutan uno a uno, y la huella hace que todos los siguientes terminen sin ninguna llamada a la API.

La cola

La cola sync funciona, pero no puede reintentar un fallo pasajero: se registra en el log como advertencia, y el post espera al siguiente guardado. En producción, usa una cola de verdad:

  • un worker solo detiene un job a los 120 segundos con la extensión pcntl;
  • da a la conexión de cola un retry_after de 150 segundos o más: si es más corto, entrega el job a un segundo worker mientras el primero aún lo está procesando;
  • un fallo pasajero (límite de frecuencia, indisponibilidad, bloqueo del modelo ya tomado) se reintenta durante 12 horas, tras el Retry-After de la API cuando lo da, si no tras 10 s, 30 s, 1 min, 5 min, y luego 15 min.

Cuando todos los intentos han fallado, se emite SocialPostFailed y el post espera a la siguiente modificación del modelo.

Los modelos antiguos

Un modelo cuya fecha de publicación es de hace más de ignore_older_than minutos (1440, un día, por defecto) no se envía automáticamente: el guardado se registra en el log, nada más. publishToSocial() lo envía de todos modos. Un modelo sin fecha de publicación nunca es demasiado antiguo: en una base de modelos existentes, usa social:baseline.

Desactivar la sincronización

QUIET_SOCIAL_SYNC_ENABLED=false (la clave sync) desactiva la sincronización en todas partes: los guardados ya no ponen nada en cola, y los jobs ya en cola terminan sin hacer nada. Es útil durante una importación o un seeder. publishToSocial() sigue funcionando.