207 lines
4.9 KiB
Markdown
207 lines
4.9 KiB
Markdown
# 🔐 CONFIGURAÇÃO URGENTE - SGSE
|
|
|
|
**Criado em:** 27/10/2025 às 07:50
|
|
**Ação necessária:** Configurar variáveis de ambiente no Convex
|
|
|
|
---
|
|
|
|
## ✅ Secret Gerado com Sucesso!
|
|
|
|
Seu secret criptograficamente seguro foi gerado:
|
|
|
|
```
|
|
+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=
|
|
```
|
|
|
|
⚠️ **IMPORTANTE:** Este secret deve ser tratado como uma senha. Não compartilhe publicamente!
|
|
|
|
---
|
|
|
|
## 🚀 Próximos Passos (5 minutos)
|
|
|
|
### **Passo 1: Acessar o Convex Dashboard**
|
|
|
|
1. Abra seu navegador
|
|
2. Acesse: https://dashboard.convex.dev
|
|
3. Faça login com sua conta
|
|
4. Selecione o projeto **SGSE**
|
|
|
|
---
|
|
|
|
### **Passo 2: Adicionar Variáveis de Ambiente**
|
|
|
|
#### **Caminho no Dashboard:**
|
|
```
|
|
Seu Projeto SGSE → Settings (⚙️) → Environment Variables
|
|
```
|
|
|
|
#### **Variável 1: BETTER_AUTH_SECRET**
|
|
|
|
| Campo | Valor |
|
|
|-------|-------|
|
|
| **Name** | `BETTER_AUTH_SECRET` |
|
|
| **Value** | `+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=` |
|
|
| **Deployment** | Selecione: **Development** (para testar) |
|
|
|
|
**Instruções:**
|
|
1. Clique em "Add Environment Variable" ou "New Variable"
|
|
2. Digite exatamente: `BETTER_AUTH_SECRET` (sem espaços)
|
|
3. Cole o valor: `+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=`
|
|
4. Clique em "Add" ou "Save"
|
|
|
|
---
|
|
|
|
#### **Variável 2: SITE_URL**
|
|
|
|
| Campo | Valor |
|
|
|-------|-------|
|
|
| **Name** | `SITE_URL` |
|
|
| **Value** | `http://localhost:5173` (desenvolvimento) |
|
|
| **Deployment** | Selecione: **Development** |
|
|
|
|
**Instruções:**
|
|
1. Clique em "Add Environment Variable" novamente
|
|
2. Digite: `SITE_URL`
|
|
3. Digite: `http://localhost:5173`
|
|
4. Clique em "Add" ou "Save"
|
|
|
|
---
|
|
|
|
### **Passo 3: Deploy/Restart**
|
|
|
|
Após adicionar as duas variáveis:
|
|
|
|
1. Procure um botão **"Deploy"** ou **"Save Changes"**
|
|
2. Clique nele
|
|
3. Aguarde a mensagem: **"Deployment successful"** ou similar
|
|
4. Aguarde 20-30 segundos para o Convex reiniciar
|
|
|
|
---
|
|
|
|
### **Passo 4: Verificar**
|
|
|
|
Volte para o terminal onde o sistema está rodando e verifique:
|
|
|
|
**✅ Deve aparecer:**
|
|
```
|
|
✔ Convex functions ready!
|
|
[INFO] Sistema carregando...
|
|
```
|
|
|
|
**❌ NÃO deve mais aparecer:**
|
|
```
|
|
[ERROR] You are using the default secret
|
|
[WARN] Better Auth baseURL is undefined
|
|
```
|
|
|
|
---
|
|
|
|
## 🔄 Se o erro persistir
|
|
|
|
Execute no terminal do projeto:
|
|
|
|
```powershell
|
|
# Voltar para a raiz do projeto
|
|
cd C:\Users\Deyvison\OneDrive\Desktop\"Secretária de Esportes"\"Tecnologia da Informação"\SGSE\sgse-app
|
|
|
|
# Limpar cache do Convex
|
|
cd packages/backend
|
|
bunx convex dev --once
|
|
|
|
# Reiniciar o servidor web
|
|
cd ../../apps/web
|
|
bun run dev
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 Checklist de Validação
|
|
|
|
Marque conforme completar:
|
|
|
|
- [ ] **Gerei o secret** (✅ Já foi feito - está neste arquivo)
|
|
- [ ] **Acessei** https://dashboard.convex.dev
|
|
- [ ] **Selecionei** o projeto SGSE
|
|
- [ ] **Cliquei** em Settings → Environment Variables
|
|
- [ ] **Adicionei** `BETTER_AUTH_SECRET` com o valor correto
|
|
- [ ] **Adicionei** `SITE_URL` com `http://localhost:5173`
|
|
- [ ] **Cliquei** em Deploy/Save
|
|
- [ ] **Aguardei** 30 segundos
|
|
- [ ] **Verifiquei** que os erros pararam no terminal
|
|
|
|
---
|
|
|
|
## 🎯 Resultado Esperado
|
|
|
|
### **Antes (atual):**
|
|
```
|
|
[ERROR] '2025-10-27T10:42:40.583Z ERROR [Better Auth]:
|
|
You are using the default secret. Please set `BETTER_AUTH_SECRET`
|
|
in your environment variables or pass `secret` in your auth config.'
|
|
```
|
|
|
|
### **Depois (esperado):**
|
|
```
|
|
✔ Convex functions ready!
|
|
✔ Better Auth initialized successfully
|
|
✔ Sistema SGSE carregado
|
|
```
|
|
|
|
---
|
|
|
|
## 🔒 Segurança - Importante!
|
|
|
|
### **Para Produção (quando for deploy):**
|
|
|
|
Você precisará criar um **NOVO secret diferente** para produção:
|
|
|
|
1. Execute novamente o comando no PowerShell para gerar outro secret
|
|
2. Configure no deployment de **Production** (não Development)
|
|
3. Mude `SITE_URL` para a URL real de produção
|
|
|
|
**⚠️ NUNCA use o mesmo secret em desenvolvimento e produção!**
|
|
|
|
---
|
|
|
|
## 🆘 Precisa de Ajuda?
|
|
|
|
### **Não encontro "Environment Variables"**
|
|
|
|
Tente:
|
|
- Procurar por "Env Vars" ou "Variables"
|
|
- Verificar na aba "Settings" ou "Configuration"
|
|
- Clicar no ícone de engrenagem (⚙️) no menu lateral
|
|
|
|
### **Não consigo acessar o Dashboard**
|
|
|
|
- Verifique se tem acesso ao projeto SGSE
|
|
- Confirme se está logado com a conta correta
|
|
- Peça acesso ao administrador do projeto
|
|
|
|
### **O erro continua aparecendo**
|
|
|
|
1. Confirme que copiou o secret corretamente (sem espaços extras)
|
|
2. Confirme que o nome da variável está correto
|
|
3. Aguarde mais 1 minuto e recarregue a página
|
|
4. Verifique se selecionou o deployment correto (Development)
|
|
|
|
---
|
|
|
|
## 📞 Status Atual
|
|
|
|
- ✅ **Código atualizado:** `packages/backend/convex/auth.ts` preparado
|
|
- ✅ **Secret gerado:** `+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=`
|
|
- ⏳ **Variáveis configuradas:** Aguardando você configurar
|
|
- ⏳ **Erro resolvido:** Será resolvido após configurar
|
|
|
|
---
|
|
|
|
**Tempo estimado total:** 5 minutos
|
|
**Dificuldade:** ⭐ Fácil
|
|
**Impacto:** 🔴 Crítico para produção
|
|
|
|
---
|
|
|
|
**Próximo passo:** Acesse o Convex Dashboard e configure as variáveis! 🚀
|
|
|