178 lines
3.6 KiB
Markdown
178 lines
3.6 KiB
Markdown
# 🔧 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
|
|
|