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

2025-10-27 08:41:53 -03:00
parent 2c2b792b4a
commit 6bfc0c2ced
19 changed files with 2105 additions and 118 deletions
--- a/INSTRUCOES_CORRETAS.md
+++ b/INSTRUCOES_CORRETAS.md
@@ -0,0 +1,214 @@
+# ✅ INSTRUÇÕES CORRETAS - Convex Local (Não Cloud!)
+
+**IMPORTANTE:** Este projeto usa **Convex Local** (rodando no seu computador), não o Convex Cloud!
+
+---
+
+## 🎯 RESUMO - O QUE VOCÊ PRECISA FAZER
+
+Você tem **2 opções simples**:
+
+### **OPÇÃO 1: Script Automático (Mais Fácil) ⭐ RECOMENDADO**
+
+```powershell
+# Execute este comando:
+cd packages\backend
+.\CRIAR_ENV.bat
+```
+
+O script vai:
+- ✅ Criar o arquivo `.env` automaticamente
+- ✅ Adicionar as variáveis necessárias
+- ✅ Configurar o `.gitignore`
+- ✅ Mostrar próximos passos
+
+**Tempo:** 30 segundos
+
+---
+
+### **OPÇÃO 2: Manual (Mais Controle)**
+
+#### **Passo 1: Criar arquivo `.env`**
+
+Crie o arquivo `packages/backend/.env` com este conteúdo:
+
+```env
+# Segurança Better Auth
+BETTER_AUTH_SECRET=+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=
+
+# URL da aplicação
+SITE_URL=http://localhost:5173
+```
+
+#### **Passo 2: Reiniciar servidores**
+
+```powershell
+# Terminal 1 - Convex
+cd packages\backend
+bunx convex dev
+
+# Terminal 2 - Web (em outro terminal)
+cd apps\web
+bun run dev
+```
+
+**Tempo:** 2 minutos
+
+---
+
+## 📊 ANTES E DEPOIS
+
+### ❌ ANTES (agora - com erros):
+```
+[ERROR] You are using the default secret. 
+Please set `BETTER_AUTH_SECRET` in your environment variables
+[WARN] Better Auth baseURL is undefined
+```
+
+### ✅ DEPOIS (após configurar):
+```
+✔ Convex dev server running
+✔ Functions ready!
+```
+
+---
+
+## 🔍 POR QUE MINHA PRIMEIRA INSTRUÇÃO ESTAVA ERRADA
+
+### ❌ Instrução Errada (ignorar!):
+- Pedia para configurar no "Convex Dashboard" online
+- Isso só funciona para projetos no **Convex Cloud**
+- Seu projeto roda **localmente**
+
+### ✅ Instrução Correta (seguir!):
+- Criar arquivo `.env` no seu computador
+- O arquivo fica em `packages/backend/.env`
+- Convex Local lê automaticamente este arquivo
+
+---
+
+## 📁 ESTRUTURA CORRETA
+
+```
+sgse-app/
+└── packages/
+    └── backend/
+        ├── convex/
+        │   ├── auth.ts       ✅ (já preparado)
+        │   └── ...
+        ├── .env              ✅ (você vai criar)
+        ├── .gitignore        ✅ (já existe)
+        └── CRIAR_ENV.bat     ✅ (script criado)
+```
+
+---
+
+## 🚀 COMEÇAR AGORA (GUIA RÁPIDO)
+
+### **Método Rápido (30 segundos):**
+
+1. Abra PowerShell
+2. Execute:
+   ```powershell
+   cd "C:\Users\Deyvison\OneDrive\Desktop\Secretária de Esportes\Tecnologia da Informação\SGSE\sgse-app\packages\backend"
+   .\CRIAR_ENV.bat
+   ```
+3. Siga as instruções na tela
+4. Pronto! ✅
+
+---
+
+## 🔒 SEGURANÇA
+
+### **Para Desenvolvimento (agora):**
+✅ Use o secret gerado: `+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=`
+
+### **Para Produção (futuro):**
+⚠️ Você **DEVE** gerar um **NOVO** secret diferente!
+
+**Como gerar novo secret:**
+```powershell
+$bytes = New-Object byte[] 32
+(New-Object Security.Cryptography.RNGCryptoServiceProvider).GetBytes($bytes)
+[Convert]::ToBase64String($bytes)
+```
+
+---
+
+## ✅ CHECKLIST RÁPIDO
+
+- [ ] Executei `CRIAR_ENV.bat` OU criei `.env` manualmente
+- [ ] Arquivo `.env` está em `packages/backend/`
+- [ ] Reiniciei o Convex (`bunx convex dev`)
+- [ ] Reiniciei o Web (`bun run dev` em outro terminal)
+- [ ] Mensagens de erro pararam ✅
+
+---
+
+## 🆘 PROBLEMAS?
+
+### **"Erro persiste após criar .env"**
+1. Pare o Convex completamente (Ctrl+C)
+2. Aguarde 5 segundos
+3. Inicie novamente
+
+### **"Não encontro o arquivo .env"**
+- Ele começa com ponto (`.env`)
+- Pode estar oculto no Windows
+- Verifique em: `packages/backend/.env`
+
+### **"Script não executa"**
+```powershell
+# Se der erro de permissão, tente:
+Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
+.\CRIAR_ENV.bat
+```
+
+---
+
+## 📞 PRÓXIMOS PASSOS
+
+### **Agora:**
+1. Execute `CRIAR_ENV.bat` ou crie `.env` manualmente
+2. Reinicie os servidores
+3. Verifique que erros pararam
+
+### **Quando for para produção:**
+1. Gere novo secret para produção
+2. Crie `.env` no servidor com valores de produção
+3. Configure `SITE_URL` com URL real
+
+---
+
+## 📚 ARQUIVOS DE REFERÊNCIA
+
+| Arquivo | Quando Usar |
+|---------|-------------|
+| `INSTRUCOES_CORRETAS.md` | **ESTE ARQUIVO** - Comece aqui! |
+| `CONFIGURAR_LOCAL.md` | Guia detalhado passo a passo |
+| `packages/backend/CRIAR_ENV.bat` | Script automático |
+
+**❌ IGNORE ESTES (instruções antigas para Cloud):**
+- `CONFIGURAR_AGORA.md` (instruções para Convex Cloud)
+- `PASSO_A_PASSO_CONFIGURACAO.md` (instruções para Convex Cloud)
+
+---
+
+## 🎉 RESUMO FINAL
+
+**O que houve:**
+- Primeira instrução assumiu Convex Cloud (errado)
+- Seu projeto usa Convex Local (correto)
+- Solução mudou de "Dashboard online" para "arquivo .env local"
+
+**O que fazer:**
+1. Execute `CRIAR_ENV.bat` (30 segundos)
+2. Reinicie servidores (1 minuto)
+3. Pronto! Sistema seguro ✅
+
+---
+
+**Tempo total:** 2 minutos  
+**Dificuldade:** ⭐ Muito Fácil  
+**Status:** Pronto para executar agora! 🚀
+