BarberBot Software BarberBotDocumentação Técnica Visão geral
DOCUMENTAÇÃO DE MÓDULO

Clientes

Manter o cadastro central dos clientes utilizados pela agenda, contratos, cobranças, próteses, análises, simulações, manutenções e portal do cliente.

MóduloClientes
Status Produção
ResponsávelJacy Cordeiro
Última revisão02/08/2026
01
OBJETIVO

Finalidade do módulo

Manter o cadastro central dos clientes utilizados pela agenda, contratos, cobranças, próteses, análises, simulações, manutenções e portal do cliente.

02
LOCALIZAÇÃO

Caminhos principais

sistema/painel/paginas/clientes.php
sistema/painel/paginas/clientes/listar.php
sistema/painel/paginas/clientes/salvar.php
sistema/painel/paginas/clientes/quick_save.php
sistema/painel/paginas/clientes/excluir.php
sistema/painel/paginas/clientes/salvar-contrato.php
sistema/painel/paginas/clientes/gerar_cobranca.php
03
PERSISTÊNCIA

Tabelas relacionadas

clientes
receber
cobrancas
contratos
proteses
manutencoes_protese
config
04
FLUXO

Sequência operacional observada

1Abrir listagem e pesquisar
2Cadastrar ou editar dados
3Validar telefone e duplicidade
4Gravar cliente e senha inicial criptografada
5Enviar mensagem de acesso quando configurado
6Usar o cliente em contratos, cobranças e demais módulos
05
ENTRADAS

Dados recebidos

  • POST principal: id, nome, telefone, data_nasc, endereco, cartao e cpf.
  • Cadastro rápido: nome e whatsapp.
  • Contrato/cobrança: cliente, conteúdo do contrato, valores, parcelas, vencimentos e forma de pagamento.
06
SAÍDAS

Resultados produzidos

  • Registro ou atualização em clientes.
  • Retornos de texto para o painel e retorno OK/DUP/ERRO no cadastro rápido.
  • Hash da senha inicial para novos clientes.
  • Mensagem de boas-vindas e acesso pelo WhatsApp quando a integração está configurada.
  • Contratos, cobranças e contas vinculadas ao cliente.
07
REGRAS DE NEGÓCIO

Comportamentos comprovados no código

O telefone é verificado para evitar duplicidade no cadastro principal.

O cadastro rápido normaliza o número e consulta duplicidade pelos dígitos.

Novos clientes recebem senha inicial “123” armazenada com password_hash.

O cliente passa a ser a referência usada pelos demais módulos.

08
PONTOS DE ATENÇÃO

Cuidados antes de alterar

A senha inicial fixa faz parte do comportamento atual; qualquer mudança precisa preservar o primeiro acesso do cliente.

Não expor telefone, CPF, endereço, contrato ou credenciais em logs e documentação pública.

O envio de WhatsApp não deve impedir o salvamento do cadastro rápido.

Revisar dependências antes de excluir clientes com histórico relacionado.

09
TESTE MÍNIMO

Validação após manutenção

  1. Cadastrar um cliente válido e confirmar o registro.
  2. Tentar cadastrar novamente o mesmo telefone.
  3. Executar o cadastro rápido com telefone válido e duplicado.
  4. Editar dados e confirmar que os vínculos existentes permanecem.
  5. Abrir o portal com o número cadastrado e validar o primeiro acesso.
  6. Gerar um contrato ou cobrança de teste e confirmar o vínculo com o cliente.
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: clientes/salvar.php • clientes/quick_save.php • clientes/salvar-contrato.php • clientes/listar.php

10
REFERÊNCIA COMPLETA

Documentação detalhada existente

Clientes — arquivo por arquivoLeitura detalhada dos arquivos operacionais.