Alguns processos empresariais duram mais do que uma requisição Web. Uma contratação pode esperar documento, aprovação e pagamento. Uma integração pode depender de um fornecedor indisponível por horas. Tentar manter tudo em uma execução comum cria estados difíceis de explicar e recuperar.
Temporal é uma opção para coordenar processos duradouros. Sua adoção deve começar pela modelagem do trabalho e pelas responsabilidades da equipe. Este manual apresenta como avaliar a ferramenta sem transformar durabilidade em uma promessa de que nenhum erro de negócio poderá acontecer.
Processo não é apenas uma sequência de chamadas
A documentação de Workflow Execution do Temporal descreve a execução durável e seu histórico. Na arquitetura empresarial, é importante distinguir a coordenação do processo das operações que interagem com o mundo externo.
Modele o objetivo, os estados e os eventos que permitem avançar. “Aguardando documento” é diferente de “falhou ao consultar documento”. Um estado pode depender de ação humana, outro de tentativa técnica. Misturá-los produz alertas inúteis e retomadas incorretas.
Identifique o processo de negócio com uma referência estável. A mesma solicitação pode receber vários eventos e atravessar atualizações de software. A referência ajuda a ligar histórico, integrações e atendimento.
| Situação | Pergunta do desenho | Resultado esperado |
|---|---|---|
| Espera humana | Quem pode responder e até quando? | Decisão vinculada à versão correta |
| Falha temporária | Uma nova tentativa é segura? | Retomada controlada |
| Recusa válida | O negócio permite alternativa? | Estado explícito, sem repetição inútil |
| Cancelamento | O que já aconteceu fora do processo? | Encerramento e conciliação |
| Atualização | Execuções antigas continuam compreensíveis? | Compatibilidade ou migração planejada |
Separe coordenação e efeitos externos
Uma atividade que envia uma cobrança ou cria um cadastro precisa lidar com repetição e confirmação perdida. A execução durável não controla automaticamente a atomicidade de outro sistema. Use referências de operação e recursos de idempotência quando disponíveis.
Se o destino não oferece um mecanismo suficiente, desenhe consulta e conciliação. Não prometa execução única apenas porque a coordenação mantém histórico. O risco está na fronteira entre confirmar um efeito e registrar que ele ocorreu.
Documente quais atividades podem ser repetidas, quais exigem consulta anterior e quais precisam de revisão. Essa classificação permite configurar tentativas com significado, em vez de aplicar o mesmo comportamento a qualquer erro.
Cancelamento precisa de regras de negócio
Cancelar um processo não desfaz automaticamente tudo o que aconteceu. Um documento já pode ter sido enviado ou uma reserva confirmada. A empresa precisa decidir quais efeitos podem ser compensados e quais precisam de tratamento humano.
Compensação também pode falhar. Se uma reserva foi cancelada, mas a comunicação ao cliente não chegou, há uma pendência distinta. Registre o estado de cada efeito relevante e o responsável pela exceção.
Evite excluir o histórico para “limpar” o processo. A rastreabilidade ajuda a explicar a decisão, investigar conflitos e atender o cliente sem adivinhações. Retenção e acesso devem respeitar a finalidade dos dados.
Exemplo hipotético: implantação de um serviço empresarial
Uma empresa vende uma implantação que depende de aceite, acesso ao ambiente do cliente e validação da primeira configuração. O processo pode durar dias. Cada etapa tem responsável e condição de avanço.
O cliente envia um documento novo depois de uma aprovação. A coordenação precisa identificar se a decisão anterior ainda vale. Ela não deve prosseguir apenas porque recebeu um evento com a palavra “aprovado”. O aceite se refere a uma versão e a um escopo.
Durante a ativação externa, a resposta se perde. Antes de repetir, o sistema consulta a referência no fornecedor. Se a ativação ocorreu, registra a evidência; se o resultado é desconhecido, abre conciliação. O cliente recebe um estado honesto, sem uma confirmação fabricada para encerrar o fluxo.
Atualizações exigem atenção às execuções em andamento
Um sistema com processos longos convive com versões antigas. Uma mudança de percurso pode afetar execuções iniciadas antes da publicação. Verifique as estratégias de compatibilidade e versionamento apropriadas ao SDK e à versão utilizados.
Inclua no ensaio um processo pausado antes da atualização e retomado depois. O teste deve demonstrar como o histórico é interpretado e como os efeitos externos são preservados. Testar apenas processos novos deixa uma parte importante da operação descoberta.
Defina também como corrigir um caso específico sem alterar silenciosamente todos os demais. Intervenções operacionais precisam de permissão, justificativa e registro, especialmente quando envolvem compromissos com clientes.
A equipe precisa operar exceções
Monitore idade dos processos, estados de espera, tentativas e falhas por atividade. Uma execução aberta não é necessariamente um problema: ela pode estar aguardando uma aprovação legítima. O alerta útil considera prazo e responsabilidade.
Prepare uma visão que permita ao operador entender o que falta e qual ação é permitida. Exibir somente um erro técnico transfere o diagnóstico para quem atende o cliente. O histórico deve ligar a ocorrência à etapa do negócio.
Ao avaliar custo, considere infraestrutura, manutenção e domínio da equipe. Uma ferramenta de coordenação pode reduzir trabalho manual, mas também introduz uma plataforma que precisa de operação e atualização.
Oficina de recuperação
Desenhe um processo com três sistemas e uma aprovação humana. Interrompa o ensaio antes e depois de cada efeito externo. Acrescente cancelamento após uma operação concluída e aprovação recebida fora de prazo.
O resultado deve mostrar onde uma tentativa pode ser repetida, onde é necessária consulta e onde entra uma compensação. Exija que a equipe explique uma retomada usando o histórico, sem reconstruir o caso por memória.
Faça prazos e intervenções aparecerem no produto
Uma etapa aguardando ação humana precisa mostrar o que falta e quem pode decidir. O tempo de espera deve ser interpretado no contexto do negócio, considerando prazos combinados e eventuais mudanças de escopo. Um alerta técnico a cada repetição não substitui essa responsabilidade.
Quando uma pessoa intervém, registre a decisão e sua relação com a versão do processo. Alterar parâmetros no meio do percurso pode ser legítimo, mas a execução seguinte precisa saber quais aprovações continuam válidas. A interface deve apresentar a consequência prevista antes de confirmar.
Inclua esses comportamentos no escopo de contratação. Uma solução durável sem operação compreensível pode manter processos abertos indefinidamente, apenas transferindo o problema de uma falha de execução para uma fila de pendências sem dono. A continuidade só agrega valor quando a equipe consegue conduzir o trabalho até um estado verificável.
Checklist de planejamento
- Modelar estados e eventos de negócio.
- Identificar processos de forma estável.
- Classificar atividades por segurança de repetição.
- Planejar cancelamento e compensação.
- Testar atualizações com execuções antigas.
- Definir responsáveis por exceções.
- Medir idade e conclusão por etapa.
Baixe o checklist editável para sua equipe e registre responsáveis, verificações e decisões.
Perguntas frequentes
Todo fluxo assíncrono precisa de Temporal?
Não. Avalie duração, coordenação, retomada e capacidade da equipe. Processos menores podem ser atendidos por soluções mais simples.
Execução durável impede efeitos duplicados?
Não sozinha. A fronteira com sistemas externos exige idempotência, consulta de estado e reconciliação apropriadas.
Cancelar equivale a desfazer?
Não. Efeitos anteriores precisam ser avaliados e, quando possível, compensados por operações específicas.
Estruture processos que continuam após uma interrupção
A Agência A2CR pode modelar coordenação e integrações de longa duração. Converse sobre continuidade de processos empresariais.
Fontes consultadas
Revisão documental: 17/11/2026. Recursos, requisitos e condições podem mudar. Exemplos hipotéticos não representam resultados medidos de clientes.



