Design de Event Store

Guia completo para projetar event stores para aplicações com event sourcing.

Quando Usar Esta Habilidade

• Projetando infraestrutura de event sourcing
• Escolhendo entre tecnologias de event store
• Implementando event stores customizados
• Otimizando armazenamento e recuperação de eventos
• Configurando esquemas de event store
• Planejando o escalonamento do event store

Conceitos Principais

1. Arquitetura do Event Store

┌─────────────────────────────────────────────────────┐
│                    Event Store                       │
├─────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐ │
│  │   Stream 1   │  │   Stream 2   │  │   Stream 3   │ │
│  │ (Aggregate)  │  │ (Aggregate)  │  │ (Aggregate)  │ │
│  ├─────────────┤  ├─────────────┤  ├─────────────┤ │
│  │ Event 1     │  │ Event 1     │  │ Event 1     │ │
│  │ Event 2     │  │ Event 2     │  │ Event 2     │ │
│  │ Event 3     │  │ ...         │  │ Event 3     │ │
│  │ ...         │  │             │  │ Event 4     │ │
│  └─────────────┘  └─────────────┘  └─────────────┘ │
├─────────────────────────────────────────────────────┤
│  Global Position: 1 → 2 → 3 → 4 → 5 → 6 → ...     │
└─────────────────────────────────────────────────────┘

2. Requisitos do Event Store

Comparação de Tecnologias

Modelos e exemplos detalhados

A biblioteca completa de modelos e exemplos detalhados está em references/details.md. Leia este arquivo quando precisar dos modelos concretos.

Melhores Práticas

Faça

• Use IDs de stream que incluam o tipo de agregado - Order-{uuid}
• Inclua IDs de correlação/causalidade - Para rastreamento
• Version eventos desde o primeiro dia - Planeje a evolução do esquema
• Implemente idempotência - Use IDs de evento para deduplicação
• Indexe apropriadamente - Para seus padrões de consulta

Não Faça

• Não atualize ou exclua eventos - São fatos imutáveis
• Não armazene payloads grandes - Mantenha eventos pequenos
• Não pule a concorrência otimista - Evita corrupção de dados
• Não ignore backpressure - Lide com consumidores lentos