Engenharia de fluxos

O que você vai aprender

1. Aula 1. Dependências e execuções duráveis

   40 min

   Por que um fluxo de verdade não cabe numa requisição: grafo de dependências, ordem de execução, estado gravado a cada passo e retomada do ponto em que parou. Com o Cloudflare Workflows como exemplo real, conferido na documentação oficial.

   • Desenhar o grafo de dependências de um processo e identificar o que roda em sequência e o que roda em paralelo.
   • Explicar o que é execução durável: resultado de cada passo gravado, retomada sem repetir o que já foi feito.
   • Escrever passos que respeitam as regras da durabilidade: um efeito por passo, retorno pequeno, nada importante fora de passo.
   • Usar espera por tempo e espera por evento (sleep e waitForEvent) para processos que duram horas ou dias.

   Aula completa, exemplos e exercícios dentro da plataforma

2. Aula 2. Retentativas com recuo e idempotência

   40 min

   Tentar de novo é fácil; tentar de novo sem causar estrago é engenharia. Política de retentativa com recuo exponencial e variação aleatória, erros que nunca se retentam, e idempotência explicada com o caso clássico da cobrança duplicada.

   • Configurar uma política de retentativa por passo: limite, atraso inicial, tipo de recuo, tempo limite por tentativa.
   • Separar erros retentáveis (indisponibilidade, limite de taxa, tempo esgotado) de erros não retentáveis (dados inválidos, recusa).
   • Explicar idempotência e aplicar a chave de idempotência numa cobrança e num webhook.
   • Projetar a tabela de idempotência: o que a chave contém, por quanto tempo vive e o que acontece na segunda chegada.

   Aula completa, exemplos e exercícios dentro da plataforma

3. Aula 3. Filas: desacoplar quem pede de quem faz

   40 min

   A fila é o balcão de senhas do seu sistema: quem pede não espera quem faz. Produtor, consumidor, lotes, confirmação, retentativas, fila de cartas mortas e a regra de ouro da entrega pelo menos uma vez. Com o Cloudflare Queues como exemplo real, conferido na documentação oficial.

   • Explicar quando uma fila resolve o problema: picos, trabalho lento, serviço externo instável, separação entre quem pede e quem faz.
   • Descrever produtor, consumidor, lote, confirmação (ack) e retentativa com atraso.
   • Configurar fila de cartas mortas e limite de retentativas para que mensagens envenenadas não travem o sistema.
   • Aplicar a semântica de entrega pelo menos uma vez: todo consumidor precisa ser idempotente.

   Aula completa, exemplos e exercícios dentro da plataforma

4. Aula 4. Concorrência e limites de taxa

   40 min

   Quantas coisas ao mesmo tempo, e quantas por minuto. Concorrência controlada com semáforo e pool, limites de taxa dos provedores de IA (429, retry-after, balde de fichas), limites da sua própria plataforma e o limite por usuária que protege o seu bolso.

   • Distinguir concorrência de paralelismo e controlar quantas operações rodam ao mesmo tempo com semáforo ou pool.
   • Ler e respeitar os limites de taxa dos provedores de IA: dimensões (requisições e tokens por minuto), resposta 429, cabeçalho retry-after.
   • Conhecer os limites da plataforma de execução (conexões simultâneas, subrequisições, tempo de CPU) e desenhar dentro deles.
   • Implementar limite por usuária com contador persistente e orçamento, nunca em memória do processo.

   Aula completa, exemplos e exercícios dentro da plataforma

Termos que você vai dominar

• Grafo de dependências (DAG)
• Ordem topológica
• Execução durável (durable execution)
• Passo (step)
• Instância (instance)
• Efeito colateral
• Retentativa (retry)
• Recuo exponencial (exponential backoff)
• Variação aleatória (jitter)
• Erro não retentável
• Idempotência
• Chave de idempotência (idempotency key)
• Produtor (producer)
• Consumidor (consumer)
• Lote (batch)
• Confirmação (ack)
• Fila de cartas mortas (dead letter queue)
• Entrega pelo menos uma vez (at-least-once)
• Mensagem envenenada (poison message)
• Concorrência
• Paralelismo
• Semáforo
• Limite de taxa (rate limit)
• Balde de fichas (token bucket)
• Contrapressão (backpressure)
• Disjuntor (circuit breaker)