Consulta em camadas: por que o SQL de 80 linhas é uma armadilha

Peça a análise inteira e vem um SQL de 80 linhas com quatro CTEs. Ele roda. Devolve uma tabela bonita. E você não tem como saber se está certo — só se está sem erro de sintaxe.

A diferença entre código e análise aparece aqui de novo: um programa de 80 linhas errado costuma quebrar. Uma consulta de 80 linhas errada devolve uma tabela plausível. Não existe teste automático dizendo que o número está torto.

A substituição é a contagem de controle: a cada camada, um número que você consegue conferir contra algo conhecido. Se a camada 1 dá 3.412 pedidos e o financeiro fechou o mês com 3.412 pedidos, a camada 1 está certa. Se a camada 2 dá 11.847, você sabe exatamente onde a linha multiplicou.

WITH base AS (...), enriquecido AS (...),
     agregado AS (...), final AS (...)
SELECT * FROM final;

-- resultado: uma tabela com 14 colunas e 38 linhas

-- Camada 1: universo de pedidos
SELECT COUNT(*), SUM(valor) FROM pedidos
WHERE criado_em >= '2026-03-01' AND criado_em < '2026-04-01'
  AND status NOT IN (3, 7);
-- 3.412 | R$ 2.108.443,10   ✓ bate com o fechamento

-- Camada 2: junta cliente (1:1 — não pode mudar a contagem)
SELECT COUNT(*), SUM(p.valor)
FROM pedidos p JOIN clientes c ON c.id = p.cliente_id
WHERE ...;
-- 3.401 | R$ 2.103.201,40   ✗ perdeu 11 pedidos!
--   → 11 pedidos com cliente_id órfão. Investigar antes de seguir.

A diferença: A regra: toda junção que deveria ser 1:1 precisa preservar a contagem. Se mudou, ou há órfão (INNER JOIN perdendo linha) ou há duplicata na tabela da direita.

A tabela de controle da análise

A camada 5 tem a conferência mais fácil e mais esquecida: se a soma dos segmentos não dá o total, algum registro caiu num segmento nulo que ninguém viu.

Preciso responder: [pergunta da especificação]

Contexto: [cole o dicionário de dados]
Especificação: [cole as definições fixadas]

Monte a consulta em camadas separadas, NÃO em um bloco único.
Para cada camada, entregue:
- a consulta
- o que ela deve produzir em uma frase
- a CONTAGEM DE CONTROLE que eu devo checar antes de seguir
- o que significa se o controle não bater

Comece só pela camada 1. Espere eu confirmar o número antes de
escrever a camada 2.