Pessoas

Clientes: arquivo por arquivo

Cadastro central de clientes, com listagem, cobrança, contratos, débitos e atalhos de cadastro rápido.

tela principal: clientes.php subpasta: /sistema/painel/paginas/clientes/ 15 arquivos internos auditados clientes.php monta a tela, chama clientes/listar.php via AJAX e aciona salvar/excluir/fluxos auxiliares do cliente.

tela

/sistema/painel/paginas/clientes.php

listar

presente

salvar

presente

buscar

não encontrado

excluir

presente

Navegação rápida

Visão do módulo

clientes.php monta a tela, chama clientes/listar.php via AJAX e aciona salvar/excluir/fluxos auxiliares do cliente.

Tela principal

/sistema/painel/paginas/clientes.php

Pasta operacional

/sistema/painel/paginas/clientes/

Arquivos auxiliares

12 arquivos além do CRUD padrão.

Padrão observado

Sem endpoint buscar.php explícito na subpasta auditada.

Leitura recomendada: abra a tela principal, depois listar.php, salvar.php, excluir.php e por fim os auxiliares que fazem a regra de negócio específica.

Tabela resumida

Arquivo Tipo Papel no módulo Entradas POST Tabelas tocadas
clientes.php
/sistema/painel/paginas/clientes.php 		tela principal Monta a interface do módulo, filtro de busca, modal e gatilhos JavaScript para listagem e cadastro. — formas_pgtofrequenciasprodutosservicos
baixar.php
/sistema/painel/paginas/clientes/baixar.php 		auxiliar Baixa cobrança/recebimento do cliente e registra pagamento. data_baixaforma_pgtoidresiduovalor_final cobrancasreceber
data_extenso.php
/sistema/painel/paginas/clientes/data_extenso.php 		helper Converte data para formato por extenso e serve de apoio em contratos/textos. — —
excluir.php
/sistema/painel/paginas/clientes/excluir.php 		excluir Exclui o cliente diretamente pela chave primária. id clientes
excluir_marketing.php
/sistema/painel/paginas/clientes/excluir_marketing.php 		auxiliar Retira o cliente da base de marketing sem excluir o cadastro principal. id clientes
gerar_cobranca.php
/sistema/painel/paginas/clientes/gerar_cobranca.php 		auxiliar Gera mensagem/link de cobrança para o cliente. datadescricaoid_parjurosmultaparcelatelefonevalor receber
listar-debitos.php
/sistema/painel/paginas/clientes/listar-debitos.php 		auxiliar Mostra débitos/contas em aberto do cliente. idpagina clientesreceber
listar.php
/sistema/painel/paginas/clientes/listar.php 		listar Lista clientes com busca e paginação, renderizando HTML para o painel. buscapagina clientesreceberservicos
listar_cobrancas.php
/sistema/painel/paginas/clientes/listar_cobrancas.php 		auxiliar Lista cobranças relacionadas ao cliente. id receber
mostar_parcelas.php
/sistema/painel/paginas/clientes/mostar_parcelas.php 		auxiliar Exibe parcelas de cobrança ou empréstimo. O nome do arquivo está com grafia legada ("mostar"). id_empmostrar clientes
quick_save.php
/sistema/painel/paginas/clientes/quick_save.php 		auxiliar Cadastro rápido usado em fluxos ágeis quando só nome e WhatsApp são necessários. nomewhatsapp —
recorrencia.php
/sistema/painel/paginas/clientes/recorrencia.php 		auxiliar Cria cobranças recorrentes com base em frequência e parcelas. clientedata_vencfrequenciaidid2obsparcelasvalor clientescobrancasfrequenciasreceber
salvar-contrato.php
/sistema/painel/paginas/clientes/salvar-contrato.php 		auxiliar Salva o contrato textual do cliente. contratoid contratos
salvar.php
/sistema/painel/paginas/clientes/salvar.php 		salvar Insere ou atualiza clientes, valida telefone e cria senha padrão no cadastro novo. cartaocpfdata_nascenderecoidnometelefone clientes
texto-contrato.php
/sistema/painel/paginas/clientes/texto-contrato.php 		auxiliar Monta o texto do contrato com dados do cliente e da cobrança. idreceber_idservico_nomevalor clientesreceberusuarios
valor.php
/sistema/painel/paginas/clientes/valor.php 		auxiliar Retorna valor de produto usado em fluxos auxiliares do módulo. produt produtos

Arquivo por arquivo

Cada card abaixo resume o papel do arquivo, volume aproximado de código, entradas esperadas e dependências visíveis para acelerar manutenção e depuração.

clientes.php

/sistema/painel/paginas/clientes.php
tela principal

Monta a interface do módulo, filtro de busca, modal e gatilhos JavaScript para listagem e cadastro.

Linhas: 930
POST: sem POST explícito detectado
Sessão: sem leitura explícita de sessão
Tabelas: formas_pgto, frequencias, produtos, servicos
Includes: ../conexao.php, verificar.php

baixar.php

/sistema/painel/paginas/clientes/baixar.php
auxiliar

Baixa cobrança/recebimento do cliente e registra pagamento.

Linhas: 150
POST: data_baixa, forma_pgto, id, residuo, valor_final
Sessão: id
Tabelas: cobrancas, receber
Includes: ../../../../ajax/api-excluir.php, ../../../conexao.php

data_extenso.php

/sistema/painel/paginas/clientes/data_extenso.php
helper

Converte data para formato por extenso e serve de apoio em contratos/textos.

Linhas: 37
POST: sem POST explícito detectado
Sessão: sem leitura explícita de sessão
Tabelas: sem tabela literal detectada
Includes: sem include adicional relevante

excluir.php

/sistema/painel/paginas/clientes/excluir.php
excluir

Exclui o cliente diretamente pela chave primária.

Linhas: 8
POST: id
Sessão: sem leitura explícita de sessão
Tabelas: clientes
Includes: ../../../conexao.php

excluir_marketing.php

/sistema/painel/paginas/clientes/excluir_marketing.php
auxiliar

Retira o cliente da base de marketing sem excluir o cadastro principal.

Linhas: 9
POST: id
Sessão: sem leitura explícita de sessão
Tabelas: clientes
Includes: ../../../conexao.php

gerar_cobranca.php

/sistema/painel/paginas/clientes/gerar_cobranca.php
auxiliar

Gera mensagem/link de cobrança para o cliente.

Linhas: 62
POST: data, descricao, id_par, juros, multa, parcela, telefone, valor
Sessão: sem leitura explícita de sessão
Tabelas: receber
Includes: ../../../../ajax/api-texto.php, ../../../conexao.php

listar-debitos.php

/sistema/painel/paginas/clientes/listar-debitos.php
auxiliar

Mostra débitos/contas em aberto do cliente.

Linhas: 167
POST: id, pagina
Sessão: sem leitura explícita de sessão
Tabelas: clientes, receber
Includes: ../../../conexao.php

listar.php

/sistema/painel/paginas/clientes/listar.php
listar

Lista clientes com busca e paginação, renderizando HTML para o painel.

Linhas: 364
POST: busca, pagina
Sessão: sem leitura explícita de sessão
Tabelas: clientes, receber, servicos
Includes: ../../../conexao.php

listar_cobrancas.php

/sistema/painel/paginas/clientes/listar_cobrancas.php
auxiliar

Lista cobranças relacionadas ao cliente.

Linhas: 114
POST: id
Sessão: sem leitura explícita de sessão
Tabelas: receber
Includes: ../../../conexao.php

mostar_parcelas.php

/sistema/painel/paginas/clientes/mostar_parcelas.php
auxiliar

Exibe parcelas de cobrança ou empréstimo. O nome do arquivo está com grafia legada ("mostar").

Linhas: 187
POST: id_emp, mostrar
Sessão: sem leitura explícita de sessão
Tabelas: clientes
Includes: ../../../conexao.php

quick_save.php

/sistema/painel/paginas/clientes/quick_save.php
auxiliar

Cadastro rápido usado em fluxos ágeis quando só nome e WhatsApp são necessários.

Linhas: 166
POST: nome, whatsapp
Sessão: sem leitura explícita de sessão
Tabelas: sem tabela literal detectada
Includes: sem include adicional relevante

recorrencia.php

/sistema/painel/paginas/clientes/recorrencia.php
auxiliar

Cria cobranças recorrentes com base em frequência e parcelas.

Linhas: 234
POST: cliente, data_venc, frequencia, id, id2, obs, parcelas, valor
Sessão: id
Tabelas: clientes, cobrancas, frequencias, receber
Includes: ../../../../ajax/api-agendar.php, ../../../../ajax/api-excluir.php, ../../../../ajax/api-texto.php, ../../../conexao.php

salvar-contrato.php

/sistema/painel/paginas/clientes/salvar-contrato.php
auxiliar

Salva o contrato textual do cliente.

Linhas: 23
POST: contrato, id
Sessão: sem leitura explícita de sessão
Tabelas: contratos
Includes: ../../../conexao.php

salvar.php

/sistema/painel/paginas/clientes/salvar.php
salvar

Insere ou atualiza clientes, valida telefone e cria senha padrão no cadastro novo.

Linhas: 50
POST: cartao, cpf, data_nasc, endereco, id, nome, telefone
Sessão: sem leitura explícita de sessão
Tabelas: clientes
Includes: ../../../../ajax/api-texto.php, ../../../conexao.php

texto-contrato.php

/sistema/painel/paginas/clientes/texto-contrato.php
auxiliar

Monta o texto do contrato com dados do cliente e da cobrança.

Linhas: 222
POST: id, receber_id, servico_nome, valor
Sessão: id
Tabelas: clientes, receber, usuarios
Includes: ../../../conexao.php

valor.php

/sistema/painel/paginas/clientes/valor.php
auxiliar

Retorna valor de produto usado em fluxos auxiliares do módulo.

Linhas: 21
POST: produt
Sessão: sem leitura explícita de sessão
Tabelas: produtos
Includes: ../../../conexao.php

Pontos de manutenção

  • Validar duplicidade por telefone e CPF antes de alterar salvar.php.
  • Fluxos de cobrança e contrato estão dentro da mesma subpasta; mudanças no cadastro podem impactar gerar_cobranca.php, recorrencia.php e texto-contrato.php.
  • Há vários endpoints auxiliares além do CRUD tradicional. Antes de mexer no módulo, revisar a lista inteira da subpasta.
Voltar para visão geral Abrir guia de depuração Abrir padrão de módulo