Trigger.dev: o piloto automático
Começa o Módulo 4 — Automação com Trigger.dev. Se o Supabase é onde a verdade mora (Módulo 3), o Trigger.dev é o que faz a verdade acontecer no horário certo, sem ninguém apertar botão. Este post abre o módulo explicando o porquê dele existir no nosso stack.
O problema que o Trigger.dev resolve
Toda plataforma viva tem trabalho que precisa rodar sozinho: resumo que chega de manhã, número que se atualiza, narrativa gerada por IA, sincronização periódica. A pergunta é: onde esse trabalho roda, com retry e com rastro?
A resposta preguiçosa seria "um cron jogado num servidor". O problema: cron solto não tem retry decente, não tem log por execução, e o código fica longe da aplicação. Quando falha às 3h da manhã, ninguém sabe.
O que o Trigger.dev entrega
- Jobs agendados e workflows com cron declarado em código.
- Retry automático — falhou? Tenta de novo segundo a política.
- Observabilidade — log e status por execução, dá pra ver o que rodou e o que quebrou.
- Código versionado junto da app — no ClubPetro, o Trigger.dev vive dentro do
apps/web, então o job está no mesmo repo, com os mesmos tipos e acesso ao mesmo Drizzle/Supabase.
O padrão que se repete
Quase todo job nosso segue a mesma forma:
- O Trigger.dev acorda (por horário ou evento).
- Lê/escreve no Supabase via Drizzle.
- Opcionalmente chama IA (Claude) pra resumir/gerar.
- Grava o resultado numa tabela.
- O usuário abre a tela e já encontra pronto.
O trabalho aconteceu enquanto ninguém olhava. Isso é o que dá a sensação de "a plataforma é inteligente".
Onde vibe coding entra
A IA é ótima pra escrever a estrutura de um job (o boilerplate de task, schedule, retry) seguindo o padrão que já existe. O que continua humano: decidir o que automatizar, com que frequência, e garantir que o job é idempotente (rodar duas vezes não duplica dado — assunto recorrente do módulo).
⚠️ Armadilha #24: automatizar algo que ainda não está estável manualmente. Job confiável automatiza um processo confiável — automatizar a bagunça só faz a bagunça acontecer sozinha, mais rápido.
Próximo da série: #25 — Seu primeiro job agendado.