Comissões¶

O que é¶

Tela /relatorios/comissoes, no menu como "Metas" → "Performance": relatório mensal de vendas por vendedor, base para o cálculo de comissao. Cada vendedor vê a própria performance (quantidade de vendas, valor total, ticket médio, produtos); quem tem permissão de ver tudo (gestão/super admin) filtra por vendedor.

Como funciona¶

Fonte: RPC get_relatorio_comissoes_mensal (Supabase), agregando por vendedor/mês num período (default = mês corrente), com detalhamento de cada venda (cliente, CPF, produto, datas de aceite/pagamento, valor).
Permissões (useComissoesPermissions, via RPC is_super_admin + permissão comissoes_view_all/comissoes_export): usuário comum só vê e não exporta os próprios números; quem tem comissoes_view_all filtra por qualquer vendedor; super admin tem tudo liberado automaticamente.
Exportação para Excel (xlsx) com linhas de resumo por vendedor/mês + detalhe por venda + linha de total geral — só disponível para quem tem permissão de exportar.

Regras de negócio¶

⚠️ A documentar. Esta tela ainda não tem as regras de negócio levantadas do código.

O que entra aqui: invariante (o que nunca pode acontecer), permissão (quem pode fazer o quê), bloqueio (o que impede a ação e a mensagem que o usuário vê), cálculo (fórmula e arredondamento) e efeito colateral (o que mais muda quando isso acontece).

Regra só entra aqui com origem no código — arquivo e linha. Regra que alguém "acha que é assim" é pior que seção vazia, porque vira decisão de produto baseada em memória.

Onde vive no código¶

CRM: apps/crm-menos-juros/client/src/pages/relatorios/comissoes.tsx
CRM (hook/permissões): apps/crm-menos-juros/client/src/hooks/use-comissoes.ts
DB: RPC get_relatorio_comissoes_mensal, is_super_admin (supabase/migrations/)

Relacionado¶

comercial · comissao · metas-comercial · proposta

Histórico¶

2026-07-10 (INGEST wiki): página criada para o cluster de Relatórios/Analytics do Comercial.