PRIMEIRO ENVIO

2025-12-25 12:02:07 -03:00
parent ca49575224
commit c4d3bd9a86
92 changed files with 26976 additions and 1 deletions
@@ -0,0 +1,163 @@
+# 🔧 Solução de Problemas - CloneWeb
+
+## Problemas Comuns e Soluções
+
+### ❌ Erro: "Failed to load resource: 404 (Not Found)"
+
+**Causa**: Recurso não encontrado ou serviço não iniciado corretamente.
+
+**Soluções**:
+1. **Verificar se os serviços estão rodando**:
+   ```bash
+   # Verificar se as portas estão em uso
+   netstat -an | findstr :3000
+   netstat -an | findstr :3001
+   ```
+
+2. **Reiniciar os serviços**:
+   ```bash
+   # Parar processos existentes
+   taskkill /f /im node.exe
+   
+   # Iniciar novamente
+   cd simple-crawler
+   npm start
+   
+   # Em outro terminal
+   cd web-interface  
+   npm start
+   ```
+
+3. **Usar os scripts de inicialização**:
+   - Execute `start-app.bat` ou `start-app.ps1`
+
+### ⚠️ Erro: "Content Security Policy directive violated"
+
+**Causa**: Política de segurança bloqueando recursos.
+
+**Solução**: Já corrigido na versão atual. Se persistir:
+1. Limpe o cache do navegador (Ctrl+Shift+Delete)
+2. Recarregue a página (F5 ou Ctrl+F5)
+3. Tente em modo anônimo/privado
+
+### 🚫 Erro: "Crawler service unavailable"
+
+**Causa**: Serviço do crawler não está rodando na porta 3001.
+
+**Soluções**:
+1. **Verificar se a porta está livre**:
+   ```bash
+   netstat -an | findstr :3001
+   ```
+
+2. **Iniciar o crawler manualmente**:
+   ```bash
+   cd simple-crawler
+   npm start
+   ```
+
+3. **Verificar dependências**:
+   ```bash
+   cd simple-crawler
+   npm install
+   ```
+
+### 📁 Erro: "Não foi possível abrir a pasta"
+
+**Causa**: Problema com permissões ou caminho inválido.
+
+**Soluções**:
+1. **Abrir manualmente**: Navegue até a pasta `cloned-sites/`
+2. **Verificar permissões**: Execute como administrador
+3. **Caminho alternativo**: Copie o caminho da pasta dos resultados
+
+### 🌐 Erro: "Não foi possível abrir o site"
+
+**Causa**: Arquivo index.html não encontrado ou corrompido.
+
+**Soluções**:
+1. **Verificar se o arquivo existe**: `cloned-sites/[site]/index.html`
+2. **Abrir manualmente**: Clique duplo no arquivo `index.html`
+3. **Usar o script**: Execute `abrir-site.bat` na pasta do clone
+
+### 🕷️ Erro durante o crawling: "Assignment to constant variable"
+
+**Causa**: Erro no código (já corrigido).
+
+**Solução**: Reinicie o serviço do crawler:
+```bash
+# Parar o crawler
+Ctrl+C no terminal do crawler
+
+# Iniciar novamente
+npm start
+```
+
+### 📦 Poucos assets baixados
+
+**Causa**: Site usa assets externos ou protegidos.
+
+**Explicação**: Normal para alguns sites. O sistema baixa apenas assets acessíveis publicamente.
+
+### 🔄 Site não funciona offline
+
+**Possíveis causas**:
+1. **JavaScript externo**: Site depende de APIs externas
+2. **CDNs**: Recursos hospedados em CDNs não foram baixados
+3. **CORS**: Políticas de segurança do navegador
+
+**Soluções**:
+1. Alguns sites podem ter funcionalidade limitada offline
+2. Sites estáticos funcionam melhor
+3. Teste com sites simples primeiro
+
+## 🚀 Dicas de Uso
+
+### Sites que funcionam bem:
+- ✅ Sites estáticos (HTML/CSS simples)
+- ✅ Blogs e sites de notícias
+- ✅ Páginas de documentação
+- ✅ Sites com poucos recursos externos
+
+### Sites que podem ter limitações:
+- ⚠️ SPAs (Single Page Applications)
+- ⚠️ Sites com muitas APIs externas
+- ⚠️ Aplicações web complexas
+- ⚠️ Sites com autenticação
+
+### Melhor performance:
+1. **Teste com sites simples primeiro**
+2. **Aguarde o processo completo** (pode demorar para sites grandes)
+3. **Verifique a conexão com internet** durante o processo
+4. **Use URLs completas** (https://exemplo.com)
+
+## 📞 Suporte
+
+Se os problemas persistirem:
+1. Verifique os logs nos terminais dos serviços
+2. Reinicie completamente o sistema
+3. Teste com um site simples como https://example.com
+4. Verifique se todas as dependências estão instaladas
+
+## 🔄 Reinicialização Completa
+
+Para resolver a maioria dos problemas:
+
+```bash
+# 1. Parar todos os processos Node.js
+taskkill /f /im node.exe
+
+# 2. Aguardar 5 segundos
+
+# 3. Iniciar novamente
+start-app.bat
+```
+
+Ou use o PowerShell:
+```powershell
+# 1. Parar processos
+Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force
+
+# 2. Iniciar novamente  
+.\start-app.ps1
+```