Automações fora do painel

Pasta /cron do BarberBot

Esta página fecha a auditoria da área /cron com foco em manutenção real: quais scripts existem, o que cada um faz, quais tabelas tocam e onde a automação conversa com financeiro, marketing, prótese capilar, segurança e mensageria.

Execução automática Cobrança e lembretes Segurança Conciliação de pagamento

10

Arquivos PHP em /cron

0

Subpastas em /cron

5

Frentes automáticas mapeadas

0

Lacunas no recorte /cron

Como ler a pasta /cron

Diferente de /paginas, a pasta /cron não é orientada a tela. Cada arquivo é uma entrada operacional que pode ser disparada pelo agendador do servidor, por execução manual via CLI ou, em casos de teste, por URL direta.

Entrada típica

Agendador do servidor → arquivo PHP específico → ../sistema/conexao.php → tabelas do sistema → integrador de mensagem/pagamento.

Risco recorrente

Como a rotina roda sem interface, bugs costumam aparecer como “nada aconteceu” ou “mensagem duplicada”, então logs e flags de status são fundamentais.

Pontos mais acoplados

cron_verificar_pagamentos.php, cron_marketing.php e alerta_manutencao.php conversam com áreas externas ao painel.

Alertas financeiros automáticos

Rotinas que varrem contas vencendo ou vencidas e disparam mensagens/flags de alerta sem passar pelo painel.

cron/cron_alerta_pagar.php Consulta contas a pagar e marca/alerta vencimentos. Tabelas: pagar • Include: ../sistema/conexao.php, texto.php • Uso: alerta de contas a pagar.
cron/cron_alerta_receber.php Consulta contas a receber com cliente válido e dispara alerta de cobrança. Tabelas: clientes, receber • Include: ../sistema/conexao.php, texto.php • Uso: cobrança no vencimento.
cron/cron_alerta_vencidas.php Varre contas a receber vencidas e notifica clientes, evitando repetição por cliente no mesmo ciclo. Tabelas: clientes, receber • Include: ../sistema/conexao.php, texto.php • Uso: cobrança de contas vencidas.

Prótese capilar e pós-serviço

Rotina especializada de manutenção de prótese, integrada com clientes, próteses e envio via WhatsApp.

cron/alerta_manutencao.php Busca próximas manutenções em manutencoes_protese, monta link de agendamento e aciona ajax/api-texto.php. Tabelas: manutencoes_protese, clientes, proteses • Integração: ../ajax/api-texto.php • Uso: lembrete de manutenção de prótese.

Marketing e mensageria

Processa disparos agendados e usa arquivos auxiliares de envio por texto e arquivo.

cron/cron_marketing.php Seleciona disparos pendentes, trava lote e processa envio com suporte a UTF-8 completo. Tabelas: disparos, marketing • Include: ../sistema/conexao.php, texto.php, marketing_file.php • Uso: lote de campanhas.
cron/marketing_file.php Envia mídia/documento para a API de mensageria. Extras: cURL • Uso: envio de arquivo/documento para API de mensageria.
cron/texto.php Envia mensagem de texto para Menuia ou EnviaMe. Extras: cURL ou file_get_contents • Uso: envio de texto para provedores externos.

Conciliação e verificação de pagamentos

Rotina automática que cruza receber/agendamentos_temp com integrações de pagamento e executa baixa/confirmação.

cron/cron_verificar_pagamentos.php Inclui Asaas, pagamentos/consultar_pagamento.php, pagamento_aprovado.php e baixar_conta.php para conciliar status. Tabelas: agendamentos_temp, receber • Includes: integrações Asaas + pagamentos/* • Uso: conciliação automática.

Segurança e utilitários

Scripts especiais fora do fluxo normal do painel.

cron/cron_security.php Varredura de segurança do public_html com modo teste, debug e envio de alerta ao administrador. Parâmetros: test, to, debug • Tabelas: config • Extras: cURL • Uso: varredura e alerta de segurança.
cron/teste_data.php Script simples de teste/apoio para datas e execução manual. Uso: apoio manual/diagnóstico de data e timezone.

Exemplos de agendamento

Referência operacional para o próximo dev ou para o time de infraestrutura validar o cron do servidor.

/usr/bin/php /home/USUARIO/public_html/cron/cron_alerta_receber.php >/dev/null 2>&1
/usr/bin/php /home/USUARIO/public_html/cron/cron_marketing.php >/dev/null 2>&1
/usr/bin/php /home/USUARIO/public_html/cron/cron_verificar_pagamentos.php >/dev/null 2>&1

Pontos críticos de manutenção

Esses pontos explicam por que um cron pode “parar de funcionar” mesmo sem erro visível no painel.

  • cron_security.php só deve rodar como script principal; quando incluído por outra tela ele retorna imediatamente.
  • cron_verificar_pagamentos.php depende de includes externos em /asaas, /asaas_contas e /pagamentos; qualquer alteração nessas integrações afeta a conciliação.
  • alerta_manutencao.php depende da existência de ajax/api-texto.php e da configuração correta do link base de agendamento.
  • texto.php e marketing_file.php conversam com provedores externos; credenciais e falhas de cURL impactam vários cron jobs ao mesmo tempo.

Relações externas mais importantes

A pasta /cron toca outras áreas do projeto. A manutenção correta exige seguir os includes e não analisar o arquivo isoladamente.

alerta_manutencao.php
→ ../sistema/conexao.php
→ clientes, proteses, manutencoes_protese
→ ../ajax/api-texto.php
cron_verificar_pagamentos.php
→ ../sistema/conexao.php
→ ../asaas/status.php, ../asaas_contas/status.php
→ ../pagamentos/*
cron_marketing.php
→ ../sistema/conexao.php
→ disparos, marketing
→ texto.php e marketing_file.php
cron_security.php
→ varredura do public_html
→ config
→ alerta ao administrador por mensageria
Abrir cobertura conjunta de /cron + /pagamentos