| Home | Escopo | Processo | Design/Mockups | Configuração | Arquitetura | Gerência | BD | Qualidade | Frontend | Backend | Analytics | 
|---|
Passo a Passo para Instalação e Configuração do Ambiente
Recomendação: Instalação do WSL (Windows Subsystem for Linux) - toda a configuração será baseada nele
No caso de utilizar linux ou mac só pular essa etapa e a parte do docker para Windows, olhar a instalação do docker aqui.
- 
Habilite o WSL no Windows: - Abra o PowerShell como administrador e execute o seguinte comando:
wsl --install
- Reinicie o computador se solicitado.
 
- Abra o PowerShell como administrador e execute o seguinte comando:
- 
Escolha uma Distribuição Linux: - Após a reinicialização, instale uma distribuição Linux (ex: Ubuntu) pela Microsoft Store.
 
- 
Configure o WSL: - Abra o Ubuntu instalado e siga as instruções para configurar seu nome de usuário e senha.
 
- 
Atualize os pacotes da distribuição: - Execute os comandos:
sudo apt update sudo apt upgrade
 
- Execute os comandos:
1. Instalação do Docker
- 
Instale o Docker Desktop no Windows: - Baixe e instale o Docker Desktop a partir do site oficial.
- Durante a instalação, certifique-se de habilitar a integração com WSL 2.
 
- 
Verifique a instalação do Docker: - No terminal do WSL, execute:
docker --version
- O comando deve retornar a versão do Docker instalada.
 
- No terminal do WSL, execute:
2. Instalação do Git
- 
Instale o Git no seu terminal: - No terminal do WSL, execute o seguinte comando para instalar o Git:
sudo apt install git
 
- No terminal do WSL, execute o seguinte comando para instalar o Git:
- 
Configure o Git: - Após a instalação, configure o Git com seu nome de usuário e email:
git config --global user.name "Seu Nome" git config --global user.email "[email protected]"
 
- Após a instalação, configure o Git com seu nome de usuário e email:
- 
Verifique a instalação: - Verifique se o Git foi instalado corretamente:
git --version
 
- Verifique se o Git foi instalado corretamente:
3. Configuração para rodar o Frontend
- 
Instale o NVM (Node Version Manager) no WSL: - Baixe e instale o NVM executando:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
- Carregue o NVM no shell atual:
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
 
- Baixe e instale o NVM executando:
- 
Instale a versão LTS do Node.js usando NVM: - Liste as versões disponíveis:
nvm ls-remote
- Instale a versão LTS mais recente (por exemplo, 18.x):
nvm install --lts
- Use a versão instalada:
nvm use --lts
- Verifique a instalação:
node -v npm -v
 
- Liste as versões disponíveis:
- 
Entre no Frontend do Projeto: - No dentro do diretório de frontend, execute:
npm install
 
- No dentro do diretório de frontend, execute:
- 
Execute o Servidor de Desenvolvimento: - Inicie o servidor:
npm run dev
- O Vite iniciará o servidor de desenvolvimento, geralmente acessível em http://localhost:5173.
 
- Inicie o servidor:
4. Configuração para rodar o Backend
- 
Entre no Backend do Projeto, Construa e Inicie o Container:
- No diretório raiz do projeto, Execute os comandos:
docker-compose build docker-compose up #ou docker-compose up -d #para liberar seu terminal enquanto o container roda
- O NestJS deve estar rodando em http://localhost:3000.
 
- No diretório raiz do projeto, Execute os comandos:
5. Extra - Dicas de extensões para IDE
- Instale essas extensões do Visual Studio Code para facilitar o desenvolvimento:
