Documentação Técnica - Frontend BarberBot

Esta seção descreve o funcionamento do frontend (site público), explicando a função de cada pasta/arquivo e como o site se conecta ao backend. A estrutura abaixo foi atualizada conforme o print enviado (raiz do projeto) e os arquivos PHP do pacote do site.

📦 Estrutura de Pastas (Raiz do Projeto)

Pastas na raiz do projeto:

AJAXajax/ – Endpoints para requisições assíncronas consumidas pelas páginas (ex.: login, cadastro, salvar agendamento).
WEBHOOKwebhook/ – Recebimento de callbacks de serviços externos (ex.: pagamentos/assinaturas).
APIapi/ – API do sistema (retornos JSON, integrações e consultas).
ASAASasaas/ – Integração com Asaas (rotinas gerais).
ASAASasaas_contas/ – Integração Asaas: contas (clientes/contas, vínculo).
ASAASasaas_planos/ – Integração Asaas: planos/assinaturas (planos, recorrência).
ASSETSfonts/ – Fontes do frontend.
ASSETSjs/ – Scripts do frontend (validações, máscaras, chamadas Ajax/API).
LOGlogs/ – Logs do projeto (erros/retornos). Não expor publicamente.
APPSapps/ – Módulos auxiliares do projeto (miniapps/integrações).
CFGconfig/ – Configurações (ambiente, chaves, conexão, constantes).
ASSETScss/ – Estilos do site (layout/responsivo).
UPLOADuploads/ – Uploads públicos (fotos/arquivos). Exigir validação no backend.
ASSETSimages/ – Imagens do site (banners/ícones).
APPapp/ – Estrutura de app/PWA (quando usada).
PUBLICpublic/ – Conteúdo público adicional (assets/rotas estáticas).
PAGpagamentos/ – Fluxos e rotinas de pagamento (Pix/cartão, baixa/retorno).
TOOLStools/ – Scripts utilitários (manutenção/diagnóstico/migrações).
CRONcron/ – Rotinas agendadas (lembretes, avisos, verificações).

📄 Páginas principais do frontend

index.php

Página inicial do sistema. Apresenta a interface de entrada com links para login, cadastro e visualização de serviços.

Carrega arquivos como cabecalho.php e rodape.php
Layout responsivo com HTML/CSS e seções de conteúdo

home.php

Tela inicial após login (cliente/usuário, conforme regra do projeto).

Exibe dados do cliente e atalhos
Quando necessário, carrega dados via Ajax/API

cadastrar.php

Formulário de cadastro (cliente/usuário).

Campos HTML5 + validação
Envia dados para endpoints em ajax/ (padrão do BarberBot)

meus-agendamentos.php

Página onde o cliente pode visualizar seus agendamentos.

Renderiza dados recebidos do backend
Permite ações como cancelar/reagendar (dependendo das regras)

📑 Outras páginas do frontend (site público)

agendamentos.php: fluxo/tela de agendamento (seleção, confirmação, etc.)
servicos.php: listagem dos serviços oferecidos
produtos.php: apresentação de produtos
politica-play.php: termos de uso e política
assinar.php / assinatura.php: início e detalhes de assinatura
obrigado.php: página de sucesso (pós conversão/pagamento)
barbearia.php, barber.php, corte-cabelo.php, mechas.php, protese.php: páginas de conteúdo/SEO (landings)
bio.php: página de apresentação/bio
contador-visitas.php: contador/registro de visitas
diagnostico.php / meu-ip.php: utilitários (usar com cuidado em produção)
security.php: rotinas de segurança
funcoes_webp.php / gerar_webp.php: otimização de imagens (WebP)
otimizador.php / seo_otimizador.php: otimizações e SEO
sitemap.xml / sitemap-index.xml: sitemaps
.htaccess: regras de rewrite/cache/segurança no Apache

🔌 Integração Frontend ⇄ Backend

Ajax: ações de formulário chamam ajax/ e recebem retorno para atualizar a tela sem reload.
API: listagens/consultas (agenda/serviços/status) podem chamar api/ e receber JSON.
Pagamentos/Assinaturas: rotinas ficam em pagamentos/ e integrações externas retornam em webhook/.
Segurança: validação real sempre no backend; no frontend apenas UX/validação básica.