BarberBot Software BarberBotDocumentação Técnica Visão geral
DOCUMENTAÇÃO DE MÓDULO

Simulação Visual de Prótese

Gerar e armazenar uma prévia visual vinculada ao cliente e à prótese, usando foto original, edição por IA ou canvas, mantendo original e resultado em arquivos separados.

MóduloSimulação Visual de Prótese
Status Produção
ResponsávelJacy Cordeiro
Última revisão02/08/2026
01
OBJETIVO

Finalidade do módulo

Gerar e armazenar uma prévia visual vinculada ao cliente e à prótese, usando foto original, edição por IA ou canvas, mantendo original e resultado em arquivos separados.

02
LOCALIZAÇÃO

Caminhos principais

sistema/painel/paginas/simulador.php
sistema/painel/paginas/simulador/buscar.php
sistema/painel/paginas/simulador/gerar_ia.php
sistema/painel/paginas/simulador/canvas.php
sistema/painel/paginas/simulador/salvar.php
sistema/painel/paginas/simulador/salvar_canvas.php
sistema/painel/paginas/simulador/listar.php
sistema/painel/images/simulacoes/
03
PERSISTÊNCIA

Tabelas relacionadas

simulacoes_protese
clientes
proteses
config
04
FLUXO

Sequência operacional observada

1Selecionar cliente e prótese
2Carregar ou enviar foto original
3Definir parâmetros técnicos
4Gerar por IA ou ajustar no canvas
5Salvar a imagem simulada
6Listar comparação e permitir envio
05
ENTRADAS

Dados recebidos

  • POST: cliente, id_protese, data_simulacao, observacoes, foto_original_atual e imagem_simulada_atual.
  • IA/canvas: imagem, img, ação e parâmetros carregados da prótese.
  • GET id em rotas que abrem uma simulação específica.
  • Telefone para envio quando o fluxo de WhatsApp é utilizado.
06
SAÍDAS

Resultados produzidos

  • Foto original e imagem simulada em sistema/painel/images/simulacoes/.
  • Registro em simulacoes_protese.
  • Imagem gerada pela API ou pelo canvas.
  • HTML de comparação antes/depois.
  • Mensagem ou envio externo quando solicitado.
07
REGRAS DE NEGÓCIO

Comportamentos comprovados no código

Cliente, prótese e data vinculam o registro da simulação.

A foto original deve permanecer separada da imagem simulada.

Os parâmetros vêm da prótese selecionada e devem permanecer associados ao registro.

Os arquivos aceitos e a gravação são validados nos endpoints.

08
PONTOS DE ATENÇÃO

Cuidados antes de alterar

A prévia visual não garante resultado físico idêntico.

Não sobrescrever a foto original ao salvar o resultado.

Validar permissões da pasta e limites de upload.

Falha da API ou do WhatsApp deve ser tratada sem perder registros já salvos.

Imagens reais não devem aparecer em documentação pública sem autorização.

09
TESTE MÍNIMO

Validação após manutenção

  1. Criar simulação com cliente e prótese válidos.
  2. Confirmar que original e simulada são arquivos diferentes.
  3. Gerar pela IA e salvar o resultado.
  4. Abrir o canvas, salvar e recarregar a comparação.
  5. Testar falha de API e arquivo inválido.
  6. Verificar que o portal/listagem mostra somente o vínculo esperado.
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: simulador.php • simulador/gerar_ia.php • simulador/canvas.php • simulador/salvar.php • simulador/salvar_canvas.php • simulador/listar.php

10
REFERÊNCIA COMPLETA

Documentação detalhada existente

Simulador no mapa do painelReferência do item no menu real. simulador.php — linha por linhaTela principal sincronizada com o snapshot. canvas.php — linha por linhaEditor visual documentado.