# Gadinet Social V25 — Fila oficial de publicação

## Objetivo
Ligar `scheduled_posts` ao adapter oficial configurado no destino.

Fluxo:
`scheduled_post -> queue_job -> PublicationJobProcessor -> AdapterExecutionService -> Meta -> publication_attempts -> published`

## Segurança operacional
- Um destino automático precisa ter `integration_id`.
- Facebook Groups continuam em `manual_review`.
- O payload não escolhe Page ID.
- O Page ID vem da integração OAuth ligada ao destino.
- Um post só vira `published` quando a API retorna `remote_post_id`.
- Se o post já estiver `published`, o worker não chama a API novamente.

## Retry
Somente erros considerados transitórios entram em retry:
- sem status HTTP / erro de rede
- HTTP 408
- HTTP 429
- HTTP 5xx

Backoff:
- tentativa 1: 2 min
- tentativa 2: 5 min
- tentativa 3: 15 min
- demais: 30 min

Após `max_attempts`, o job e o post terminam como `failed`.

## Idempotência local
`queue_jobs` ganha índice único `(scheduled_post_id, job_type)`.
Isso impede múltiplos jobs locais de publicação para o mesmo post.

Observação: isso não garante exactly-once em uma falha de rede ocorrida depois de a plataforma remota publicar mas antes de responder. A V25 evita duplicação local após confirmação, mas não inventa garantia distribuída que a API remota não ofereça.

## Destinos Meta
Ao concluir OAuth, a V25 cria ou sincroniza automaticamente um destino Facebook Page e grava `destinations.integration_id`.

## Materialização
O worker monta:
- headline
- body
- CTA
- tracked link
- image URL HTTPS pública

## Cron
`* * * * * /usr/bin/php /home/USUARIO/gadinet-social/cron/queue-worker.php`

## Upgrade
`database/migrate_v24_to_v25.sql`

## Fresh install
`database/schema_v25_clean.sql`
