Storage & Arquivos

Armazenamento centralizado e inteligente para sua operação

O módulo Storage & Arquivos oferece gerenciamento centralizado de todos os arquivos da sua organização. Com upload direto para S3 (DigitalOcean Spaces), seus arquivos são armazenados com segurança, redundância e alta disponibilidade via CDN global.

Cada organização possui uma quota de armazenamento definida pelo seu plano, com visibilidade clara de uso por módulo: propostas, contratos, anexos de tickets, gravações de reuniões e muito mais. O painel de storage mostra exatamente onde o espaço está sendo utilizado.

O sistema suporta preview inline de imagens e PDFs, versionamento de arquivos, links de compartilhamento com expiração e operações em lote para gerenciar grandes volumes de documentos.

A integração nativa com todos os módulos do SniperSell garante que arquivos enviados em tickets, propostas ou projetos fiquem organizados e acessíveis em um único lugar, sem duplicação e com rastreabilidade completa.

Bucket / Espaço

Contêiner de armazenamento S3 onde os arquivos são salvos fisicamente. Cada organização tem um namespace isolado dentro do bucket, garantindo separação total de dados entre tenants.

Quota

Limite de armazenamento por organização, definido pelo plano contratado. O sistema monitora uso em tempo real e envia alertas ao se aproximar do limite (80%, 90%, 100%).

Breakdown por Módulo

Visualização do consumo de storage separado por origem: propostas, contratos, tickets, reuniões, base de conhecimento, etc. Permite identificar onde otimizar.

Upload Direto (Presigned URL)

Arquivos são enviados diretamente do navegador para o S3 usando URLs pré-assinadas. O servidor nunca toca no arquivo, garantindo performance e reduzindo carga no backend.

Versionamento

Ao reenviar um arquivo com o mesmo nome, a versão anterior é mantida. Histórico de versões acessível para restauração. Útil para contratos, propostas e documentos revisados frequentemente.

Link de Compartilhamento

URL temporária para compartilhar um arquivo com pessoas externas. Expira após o prazo configurado (1h, 24h, 7 dias). Não requer login no sistema.

Como usar o Storage

1. Acesse Gerir → Storage no menu lateral.
2. Visualize o dashboard com uso total, quota disponível e breakdown por módulo.
3. Navegue pela estrutura de pastas ou use a busca para encontrar arquivos.
4. Para enviar um arquivo, clique em Upload ou arraste e solte na área indicada.
5. Selecione o arquivo, defina a pasta de destino e confirme o envio.
6. Para compartilhar, clique no arquivo e selecione Gerar Link com prazo de expiração.

Dica: Na maioria dos casos, o upload acontece diretamente nos módulos (ao anexar um arquivo em um ticket, proposta ou projeto). O Storage centraliza a visualização e gestão de todos esses arquivos em um só lugar.

Formatos suportados incluem imagens (JPG, PNG, WebP), documentos (PDF, DOCX, XLSX), vídeos e qualquer outro tipo de arquivo. O limite por arquivo individual depende do plano.

Upload S3 Direto

Upload via presigned URL direto para DigitalOcean Spaces. Barra de progresso em tempo real. Suporte a múltiplos arquivos simultâneos. Drag-and-drop na interface.

Gestão de Quotas

Painel visual de uso vs. quota. Breakdown por módulo (propostas, tickets, projetos, etc.). Alertas automáticos em 80%, 90% e 100% do limite. Administradores podem solicitar aumento de quota.

Preview Inline

Visualize imagens (JPG, PNG, WebP, GIF) e PDFs diretamente no navegador sem baixar. Miniaturas geradas automaticamente para navegação rápida em listas de arquivos.

Versionamento de Arquivos

Histórico de versões para cada arquivo. Compare versões, restaure versões anteriores. Ideal para documentos que passam por revisões (contratos, propostas, manuais).

Links de Compartilhamento

Gere URLs temporárias para compartilhar com clientes ou parceiros. Defina expiração (1h a 30 dias). Sem necessidade de conta no sistema. Rastreamento de acessos.

Operações em Lote

Selecione múltiplos arquivos para mover, copiar, baixar ou excluir de uma vez. Exportação de lista de arquivos em CSV para auditoria.

Analytics de Armazenamento

Relatórios de crescimento de uso ao longo do tempo. Arquivos maiores, tipos mais comuns, módulos que mais consomem. Base para decisões de otimização e upgrade de plano.

Fluxo de Upload via Módulo

1. Usuário anexa arquivo em um ticket, proposta, projeto ou contrato.
2. Sistema solicita presigned URL ao backend.
3. Arquivo é enviado diretamente para o S3 com barra de progresso.
4. Metadados (nome, tamanho, tipo, módulo de origem) são registrados no banco.
5. Arquivo aparece tanto no contexto do módulo quanto no Storage centralizado.

Fluxo de Compartilhamento Externo

1. Usuário localiza o arquivo no Storage ou no módulo de origem.
2. Clica em "Compartilhar" e define o prazo de expiração do link.
3. Link é gerado e copiado para a área de transferência.
4. Envia o link ao destinatário (email, WhatsApp, chat).
5. Destinatário acessa o arquivo sem precisar de login.
6. Após expiração, o link deixa de funcionar automaticamente.

Fluxo de Gestão de Quota

1. Sistema monitora uso continuamente.
2. Ao atingir 80% da quota, administrador recebe alerta.
3. Administrador revisa breakdown por módulo para identificar otimizações.
4. Remove arquivos desnecessários ou solicita upgrade de plano.

Quota por Organização

Defina o limite de armazenamento por organização conforme o plano contratado. Valores em GB. Pode ser ajustado pelo administrador da plataforma a qualquer momento.

Tipos de Arquivo Permitidos

Configure quais extensões são aceitas para upload. Por padrão: imagens, PDFs, documentos Office, vídeos. Bloqueie executáveis (.exe, .bat) por segurança.

Limite por Arquivo

Tamanho máximo por arquivo individual. Configurável por plano: básico (25 MB), profissional (100 MB), enterprise (500 MB).

Retenção e Limpeza

Defina políticas de retenção: manter versões anteriores por 30, 90 ou 365 dias. Limpeza automática de arquivos órfãos (sem vínculo com nenhum registro). Lixeira com recuperação por 30 dias.

CDN e Cache

Arquivos públicos (imagens de perfil, logos) são servidos via CDN para performance global. Arquivos privados usam presigned URLs com expiração curta para segurança.

Integrações nativas do módulo Storage

• Helpdesk — Anexos de tickets armazenados no Storage. Visualização inline de imagens e PDFs na conversa do ticket.
• Propostas — PDFs de propostas geradas e anexos salvos automaticamente no Storage com versionamento.
• Projetos — Entregáveis e documentos do projeto organizados por pasta do projeto.
• Assinatura Digital — Contratos assinados armazenados com selo de integridade e versionamento.
• Meet — Gravações de reuniões salvas automaticamente no Storage vinculadas à reunião.
• Base de Conhecimento — Imagens e anexos de artigos gerenciados centralizadamente.
• Financeiro — Comprovantes de pagamento e notas fiscais anexados às faturas.

O que acontece quando a quota é atingida?

Novos uploads são bloqueados até que espaço seja liberado ou a quota seja aumentada. Arquivos existentes continuam acessíveis normalmente. O administrador recebe notificação para tomar ação.

Posso recuperar um arquivo excluído?

Sim, por até 30 dias. Arquivos excluídos vão para a lixeira, onde podem ser restaurados. Após 30 dias, a exclusão é definitiva e o espaço é liberado.

Os arquivos são criptografados?

Sim. Arquivos são criptografados em trânsito (TLS/HTTPS) e em repouso (AES-256 no servidor S3). Links de compartilhamento usam presigned URLs com expiração para controle de acesso.

Posso organizar arquivos em pastas?

Sim. Crie pastas e subpastas para organizar arquivos por cliente, projeto, departamento ou qualquer critério. Arquivos de módulos são automaticamente organizados por origem.

Qual o limite de tamanho por upload?

Depende do plano da organização. O upload direto para S3 suporta arquivos grandes sem timeout, pois não passa pelo servidor da aplicação. Verifique o limite do seu plano na seção Configurações.

Upload falha ou trava no meio

Causa: Conexão instável, arquivo excede o limite de tamanho, ou presigned URL expirou durante upload lento.

Solução: Verifique sua conexão de internet. Confirme que o arquivo está dentro do limite. Tente novamente — uma nova presigned URL será gerada automaticamente.

Preview de PDF não carrega

Causa: PDF protegido por senha, corrompido, ou muito grande para renderização inline.

Solução: Baixe o arquivo e abra localmente. Para PDFs protegidos, remova a senha antes de enviar ao sistema.

Link de compartilhamento retorna "acesso negado"

Causa: Link expirou, ou o arquivo foi excluído/movido após a geração do link.

Solução: Gere um novo link de compartilhamento a partir do arquivo. Verifique se o arquivo ainda existe no Storage.

Quota mostra uso maior que o esperado

Causa: Versões anteriores de arquivos ocupam espaço. Arquivos na lixeira ainda contam na quota. Gravações de reuniões podem consumir bastante espaço.

Solução: Revise o breakdown por módulo. Limpe versões antigas desnecessárias. Esvazie a lixeira. Considere reduzir a retenção de gravações de reuniões.