Fluxo: alertar manutenção na data prevista

O cron localiza manutenções previstas para hoje, monta a mensagem, tenta o envio e atualiza o registro quando o envio é aceito.

Entrada: cron/alerta_manutencao.php Tabelas: manutencoes_protese, clientes e proteses 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 ou cron/texto.php
cron -> UPDATE após o envio ser aceito

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`	Primeira opção de envio quando o arquivo existe.
`cron/texto.php`	Alternativa de envio quando o arquivo principal não existe.
`cron/timezone_cron.php`	Carregado somente quando existe.
`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 carrega `cron/timezone_cron.php` quando existe e depois 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 usa `../ajax/api-texto.php` quando existe; caso contrário, usa `cron/texto.php`.
6. Marcação de estado	O cron atualiza `alerta_manutencao_enviado = 1` e `data_alerta_manutencao = NOW()` somente quando o envio é considerado aceito.
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`	`bb_cron_data_hoje()` quando disponível; caso contrário, `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` ou `cron/texto.php`
`Banco`	Marcação de alerta enviado
`Texto console`	Resumo do processamento

Pontos críticos de manutenção

O cron exige que exista `ajax/api-texto.php` ou `cron/texto.php`; sem os dois arquivos, a execução é interrompida.
A marcação do banco ocorre no mesmo cron e depende do resultado considerado pelo fluxo de envio.
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