# 🚀 Passo a Passo - Configurar BETTER_AUTH_SECRET

## ⚡ Resolva o erro em 5 minutos

A mensagem de erro que você está vendo é **ESPERADA** porque ainda não configuramos a variável de ambiente no Convex.

---

## 📝 Passo a Passo

### **Passo 1: Gerar o Secret (2 minutos)**

Abra o PowerShell e execute:

```powershell
[Convert]::ToBase64String([System.Security.Cryptography.RandomNumberGenerator]::GetBytes(32))
```

**Você vai receber algo assim:**
```
aBc123XyZ789+/aBc123XyZ789+/aBc123XyZ789+/==
```

✏️ **COPIE este valor** - você vai precisar dele no próximo passo!

---

### **Passo 2: Configurar no Convex (2 minutos)**

1. **Acesse:** https://dashboard.convex.dev
2. **Faça login** com sua conta
3. **Selecione** o projeto SGSE
4. **Clique** em "Settings" no menu lateral esquerdo
5. **Clique** na aba "Environment Variables"
6. **Clique** no botão "Add Environment Variable"

7. **Adicione a primeira variável:**
   - Name: `BETTER_AUTH_SECRET`
   - Value: (Cole o valor que você copiou no Passo 1)
   - Clique em "Add"

8. **Adicione a segunda variável:**
   - Name: `SITE_URL`
   - Value (escolha um):
     - Para desenvolvimento local: `http://localhost:5173`
     - Para produção: `https://sgse.pe.gov.br` (ou sua URL real)
   - Clique em "Add"

9. **Salve:**
   - Clique em "Save" ou "Deploy"
   - Aguarde o Convex reiniciar (aparece uma notificação)

---

### **Passo 3: Verificar (1 minuto)**

1. **Aguarde** 10-20 segundos para o Convex reiniciar
2. **Volte** para o terminal onde o sistema está rodando
3. **Verifique** se a mensagem de erro parou de aparecer

**Você deve ver apenas:**
```
✔ Convex functions ready!
```

**SEM mais essas mensagens:**
```
❌ [ERROR] 'You are using the default secret'
❌ [WARN] 'Better Auth baseURL is undefined'
```

---

## 🔄 Alternativa Rápida para Testar

Se você só quer **testar** agora e configurar direito depois, pode usar um secret temporário:

### **No Convex Dashboard:**

| Variável | Valor Temporário para Testes |
|----------|-------------------------------|
| `BETTER_AUTH_SECRET` | `desenvolvimento-local-12345678901234567890` |
| `SITE_URL` | `http://localhost:5173` |

⚠️ **ATENÇÃO:** Este secret temporário serve **APENAS para desenvolvimento local**. 
Você **DEVE** gerar um novo secret seguro antes de colocar em produção!

---

## ✅ Checklist Rápido

- [ ] Abri o PowerShell
- [ ] Executei o comando para gerar o secret
- [ ] Copiei o resultado
- [ ] Acessei https://dashboard.convex.dev
- [ ] Selecionei o projeto SGSE
- [ ] Fui em Settings > Environment Variables
- [ ] Adicionei `BETTER_AUTH_SECRET` com o secret gerado
- [ ] Adicionei `SITE_URL` com a URL correta
- [ ] Salvei as configurações
- [ ] Aguardei o Convex reiniciar
- [ ] Mensagem de erro parou de aparecer ✅

---

## 🆘 Problemas?

### "Não consigo acessar o Convex Dashboard"
- Verifique se você está logado na conta correta
- Verifique se tem permissão no projeto SGSE

### "O erro ainda aparece após configurar"
- Aguarde 30 segundos e recarregue a aplicação
- Verifique se salvou as variáveis corretamente
- Confirme que o nome da variável está correto: `BETTER_AUTH_SECRET` (sem espaços)

### "Não encontro onde adicionar variáveis"
- Certifique-se de estar em Settings (ícone de engrenagem)
- Procure pela aba "Environment Variables" ou "Env Vars"
- Se não encontrar, o projeto pode estar usando a versão antiga do Convex

---

## 📞 Próximos Passos

Após configurar:
1. ✅ As mensagens de erro vão parar
2. ✅ O sistema vai funcionar com segurança
3. ✅ Você pode continuar desenvolvendo normalmente

Quando for para **produção**:
1. 🔐 Gere um **NOVO** secret (diferente do desenvolvimento)
2. 🌐 Configure `SITE_URL` com a URL real de produção
3. 🔒 Guarde o secret de produção em local seguro

---

**Criado em:** 27/10/2025 às 07:45
**Tempo estimado:** 5 minutos
**Dificuldade:** ⭐ Fácil