![]() |
Este artigo apresenta as diferenças entre CQS (Command Query Separation) e CQRS (Command Query Responsibility Segregation), utilizando exemplos em C# de um sistema de gerenciamento de pedidos. (Gerado com ajuda da IA, ajustado e revisado por Macoratti) |

public class Pedido { public Guid Id { get; private set; } public string Cliente { get; private set; } public decimal ValorTotal { get; private set; } public PedidoStatus Status { get; private set; } public void Aprovar() { Status = PedidoStatus.Aprovado; } } |
public class PedidoService { public Pedido? ObterPedido(Guid id) { // Consulta o pedido } public void AprovarPedido(Guid id) { // Altera o status do pedido } } |
AprovarPedido(Guid pedidoId);Pedido? ObterPedido(Guid pedidoId);public record AprovarPedidoCommand(Guid PedidoId); |
public class AprovarPedidoHandler(IPedidoRepository repository) { public async Task HandleAsync(AprovarPedidoCommand command) { var pedido = await repository .ObterPorIdAsync(command.PedidoId); if (pedido is null) throw new Exception("Pedido não encontrado"); pedido.Aprovar(); await repository.AtualizarAsync(pedido); } } |
public record ObterPedidoQuery(Guid PedidoId); |
public record PedidoDto(
Guid Id,
string Cliente,
decimal ValorTotal,
string Status); |
public class ObterPedidoHandler(IDbConnection connection) { public async Task<PedidoDto?> HandleAsync(ObterPedidoQuery query) { const string sql = """ SELECT p.Id, c.Nome AS Cliente, p.ValorTotal, p.Status FROM Pedidos p INNER JOIN Clientes c ON c.Id = p.ClienteId WHERE p.Id = @PedidoId """; return await connection.QuerySingleOrDefaultAsync<PedidoDto>( sql, new { query.PedidoId }); } } |
| Característica | CQS | CQRS |
|---|---|---|
| Objetivo | Separar operações de leitura e escrita | Separar responsabilidades e modelos de leitura e escrita |
| Nível de aplicação | Princípio de projeto | Padrão arquitetural |
| Classes distintas | Não exige | Normalmente utiliza componentes distintos |
| Modelos distintos | Não exige | Permite modelos específicos para leitura e escrita |
| Bancos distintos | Não exige | Opcional |
| Complexidade | Baixa | Pode ser maior |