SESP/sgse-app
2
0
Fork 0
Code Issues 3 Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
feat-cadastro-funcinarios
sgse-app/CONFIGURAR_AGORA.md

4.9 KiB
Raw Permalink Blame History

🔐 CONFIGURAÇÃO URGENTE - SGSE

Criado em: 27/10/2025 às 07:50
Ação necessária: Configurar variáveis de ambiente no Convex

✅ Secret Gerado com Sucesso!

Seu secret criptograficamente seguro foi gerado:

+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=

⚠️ IMPORTANTE: Este secret deve ser tratado como uma senha. Não compartilhe publicamente!

🚀 Próximos Passos (5 minutos)

Passo 1: Acessar o Convex Dashboard

  1. Abra seu navegador
  2. Acesse: https://dashboard.convex.dev
  3. Faça login com sua conta
  4. Selecione o projeto SGSE

Passo 2: Adicionar Variáveis de Ambiente

Caminho no Dashboard:

Seu Projeto SGSE → Settings (⚙️) → Environment Variables

Variável 1: BETTER_AUTH_SECRET

Campo Valor
Name BETTER_AUTH_SECRET
Value +Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=
Deployment Selecione: Development (para testar)

Instruções:

  1. Clique em "Add Environment Variable" ou "New Variable"
  2. Digite exatamente: BETTER_AUTH_SECRET (sem espaços)
  3. Cole o valor: +Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=
  4. Clique em "Add" ou "Save"

Variável 2: SITE_URL

Campo Valor
Name SITE_URL
Value http://localhost:5173 (desenvolvimento)
Deployment Selecione: Development

Instruções:

  1. Clique em "Add Environment Variable" novamente
  2. Digite: SITE_URL
  3. Digite: http://localhost:5173
  4. Clique em "Add" ou "Save"

Passo 3: Deploy/Restart

Após adicionar as duas variáveis:

  1. Procure um botão "Deploy" ou "Save Changes"
  2. Clique nele
  3. Aguarde a mensagem: "Deployment successful" ou similar
  4. Aguarde 20-30 segundos para o Convex reiniciar

Passo 4: Verificar

Volte para o terminal onde o sistema está rodando e verifique:

✅ Deve aparecer:

✔ Convex functions ready!
[INFO] Sistema carregando...

❌ NÃO deve mais aparecer:

[ERROR] You are using the default secret
[WARN] Better Auth baseURL is undefined

🔄 Se o erro persistir

Execute no terminal do projeto:

# Voltar para a raiz do projeto
cd C:\Users\Deyvison\OneDrive\Desktop\"Secretária de Esportes"\"Tecnologia da Informação"\SGSE\sgse-app

# Limpar cache do Convex
cd packages/backend
bunx convex dev --once

# Reiniciar o servidor web
cd ../../apps/web
bun run dev

📋 Checklist de Validação

Marque conforme completar:

  • Gerei o secret (✅ Já foi feito - está neste arquivo)
  • Acessei https://dashboard.convex.dev
  • Selecionei o projeto SGSE
  • Cliquei em Settings → Environment Variables
  • Adicionei BETTER_AUTH_SECRET com o valor correto
  • Adicionei SITE_URL com http://localhost:5173
  • Cliquei em Deploy/Save
  • Aguardei 30 segundos
  • Verifiquei que os erros pararam no terminal

🎯 Resultado Esperado

Antes (atual):

[ERROR] '2025-10-27T10:42:40.583Z ERROR [Better Auth]: 
You are using the default secret. Please set `BETTER_AUTH_SECRET` 
in your environment variables or pass `secret` in your auth config.'

Depois (esperado):

✔ Convex functions ready!
✔ Better Auth initialized successfully
✔ Sistema SGSE carregado

🔒 Segurança - Importante!

Para Produção (quando for deploy):

Você precisará criar um NOVO secret diferente para produção:

  1. Execute novamente o comando no PowerShell para gerar outro secret
  2. Configure no deployment de Production (não Development)
  3. Mude SITE_URL para a URL real de produção

⚠️ NUNCA use o mesmo secret em desenvolvimento e produção!

🆘 Precisa de Ajuda?

Não encontro "Environment Variables"

Tente:

  • Procurar por "Env Vars" ou "Variables"
  • Verificar na aba "Settings" ou "Configuration"
  • Clicar no ícone de engrenagem (⚙️) no menu lateral

Não consigo acessar o Dashboard

  • Verifique se tem acesso ao projeto SGSE
  • Confirme se está logado com a conta correta
  • Peça acesso ao administrador do projeto

O erro continua aparecendo

  1. Confirme que copiou o secret corretamente (sem espaços extras)
  2. Confirme que o nome da variável está correto
  3. Aguarde mais 1 minuto e recarregue a página
  4. Verifique se selecionou o deployment correto (Development)

📞 Status Atual

  • ✅ Código atualizado: packages/backend/convex/auth.ts preparado
  • ✅ Secret gerado: +Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=
  • ⏳ Variáveis configuradas: Aguardando você configurar
  • ⏳ Erro resolvido: Será resolvido após configurar

Tempo estimado total: 5 minutos
Dificuldade: ⭐ Fácil
Impacto: 🔴 Crítico para produção

Próximo passo: Acesse o Convex Dashboard e configure as variáveis! 🚀