Arquivos

O que é o módulo Arquivos

O módulo Arquivos é o gerenciador centralizado de mídia do Bunto ERP. Ele controla todos os arquivos enviados pelos usuários e pelos módulos — imagens de produtos, fotos de clientes, anexos de pedidos, XMLs de notas fiscais, PDFs de contratos, vídeos de treinamento — com quota por empresa, organização por módulo e armazenamento em S3 (AWS) ou filesystem local.

Ele trabalha em segundo plano na maior parte do tempo: você raramente precisa entrar no módulo diretamente, porque os uploads acontecem nos formulários dos outros módulos. A tela dedicada serve para auditoria, limpeza e visualização consolidada.

Como acessar

No menu lateral, acesse Sistema → Arquivos. Rota: /arquivos.

Tela principal

Cards de resumo

• Todas as mídias — total de arquivos e tamanho ocupado.
• Por tipo — imagem, vídeo, áudio, documento, PDF, planilha.
• Por módulo — clientes, produtos, pedidos, notas fiscais, contratos, cada um com seu tamanho.
• Gráfico de armazenamento — quanto da quota total foi usada.

Listagem

Lista detalhada com nome original, tipo, tamanho, módulo de origem, data de criação e usuário que enviou. Filtros por tipo, módulo e período.

Operações

• Upload — arrastar e soltar ou selecionar pelo seletor.
• Visualizar — preview para imagens, vídeos e PDFs direto na tela.
• Baixar — download do arquivo original.
• Renomear.
• Excluir — apaga do S3 ou do filesystem.
• Compartilhar — gera um link público que permite acesso sem autenticação.

Estrutura

Cada arquivo tem nome original, nome interno (UUID único para evitar colisões), extensão, tipo MIME, tamanho em bytes, módulo de origem, usuário que enviou, empresa, flag de público ou privado e status.

O sistema resolve o caminho automaticamente com base no módulo, evitando conflitos entre empresas.

Integrações com outros módulos

Praticamente todos os módulos usam o gerenciador de arquivos para seus anexos:

• Clientes — logo, documentos, comprovantes.
• Produtos — imagens, manuais, fichas técnicas.
• Pedidos e notas fiscais — XMLs e PDFs anexados.
• Contratos — documentos assinados.
• RH — holerites, atestados, documentos do colaborador.
• Propostas — anexos comerciais.
• Restaurante — imagens de pratos, comanda física personalizada.

Storage

Em produção, o Bunto usa S3 (AWS). Em desenvolvimento, pode usar filesystem local. A escolha é transparente para o usuário.

Os nomes de arquivos são UUIDs internos, evitando conflitos entre empresas e garantindo que downloads solicitados com o nome original funcionem sem expor a estrutura interna.

Permissões

• Visualizar arquivos.
• Fazer upload.
• Excluir arquivos.
• Compartilhar (tornar público).
• Visualizar estatísticas (dashboard e quota).

Perguntas frequentes

Qual o limite de tamanho por arquivo?

Depende da configuração do storage. Em S3, o limite prático costuma ser de alguns gigabytes por arquivo. Para arquivos muito grandes, consulte o suporte.

Onde os arquivos ficam armazenados?

No S3 da AWS em produção. Cada empresa tem um prefixo próprio que garante isolamento.

Posso gerar um link público para um cliente?

Sim. Use a opção Compartilhar — o link público permite acesso direto sem login. Cuidado com dados sensíveis.

Como recupero um arquivo excluído?

A exclusão é definitiva. Mantenha backups externos e use a exclusão com cuidado. Em casos críticos, contate o suporte — dependendo da política de versionamento do S3, ainda pode haver como recuperar.

Como saber quanto da minha quota já foi usada?

O gráfico de armazenamento no topo da tela mostra o uso total contra o limite contratado. Se estiver próximo do limite, considere excluir arquivos antigos ou solicitar ampliação.