sgse-app/PASSO_A_PASSO_CONFIGURACAO.md

🚀 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:

[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