Padrões de Orquestração de Workflow

Domine a arquitetura de orquestração de workflow com Temporal, cobrindo decisões fundamentais de design, padrões de resiliência e melhores práticas para construir sistemas distribuídos confiáveis.

Use esta habilidade quando

• Trabalhando em tarefas ou workflows de padrões de orquestração de workflow
• Precisando de orientação, melhores práticas ou checklists para padrões de orquestração de workflow

Não use esta habilidade quando

• A tarefa não estiver relacionada a padrões de orquestração de workflow
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique melhores práticas relevantes e valide os resultados.
• Forneça etapas acionáveis e verificação.

Quando Usar Orquestração de Workflow

Casos de Uso Ideais (Fonte: docs.temporal.io)

• Processos de várias etapas que abrangem máquinas/serviços/bancos de dados
• Transações distribuídas que exigem semântica de tudo ou nada
• Workflows de longa duração (horas a anos) com persistência automática de estado
• Recuperação de falhas que deve retomar do último passo bem-sucedido
• Processos de negócios: reservas, pedidos, campanhas, aprovações
• Gerenciamento de ciclo de vida de entidades: rastreamento de inventário, gerenciamento de contas, workflows de carrinho
• Automação de infraestrutura: pipelines de CI/CD, provisionamento, implantações
• Sistemas humanos no loop que exigem timeouts e escalonamentos

Quando NÃO Usar

• Operações CRUD simples (use chamadas diretas de API)
• Pipelines de processamento de dados puros (use Airflow, processamento em lote)
• Requisição/resposta sem estado (use APIs padrão)
• Streaming em tempo real (use Kafka, processadores de eventos)

Decisão Crítica de Design: Workflows vs. Atividades

A Regra Fundamental (Fonte: temporal.io/blog/workflow-engine-principles):

• Workflows = Lógica de orquestração e tomada de decisão
• Atividades = Interações externas (APIs, bancos de dados, chamadas de rede)

Workflows (Orquestração)

Características:

• Contêm lógica de negócios e coordenação
• DEVEM ser determinísticos (mesmas entradas → mesmas saídas)
• Não podem realizar chamadas externas diretas
• Estado automaticamente preservado em caso de falhas
• Podem rodar por anos, apesar de falhas de infraestrutura

Exemplos de tarefas de workflow:

• Decidir quais etapas executar
• Lidar com a lógica de compensação
• Gerenciar timeouts e retentativas
• Coordenar workflows filhos

Atividades (Interações Externas)

Características:

• Lidam com todas as interações de sistemas externos
• Podem ser não determinísticas (chamadas de API, escritas em banco de dados)
• Incluem timeouts e lógica de retentativa embutidos
• Devem ser idempotentes (chamar N vezes = chamar uma vez)
• De curta duração (geralmente segundos a minutos)

Exemplos de tarefas de atividade:

• Chamar API do gateway de pagamento
• Escrever no banco de dados
• Enviar e-mails ou notificações
• Consultar serviços externos

Framework de Decisão de Design

Does it touch external systems? → Activity
Is it orchestration/decision logic? → Workflow

Padrões Essenciais de Workflow

1. Padrão Saga com Compensação

Propósito: Implementar transações distribuídas com capacidade de rollback

Padrão (Fonte: temporal.io/blog/compensating-actions-part-of-a-complete-breakfast-with-sagas):

For each step:
  1. Register compensation BEFORE executing
  2. Execute the step (via activity)
  3. On failure, run all compensations in reverse order (LIFO)

Exemplo: Workflow de Pagamento

1. Reservar inventário (compensação: liberar inventário)
2. Cobrar pagamento (compensação: reembolsar pagamento)
3. Cumprir pedido (compensação: cancelar cumprimento)

Requisitos Críticos:

• Compensações devem ser idempotentes
• Registrar compensação ANTES de executar o passo
• Executar compensações na ordem inversa
• Lidar com falhas parciais de forma graciosa

2. Workflows de Entidade (Modelo de Ator)

Propósito: Workflow de longa duração representando uma única instância de entidade

Padrão (Fonte: docs.temporal.io/evaluate/use-cases-design-patterns):

• Uma execução de workflow = uma entidade (carrinho, conta, item de inventário)
• Workflow persiste durante a vida útil da entidade
• Recebe sinais para mudanças de estado
• Suporta consultas para o estado atual

Exemplos de Casos de Uso:

• Carrinho de compras (adicionar itens, checkout, expiração)
• Conta bancária (depósitos, saques, verificações de saldo)
• Inventário de produtos (atualizações de estoque, reservas)

Benefícios:

• Encapsula o comportamento da entidade
• Garante consistência por entidade
• Event sourcing natural

3. Fan-Out/Fan-In (Execução Paralela)

Propósito: Executar várias tarefas em paralelo, agregar resultados

Padrão:

• Gerar workflows filhos ou atividades paralelas

…