Este mapa serve para localizar a peça certa do módulo antes de editar código. Ele responde: onde o fluxo nasce, quais arquivos do painel intermediam a operação, quais tabelas armazenam o resultado e quais dependências externas sustentam a rotina.
O BarberBot trata prótese capilar como um subconjunto especializado do painel administrativo. O cliente é a entidade comum. Em cima dela o sistema adiciona a ficha de prótese, o registro de análise, a simulação visual e a manutenção posterior. A camada pública existe mais como vitrine/comunicação do que como motor do fluxo administrativo.
| Bloco | Responsabilidade principal | Onde geralmente surge bug |
|---|---|---|
| Interface | Abrir modal, montar formulário, acionar AJAX e exibir resposta. | Parâmetro não enviado, botão que não atualiza lista, preview quebrado, modal sem estado. |
| Endpoints | Validar entrada, consultar banco, gravar arquivo e devolver HTML/JSON/texto. | Validação ausente, SQL inseguro, retorno incompatível com o JS, inconsistência entre cadastro e edição. |
| Banco e arquivos | Persistir dados operacionais e referências a imagens. | Registro órfão, imagem não removida, relacionamento inconsistente entre cliente e prótese. |
| Integrações | Processar IA, gerar imagem, disparar alerta externo. | Chave ausente em config, timeout, diretório sem permissão, retorno inesperado da API. |