# 🔐 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! 🚀