Carregando
0x80Lição 9 de 15

CQRS e event sourcing

Separe escritas de leituras com CQRS, guarde o estado como um log de eventos com event sourcing e construa modelos de leitura com projeções.

28 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Explicar o CQRS e quando modelos de leitura separados compensam
  • Reconstruir o estado a partir de um log de eventos e usar snapshots
  • Construir projeções e reprocessá-las em modelos de leitura

O CQRS - command query responsibility segregation (separação de responsabilidades entre comandos e consultas) - divide o modelo de um serviço em dois:

  • o modelo de escrita trata os comandos (PlaceOrder, CancelOrder) e garante as regras de negócio;
  • um ou mais modelos de leitura têm um formato feito só para consultas: um painel de pedidos por planeta, o histórico de pedidos de um cliente, um índice de busca.

Os modelos de leitura são atualizados a partir dos eventos do lado da escrita, então têm consistência eventual - e você pode ter quantos quiser, cada um no armazenamento mais adequado às suas consultas. O CQRS compensa a complexidade quando leituras e escritas são muito diferentes ou escalam de forma muito diferente; para um CRUD simples, é exagero.

Event sourcing

O event sourcing vai além: em vez de guardar o estado atual de um pedido e sobrescrevê-lo, você guarda cada evento que aconteceu com ele - OrderPlaced, OrderPaid, DishesCooked, OrderDelivered - num event store só de acréscimo (append-only). O estado atual é um fold (redução) sobre os eventos.

  • Você ganha uma trilha de auditoria perfeita e consegue responder “como estava este pedido às 18:42?”.
  • Novos modelos de leitura podem ser construídos depois, reprocessando o histórico.
  • Históricos longos são lentos de reprocessar, então você salva periodicamente um snapshot do estado e reprocessa só os eventos posteriores a ele.
  • Os custos: os eventos são para sempre (versioná-los importa - veja a lição anterior), e as consultas exigem projeções.
event_sourcing.py
1events = [
2    {"seq": 1, "type": "OrderPlaced", "order": 42, "total": 1450},
3    {"seq": 2, "type": "OrderPaid", "order": 42},
4    {"seq": 3, "type": "OrderPlaced", "order": 43, "total": 990},
5    {"seq": 4, "type": "DishesCooked", "order": 42},
6    {"seq": 5, "type": "OrderCancelled", "order": 43},
7    {"seq": 6, "type": "OrderDelivered", "order": 42},
8]
9STATUS = {"OrderPlaced": "placed", "OrderPaid": "paid", "DishesCooked": "cooked",
10          "OrderDelivered": "delivered", "OrderCancelled": "cancelled"}
11
12def state_at(seq):
13    orders = {}
14    for event in events:
15        if event["seq"] > seq:
16            break
17        order = orders.setdefault(event["order"], {})
18        order.update(status=STATUS[event["type"]], **({"total": event["total"]} if "total" in event else {}))
19    return orders
20
21print("now:     ", state_at(6))
22print("at seq 3:", state_at(3))
Saída
now:      {42: {'status': 'delivered', 'total': 1450}, 43: {'status': 'cancelled', 'total': 990}}
at seq 3: {42: {'status': 'paid', 'total': 1450}, 43: {'status': 'placed', 'total': 990}}

Experimente

Até 15 XP

Qual padrão serve?

Decida onde cada padrão combina bem - ou onde um serviço CRUD simples é mais simples e melhor.

0 de 6 classificadosPontuação 0/0
  • “Um livro-razão de cada moeda adicionada e gasta nas carteiras dos clientes, com auditoria completa”

  • “Um painel ao vivo de entregas por planeta, atualizado sem parar para milhares de pessoas”

  • “Administradores editando a lista de planetas atendidos, duas vezes por ano”

  • ““Mostre exatamente como estava este pedido antes de a cozinha alterá-lo””

  • “Busca de texto completo nas descrições do cardápio”

  • “Uma página de configurações em que cada usuário escolhe o seu lámen favorito”

Principais conclusões

  • O CQRS separa um modelo de escrita (comandos, regras) dos modelos de leitura (consultas), ligados por eventos.

  • O event sourcing guarda cada mudança como um evento; o estado atual é um fold sobre eles.

  • Snapshots aceleram a reconstrução; o reprocessamento constrói novos modelos de leitura a partir do histórico.

  • Os dois acrescentam complexidade - use-os onde auditoria, viagem no tempo ou necessidades de leitura muito diferentes justifiquem.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: simule padrões de microsserviços com Python

Crie pequenas simulações em Python dos padrões, como roteadores, sagas, outboxes, circuit breakers e traces, e execute-as com entradas de exemplo. Elas rodam localmente no navegador; não é preciso ter servidores nem contêineres.

Exercício 1

Reconstrua pedidos a partir dos eventos

+25 XP

Cada linha da entrada é um evento seq order EVENT (EVENT é OrderPlaced, OrderPaid, DishesCooked, OrderDelivered ou OrderCancelled). Reconstrua o status de cada pedido reprocessando os eventos na ordem de seq, respeitando o ciclo de vida:

  • placed → paid → cooked → delivered, e cancelar só é permitido antes de cozinhar;
  • um evento que não é permitido no estado atual é rejeitado (seq 7: OrderDelivered rejected for order 43 (status paid)) e não muda nada.

Depois, imprima o status final de cada pedido, pelo número do pedido: order 42: delivered.

  • Noite movimentada
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

Uma projeção com checkpoint

+25 XP

Um modelo de leitura conta os pedidos por planeta e a receita dos pedidos entregues. A primeira linha da entrada é o estado salvo da projeção: checkpoint N seguido das contagens em pares planet=count e revenue=cents. As linhas restantes são eventos seq type order planet cents.

Aplique só os eventos depois do checkpoint (pode haver antigos, que precisam ser ignorados): OrderPlaced soma 1 à contagem do planeta dele; OrderDelivered soma os cents dele à receita. Imprima skipped N already-applied events, depois as contagens por planeta em ordem alfabética (Earth: 3), revenue: 4130 e checkpoint: 12 (a última seq aplicada).

  • Retomar depois de um reinício
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…