Painel de Recargas - Guia de Instalação Visual

📋 Pré-requisitos

🟢

Node.js

Versão 18 ou superior

📦

NPM ou Yarn

Gerenciador de pacotes

🗄️

Banco de Dados

PostgreSQL / MySQL / SQLite

ℹ️ Verificar Instalações

node --version  # Deve retornar v18.x.x ou superior
npm --version   # Verifica NPM instalado
                    

🔧 Instalação do Backend

1 Navegue até o diretório do backend

cd backend

2 Instale as dependências

npm install
# ou usando Yarn:
yarn install
                            

📥 O que está sendo instalado?

Express, Prisma ORM, JWT, dependências de autenticação e APIs

3 Configure as variáveis de ambiente

# Crie o arquivo .env
cp .env.example .env

# Edite com suas configurações:
DATABASE_URL="postgresql://user:password@localhost:5432/painel_recargas"
JWT_SECRET="seu_segredo_aqui"
PORT=3000
                            

⚠️ Importante

Nunca commit o arquivo .env com dados sensíveis!

4 Execute as migrations do banco de dados

npx prisma migrate dev
# Este comando irá:
# - Criar o banco de dados
# - Aplicar todas as migrations
# - Gerar o Prisma Client
                            

5 Inicie o servidor de desenvolvimento

npm run dev
# ou usando Yarn:
yarn dev
                            

✅ Backend Rodando!

Servidor disponível em http://localhost:3000

🎨 Instalação do Frontend

1 Navegue até o diretório do frontend

cd frontend
# Se estiver no backend, volte ao root primeiro:
cd ..
cd frontend
                            

2 Instale as dependências

npm install
# ou usando Yarn:
yarn install
                            

3 Configure o arquivo de ambiente (se necessário)

# Crie .env.local
VITE_API_URL=http://localhost:3000/api
                            

4 Inicie o servidor de desenvolvimento

npm run dev
# ou usando Yarn:
yarn dev
                            

🎉 Frontend Rodando!

Aplicação disponível em http://localhost:5173

🚀 Comandos Rápidos

Backend

# Setup completo
cd backend
npm install
npx prisma migrate dev
npm run dev

# Outros comandos úteis:
npm run build      # Build produção
npm run start      # Produção
npx prisma studio  # GUI do banco
                        

Frontend

# Setup completo
cd frontend
npm install
npm run dev

# Outros comandos úteis:
npm run build      # Build produção
npm run preview    # Preview build
npm run lint       # Verificar código
                        

🔍 Resolução de Problemas

❌ Erro: "Port already in use"

Solução: Mude a porta no arquivo .env ou encerre o processo na porta

# Linux/Mac - Encontrar processo:
lsof -i :3000
kill -9 [PID]

# Windows:
netstat -ano | findstr :3000
taskkill /PID [PID] /F
                    

❌ Erro de conexão com banco de dados

Solução: Verifique se o banco está rodando e se a DATABASE_URL está correta

# Testar conexão Prisma:
npx prisma db push
npx prisma studio
                    

❌ Módulos não encontrados

Solução: Limpe o cache e reinstale

rm -rf node_modules package-lock.json
npm install
                    

⚙️ Guia de Instalação