KaDelanegri/Help-Desk-Project

Portal de Suporte Técnico (Help Desk) Web utilizando: Node.js, Express, MongoDB e Handlebars.

PT-BR:

Help Desk Project

Portal de Suporte Técnico (Help Desk) usando:

• Node.js,
• Express,
• MongoDB and
• Handlebars.

Passo 1: Configuração do Ambiente

1.1. Certifique-se de ter o Node.js instalado em sua máquina. Você pode baixá-lo em https://nodejs.org/.

1.2. Instale o MongoDB em sua máquina, se ainda não estiver instalado https://www.mongodb.com/try/download/community. Você pode encontrar instruções de instalação em https://docs.mongodb.com/manual/installation/.

Fonte: https://www.youtube.com/watch?v=l4HeaNRi8f8

1.3. Lembre-se de habilitar a opção Install MongoDB Compass para que seja instalada a versão Graphical User Interface (GUI) do MongoDB.

1.4. Para verificar se o Server foi realmente instalado e está em execução, buscar por MongoDB em Serviços e ele estará em execução:

1.5. A porta padrão será a 27017, clicar em Connect:

1.6. Automaticamente são criados 3 bancos de dados o admin, o config e local:

2.0. Criação da Pasta de Trabalho:

2.1. Na barra de pesquisa do Windows pesquisar por CMD e irá abrir o prompt de comando;

2.2. O comando CD + TAB irá alternar entre as pastas que já estão criadas no C:\Users\seu_usuario_windows>cd pastas (no caso escolhi a pasta Desktop) + enter

2.3. Dentro da pasta desejada acionar o comando MKDIR + Nome_da_sua_pasta para criar uma nova pasta;

2.4. Acionar novamente o comando cd + Nome_da_sua_pasta para entrarmos nesta nova pasta:

3.0. Criação do novo projeto Node.js e instalar as dependências necessárias:

3.1. Utilizar o comando npm init -y

3.2. Utilizar o comando: npm install express mongoose express-handlebars

4.0. Criação dos Arquivos do Projeto

4.1. Crie uma pasta chamada views dentro do diretório do seu projeto:

4.2. Com o comando echo criaremos os arquivos com a extensão .handlebars, que é comumente usada para arquivos de modelo HTML quando você está trabalhando com o mecanismo de modelo Handlebars no Node.js.

OBS.: com o comando cd na pasta views conseguimos visualizar os arquivos criados.

4.3. Com o comando cd.. vamos descer um nível de diretório e retornar ao diretório principal HelpDeskProject e criar o arquivo .js com o comando echo. > app.js:

OBS.: Para confirmar se o arquivo foi criado, pressione a tecla TAB até que o arquivo seja exibido.

5.0. Configuração do Express e Handlebars

5.1. Abra o arquivo app.js em um editor de texto simples, como o Bloco de Notas ou Visual Studio Code, no meu caso estou utilizando o Microsoft Visual Studio Community 2022 (64 bits) - Versão 17.5.2

5.2. Adicione o seguinte código no arquivo para configurar o Express e Handlebars:

const express = require('express');
const exphbs = require('express-handlebars');
const app = express();
const PORT = process.env.PORT || 3000;

app.engine('handlebars', exphbs());
app.set('view engine', 'handlebars');
app.use(express.urlencoded({ extended: true }));

Executando a Aplicação:

1. No prompt de comando executar: node app.js.

2. Abra o navegador no endereço http://localhost:3000 para ver a aplicação.

Fontes:

• Como instalar o MongoDB (2022) PT-BR: YouTube.
• Site oficial do Node.js Node.js official website.
• Site oficial do MongoDB MongoDB official website.

EN:

Help Desk Project

Overview

This project builds a simple Technical Support Portal (Help Desk) using

• Node.js,
• Express,
• MongoDB and
• Handlebars.

Installation and Setup

1. Ensure Node.js is installed on your machine. You can download it from Node.js official website.
2. Install MongoDB on your machine if it isn't already installed. You can download it from MongoDB official website. Installation instructions can be found on the MongoDB documentation page.
3. Remember to enable the Install MongoDB Compass option to install the Graphical User Interface (GUI) version of MongoDB.
4. To verify if the server is truly installed and running, search for MongoDB in Services and it will be running.

5. The default port will be 27017.

6. Automatically, 3 databases are created: admin, config and local.

Project Creation

1. Create a new directory for your project in the desired location.

2. Initialize a new Node.js project in this directory by running npm init -y in your terminal.

3. Install the necessary dependencies by running npm install express mongoose express-handlebars in your terminal.

Project Files

1. Create a new directory named 'views' within your project directory.

2. Create new .handlebars files in the 'views' directory for your HTML templates.

3. Create a new file named 'app.js' in the main project directory.

4. Open 'app.js' in a text editor and add the following code to configure Express and Handlebars:

const express = require('express');
const exphbs = require('express-handlebars');
const app = express();
const PORT = process.env.PORT || 3000;

app.engine('handlebars', exphbs());
app.set('view engine', 'handlebars');
app.use(express.urlencoded({ extended: true }));

Running the Application

1. Start the application by running node app.js in your terminal.

2. Open a web browser and navigate to http://localhost:3000 to view the application.

Sources

• How to install MongoDB (2022) PT-BR: YouTube.
• Node.js official website.
• MongoDB official website.