projection-patterns
Ajuda seu agente a criar visualizações de dados a partir de fluxos de eventos. É útil para otimizar como os dados são lidos e apresentados.
O que ela faz
Esta ferramenta ajuda a organizar informações de eventos passados para que você possa consultá-las rapidamente. Ela cria 'visões' otimizadas dos seus dados.
Quando usar
- ✓Quando você precisa ver o estado atual das coisas em tempo real.
- ✓Ao reconstruir informações a partir de um histórico de eventos.
- ✓Para tornar as consultas de dados mais rápidas e eficientes.
Exemplo do que pedir para a IA
“Como posso criar uma visão otimizada dos meus dados de vendas a partir dos eventos de transação?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ela funciona pegando uma sequência de eventos (como registros de ações) e os processando para criar um modelo de dados mais simples e direto. Esse modelo é então usado para responder perguntas rapidamente.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add wshobson/agents --skill projection-patternsOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/backend-development/skills/projection-patterns/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Padrões de Projeção
Guia completo para construir projeções e modelos de leitura para sistemas com event sourcing.
Quando Usar Esta Habilidade
- Construir modelos de leitura CQRS
- Criar visualizações materializadas a partir de eventos
- Otimizar o desempenho de consultas
- Implementar dashboards em tempo real
- Construir índices de busca a partir de eventos
- Agregar dados entre fluxos
Conceitos Principais
1. Arquitetura de Projeção
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Event Store │────►│ Projector │────►│ Read Model │
│ │ │ │ │ (Database) │
│ ┌─────────┐ │ │ ┌─────────┐ │ │ ┌─────────┐ │
│ │ Events │ │ │ │ Handler │ │ │ │ Tables │ │
│ └─────────┘ │ │ │ Logic │ │ │ │ Views │ │
│ │ │ └─────────┘ │ │ │ Cache │ │
└─────────────┘ └─────────────┘ └─────────────┘
2. Tipos de Projeção
| Tipo | Descrição | Caso de Uso |
|---|---|---|
| Ao Vivo | Tempo real a partir de assinatura | Consultas de estado atual |
| Recuperação | Processa eventos históricos | Reconstruir modelos de leitura |
| Persistente | Armazena ponto de verificação | Retomar após reinício |
| Em Linha | Mesma transação da escrita | Consistência forte |
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
O Que Fazer
- Tornar projeções idempotentes - Seguro para reproduzir
- Usar transações - Para atualizações de várias tabelas
- Armazenar pontos de verificação - Retomar após falhas
- Monitorar atraso - Alertar sobre atrasos na projeção
- Planejar reconstruções - Projetar para reconstrução
O Que Não Fazer
- Não acoplar projeções - Cada uma é independente
- Não ignorar tratamento de erros - Registrar e alertar sobre falhas
- Não ignorar a ordem - Eventos devem ser processados em ordem
- Não normalizar em excesso - Desnormalizar para padrões de consulta
Perguntas frequentes
O que são 'eventos'?
Eventos são registros de algo que aconteceu no passado, como 'usuário se cadastrou' ou 'pedido foi feito'.
O que é um 'read model'?
É uma forma organizada de ver os dados, feita especificamente para responder perguntas, diferente de como os dados são originalmente registrados.
Por que 'otimizar performance'?
Para que o sistema responda mais rápido às suas perguntas, mesmo com muitos dados, evitando lentidão.
Detalhes
Descrição original do autor
Build read models and projections from event streams. Use when implementing CQRS read sides, building materialized views, or optimizing query performance in event-sourced systems.
repo: wshobson/agents
Popularidade
- Estrelas no GitHub
- 41 mil
- Posição no ranking
- #4807
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
screen-reader-testing
Faz seu agente testar sites usando leitores de tela para garantir que sejam acessíveis.
wshobson/agents
wcag-audit-patterns
Ajuda seu agente a auditar sites para acessibilidade e corrigir problemas de acordo com as diretrizes WCAG.
wshobson/agents
multi-reviewer-patterns
Faz seu agente coordenar revisões de código paralelas, deduplicando achados e consolidando relatórios.
wshobson/agents
parallel-debugging
Permite ao agente depurar problemas complexos com investigações paralelas e análise de causa raiz.
wshobson/agents
Skills parecidas
api-connector-builder
Faz seu agente construir novas conexões com APIs seguindo o padrão já existente. Use quando precisar adicionar mais uma integração sem criar um novo jeito de fazer.
affaan-m/ECC
api-design
Ajuda seu agente a projetar APIs REST seguindo as melhores práticas. É útil para definir como as APIs se comunicam, como os erros são mostrados e como organizar os dados.
affaan-m/ECC
backend-patterns
Ajuda seu agente com padrões de arquitetura do lado do servidor e otimização de banco de dados. É útil para construir ou revisar o código que roda no servidor.
affaan-m/ECC