Um fluxo pode terminar sem erro e ainda gastar recursos sem produzir uma publicação nova. Isso acontece quando a automação gera o texto, cria uma capa e só descobre no último passo que a notícia já está no banco.

No Pleno Controle, a barreira final é um slug único no MySQL. Ela impede registros repetidos, mas a verificação que evita trabalho desnecessário precisa acontecer antes das chamadas de IA.

O que verificar antes de gerar conteúdo

A primeira etapa lê o RSS e prepara um conjunto limitado de candidatos recentes. Para cada item, produz um slug determinístico a partir do título e da URL da fonte. Uma mesma referência deve resultar no mesmo identificador entre tentativas.

O fluxo envia esses slugs ao endpoint autenticado POST /api/webhook/posts/check. A aplicação consulta tanto os artigos publicados quanto os rascunhos. Assim, uma notícia aguardando revisão também não precisa ser gerada novamente.

{"slugs":["noticia-a","noticia-b"]}

A resposta informa os identificadores encontrados:

{"existing":["noticia-a"]}

O próximo nó escolhe a primeira candidata que não aparece nessa lista. Somente ela segue para os modelos. Se todas já existirem, o nó retorna uma lista vazia e encerra o ramo.

Como organizar os nós

  1. Ler o RSS e filtrar as fontes permitidas.
  2. Preparar até 20 candidatas recentes com slug estável.
  3. Consultar o banco por meio do endpoint autenticado.
  4. Selecionar uma candidata inédita ou encerrar sem chamar modelos.
  5. Gerar texto e capa, revisar e salvar a publicação ou o rascunho.

No workflow do projeto, os nós “Verificar inéditas” e “Selecionar inédita” ficam antes de “Resumir com OpenAI”. A capa e a revisão também ficam depois dessa barreira.

Falhar na consulta não significa notícia inédita

Se o banco estiver indisponível ou a resposta não tiver o formato esperado, a execução deve interromper. Tratar uma falha de consulta como uma lista vazia de registros existentes permitiria gerar conteúdo novamente durante uma indisponibilidade.

A autorização Bearer também é necessária na rede Docker. O endereço interno do serviço facilita a conectividade, mas não substitui o controle de acesso.

Por que manter a restrição no banco

A pré-checagem não é uma trava contra concorrência. Duas execuções iniciadas ao mesmo tempo podem consultar o banco antes de qualquer uma inserir a notícia. Por isso, a coluna slug continua com restrição única, e o webhook responde 409 quando já existe um registro.

Esse retorno evita uma segunda inserção; ele não estorna chamadas de IA que já ocorreram. Também não atualiza automaticamente o texto ou a imagem da notícia existente.

O que medir

Acompanhe quantas candidatas foram examinadas, quantas foram ignoradas como repetidas e quantas viraram publicações. Para calcular custo por artigo, use o consumo real das APIs e as publicações efetivas do período. Não confunda execuções do agendamento com artigos novos.

O projeto inclui testes para a seleção de inéditas, o encerramento antes da IA e a rejeição de respostas inválidas. A redução financeira concreta depende da frequência de repetições e do consumo da sua conta.

Leia também o checklist de implantação com Docker e nossa política editorial.