DOCUMENTAÇÃO DE MÓDULO

Manutenção de Prótese

Registrar a manutenção da prótese, produtos e observações, calcular ou aceitar a próxima data, exibir o estado do retorno e enviar alerta no dia previsto quando houver telefone e integração disponíveis.

MóduloManutenção de Prótese

Status Produção

ResponsávelJacy Cordeiro

Última revisão02/08/2026

OBJETIVO

Finalidade do módulo

LOCALIZAÇÃO

Caminhos principais

sistema/painel/paginas/manutencoes.php

sistema/painel/paginas/manutencoes/salvar.php

sistema/painel/paginas/manutencoes/listar.php

sistema/painel/paginas/manutencoes/excluir.php

cron/alerta_manutencao.php

ajax/api-texto.php

PERSISTÊNCIA

Tabelas relacionadas

manutencoes_protese

proteses

clientes

produtos

usuarios

agendamentos

FLUXO

Sequência operacional observada

1Selecionar cliente

2Selecionar prótese

3Registrar manutenção e fatores técnicos

4Definir ou calcular próxima data

5Salvar histórico e zerar estado do alerta

6Listar situação

7Executar cron e enviar alerta no dia previsto

ENTRADAS

Dados recebidos

POST: id, cliente, id_protese, data_manutencao, tipo, produtos_utilizados, observacoes e proxima_manutencao.
Fatores: tipo_pele, nivel_sudorese, clima e tipo_adesivo.
Listagem: busca e pagina.
Cron: data atual, telefone do cliente e configuração de envio carregada pelo sistema.

SAÍDAS

Resultados produzidos

Registro ou atualização em manutencoes_protese.
Próxima data calculada quando o campo é deixado em branco.
HTML com status Vencida, Vence Hoje ou Em Dia.
Link de agendamento vinculado ao cliente e à prótese.
Alerta pelo WhatsApp e atualização de alerta_manutencao_enviado/data_alerta_manutencao.

REGRAS DE NEGÓCIO

Comportamentos comprovados no código

Cliente, prótese e data da manutenção são obrigatórios.

A combinação cliente + prótese + data é consultada para evitar duplicidade.

Quando a próxima data está vazia, o endpoint inicia em 15 dias e ajusta por pele, sudorese, clima e adesivo, com mínimo de 5 dias.

Salvar ou editar reinicia o estado do alerta.

O cron seleciona somente registros cuja próxima manutenção é exatamente a data atual e ainda não foram alertados.

PONTOS DE ATENÇÃO

Cuidados antes de alterar

A tabela possui campo usuario, mas o salvar.php analisado não o inclui no INSERT/UPDATE.

Existem outros fluxos do sistema com regras diferentes para próxima manutenção; não assumir uniformidade sem revisar todos os caminhos.

O cron depende de ajax/api-texto.php ou cron/texto.php e da configuração carregada por sistema/conexao.php.

Produtos_utilizados guarda o nome selecionado, não uma chave estrangeira no fluxo manual.

Testar o alerta com número autorizado e nunca expor telefone real na documentação.

TESTE MÍNIMO

Validação após manutenção

Cadastrar manutenção com próxima data informada.
Cadastrar outra deixando a próxima data em branco e conferir o cálculo.
Repetir cliente + prótese + data e confirmar bloqueio.
Editar o registro e confirmar que o alerta volta para não enviado.
Executar o cron com vencimento hoje e telefone de teste autorizado.
Executar novamente e confirmar que não reenvia após marcar o alerta.
Conferir status visual para data passada, hoje e futura.

Fonte da documentação

Conteúdo conferido no snapshot agenda.barberbot(1).zip e no esquema barberbotcom_agenda(1).sql. Quando o código não comprova um comportamento, ele não é apresentado como regra.

Evidências principais: manutencoes/salvar.php • manutencoes/listar.php • manutencoes.php • cron/alerta_manutencao.php

REFERÊNCIA COMPLETA

Documentação detalhada existente

Manutenções no mapa do painelReferência do item no menu real. Fluxo de registroSequência detalhada da manutenção. Fluxo do alertaCron e envio da mensagem.