sgse-app/PROBLEMA_BETTER_AUTH_E_SOLUCAO.md

🐛 PROBLEMA IDENTIFICADO - Better Auth

Data: 27/10/2025
Status: ⚠️ Erro detectado

---

📸 SCREENSHOT DO ERRO

Erro:

Package subpath './env' is not defined by "exports" in @better-auth/core/package.json

---

🔍 DIAGNÓSTICO

Problema:

• O better-auth versão 1.3.29 tem um bug de importação
• Está tentando importar @better-auth/core/env que não existe nos exports do pacote
• O cache do Bun está mantendo a versão problemática

Arquivos Afetados:

• apps/web/src/lib/auth.ts - Configuração do cliente de autenticação
• apps/web/package.json - Dependências

---

✅ SOLUÇÃO MANUAL (RECOMENDADA)

Passo 1: Parar TODOS os servidores

Abra o Gerenciador de Tarefas e mate esses processos:

• node.exe
• bun.exe
• Feche todos os terminais do PowerShell que estão rodando o projeto

Ou no PowerShell como Admin:

taskkill /F /IM node.exe
taskkill /F /IM bun.exe

Passo 2: Limpar completamente o cache

cd "C:\Users\Deyvison\OneDrive\Desktop\Secretaria de Esportes\Tecnologia da Informacao\SGSE\sgse-app"

# Limpar tudo
Remove-Item -Path "node_modules" -Recurse -Force
Remove-Item -Path "apps\web\node_modules" -Recurse -Force
Remove-Item -Path "packages\backend\node_modules" -Recurse -Force  
Remove-Item -Path "bun.lock" -Force
Remove-Item -Path ".bun" -Recurse -Force -ErrorAction SilentlyContinue

Passo 3: Reinstalar com a versão correta

Já ajustei o package.json para usar a versão 1.3.27 do better-auth.

# Na raiz do projeto
bun install

Passo 4: Reiniciar os servidores

Terminal 1 - Backend:

cd packages\backend
bunx convex dev

Terminal 2 - Frontend:

cd apps\web
bun run dev

Passo 5: Testar

Acesse: http://localhost:5173

---

🔧 SOLUÇÃO ALTERNATIVA (SE PERSISTIR)

Se o problema continuar mesmo depois de limpar, tente usar npm em vez de bun:

# Limpar tudo primeiro
Remove-Item -Path "node_modules" -Recurse -Force
Remove-Item -Path "apps\web\node_modules" -Recurse -Force
Remove-Item -Path "bun.lock" -Force

# Instalar com npm
npm install

# Iniciar com npm
cd apps\web
npm run dev

---

📊 STATUS ATUAL

Item	Status	Observação
Backend Convex	✅ Funcionando	Porta 3210, dados populados
Banco de Dados	✅ OK	3 funcionários cadastrados
Frontend	❌ Erro 500	Problema com better-auth
Configuração	✅ Correta	.env configurado
Versão Better Auth	⚠️ Ajustada	Mudou de 1.3.29 para 1.3.27

---

🎯 O QUE DEVE FUNCIONAR DEPOIS

Após seguir os passos acima:

1. ✅ Página inicial carrega
2. ✅ Login funciona
3. ✅ Dashboard aparece
4. ✅ Listagem de funcionários funciona
5. ✅ Todas as funcionalidades operacionais

---

📝 RESUMO EXECUTIVO

Problema: Versão incompatível do better-auth (1.3.29)
Causa: Bug no pacote que tenta importar módulo inexistente
Solução: Downgrade para versão 1.3.27 + limpeza completa do cache
Próximo Passo: Seguir os 5 passos acima manualmente

---

⚠️ IMPORTANTE

POR QUE PRECISA SER MANUAL:

O bun está mantendo cache antigo que não consigo limpar remotamente. É necessário:

1. Matar todos os processos
2. Limpar manualmente as pastas
3. Reinstalar tudo do zero

Isso vai resolver definitivamente o problema!

---

Criado em: 27/10/2025
Tempo estimado para solução: 5 minutos
Dificuldade: ⭐ Fácil (apenas copiar e colar comandos)

---

🚀 Depois de seguir os passos, teste em http://localhost:5173!