fix: improve role assignment logic and permission handling in dashboard components

PASSO_A_PASSO_CONFIGURACAO.md

@@ -0,0 +1,141 @@
+# 🚀 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
+