Leitura rápida do recorte
O bloco /app contém a parte operacional e executável. Já /apps e /public
funcionam como suporte estático e runtime. Essa distinção evita muito retrabalho em debug.
/app
25 PHP + 933 arquivos
PWA / interface mobile com painel embutido
Concentra autenticação, recuperação de senha, service worker, manifest e um painel mobile próprio em /app/painel. É a parte mais viva do recorte.
PWA
auth
painel mobile
service-worker
- Entrada pública em app/index.php + autenticação em app/autenticar.php.
- Recuperação de acesso em alterar-senha.php, recuperar-senha.php e resetar-senha.php.
- Painel mobile em app/painel com shell, menus, cabeçalho, rodapé e verificação de permissões.
- Mini-módulos internos em app/painel/paginas: agenda, clientes, dias, dias_bloqueio_func, meus_servicos, minhas_comissoes e servicos_func.
/apps
0 PHP + 9 arquivos
Espelho de assets estáticos
Não possui lógica PHP. Funciona como diretório auxiliar de CSS e JS reaproveitados por interfaces mobile ou páginas públicas.
assets
css
js
sem PHP
- Possui apenas apps/css e apps/js.
- Replica arquivos como bootstrap.css, swiper.css, style.css e bootstrap.min.js.
- Deve ser tratado como pacote estático, não como módulo de negócio.
/public
0 PHP + 2 arquivos
Artefatos públicos de runtime
No estado atual do projeto, serve como armazenamento público para uploads do site. O recorte auditado mostra somente public/uploads/site.
uploads
runtime
site
sem PHP
- A pasta public/uploads/site contém arquivos enviados e publicados no front.
- Não deve ser tratada como fonte de regras de negócio.
- Mudanças nessa área impactam disponibilidade de mídia e URL pública.
Arquivos PHP reais em /app
O código executável do recorte está todo em /app. O resto é suporte visual, cache, plugins ou runtime público.
Abaixo está a trilha principal para o próximo dev começar.
app/index.php
app/autenticar.php
app/alterar-senha.php · app/recuperar-senha.php · app/resetar-senha.php
app/painel/index.php
app/painel/verificar_permissoes.php · app/painel/logout.php
app/painel/cabecalho.php · menu-lateral.php · rodape.php
app/painel/paginas/agenda.php · clientes.php · dias.php · dias_bloqueio_func.php · meus_servicos.php · minhas_comissoes.php · servicos_func.php
app/painel/php/contact.php
Regra prática de manutenção
1Se o problema for login, sessão ou acesso, começar em
/app.2Se o bug estiver no painel mobile, seguir para
/app/painel/index.php e depois shell + páginas internas.3Se for layout, ícones, PWA, splash, cache ou scripts, revisar assets em
/app e /apps.4Se o sintoma for arquivo/imagem pública quebrada, revisar
/public/uploads/site e a URL consumida no front.Grupos internos de /app
Esse agrupamento ajuda o próximo dev a não se perder em meio a plugins, imagens, SCSS, CKEditor e páginas internas do painel mobile.
Autenticação e recuperação
Fluxo de entrada do app/PWA e recuperação de senha do usuário.
app/index.phpapp/autenticar.phpapp/alterar-senha.phpapp/recuperar-senha.phpapp/resetar-senha.phpapp/alertas.php
Shell do painel mobile
Estrutura-base que monta menu, cabeçalho, rodapé, alertas e controle de permissões.
app/painel/index.phpapp/painel/cabecalho.phpapp/painel/menu-lateral.phpapp/painel/menu-cores.phpapp/painel/menu-highlights.phpapp/painel/menu-pagar.phpapp/painel/menu-receber.phpapp/painel/rodape.phpapp/painel/verificar_permissoes.phpapp/painel/logout.phpapp/painel/alertas.php
Páginas internas do painel mobile
Recorte enxuto de módulos voltados ao uso mobile / operacional.
app/painel/paginas/agenda.phpapp/painel/paginas/clientes.phpapp/painel/paginas/dias.phpapp/painel/paginas/dias_bloqueio_func.phpapp/painel/paginas/meus_servicos.phpapp/painel/paginas/minhas_comissoes.phpapp/painel/paginas/servicos_func.php
Assets e runtime que não devem ser lidos como módulo
Nem tudo que existe nessas pastas é “fonte de regra”. Há muito conteúdo de suporte que deve ser tratado como camada estática ou operacional.
app/_manifest.json · app/_service-worker.js · app/painel/service-worker.js
app/css · app/js · app/images · app/app/icons · app/app/splash
app/painel/css · js · images · plugins · scss · styles · ckeditor5
apps/css · apps/js
public/uploads/site/*
Achados que valem atenção
O diretório /app mistura PWA, painel mobile, mídia, SCSS, plugins e CKEditor. Ele é maior do que um simples “front mobile”.
Há service worker e manifest tanto em /app quanto em /app/painel, o que exige cautela com cache e invalidação em deploy.
O diretório /apps não possui PHP e deve ser lido como espelho estático, não como módulo de execução.
O diretório /public também não possui PHP; ele representa artefatos públicos de runtime, principalmente uploads do site.
Os sete arquivos em /app/painel/paginas não substituem o painel principal do sistema; eles são um recorte operacional mobile.
Resumo objetivo para manutenção
Este bloco está fechado. O que ainda resta fora do painel não está aqui: sobram principalmente /config,
utilitários residuais e alguns artefatos de suporte fora do núcleo já auditado.
Leitura certa para o próximo dev:
/app = execução mobile/PWA e shell de painel. /apps = pacote estático. /public = runtime público de uploads.
Tratar tudo isso como um único “módulo de negócio” gera análise errada e manutenção confusa.