# 📁 GUIA: Renomear Pastas Removendo Caracteres Especiais

## ⚠️ IMPORTANTE - LEIA ANTES DE FAZER

Renomear as pastas é uma **EXCELENTE IDEIA** e vai resolver os problemas com PowerShell!

**Mas precisa ser feito com CUIDADO para não perder seu trabalho.**

---

## 🎯 ESTRUTURA ATUAL vs PROPOSTA

### **Atual (com problemas):**
```
C:\Users\Deyvison\OneDrive\Desktop\
└── Secretária de Esportes\
    └── Tecnologia da Informação\
        └── SGSE\
            └── sgse-app\
```

### **Proposta (sem problemas):**
```
C:\Users\Deyvison\OneDrive\Desktop\
└── Secretaria-de-Esportes\
    └── Tecnologia-da-Informacao\
        └── SGSE\
            └── sgse-app\
```

**OU ainda mais simples:**
```
C:\Users\Deyvison\OneDrive\Desktop\
└── SGSE\
    └── sgse-app\
```

---

## ✅ PASSO A PASSO SEGURO

### **Preparação (IMPORTANTE!):**

1. **Pare TODOS os servidores:**
   - Terminal do Convex: **Ctrl + C**
   - Terminal do Web: **Ctrl + C**
   - Feche o VS Code completamente

2. **Feche o Git (se estiver aberto):**
   - Não deve haver processos usando os arquivos

---

### **OPÇÃO 1: Renomeação Completa (Recomendada)**

#### **Passo 1: Fechar tudo**
- Feche VS Code
- Pare todos os terminais
- Feche qualquer programa que possa estar usando as pastas

#### **Passo 2: Renomear no Windows Explorer**

1. Abra o Windows Explorer
2. Navegue até: `C:\Users\Deyvison\OneDrive\Desktop\`
3. Renomeie as pastas:
   - `Secretária de Esportes` → `Secretaria-de-Esportes`
   - `Tecnologia da Informação` → `Tecnologia-da-Informacao`

**Resultado:**
```
C:\Users\Deyvison\OneDrive\Desktop\Secretaria-de-Esportes\Tecnologia-da-Informacao\SGSE\sgse-app\
```

#### **Passo 3: Reabrir no VS Code**

1. Abra o VS Code
2. File → Open Folder
3. Selecione o novo caminho: `C:\Users\Deyvison\OneDrive\Desktop\Secretaria-de-Esportes\Tecnologia-da-Informacao\SGSE\sgse-app`

---

### **OPÇÃO 2: Simplificação Máxima (Mais Simples)**

Mover tudo para uma pasta mais simples:

#### **Passo 1: Criar nova estrutura**

1. Abra Windows Explorer
2. Navegue até: `C:\Users\Deyvison\OneDrive\Desktop\`
3. Crie uma nova pasta: `SGSE-Projetos`

#### **Passo 2: Mover o projeto**

1. Vá até a pasta atual: `Secretária de Esportes\Tecnologia da Informação\SGSE\`
2. **Copie** (não mova ainda) a pasta `sgse-app` inteira
3. Cole em: `C:\Users\Deyvison\OneDrive\Desktop\SGSE-Projetos\`

**Resultado:**
```
C:\Users\Deyvison\OneDrive\Desktop\SGSE-Projetos\sgse-app\
```

#### **Passo 3: Testar**

1. Abra VS Code
2. Abra a nova pasta: `C:\Users\Deyvison\OneDrive\Desktop\SGSE-Projetos\sgse-app`
3. Teste se tudo funciona:
   ```powershell
   # Terminal 1
   cd packages\backend
   bunx convex dev
   
   # Terminal 2
   cd apps\web
   bun run dev
   ```

#### **Passo 4: Limpar (após confirmar que funciona)**

Se tudo funcionar perfeitamente:
- Você pode deletar a pasta antiga: `Secretária de Esportes\Tecnologia da Informação\SGSE\sgse-app`

---

## 🎯 MINHA RECOMENDAÇÃO

### **Recomendo a OPÇÃO 2 (Simplificação):**

**Por quê?**
1. ✅ Caminho muito mais simples
2. ✅ Zero chances de problemas com PowerShell
3. ✅ Mais fácil de digitar
4. ✅ Mantém backup (você copia, não move)
5. ✅ Pode testar antes de deletar o antigo

**Novo caminho:**
```
C:\Users\Deyvison\OneDrive\Desktop\SGSE-Projetos\sgse-app\
```

---

## 📋 CHECKLIST DE EXECUÇÃO

### **Antes de começar:**
- [ ] Parei o servidor Convex (Ctrl + C)
- [ ] Parei o servidor Web (Ctrl + C)
- [ ] Fechei o VS Code
- [ ] Salvei todo o trabalho (commits no Git)

### **Durante a execução:**
- [ ] Criei a nova pasta (se OPÇÃO 2)
- [ ] Copiei/renomeiei as pastas
- [ ] Verifiquei que todos os arquivos foram copiados

### **Depois de mover:**
- [ ] Abri VS Code no novo local
- [ ] Testei Convex (`bunx convex dev`)
- [ ] Testei Web (`bun run dev`)
- [ ] Confirmei que tudo funciona

### **Limpeza (apenas se tudo funcionar):**
- [ ] Deletei a pasta antiga

---

## ⚠️ CUIDADOS IMPORTANTES

### **1. Git / Controle de Versão:**

Se você tem commits não enviados:
```powershell
# Antes de mover, salve tudo:
git add .
git commit -m "Antes de mover pastas"
git push
```

### **2. OneDrive:**

Como está no OneDrive, o OneDrive pode estar sincronizando:
- Aguarde a sincronização terminar antes de mover
- Verifique o ícone do OneDrive (deve estar com checkmark verde)

### **3. Node Modules:**

Após mover, pode ser necessário reinstalar dependências:
```powershell
# Na raiz do projeto
bun install
```

---

## 🚀 SCRIPT PARA TESTAR NOVO CAMINHO

Após mover, use este script para verificar se está tudo OK:

```powershell
# Teste 1: Verificar estrutura
Write-Host "Testando estrutura de pastas..." -ForegroundColor Yellow
Test-Path ".\packages\backend\convex"
Test-Path ".\apps\web\src"

# Teste 2: Verificar dependências
Write-Host "Testando dependências..." -ForegroundColor Yellow
cd packages\backend
bun install

cd ..\..\apps\web
bun install

# Teste 3: Testar build
Write-Host "Testando build..." -ForegroundColor Yellow
cd ..\..
bun run build

Write-Host "✅ Todos os testes passaram!" -ForegroundColor Green
```

---

## 💡 VANTAGENS APÓS A MUDANÇA

### **Antes (com caracteres especiais):**
```powershell
cd "C:\Users\Deyvison\OneDrive\Desktop\Secretária de Esportes\Tecnologia da Informação\SGSE\sgse-app"
# ❌ Dá erro no PowerShell
```

### **Depois (sem caracteres especiais):**
```powershell
cd C:\Users\Deyvison\OneDrive\Desktop\SGSE-Projetos\sgse-app
# ✅ Funciona perfeitamente!
```

---

## 🎯 RESUMO DA RECOMENDAÇÃO

**Faça assim (mais seguro):**

1. ✅ Crie: `C:\Users\Deyvison\OneDrive\Desktop\SGSE-Projetos\`
2. ✅ **COPIE** `sgse-app` para lá (não mova ainda!)
3. ✅ Abra no VS Code e teste tudo
4. ✅ Crie o arquivo `.env` (agora vai funcionar!)
5. ✅ Se tudo funcionar, delete a pasta antiga

---

## ❓ QUER QUE EU TE AJUDE?

Posso te guiar passo a passo durante a mudança:

1. Te aviso o que fazer em cada passo
2. Verifico se está tudo certo
3. Ajudo a testar depois de mover
4. Crio o `.env` no novo local

**O que você prefere?**
- A) Opção 1 - Renomear pastas mantendo estrutura
- B) Opção 2 - Simplificar para `SGSE-Projetos\sgse-app`
- C) Outra sugestão de nome/estrutura

Me diga qual opção prefere e vou te guiar! 🚀