Fluxo: registrar manutenção

Grava o atendimento, calcula a próxima manutenção e reseta o estado de alerta.

Entrada: sistema/painel/paginas/manutencoes.php Tabelas: manutencoes_protese, proteses, clientes Ator: Profissional ou gestor registrando manutenção de prótese já aplicada ao cliente.

Cadeia de chamada

manutencoes.php -> listarManutencoes() -> paginas/manutencoes/listar.php
manutencoes.php -> submit #form_manutencao -> paginas/manutencoes/salvar.php
salvar.php -> INSERT/UPDATE manutencoes_protese -> alerta_manutencao_enviado = 0
Esta seção responde à pergunta central de manutenção: qual arquivo chama qual arquivo dentro deste fluxo.

Arquivos envolvidos

ArquivoPapel dentro do fluxo
sistema/painel/paginas/manutencoes.phpTela principal, formulário e busca.
sistema/painel/paginas/manutencoes/listar.phpConsulta, HTML e link para agendamento.
sistema/painel/paginas/manutencoes/salvar.phpValidação, cálculo automático e INSERT/UPDATE.
sistema/painel/paginas/manutencoes/excluir.phpExclusão do histórico.

Passo a passo

EtapaO que acontece
1. ListagemA página carrega e `listarManutencoes()` consulta `listar.php` por AJAX.
2. FormulárioO modal recebe cliente, prótese, data, tipo, produtos, observações e perfil técnico da manutenção.
3. Cálculo automáticoSe `proxima_manutencao` vier vazia, `salvar.php` calcula a data com base em tipo de pele, sudorese, clima e adesivo.
4. PersistênciaO backend faz INSERT ou UPDATE em `manutencoes_protese`.
5. Reset de alertaSempre que salva, o backend força `alerta_manutencao_enviado = 0` e `data_alerta_manutencao = NULL`, rearmando o cron.
6. Pós-sucessoO modal fecha e a grade é recarregada.
7. ExclusãoA exclusão chama `manutencoes/excluir.php` via AJAX e refaz a listagem.

Entradas

EntradaOrigem/uso
clienteCliente vinculado
id_protesePrótese atendida
data_manutencaoData do atendimento
tipo_pele/nivel_sudorese/clima/tipo_adesivoBase do cálculo
proxima_manutencaoPode vir informada manualmente ou vazia

Saídas

SaídaDestino
BancoNova linha ou atualização em `manutencoes_protese`
Texto`Salvo com Sucesso` / `Excluído com Sucesso`

Pontos críticos de manutenção

  • O cálculo automático da próxima manutenção está todo no backend e não aparece antecipado no modal, o que pode confundir quem só lê o frontend.
  • O módulo depende de a prótese e o cliente estarem coerentes; isso precisa ser garantido por validação mais forte.
  • A listagem contém link de agendamento com rota fixa (`agendamentos`), que pode precisar ajuste em outras instalações.

Abrir a camada linha por linha

Tela da manutenção linha por linhaSalvar manutenção linha por linhaListagem 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 fluxosFluxo anteriorPróximo fluxo