sgse-app/CRIAR_ENV_MANUALMENTE.md

🔧 CRIAR ARQUIVO .env MANUALMENTE (Método Simples)

⚡ Passo a Passo (2 minutos)

Passo 1: Abrir VS Code

Você já tem o VS Code aberto com o projeto SGSE.

---

Passo 2: Navegar até a pasta correta

No VS Code, no painel lateral esquerdo:

1. Abra a pasta packages
2. Abra a pasta backend
3. Você deve ver arquivos como package.json, convex/, etc.

---

Passo 3: Criar novo arquivo

1. Clique com botão direito na pasta backend (no painel lateral)
2. Selecione "New File" (Novo Arquivo)
3. Digite exatamente: .env (com o ponto no início!)
4. Pressione Enter

⚠️ IMPORTANTE: O nome do arquivo é .env (começa com ponto!)

---

Passo 4: Copiar e colar o conteúdo

Cole exatamente este conteúdo no arquivo .env:

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

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

---

Passo 5: Salvar

Pressione Ctrl + S para salvar o arquivo.

---

Passo 6: Verificar

A estrutura deve ficar assim:

packages/
└── backend/
    ├── convex/
    ├── .env          ← NOVO ARQUIVO AQUI!
    ├── package.json
    └── ...

---

Passo 7: Reiniciar servidores

Agora você precisa reiniciar os servidores para carregar as novas variáveis.

Terminal 1 - Convex:

Se o Convex já está rodando:

1. Pressione Ctrl + C para parar
2. Execute novamente:

   cd packages\backend
   bunx convex dev
   

Terminal 2 - Web:

Se o servidor Web já está rodando:

1. Pressione Ctrl + C para parar
2. Execute novamente:

   cd apps\web
   bun run dev
   

---

Passo 8: Validar ✅

No terminal do Convex, você deve ver:

✅ Sucesso (deve aparecer):

✔ Convex dev server running
✔ Functions ready!

❌ Erro (NÃO deve mais aparecer):

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

---

📋 CHECKLIST RÁPIDO

• Abri o VS Code
• Naveguei até packages/backend/
• Criei arquivo .env (com ponto no início)
• Colei o conteúdo com as 2 variáveis
• Salvei o arquivo (Ctrl + S)
• Parei o Convex (Ctrl + C)
• Reiniciei o Convex (bunx convex dev)
• Parei o Web (Ctrl + C)
• Reiniciei o Web (bun run dev)
• Verifiquei que erros pararam ✅

---

🆘 PROBLEMAS COMUNS

"Não consigo ver o arquivo .env após criar"

Arquivos que começam com . ficam ocultos por padrão:

• No VS Code, eles aparecem normalmente
• No Windows Explorer, você precisa habilitar "Mostrar arquivos ocultos"

"O erro ainda aparece"

1. Confirme que o arquivo se chama exatamente .env
2. Confirme que está na pasta packages/backend/
3. Confirme que reiniciou AMBOS os servidores (Convex e Web)
4. Aguarde 10 segundos após reiniciar

"VS Code não deixa criar arquivo com nome .env"

Tente:

1. Criar arquivo temp.txt
2. Renomear para .env
3. Cole o conteúdo
4. Salve

---

📦 CONTEÚDO COMPLETO DO .env

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

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

⚠️ Copie exatamente como está acima!

---

🎉 PRONTO!

Após seguir todos os passos:

• ✅ Arquivo .env criado
• ✅ Variáveis configuradas
• ✅ Servidores reiniciados
• ✅ Erros devem ter parado
• ✅ Sistema seguro e funcionando!

---

Tempo total: 2 minutos
Dificuldade: ⭐ Muito Fácil
Método: 100% manual via VS Code