Mapa 3 — Diagrama de endpoints

Este mapa mostra a camada que realmente processa o módulo. Ele serve para rastrear chamadas AJAX, entender formatos de retorno e localizar o ponto exato onde uma ação do usuário vira operação de banco, geração de imagem ou resposta dinâmica de interface.

AJAX HTML parcial / JSON / texto Manutenção de contratos entre tela e backend

Diagrama da camada de endpoints

Telas proteses.php analises.php simulador.php manutencoes.php cron/alerta... Endpoints internos proteses/listar.php proteses/salvar.php proteses/excluir.php analises/listar.php analises/salvar.php analises/buscar_protese.php analises/processar.php analises/excluir.php simulador/listar.php simulador/salvar.php proteses/listar_por_cliente.php simulador/gerar_ia.php simulador/buscar.php simulador/salvar_canvas.php simulador/excluir.php manutencoes/listar.php manutencoes/salvar.php manutencoes/excluir.php Retorno dominante HTML parcial listar.php e listar_por_cliente.php Texto simples salvar.php / excluir.php / gerar_ia.php / salvar_canvas.php JSON analises/processar.php e buscar.php Job / saída textual cron/alerta_manutencao.php Risco clássico Mudança de formato sem ajustar o JS consumidor.

Matriz de chamadas por tela

Tela origemEndpoint chamadoTipo de retornoUso principal
proteses.phpproteses/listar.php, salvar.php, excluir.phpHTML + textoListar, cadastrar/editar e excluir.
analises.phpanalises/listar.php, salvar.php, buscar_protese.php, processar.php, excluir.phpHTML + texto + JSONListar análise, salvar foto, preencher dados da prótese e processar IA.
simulador.phpsimulador/listar.php, salvar.php, gerar_ia.php, buscar.php, salvar_canvas.php, excluir.php, proteses/listar_por_cliente.phpHTML + texto + JSONListagem, cadastro, geração IA, consulta de detalhes e salvamento do editor.
manutencoes.phpmanutencoes/listar.php, salvar.php, excluir.php, proteses/listar_por_cliente.phpHTML + textoListagem, cadastro/exclusão e carregamento dinâmico de próteses do cliente.
cron/alerta_manutencao.phpajax/api-texto.phptextoDisparar alerta de manutenção vencida via canal externo.
Ponto crítico: quando um endpoint devolve “Sucesso” em texto simples, a tela depende desse texto para decidir o próximo passo. Qualquer alteração de wording pode quebrar o JS sem gerar erro visível no PHP.
Mapa anterior: telasPróximo mapa: banco