GitLab

Descrição

Esta seção apresentará todas as configurações necessárias dos ambientes do Front-end e Back-end.

Sumário

• Instalação de uma IDE
• Configuração do Front-end
• Configuração do Back-end

Instalação de uma IDE:

1. IntelliJ IDEA:
   • Acesse a página de downloads do IntelliJ IDEA.
   • Baixe a versão Community (gratuita) ou a versão Ultimate (paga, com mais recursos).
   • Siga as instruções de instalação para o seu sistema operacional.
   • Após a instalação:
     1. Abra o IntelliJ IDEA.
     2. Selecione Open e navegue até o diretório do projeto.
     3. Selecione o diretório e clique em OK para abrir o projeto.
2. Visual Studio Code (VSCode):
   • Acesse a página de downloads do VSCode.
   • Baixe e instale a versão apropriada para o seu sistema operacional.
   • Após a instalação, abra o VSCode e importe o projeto:
     1. Abra o VSCode.
     2. Selecione File > Open Folder e navegue até o diretório do projeto.
     3. Selecione o diretório e clique em Open.

Configuração do Front-end:

Pré-requisitos

1. Node.js
2. npm

Passo 1: Instalando Node.js e npm

1. Acesse o site oficial do Node.js: Node.js Downloads.
2. Siga as instruções do instalador. Durante a instalação, você pode selecionar as opções padrão.
3. Você pode verificar se o Node.js está instalado rodando node -v no terminal. Para o npm, use npm -v.

node -v
npm -v

Passo 2: Clonando o Repositório

1. Navegue até o diretório onde você deseja clonar o projeto
2. Clone o repositório usando o comando git clone

git clone https://link_copiado_do_gitLab

Passo 3: Iniciando

Para começar, siga os passos abaixo para instalar as dependências e iniciar o servidor de desenvolvimento:

npm install
npm run dev

Passo 4: Executando a Aplicação

Após configurar e instalar as dependências, você pode iniciar a aplicação:

1. Execute o comando npm run dev para iniciar o servidor de desenvolvimento.
2. Abra http://localhost:3000 no seu navegador para visualizar a aplicação.

Configuração do Back-end:

Pré-requisitos

Certifique-se de ter a versão atualizada dos seguintes itens instalados em sua máquina:

1. Java Development Kit (JDK)
2. IDE (IntelliJ IDEA ou Visual Studio Code)
3. Apache Maven

Passo 1: Instalar o JDK

1. Baixar e instalar o JDK:
   • Acesse a página de downloads do JDK ou o OpenJDK.
   • Baixe a versão mais recente disponível (estou utilizando o JDK 22).
   • Siga as instruções de instalação para o seu sistema operacional.
2. Configurar a variável de ambiente JAVA_HOME:
   • Windows:
     1. Abra as Configurações do Sistema e vá para Variáveis de Ambiente.
     2. Adicione uma nova variável de sistema chamada JAVA_HOME com o caminho para a pasta onde o JDK foi instalado.
   • macOS/Linux:
     1. Abra o terminal e edite o arquivo de configuração do shell (.bashrc, .bash_profile, .zshrc, etc.).
     2. Adicione a linha: export JAVA_HOME=/caminho/para/o/jdk
     3. Execute source ~/.bashrc (ou o arquivo correspondente) para aplicar as alterações.
3. Verificar a instalação:
   • Abra um terminal e execute java -version e javac -version para garantir que o JDK está instalado corretamente.

Passo 2: Instalar o Apache Maven

1. Baixar e instalar o Maven:
   • Acesse a página de downloads do Apache Maven.
   • Baixe o arquivo binário (por exemplo, apache-maven-x.y.z-bin.zip).
   • Extraia o arquivo baixado para um diretório de sua escolha.
2. Configurar a variável de ambiente MAVEN_HOME:
   • Windows:
     1. Abra as Configurações do Sistema e vá para Variáveis de Ambiente.
     2. Adicione uma nova variável de sistema chamada MAVEN_HOME com o caminho para a pasta onde o Maven foi extraído.
     3. Adicione o diretório bin do Maven ao PATH:
        • Selecione a variável Path e clique em Editar.
        • Adicione o caminho %MAVEN_HOME%\bin.
   • macOS/Linux:

     1. Abra o terminal e edite o arquivo de configuração do shell (.bashrc, .bash_profile, .zshrc, etc.).

     2. Adicione as linhas:

        export MAVEN_HOME=/caminho/para/o/apache-maven-x.y.z
        export PATH=$MAVEN_HOME/bin:$PATH

     3. Execute source ~/.bashrc (ou o arquivo correspondente) para aplicar as alterações.

3. Verificar a instalação:
   • Abra um terminal e execute mvn -v para garantir que o Maven está instalado corretamente.

Passo 3: Executar o Projeto

1. Importar o Projeto:
   • No IntelliJ IDEA, o projeto deve ser carregado automaticamente. Se necessário, sincronize o projeto com o Maven ou Gradle (ícones geralmente localizados na parte superior direita da janela do IntelliJ).
   • No VSCode, o projeto deve ser carregado automaticamente após a abertura. Você pode precisar configurar a execução do Maven ou Gradle conforme necessário.
2. Executar o Projeto:
   • No IntelliJ IDEA:
     1. Navegue até o arquivo principal de aplicação;
     2. Clique com o botão direito no arquivo e selecione Run 'Application'.
   • No VSCode:
     1. Abra o terminal integrado (Ctrl+ `).
     2. Navegue até o diretório do projeto se necessário.
     3. Execute o comando ./mvnw spring-boot:run.