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

CONFIGURACAO_PRODUCAO.md

@@ -0,0 +1,183 @@
+# 🚀 Configuração para Produção - SGSE
+
+Este documento contém as instruções para configurar as variáveis de ambiente necessárias para colocar o sistema SGSE em produção.
+
+---
+
+## ⚠️ IMPORTANTE - SEGURANÇA
+
+As configurações abaixo são **OBRIGATÓRIAS** para garantir a segurança do sistema em produção. **NÃO pule estas etapas!**
+
+---
+
+## 📋 Variáveis de Ambiente Necessárias
+
+### 1. `BETTER_AUTH_SECRET` (OBRIGATÓRIO)
+
+**O que é:** Chave secreta usada para criptografar tokens de autenticação.
+
+**Por que é importante:** Sem um secret único e forte, qualquer pessoa pode falsificar tokens de autenticação e acessar o sistema sem autorização.
+
+**Como gerar um secret seguro:**
+
+#### **Opção A: PowerShell (Windows)**
+```powershell
+[Convert]::ToBase64String([System.Security.Cryptography.RandomNumberGenerator]::GetBytes(32))
+```
+
+#### **Opção B: Linux/Mac**
+```bash
+openssl rand -base64 32
+```
+
+#### **Opção C: Node.js**
+```bash
+node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"
+```
+
+**Exemplo de resultado:**
+```
+aBc123XyZ789+/aBc123XyZ789+/aBc123XyZ789+/==
+```
+
+---
+
+### 2. `SITE_URL` ou `CONVEX_SITE_URL` (OBRIGATÓRIO)
+
+**O que é:** URL base da aplicação onde o sistema está hospedado.
+
+**Exemplos:**
+- **Desenvolvimento Local:** `http://localhost:5173`
+- **Produção:** `https://sgse.pe.gov.br` (substitua pela URL real)
+
+---
+
+## 🔧 Como Configurar no Convex
+
+### **Passo 1: Acessar o Convex Dashboard**
+
+1. Acesse: https://dashboard.convex.dev
+2. Faça login com sua conta
+3. Selecione o projeto **SGSE**
+
+### **Passo 2: Configurar Variáveis de Ambiente**
+
+1. No menu lateral, clique em **Settings** (Configurações)
+2. Clique na aba **Environment Variables**
+3. Adicione as seguintes variáveis:
+
+#### **Para Desenvolvimento:**
+
+| Variável | Valor |
+|----------|-------|
+| `BETTER_AUTH_SECRET` | (Gere um usando os comandos acima) |
+| `SITE_URL` | `http://localhost:5173` |
+
+#### **Para Produção:**
+
+| Variável | Valor |
+|----------|-------|
+| `BETTER_AUTH_SECRET` | (Gere um NOVO secret diferente do desenvolvimento) |
+| `SITE_URL` | `https://sua-url-de-producao.com.br` |
+
+### **Passo 3: Salvar as Configurações**
+
+1. Clique em **Add** para cada variável
+2. Clique em **Save** para salvar as alterações
+3. Aguarde o Convex reiniciar automaticamente
+
+---
+
+## ✅ Verificação
+
+Após configurar as variáveis, as mensagens de ERRO e WARN no terminal devem **desaparecer**:
+
+### ❌ Antes (com erro):
+```
+[ERROR] 'You are using the default secret. Please set `BETTER_AUTH_SECRET`'
+[WARN] 'Better Auth baseURL is undefined. This is probably a mistake.'
+```
+
+### ✅ Depois (sem erro):
+```
+✔ Convex functions ready!
+```
+
+---
+
+## 🔐 Boas Práticas de Segurança
+
+### ✅ FAÇA:
+
+1. **Gere secrets diferentes** para desenvolvimento e produção
+2. **Nunca compartilhe** o `BETTER_AUTH_SECRET` publicamente
+3. **Nunca commite** arquivos `.env` com secrets no Git
+4. **Use secrets fortes** com pelo menos 32 caracteres aleatórios
+5. **Rotacione o secret** periodicamente em produção
+6. **Documente** onde os secrets estão armazenados (Convex Dashboard)
+
+### ❌ NÃO FAÇA:
+
+1. **NÃO use** "1234" ou "password" como secret
+2. **NÃO compartilhe** o secret em e-mails ou mensagens
+3. **NÃO commite** o secret no código-fonte
+4. **NÃO reutilize** o mesmo secret em múltiplos ambientes
+5. **NÃO deixe** o secret em produção sem configurar
+
+---
+
+## 🆘 Troubleshooting
+
+### Problema: Mensagens de erro ainda aparecem após configurar
+
+**Solução:**
+1. Verifique se as variáveis foram salvas corretamente no Convex Dashboard
+2. Aguarde alguns segundos para o Convex reiniciar
+3. Recarregue a aplicação no navegador
+4. Verifique os logs do Convex para confirmar que as variáveis foram carregadas
+
+### Problema: Erro "baseURL is undefined"
+
+**Solução:**
+1. Certifique-se de ter configurado `SITE_URL` no Convex Dashboard
+2. Use a URL completa incluindo `http://` ou `https://`
+3. Não adicione barra `/` no final da URL
+
+### Problema: Sessões não funcionam após configurar
+
+**Solução:**
+1. Limpe os cookies do navegador
+2. Faça logout e login novamente
+3. Verifique se o `BETTER_AUTH_SECRET` está configurado corretamente
+
+---
+
+## 📞 Suporte
+
+Se encontrar problemas durante a configuração:
+
+1. Verifique os logs do Convex Dashboard
+2. Consulte a documentação do Convex: https://docs.convex.dev
+3. Consulte a documentação do Better Auth: https://www.better-auth.com
+
+---
+
+## 📝 Checklist de Produção
+
+Antes de colocar o sistema em produção, verifique:
+
+- [ ] `BETTER_AUTH_SECRET` configurado no Convex Dashboard
+- [ ] `SITE_URL` configurado com a URL de produção
+- [ ] Secret gerado usando método criptograficamente seguro
+- [ ] Secret é diferente entre desenvolvimento e produção
+- [ ] Mensagens de erro no terminal foram resolvidas
+- [ ] Login e autenticação funcionando corretamente
+- [ ] Permissões de acesso configuradas
+- [ ] Backup do secret armazenado em local seguro
+
+---
+
+**Data de Criação:** 27/10/2025
+**Versão:** 1.0
+**Autor:** Equipe TI SGSE
+