Mapa estrutural auditado

Estrutura real do BarberBot

Esta página foi ajustada com base na estrutura real do projeto, e não apenas em uma visão resumida. O objetivo é permitir que o próximo dev saiba quais pastas existem de fato, por onde começar e em qual diretório investigar cada tipo de problema.

auditoria real foco no painel leitura por diretório manutenção orientada
Leitura inicial

O BarberBot tem uma estrutura mais ampla do que a doc mostrava

Antes desta revisão, a documentação destacava apenas uma parte das pastas. Depois da conferência com o barberbot.zip, a leitura da estrutura passou a considerar a árvore real do projeto.

Pastas na raiz 21
Diretórios no 2º nível 48
Subpastas em /sistema/painel/paginas 57
Correção aplicada estrutura auditada
Mapa por grupo

Pastas principais do projeto

Organização prática para o dev localizar rápido a área correta do sistema.

Núcleo do sistema

/sistema

Core principal do BarberBot: autenticação, conexão, painel administrativo, vendor e recursos internos.

/sistema/painel

Painel administrativo com layout, verificações, funções auxiliares, relatórios, PDF e módulos.

/sistema/painel/paginas

Centro funcional do sistema. Contém as telas principais e 57 subpastas operacionais.

/sistema/painel_cliente

Área/painel voltado ao cliente final.

/sistema/public

Arquivos públicos internos usados pelo núcleo.

Integrações e comunicação

/ajax

Endpoints rápidos para chamadas assíncronas de tela, automações e utilitários.

/api

Endpoints estruturados por recurso: agenda, clientes, estoque, usuários, vendas, etc.

/webhook

Recebimento e processamento de eventos externos, com apoio em sessões.

/pagamentos

Fluxos de pagamento, confirmação, webhooks e assets próprios do checkout.

/asaas

Estrutura dedicada à integração com Asaas.

/asaas_contas

Variante de integração Asaas voltada a contas.

/asaas_planos

Variante de integração Asaas voltada a planos.

Aplicativo e interface

/app

Base do app/PWA, com assets, painel próprio e telas móveis.

/apps

Recursos complementares de frontend do app.

/css

Folhas de estilo globais.

/js

Scripts globais.

/images

Imagens, banners e resultados visuais.

/fonts

Fontes customizadas.

/libs

Bibliotecas auxiliares legadas.

Operação, suporte e ambiente

/cron

Rotinas agendadas do sistema.

/config

Configurações técnicas, licenças, OpenAI, recaptcha e boot de ambiente.

/uploads

Uploads persistidos pelo sistema.

/public

Uploads públicos.

/logs

Arquivos de log.

/tools

Ferramentas auxiliares e scripts utilitários.

Leitura operacional

Caminhos críticos de manutenção

Esses diretórios são os que mais aparecem em manutenção corretiva e evolução do sistema.

/sistema

9 subpastas diretas

Comece aqui quando o bug envolver login, conexão, permissões, bootstrap do painel ou dependências internas.

assets css dist dompdf img painel painel_cliente public vendor

/sistema/painel

13 subpastas diretas

Use esta pasta quando o problema estiver no administrativo, layout, relatórios, PDF, scripts do painel ou navegação.

DataTables assets cron css dist fonts funcoes images img js paginas pdf rel

/sistema/painel/paginas

57 subpastas diretas

É a pasta mais crítica da manutenção. Cada arquivo principal representa uma tela, e cada subpasta contém os endpoints internos do módulo.

acessos agenda agendamentos analises anotacoes assinaturas avaliacoes bio caixas calendario cargos cat_produtos cat_servicos clientes clientes_retorno cobrancas cobrancas_pagas comanda comentarios comissoes compras dias_bloqueio dias_bloqueio_func dispositivos duvidas entradas estoque faq fornecedores foto_admin frequencias funcionarios grupo_acessos grupos grupos_disparos manutencoes marketing meus_servicos minhas_comissoes pagar perguntas pgto planos produtos proteses receber receber_vencidas saidas servicos servicos_agenda simulador site tarefas textos_index usuarios vendas whatsapp

/api

17 subpastas diretas

Analise aqui integrações externas, consumo via app, clientes externos ou retornos estruturados.

agenda clientes clientes_retorno comissoes compras dias estoque fornecedores funcionarios home horarios login pagar receber servicos usuarios vendas

/app/painel

12 subpastas diretas

Use quando o bug estiver no app, assets móveis, plugins do app ou painel complementar.

app ckeditor5 css fonts images js paginas php plugins scripts scss styles

/pagamentos/assets

3 subpastas diretas

Suporte ao checkout e páginas de pagamento.

css img js
Correção aplicada

O que a documentação anterior não estava mostrando

O caso mais claro estava em /sistema/painel/paginas: a doc anterior listava 53 subpastas, mas o projeto atual possui 57. As quatro subpastas que faltavam eram:

analises proteses simulador manutencoes

Além disso, a visão de estrutura não destacava várias pastas reais da raiz, como /asaas, /asaas_contas, /asaas_planos, /logs, /tools, /uploads, /public e /webhook.

Regra de leitura

Como o próximo dev deve navegar no projeto

Comece pelo fluxo, não pelo arquivo aleatório

Identifique primeiro se o problema nasce na tela, em um endpoint AJAX, em uma API, no cron ou no banco.

Depois entre no diretório certo

Problema administrativo quase sempre cai em /sistema/painel/paginas. Integração externa tende a cair em /api, /ajax, /pagamentos ou /webhook.

Confirme a tabela usada

Se o endpoint lista, salva, busca ou exclui, o próximo passo é descobrir qual tabela ele usa e qual regra está sendo aplicada.

Não confie em resumo antigo

Quando houver dúvida, confira a pasta real do projeto. Esta página já foi atualizada para reduzir esse gap.

Leitura complementar

Páginas relacionadas

Arquivos, pastas e subpastas Visão mais detalhada da árvore real.
Subpastas de /sistema/painel/paginas Mapa funcional das 57 subpastas do painel.
Arquitetura por pastas Leitura por camada e papel de cada diretório.
Auditoria real de pastas Checklist objetivo do que existe na árvore real.