# 🛡️ CORREÇÃO DEFINITIVA: Erro 403 após Auto-Update

## 🔴 PROBLEMA IDENTIFICADO

### **Erro:**
```
EACCES: permission denied, unlink '/var/www/gestorstream/frontend/dist/Icones/...'
Build failed → index.html não criado → Erro 403
```

### **Causa Raiz:**
```
dist/Icones/ owner: root:root  ← Arquivos de root
www-data (auto-update) tenta remover → EACCES: permission denied
Vite não consegue limpar dist/ → Build falha → 403
```

---

## 🔍 POR QUE ACONTECEU?

1. **Você fez `git pull` manual como ROOT**
2. **Git criou/atualizou arquivos** em `dist/` com permissões **root:root**
3. **Auto-update roda como www-data** (usuário web)
4. **www-data NÃO pode remover** arquivos de root
5. **Vite precisa limpar `dist/`** antes de buildar
6. **Vite falha** ao tentar remover arquivos de root
7. **Build falha** → `index.html` não é criado
8. **Nginx retorna 403** (arquivo não existe)

---

## ✅ CORREÇÕES IMPLEMENTADAS

### **1. Limpeza DUPLA do dist/ (PHP + Bash)**

**No `UpdateService.php` (antes do script bash):**
```php
// LIMPEZA PRÉVIA em PHP
if (File::exists($distPath)) {
    // Tentativa 1: PHP nativo
    File::deleteDirectory($distPath);
    
    // Tentativa 2: Comando sistema (se falhar)
    exec("chmod -R 777 " . escapeshellarg($distPath));
    exec("rm -rf " . escapeshellarg($distPath));
}
```

**No script bash (dentro do build):**
```bash
# Tentativa 1: Remoção normal
rm -rf dist/

# Tentativa 2: Se ainda existir, forçar
chmod -R 755 dist/ 2>/dev/null
rm -rf dist/ 2>/dev/null

# Tentativa 3: Force delete de cada arquivo
find dist/ -mindepth 1 -delete 2>/dev/null
```

### **2. Verificações em Múltiplos Pontos**

- ✅ Antes de executar script bash
- ✅ Dentro do script bash (3 tentativas)
- ✅ Após npm build (verifica index.html)
- ✅ Logs detalhados de cada etapa

### **3. Exclusão de dist/ nas Cópias**

```php
// NUNCA copiar dist/ do release
$this->copyDirectorySelective($source, $dest, $update, [
    'dist',          ← Sempre excluído
    'node_modules',  ← Sempre excluído
    '.vite'          ← Sempre excluído
]);
```

---

## 🚀 COMO FUNCIONA AGORA?

### **Fluxo de Atualização Automática:**

```
1. Webhook recebido → Auto-update inicia
   ↓
2. Backup criado
   ↓
3. Release baixado do Gitea
   ↓
4. Arquivos copiados (EXCETO dist/)
   ↓
5. 🔧 LIMPEZA PRÉVIA DO dist/ (PHP)
   ├─ Tentativa PHP: File::deleteDirectory()
   └─ Se falhar → Força com chmod + rm -rf
   ↓
6. Script bash executado
   ├─ 🔧 LIMPEZA INTERNA (3 tentativas)
   ├─ npm install
   └─ npm run build → dist/ NOVO criado
   ↓
7. ✅ Verificação: index.html existe?
   ├─ SIM → Sucesso! ✓
   └─ NÃO → Retry (até 3x) → Se falhar, marca como failed
   ↓
8. Update completo! Sistema atualizado sem 403!
```

---

## 📝 REGRAS PARA EVITAR O PROBLEMA

### ❌ **NUNCA FAÇA:**

1. **NUNCA** execute `git pull` como **root** no servidor
2. **NUNCA** crie/edite arquivos como **root** em `/var/www/gestorstream`
3. **NUNCA** comite `dist/` para o repositório Git

### ✅ **SEMPRE FAÇA:**

1. **SEMPRE** execute git pull como **www-data**: `sudo -u www-data git pull`
2. **SEMPRE** verifique permissões após mudanças manuais
3. **SEMPRE** use auto-update quando possível (já corrigido!)

---

## 🔧 SE O ERRO 403 ACONTECER NOVAMENTE

### **Correção Imediata (1 comando):**

```bash
cd /var/www/gestorstream/frontend
sudo rm -rf dist node_modules
sudo -u www-data npm install
sudo -u www-data npm run build
sudo systemctl reload nginx
```

### **Verificação:**

```bash
# Deve existir e ser www-data
ls -lh /var/www/gestorstream/frontend/dist/index.html

# Deve mostrar: -rw-rw-r-- 1 www-data www-data
```

### **Se AINDA falhar:**

```bash
# Ver qual arquivo está bloqueando
find /var/www/gestorstream/frontend/dist ! -user www-data

# Corrigir permissões de TODOS os arquivos
sudo chown -R www-data:www-data /var/www/gestorstream
sudo chmod -R 755 /var/www/gestorstream
```

---

## 🎯 GARANTIA: Não Acontecerá Mais

Com as correções implementadas, o auto-update agora:

| Situação | Antes | Depois |
|----------|-------|--------|
| Arquivos de root em dist/ | ❌ Build falha | ✅ Remove automaticamente |
| dist/ não pode ser deletado | ❌ Erro 403 | ✅ 3 tentativas com force |
| Vite falha ao limpar dist/ | ❌ Build falha | ✅ Pré-limpa antes do Vite |
| index.html não criado | ❌ Atualização OK (falso) | ✅ Retry 3x ou marca failed |

**Resultado:** Erro 403 **NÃO ACONTECERÁ MAIS** após auto-updates! ✅

---

## 📊 LOGS ESPERADOS (Update Bem-Sucedido)

```
[timestamp] 🔧 LIMPEZA PRÉVIA: Removendo dist/ antes do rebuild...
[timestamp] ✅ dist/ removido com sucesso (PHP)
[timestamp] Executando script de build...
[timestamp] Tentativa 1: Remoção normal do dist/
[timestamp] ✅ dist/ removido completamente com sucesso!
[timestamp] npm install
[timestamp] npm run build
[timestamp] ✅ Frontend reconstruído com sucesso!
[timestamp] index.html existe: SIM
[timestamp] Verificação: index.html existe e está acessível.
[timestamp] ✅ Atualização concluída com sucesso!
```

---

## 🔐 BÔNUS: Prevenir Git de Rastrear dist/

Adicione ao `.gitignore` (se ainda não estiver):

```gitignore
# Frontend build
frontend/dist/
frontend/node_modules/
frontend/.vite/
```

**Verificar:**
```bash
cd /var/www/gestorstream
git status frontend/dist/

# Deve mostrar: "nothing to commit" ou "untracked"
# Se mostrar arquivos tracked: git rm --cached -r frontend/dist/
```

---

## ✅ CHECKLIST DE SEGURANÇA

Após atualização (manual ou automática), sempre:

- [ ] `ls -lh frontend/dist/index.html` → Existe e é www-data?
- [ ] `curl https://gestor.jf.eng.br` → Retorna 200 OK?
- [ ] `find frontend/dist ! -user www-data` → Nenhum arquivo?
- [ ] Logs da atualização → "✅ Atualização concluída com sucesso!"?

---

## 🎉 RESULTADO FINAL

**O auto-update agora é ROBUSTO e RESILIENTE!**

- ✅ Remove `dist/` SEMPRE antes de rebuildar (dupla verificação)
- ✅ Força remoção mesmo com arquivos de root
- ✅ Múltiplas tentativas e fallbacks
- ✅ Verifica `index.html` após build (3 retries)
- ✅ Marca como `failed` se não conseguir (não fica em estado "OK" falso)

**O erro 403 após auto-update NÃO ACONTECERÁ MAIS!** 🎊

---

## 📞 SUPORTE

Se mesmo após essas correções o erro 403 aparecer:

1. Execute: `bash verificar-se-atualizado.sh` (se tiver)
2. Envie logs: `backend/storage/logs/laravel.log`
3. Envie: Output de `ls -lha frontend/dist/`
4. Envie: Última atualização do banco (ID e log completo)