Command Query Separation (CQS) é um princípio fundamental do design de software que promove clareza e simplicidade na sua base de código. Cunhada por Bertrand Meyer, o princípio afirma que todo método de um sistema deve executar uma ação (um comando) ou retornar dados (uma consulta), mas nunca ambos. Essa distinção garante que seu código seja mais fácil de entender, testar e manter.

Nesta postagem do blog, exploraremos os principais aspectos do CQS, como implementá -lo e os benefícios que ele traz para o desenvolvimento de software. Também forneceremos exemplos de aplicação de CQs em cenários práticos, como design de API e interações de banco de dados.

1️⃣ Entendendo os princípios básicos de CQs

Em seu núcleo, o CQS separa as funções em duas categorias distintas:

✓ comandos: executar ações que alteram o estado do sistema, mas retornem nenhum valor (por exemplo, atualizando um banco de dados ou enviando um email).

✓ consultas: Recuperar dados sem alterar o estado do sistema (por exemplo, buscar detalhes do usuário de um banco de dados).

Esta separação simplifica o raciocínio sobre o código e evita efeitos colaterais não intencionais.

2️⃣ benefícios do uso de cqs
Legabilidade de código aprimorado: distinção clara entre comandos e consultas facilita a compreensão do código.
Efeitos colaterais reduzidos: consultas não modificam o estado, garantindo comportamento previsível.
Teste mais fácil: comandos e consultas podem ser testados de forma independente, reduzindo a complexidade nos casos de teste.
Design escalável: incentiva o código modular e desacoplado, facilitando a dimensionamento do sistema.

3️⃣ implementando CQs na prática

Exemplo: Express.js API

Vamos aplicar os princípios do CQS a um aplicativo Express.js:

? Sem cqs:

app.post('/user', (req, res) => {
  const user = createUser(req.body); // Command
  res.json(user); // Query
});

? Com cqs:

app.post('/user', (req, res) => {
  createUser(req.body); // Command
  res.sendStatus(201);
});

app.get('/user/:id', (req, res) => {
  const user = getUser(req.params.id); // Query
  res.json(user);
});

aqui, comandos (createUser) e consultas (getuser) são separados, tornando as responsabilidades de cada função mais clara.

integração com código legado: Adotar CQs em uma base de código existente pode exigir refatoramento. Comece pequeno, com foco em novos recursos ou componentes críticos.

Performance Overhead: A adesão estrita aos CQs às vezes pode levar a chamadas de função adicionais. Otimizar seletivamente para equilibrar clareza e desempenho.

Conclusão

A separação da consulta é um princípio simples e poderoso que promove a clareza e a manutenção no design de software. Ao abraçar essa abordagem, você pode criar sistemas mais fáceis de raciocinar, escalar e testar. Esteja você projetando APIs, implementando a lógica do domínio ou gerenciando interações de banco de dados, o CQS é uma ferramenta valiosa para a engenharia de software moderna.