Caminho no Gestor modulos/admin-arquivos/
Gerencia a árvore física de arquivos sob contents-path: navega pastas, envia arquivos, cria miniaturas, renomeia, exclui e associa categorias. O cadastro individual em arquivos é legado e não alimenta a listagem atual.
Como usar
Abra admin-arquivos/ para navegar, filtrar por data/categoria e alternar visualização. Crie ou renomeie pastas, selecione arquivos, copie seus caminhos ou exclua itens. Em admin-arquivos/adicionar/, escolha a pasta de destino e envie arquivos por seletor ou arrastar e soltar; categorias podem ser associadas durante o upload ou depois. O painel oferece galeria de prévia e seleção para outros editores. As rotas são iguais nos dois idiomas. admin-arquivos/emissao-teste/ consta no JSON sem opção de controlador.
Referência técnica
O controlador despacha listar-arquivos e upload. AJAX administrativo: navegar, uploadFile, miniaturas, excluir, pasta-criar, renomear, categorias-arquivo. Não há widget, template, hooks ou hooks.api no JSON. O JS usa jQuery File Upload, pede páginas e miniaturas em lotes e mantém a seleção do seletor de mídia.
admin_arquivos_ler_pasta() varre o disco, ignora arquivos ocultos e a pasta mini, põe pastas antes dos arquivos, filtra por data/categoria e pagina apenas arquivos. Padrões do JSON: 24 arquivos por página, lotes de cinco miniaturas, 20 MB por upload, largura de miniatura 200. Miniaturas usam GD apenas quando a função de leitura/gravação do formato está disponível. A biblioteca arquivo valida caminho relativo, bloqueia extensão perigosa, higieniza o nome e resolve colisões. Excluir uma pasta não vazia requer recursivo=true; renomear move miniatura e associações de categoria.
A relação corrente é arquivos_disco_categorias: id_arquivos_disco_categorias, caminho até 1024, caminho_hash MD5, id_categorias, data_criacao, com unicidade (caminho_hash,id_categorias). A tabela antiga arquivos contém id_arquivos, nome, tipo, caminho, miniatura, permissão e estado; arquivos_categorias associa seus IDs, mas o fluxo atual não cria registros individuais nela. O filtro de categorias cruza hashes dos caminhos listados com a tabela nova.
Limitações confirmadas
Veja também
Controles do painel Tailwind
O seletor tem bandeja das miniaturas escolhidas e botão Confirmar; selecione antes de confirmar. A galeria abre centralizada. Upload, pasta e listagem são o fluxo comum; escopo e cota podem ser restringidos por filtros do projeto.
Convenções compartilhadas: Interface administrativa.