Workflows duráveis com Temporal.io
Temporal.io trata o estado do workflow como parte do código. Veja como workflows e activities eliminam máquinas de estado manuais em sistemas distribuídos.
Quem constrói sistemas distribuídos já viveu este cenário: um fluxo precisa executar o passo A, depois o B e, por fim, o C. No meio do caminho, uma chamada externa falha, o processo cai e ninguém sabe exatamente em que estado a operação ficou.
A solução tradicional é construir uma máquina de estado manual. Uma tabela guarda o status, um cronjob retoma o que ficou parado, e cada nova exceção adiciona mais um if ao código. Funciona até o fluxo crescer — e então vira um dos componentes mais difíceis de manter do sistema.
O Temporal é uma plataforma de código aberto para execução durável (durable execution). Ele foi criado pelos mesmos engenheiros por trás do Uber Cadence e do AWS Simple Workflow Service, com uma proposta direta: permitir que fluxos assíncronos complexos sejam escritos como código sequencial simples.
O que é execução durável
Em um sistema comum, o estado de uma operação em andamento vive na memória do processo. Se o processo morre, o estado morre junto. Em execução durável, o estado é reconstruído a partir do histórico de eventos persistido pelo runtime.
Se a comunicação entre serviços para no meio da execução, o Temporal restaura o estado exato em outro nó do cluster e continua de onde parou. O estado da aplicação é a própria execução do código — não uma tabela paralela que precisa ser sincronizada.
Workflows e activities
A arquitetura se apoia em dois conceitos.
Workflows são o código determinístico que orquestra a lógica de negócio. Eles definem a sequência de passos, timers e decisões. Se o fluxo é interrompido, o Temporal faz replay do histórico para reconstruir o estado. Por isso o código precisa ser determinístico: mesma entrada, mesma sequência de decisões.
Activities são onde o trabalho não determinístico acontece: chamadas HTTP, consultas a banco, envio de e-mail. É nelas que você configura políticas de retry, timeouts e limites. Separar orquestração de efeitos colaterais é o que torna o replay seguro.
Por que isso reduz complexidade
Fim do gerenciamento manual de estado. Você não precisa salvar status = 'PROCESSING' no banco para saber onde parou. O runtime garante a persistência de cada passo executado.
Timers de longa duração. É possível colocar um sleep() de 30 dias no código. Durante esse período, a aplicação não consome memória nem CPU; o Temporal apenas reagenda a execução no momento certo.
SDKs nativos. Os workflows são escritos em Go, TypeScript/JavaScript, Python, Java ou .NET, sem uma linguagem de domínio específica ou diagramas em JSON/YAML.
Onde faz sentido
- Pagamentos e processamento financeiro: cobranças recorrentes, estornos e reconciliação bancária, onde cada etapa precisa de rastreabilidade.
- Onboarding e provisionamento: fluxos que dependem de confirmação por e-mail, verificação de documentos e integração com terceiros.
- Orquestração de microsserviços: substituição de coreografias de eventos difíceis de seguir por sagas orquestradas com estado explícito.
Cuidados antes de adotar
Temporal não é um plugin. Ele adiciona um cluster e um modelo mental novo ao time.
- Determinismo: código de workflow não pode depender de horário atual, número aleatório ou chamada externa direta. Isso precisa estar nas activities.
- Versionamento: mudanças em workflows já em execução exigem estratégia de compatibilidade. Trate como contrato, não como código descartável.
- Tamanho de payload: o histórico tem limites; dados grandes devem ficar em storage externo e ser referenciados.
- Operação: alguém precisa cuidar do cluster, da retenção do histórico e do monitoramento.
Para equipes que já sofrem com máquinas de estado manuais em fluxos críticos, o ganho costuma compensar. Para um fluxo simples e isolado, uma fila com retry pode ser suficiente. Se a sua equipe também precisa abstrair estado, eventos e resiliência entre serviços, vale comparar com o Dapr.
Se o seu sistema distribuído depende de cronjobs e tabelas de status para não perder trabalho, vale uma revisão de arquitetura para avaliar o custo real dessa abordagem. Para discutir alternativas, fale com a gente.
Pronto para o próximo passo da sua arquitetura?
Construímos e revisamos arquiteturas para sistemas críticos — do desenho à operação, com decisões documentadas e custos sob controle.
Falar sobre seu projeto