Fluxo: alertar manutenção vencida

O cron localiza manutenções vencidas, monta mensagem e delega o envio ao script de WhatsApp.

Entrada: cron/alerta_manutencao.php Tabelas: manutencoes_protese, clientes, proteses, config (indiretamente pelo envio) Ator: Scheduler do servidor, sem interação direta do usuário final.

Cadeia de chamada

agendamento do servidor -> cron/alerta_manutencao.php
cron -> SELECT manutencoes_protese + clientes + proteses
cron -> include ../ajax/api-texto.php
cron -> UPDATE manutencoes_protese.alerta_manutencao_enviado = 1

Esta seção responde à pergunta central de manutenção: qual arquivo chama qual arquivo dentro deste fluxo.

Arquivos envolvidos

Arquivo	Papel dentro do fluxo
`cron/alerta_manutencao.php`	Script principal de varredura e disparo.
`ajax/api-texto.php`	Canal real de envio da mensagem para WhatsApp.
`sistema/conexao.php`	Fonte de conexão e variáveis globais do sistema.

Passo a passo

Etapa	O que acontece
1. Disparo externo	O servidor chama `cron/alerta_manutencao.php` via agendador do sistema operacional.
2. Boot do script	O cron define timezone, habilita erros e carrega `sistema/conexao.php`.
3. Consulta principal	O script busca manutenções com `proxima_manutencao < hoje` e cujo alerta ainda não foi enviado.
4. Montagem da mensagem	Para cada registro, o cron monta um texto com nome do cliente, prótese e link para agendamento.
5. Delegação do envio	O envio real acontece por `include($arquivo_envio)`, que aponta para `../ajax/api-texto.php`.
6. Marcação de estado	Se passou pelo fluxo, o cron atualiza `alerta_manutencao_enviado = 1` e grava `data_alerta_manutencao = NOW()`.
7. Resposta operacional	Ao final, o script imprime total de alertas enviados e ignorados para facilitar diagnóstico manual.

Entradas

Entrada	Origem/uso
`Data atual`	`date('Y-m-d')`
`rota_agendamento`	Configurada no próprio cron
`telefone do cliente`	Lido da tabela `clientes`

Saídas

Saída	Destino
`Mensagem externa`	Enviada via `api-texto.php`
`Banco`	Marcação de alerta enviado
`Texto console`	Resumo do processamento

Pontos críticos de manutenção

O cron assume que `ajax/api-texto.php` existe e está operacional; se esse arquivo mudar, o alerta para de funcionar.
A marcação do banco ocorre no mesmo script de envio. Sem logs extras, depurar falha intermitente fica difícil.
O link de agendamento é composto a partir de variáveis de ambiente e rota fixa; configuração incorreta gera link quebrado na mensagem.

Abrir a camada linha por linha

Cron linha por linha

Use estes links quando já souber qual arquivo do fluxo precisa ser alterado e quiser leitura minuciosa do código.

Voltar ao índice de fluxos Fluxo anterior