REFERÊNCIA TÉCNICA PARA DESENVOLVEDORES
Ambiente documentado do BarberBot
Visão inicial para localizar instalação, arquitetura, módulos, banco de dados, integrações e procedimentos seguros de manutenção.
FLUXO PRINCIPAL
Visão resumida da operação
Cliente
Agenda
Atendimento
Pagamento
Histórico
Fluxo especializado de prótese vinculado ao atendimento
Prótese
Análise
Simulação
Manutenção
MÓDULOS DESTACADOS
Acesso direto
Conteúdo conferido no snapshot agenda.barberbot(1).zip e na estrutura do banco
barberbotcom_agenda(1).sql. A documentação deve ser atualizada sempre que o código ou o banco forem alterados.
SNAPSHOT VERIFICADO
Fonte conferida em 02/08/2026 21:45
Dimensão da versão analisada
GUIAS POR OBJETIVO
Rotas de trabalho detalhadas
Conteúdo complementar para preparação do ambiente, leitura da arquitetura, manutenção de módulos e publicação segura.
Começar a desenvolver
Preparação do ambiente e primeiro acesso ao código.
Arquitetura
Visão das camadas e dos pontos de integração.
Módulos principais
Acesso direto às áreas mais usadas na manutenção.
Manutenção segura
Controles mínimos antes de alterar ou publicar.
ARQUITETURA OBSERVADA NO SNAPSHOT
Abrir arquitetura detalhada →
Visão técnica do fluxo da aplicação
Resumo das camadas identificadas nos arquivos do BarberBot. Os nomes abaixo representam caminhos e responsabilidades observados no código enviado.
Cliente / Navegador
Acesso por computador ou dispositivo móvel.
Site público / Painel / Portal do cliente
raiz do projeto · sistema/painel · sistema/painel_cliente
Controladores e páginas PHP
sistema/ · sistema/painel/paginas/ · arquivos PHP da raiz
- AJAXRequisições assíncronas e endpoints encontrados em pastas e arquivos AJAX.
- Sessão e permissõesAutenticação, sessão e verificações de acesso nos painéis.
- Regras de negócioFluxos implementados nos módulos, páginas e rotinas PHP.
- Integrações externasChamadas para serviços configurados no sistema.
MySQL / MariaDB
conexão observada em sistema/conexao.php
SEGURANÇA OPERACIONAL
Regras para alterar sem promessas genéricas
Escopo das afirmações técnicas
O snapshot analisado contém uso de PHP, PDO, MySQL, AJAX, JavaScript, jQuery e Bootstrap. Essa identificação registra tecnologias encontradas nos arquivos e não afirma que todos os módulos utilizam o mesmo padrão.
Padrão para código novo: módulos novos devem utilizar consultas preparadas, validação das entradas, controle de sessão e autorização no servidor.
Consultas SQL: consultas que recebem dados externos devem utilizar prepare() e parâmetros vinculados. Arquivos legados devem ser revisados antes de qualquer alteração.
AMBIENTE
Instalação e configuração
A conexão observada está em sistema/conexao.php. O arquivo .env do snapshot contém parâmetros de licença e alertas, não substitui a configuração atual do banco. O manual foi corrigido para refletir esses caminhos.
MANUTENÇÃO E EVOLUÇÃO
Como manter esta documentação confiável
Atualize a documentação junto com o código.
Quando um arquivo, tabela, endpoint ou regra mudar, atualize a página correspondente, registre a data e gere um novo hash do snapshot. A documentação atual representa apenas os arquivos conferidos nesta revisão.
CONTROLE DE ALTERAÇÕES
Versão 2026.08
Changelog da documentação
02/08/2026Organização profissional da página inicial
- Abertura técnica com versão, stack, ambiente, responsável e data.
- Quatro acessos rápidos para desenvolvimento, arquitetura, módulos e manutenção segura.
- Menu reorganizado sem itens repetidos e com nomenclatura padronizada.
- Links direcionados somente para páginas existentes no portal técnico.
- Diagrama inicial da arquitetura com camadas do navegador ao banco e serviços externos identificados.
- Mapa do Código com as 21 pastas da raiz, pontos de entrada e cuidados antes de alterar.
- Primeira tela reorganizada com versão, seis acessos rápidos, fluxo principal, módulos destacados e aviso técnico.
RESPONSÁVEL
BarberBot Software
Documentação técnica organizada para continuidade do desenvolvimento e manutenção do sistema.
Jacy Cordeirojacy@jc.tec.brbarberbot.com.br