DOCUMENTAÇÃO DE MÓDULO

Relatórios

Gerar consultas e saídas para produtos, entradas, saídas, comissões, contas, serviços, aniversariantes, lucro, inadimplência, comprovantes e documentos operacionais.

MóduloRelatórios

Status Produção

ResponsávelJacy Cordeiro

Última revisão02/08/2026

OBJETIVO

Finalidade do módulo

Gerar consultas e saídas para produtos, entradas, saídas, comissões, contas, serviços, aniversariantes, lucro, inadimplência, comprovantes e documentos operacionais.

LOCALIZAÇÃO

Caminhos principais

sistema/painel/rel/rel_produtos.php

sistema/painel/rel/rel_entradas.php

sistema/painel/rel/rel_saidas.php

sistema/painel/rel/rel_comissoes.php

sistema/painel/rel/rel_contas.php

sistema/painel/rel/rel_servicos.php

sistema/painel/rel/rel_aniv.php

sistema/painel/rel/rel_lucro.php

sistema/painel/rel/*_class.php

PERSISTÊNCIA

Tabelas relacionadas

produtos

cat_produtos

pagar

receber

usuarios

clientes

servicos

formas_pgto

fornecedores

contratos

grupo_assinaturas

itens_assinaturas

FLUXO

Sequência operacional observada

1Abrir relatório ou impressão

2Informar filtros de período e contexto

3Executar arquivo principal

4Carregar classe auxiliar quando existente

5Consultar tabelas

6Montar HTML, impressão, comprovante ou documento

ENTRADAS

Dados recebidos

Filtros variam por relatório: datas, status, pessoa, profissional, serviço ou produto.
Identificadores de comprovante, contrato, caixa ou anotação conforme a rota.
Dados de sessão e configuração carregados pelo painel.

SAÍDAS

Resultados produzidos

HTML de relatório ou tela pronta para impressão.
Comprovantes, recibos, contratos e detalhamentos.
Totais e agrupamentos calculados pelos arquivos *_class.php.
Consultas de lucro, entradas, saídas, comissões e inadimplência.

REGRAS DE NEGÓCIO

Comportamentos comprovados no código

Cada relatório possui filtros e tabelas próprios; não existe um único contrato para toda a pasta.

Vários pares usam arquivo principal + arquivo *_class.php.

Os totais dependem dos status e datas registrados nos módulos de origem.

Relatórios não devem alterar dados salvo quando a rota é explicitamente operacional.

PONTOS DE ATENÇÃO

Cuidados antes de alterar

Conferir o relatório específico antes de alterar uma consulta compartilhada.

Validar totais com um conjunto pequeno de dados conhecido.

Não mostrar dados pessoais em exemplos públicos.

Testar impressão e codificação além da visualização na tela.

TESTE MÍNIMO

Validação após manutenção

Escolher um período com dados conhecidos.
Executar relatórios de entradas, saídas, contas e serviços.
Comparar totais com as tabelas de origem.
Gerar um comprovante ou recibo de teste.
Testar período sem registros.
Confirmar impressão e caracteres em português.

Fonte da documentação

Conteúdo conferido no snapshot agenda.barberbot(1).zip e no esquema barberbotcom_agenda(1).sql. Quando o código não comprova um comportamento, ele não é apresentado como regra.

Evidências principais: rel/rel_produtos.php • rel/rel_entradas.php • rel/rel_saidas.php • rel/rel_comissoes.php • rel/rel_contas.php • rel/rel_servicos.php • rel/rel_lucro.php

REFERÊNCIA COMPLETA

Documentação detalhada existente

Relatórios — mapa técnicoArquivos reais e padrão da pasta rel. Relatórios financeirosVisão focada em valores e contas.