SESP/sgse-app
2
0
Fork 0
Code Issues 3 Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
929633492d22b27ab7e40a8dfec2c902367fc9a5
sgse-app/INSTRUCOES_CORRETAS.md

4.8 KiB
Raw Blame History

✅ 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

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

# Segurança Better Auth
BETTER_AUTH_SECRET=+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=

# URL da aplicação
SITE_URL=http://localhost:5173

Passo 2: Reiniciar servidores

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

$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"

# 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! 🚀