Primeiros Passos
Como executar o projeto?
Para executar o projeto corretamente:
- Abra o terminal/prompt de comando
- Navegue até a pasta do projeto
- Execute:
npm start - Abra:
http://localhost:8000
Importante: Não abra o arquivo HTML diretamente. Use sempre um servidor local.
Por que preciso de um servidor local?
O projeto é uma PWA (Progressive Web App) que utiliza:
- Service Workers: Para cache offline e funcionalidades avançadas
- Manifest: Para instalação como app
- APIs modernas: Que requerem HTTPS ou localhost
Essas funcionalidades não funcionam com o protocolo file://.
Quais navegadores são suportados?
Navegadores modernos com suporte a:
- Chrome 67+ - Suporte completo
- Firefox 68+ - Suporte completo
- Safari 11.1+ - Suporte completo
- Edge 79+ - Suporte completo
Não suportado: Internet Explorer
Funcionalidades
Quais tipos de arquivo são suportados?
O app suporta mais de 50 tipos de arquivo:
- Imagens: JPG, PNG, GIF, SVG, WebP, BMP, TIFF
- Vídeos: MP4, AVI, MOV, WMV, FLV, WebM
- Áudios: MP3, WAV, FLAC, AAC, OGG
- Documentos: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX
- Arquivos: ZIP, RAR, 7Z, TAR, GZ
- Executáveis: EXE, MSI, APP, DEB, RPM
Como funciona a detecção de duplicatas?
A detecção usa múltiplas estratégias:
- Hash SHA-256: Comparação exata de conteúdo
- Nome e tamanho: Detecção por metadados
- Confiança: Classificação de precisão
Arquivos com hash idêntico são considerados duplicatas exatas.
Os arquivos são enviados para a internet?
Não! Todos os processamentos são feitos localmente:
- ✅ Análise no seu navegador
- ✅ Armazenamento local (localStorage)
- ✅ Sem envio de dados
- ✅ Privacidade total
Seus arquivos nunca saem do seu computador.
Configurações
Como configurar o limite de arquivos grandes?
Para configurar o limite:
- Vá para a seção "Configurações"
- Encontre "Limite de arquivos grandes"
- Digite um valor entre 1 e 1000 MB
- A configuração é salva automaticamente
Arquivos acima deste limite serão destacados.
Como exportar meus dados?
Para exportar seus dados:
- Vá para "Configurações"
- Clique em "Exportar Dados"
- Escolha o formato (JSON ou CSV)
- O arquivo será baixado automaticamente
Você pode usar este arquivo para backup ou importar em outro dispositivo.
Como limpar todos os dados?
Atenção: Esta ação não pode ser desfeita!
- Vá para "Configurações"
- Clique em "Limpar Todos os Dados"
- Confirme a ação
Isso removerá todos os arquivos, categorias e configurações.
PWA e Instalação
Como instalar o app no meu dispositivo?
Para instalar como PWA:
- Chrome/Edge: Clique no ícone de instalação na barra de endereços
- Safari: Compartilhar → Adicionar à Tela Inicial
- Firefox: Menu → Instalar App
- Mobile: Compartilhar → Adicionar à Tela Inicial
O app funcionará offline após a instalação.
O app funciona offline?
Sim! Após a primeira visita:
- ✅ Interface carrega offline
- ✅ Dados salvos localmente
- ✅ Funcionalidades básicas disponíveis
- ⚠️ Análise de novos arquivos requer conexão
O Service Worker gerencia o cache automaticamente.
Como atualizar o app?
Atualizações são automáticas:
- 🔄 Verificação automática de novas versões
- 🔔 Notificação quando há atualização
- 🔄 Recarregue a página para aplicar
- ⚡ Cache é atualizado automaticamente
Você será notificado quando uma nova versão estiver disponível.
Solução de Problemas
O Service Worker não está registrando
Possíveis causas e soluções:
- Protocolo incorreto: Use
http://localhost:8000 - Navegador antigo: Atualize para versão recente
- Cache: Limpe o cache do navegador
- Extensões: Desabilite extensões que bloqueiam SW
Verifique o console (F12) para mensagens de erro específicas.
Erro de "localStorage cheio"
Para resolver problemas de armazenamento:
- Limpe dados antigos em "Configurações"
- Remova arquivos desnecessários
- Exporte e limpe dados antigos
- Use backup automático
O app gerencia automaticamente o espaço disponível.
Arquivos não estão sendo analisados
Verifique os seguintes pontos:
- Tamanho: Arquivos muito grandes podem falhar
- Tipo: Verifique se o tipo é suportado
- Permissões: Navegador precisa de permissão
- Memória: Muitos arquivos simultâneos
Tente analisar arquivos menores ou em lotes menores.
Atalhos de Teclado
Quais atalhos estão disponíveis?
Atalhos de teclado disponíveis:
- Ctrl/Cmd + O: Abrir seletor de arquivos
- Ctrl/Cmd + S: Exportar dados
- Esc: Fechar modais
- Tab: Navegação entre elementos
- Enter/Espaço: Ativar elementos
Use Tab para navegar e Enter para ativar elementos.