Raiz do projeto
barberhub/
├── admin/ Painel administrativo global
├── barbearia/ Painel do proprietário
├── barbeiro/ Painel do barbeiro
├── cliente/ Marketplace e agendamentos do cliente
├── wiki/ Esta documentação (/wiki)
├── config/ local.php · production.php · env.php
├── includes/ Auth, billing, layout, MP, notificações
├── assets/ CSS, JS, ícones SVG inline
├── database/ schema.sql, migrações PHP, seeds
├── cron/ Jobs agendados (assinaturas, lembretes)
├── webhooks/ mercadopago.php
├── uploads/ Logos, fotos (barbeiros, produtos)
├── index.php Landing page
├── login.php Cadastro/login proprietário
├── install.php Instalação inicial do banco
└── notificacoes.php API JSON de notificações
Pastas protegidas (.htaccess)
config/ — 403 direto
database/ — 403 direto
uploads/ — bloqueio de scripts PHP
Convenções PHP
- Cada área tem
helpers.php com funções de domínio
- Páginas incluem
auth.php, layout.php, chamam guards (requireProprietario, etc.)
- POST + redirect + flash toast para ações
- Migrações incrementais em
database/migrate_*.php — rodadas via Admin → Migrações
Assets JavaScript
| Arquivo | Uso |
panel.js | Sidebar, modais, confirmações, toggle lista/cards |
notifications.js | Polling do sino, popup, push |
mp-card-brick.js | Formulário seguro Mercado Pago |
payment-wait.js | Aguardando confirmação de pagamento |
onboarding.js | Wizard de configuração |
barber-crop.js / product-crop.js | Recorte de imagens |