# 🔧 CRIAR ARQUIVO .env MANUALMENTE (Método Simples)

## ⚡ Passo a Passo (2 minutos)

### **Passo 1: Abrir VS Code**
Você já tem o VS Code aberto com o projeto SGSE.

---

### **Passo 2: Navegar até a pasta correta**

No VS Code, no painel lateral esquerdo:
1. Abra a pasta `packages`
2. Abra a pasta `backend`
3. Você deve ver arquivos como `package.json`, `convex/`, etc.

---

### **Passo 3: Criar novo arquivo**

1. **Clique com botão direito** na pasta `backend` (no painel lateral)
2. Selecione **"New File"** (Novo Arquivo)
3. Digite exatamente: `.env` (com o ponto no início!)
4. Pressione **Enter**

⚠️ **IMPORTANTE:** O nome do arquivo é **`.env`** (começa com ponto!)

---

### **Passo 4: Copiar e colar o conteúdo**

Cole exatamente este conteúdo no arquivo `.env`:

```env
# Segurança Better Auth
BETTER_AUTH_SECRET=+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=

# URL da aplicação
SITE_URL=http://localhost:5173
```

---

### **Passo 5: Salvar**

Pressione **Ctrl + S** para salvar o arquivo.

---

### **Passo 6: Verificar**

A estrutura deve ficar assim:

```
packages/
└── backend/
    ├── convex/
    ├── .env          ← NOVO ARQUIVO AQUI!
    ├── package.json
    └── ...
```

---

### **Passo 7: Reiniciar servidores**

Agora você precisa reiniciar os servidores para carregar as novas variáveis.

#### **Terminal 1 - Convex:**

Se o Convex já está rodando:
1. Pressione **Ctrl + C** para parar
2. Execute novamente:
   ```powershell
   cd packages\backend
   bunx convex dev
   ```

#### **Terminal 2 - Web:**

Se o servidor Web já está rodando:
1. Pressione **Ctrl + C** para parar
2. Execute novamente:
   ```powershell
   cd apps\web
   bun run dev
   ```

---

### **Passo 8: Validar ✅**

No terminal do Convex, você deve ver:

**✅ Sucesso (deve aparecer):**
```
✔ Convex dev server running
✔ Functions ready!
```

**❌ Erro (NÃO deve mais aparecer):**
```
[ERROR] You are using the default secret
[WARN] Better Auth baseURL is undefined
```

---

## 📋 CHECKLIST RÁPIDO

- [ ] Abri o VS Code
- [ ] Naveguei até `packages/backend/`
- [ ] Criei arquivo `.env` (com ponto no início)
- [ ] Colei o conteúdo com as 2 variáveis
- [ ] Salvei o arquivo (Ctrl + S)
- [ ] Parei o Convex (Ctrl + C)
- [ ] Reiniciei o Convex (`bunx convex dev`)
- [ ] Parei o Web (Ctrl + C)
- [ ] Reiniciei o Web (`bun run dev`)
- [ ] Verifiquei que erros pararam ✅

---

## 🆘 PROBLEMAS COMUNS

### **"Não consigo ver o arquivo .env após criar"**

Arquivos que começam com `.` ficam ocultos por padrão:
- No VS Code, eles aparecem normalmente
- No Windows Explorer, você precisa habilitar "Mostrar arquivos ocultos"

### **"O erro ainda aparece"**

1. Confirme que o arquivo se chama exatamente `.env`
2. Confirme que está na pasta `packages/backend/`
3. Confirme que reiniciou AMBOS os servidores (Convex e Web)
4. Aguarde 10 segundos após reiniciar

### **"VS Code não deixa criar arquivo com nome .env"**

Tente:
1. Criar arquivo `temp.txt`
2. Renomear para `.env`
3. Cole o conteúdo
4. Salve

---

## 📦 CONTEÚDO COMPLETO DO .env

```env
# Segurança Better Auth
BETTER_AUTH_SECRET=+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=

# URL da aplicação
SITE_URL=http://localhost:5173
```

⚠️ **Copie exatamente como está acima!**

---

## 🎉 PRONTO!

Após seguir todos os passos:
- ✅ Arquivo `.env` criado
- ✅ Variáveis configuradas
- ✅ Servidores reiniciados
- ✅ Erros devem ter parado
- ✅ Sistema seguro e funcionando!

---

**Tempo total:** 2 minutos  
**Dificuldade:** ⭐ Muito Fácil  
**Método:** 100% manual via VS Code