Resolução de Problemas

🚨 Problemas Comuns

1. Servidor não inicia

Erro: "Port already in use"

# Verificar qual processo está usando a porta
sudo lsof -i :3000

# Matar o processo
sudo kill -9 PID

Erro: "Module not found"

# Reinstalar dependências
rm -rf node_modules package-lock.json
npm install

2. Problemas de Banco de Dados

SQLite: "no such table"

# Aplicar migrações
npm run migrate:db

PostgreSQL: "connection refused"

# Verificar se PostgreSQL está rodando
sudo systemctl status postgresql

# Iniciar se necessário
sudo systemctl start postgresql

3. Problemas de Pagamento

Stripe: "Invalid API key"

• Verificar se STRIPE_SECRET_KEY está correto

• Confirmar se está usando chave de produção/sandbox apropriada

PayPal: "Authentication failed"

• Verificar PAYPAL_CLIENT_ID e PAYPAL_CLIENT_SECRET

• Confirmar configuração de sandbox/live

4. Problemas de Performance

Alta latência

1. Verificar conexões de banco de dados

2. Revisar queries N+1

3. Implementar cache adequado

4. Otimizar índices do banco

Memory leaks

1. Usar node --inspect para debugging

2. Verificar event listeners não removidos

3. Revisar conexões não fechadas

🔍 Debugging

Logs Detalhados

LOG_LEVEL=debug
NODE_ENV=development

Health Checks

# Verificar saúde do sistema
curl http://localhost:3000/api/health

# Verificar provedores
curl http://localhost:3000/api/monitoring/providers

Métricas de Performance

# Acessar métricas Prometheus
curl http://localhost:3000/metrics

📞 Suporte

Logs Importantes

1. logs/application.log - Logs da aplicação

2. logs/error.log - Logs de erro

3. logs/audit.log - Logs de auditoria

Comandos Úteis

# Verificar versão
node --version

# Verificar configuração
npm run config:check

# Testar conectividade
npm run test:connectivity

---

Documentação atualizada: December 2024