Skip to content

2. Capítulo 1 - Configuração do ambiente de trabalho

2.1. Instalar as ferramentas

  1. Node.js: baixe e instale a versão 22 (ou posterior) em nodejs.org. Verifique a instalação em um terminal:
    node --version
    npm --version
    
  1. Visual Studio Code (VSCode): disponível para download gratuito em code.visualstudio.com. Instale a extensão “TypeScript and JavaScript Language Features” (geralmente já incluída).
  2. A CLI do [NestJS] e a CLI do [Angular] : duas ferramentas de linha de comando instaladas uma única vez. Em um terminal do VSCode:
    npm install -g @nestjs/cli
    npm install -g @angular/cli
    
  1. [MySQL] 8: instale, por exemplo, com XAMPP, Laragon (no Windows) ou diretamente com o [MySQL] Community Server. Uma ferramenta gráfica de administração (phpMyAdmin, [MySQL] Workbench, DBeaver, HeidiSQL…) facilita o restante do processo. Daqui em diante, usa-se a ferramenta Laragon.
  2. Postman: disponível para download gratuito em postman.com.

Se você baixou o código, ele está em duas pastas:

Image

  • em [1], o cliente [Angular];
  • em [2], o servidor [NestJS];

Abra a pasta [2] com o Visual Studio [File / Open Folder]:

Image

2.2. Criar o banco de dados

Para criar o banco de dados [MySQL] usado pelo servidor [NestJS], usaremos a ferramenta Laragon. Em setembro de 2026, o Laragon está disponível na URL [Download Laragon – Fast & Modern Dev Environment ]. O Laragon inclui ferramentas que permitem instalar um servidor PHP, o SGBD e servidores [MySQL]:

Image

  • em [1], um servidor web Apache;
  • em [2], o SGBD [MySQL];
  • em [3], uma ferramenta de mensagens que não usaremos;
  • [4] inicia todos os serviços (Apache, [MySQL], MailPit);
  • [5] exibe a página web da URL [http://localhost]. Por padrão, essa URL remete à pasta <laragon-install>\www, em que <laragon-install> é a pasta de instalação do Laragon;
  • em [6], inicia a ferramenta HeidiSQL, que permite gerenciar bancos de dados MySQL. Usaremos essa ferramenta para criar o banco de dados usado pelo servidor [NestJS];
  • em [7], abre um terminal; todos os binários necessários ao Laragon estão no PATH;
  • em [8], abre o Windows Explorer na pasta associada à URL [http://localhost];

A pasta de instalação do Laragon contém os seguintes itens:

 
  • Em [1], a pasta [bin] contém várias aplicações:
  • em [1], o servidor web Apache;
  • em [2], um terminal de linha de comando;
  • em [3], um cliente [git] que permite gerenciar as diferentes versões de um projeto;
  • em [4], um gerenciador de banco de dados;
  • [5], um gerenciador de e-mail;
  • [6], o SGBD [MySQL];
  • [7], outro servidor web;
  • em [8], [node.js] para executar scripts JavaScript;
  • [9], um editor de texto;
  • em [10], o interpretador PHP;
  • [11], o interpretador [Python];
  • [12], um servidor de cache;

O Laragon vem com um ambiente de desenvolvimento completo. Neste curso, usaremos apenas o SGBD [MySQL] [6] e o [heidisql] para o gerenciamento gráfico;

Para criar o banco de dados [MySQL] exigido pelo servidor [NestJS], proceda da seguinte forma:

 
  • Em [1], todos os serviços devem estar iniciados;
  • Em [2], a opção [Database] permite gerenciar o banco de dados;

A opção [Database] inicia um utilitário chamado HeidiSQL:

  • Em [1], você pode selecionar diversas opções de SGBD. O valor padrão proposto é o SGBD MySQL. Ele serve;
  • em [2], você se conecta ao HeidiSQL;
  • Em [1-2], execute o arquivo SQL e depois selecione o arquivo [dbrdvmedecins.sql], que você encontrará na pasta [rdvmedecins-nestjs-server/database]:

Image

A execução do arquivo [3] criará o banco de dados [dbrdvmedecins] usado pelo servidor [NestJS]. Para visualizá-lo, pressione F5 no HeidiSQL para atualizar a exibição:

Image

O banco de dados [dbrdvmedecins] foi criado. Você pode ver seu conteúdo:

Image

  • em [1-3], a tabela [clients];
    • [id] é a chave primária da tabela;
    • [version] é o número de versão da linha. Esse número é incrementado a cada modificação da linha;
    • [title, last_name, first_name] identificam a pessoa;

Image

  • em [1-3], a tabela [doctors];
    • [id] é a chave primária da tabela;
    • [version] é o número de versão da linha;
    • [title, last_name, first_name] identificam a pessoa;

Image

  • Em [1-3], a tabela dos horários de consulta dos médicos, [slots]:
    • [id]: chave primária;
    • [version]: número de versão da linha;
    • [doctor_id]: chave estrangeira que referencia a chave primária do médico;
    • [start_hour, start_minute]: hora e minutos do início da consulta. Assim, [8,20] significa 8h20;
    • [end_hour, end_minute]: hora e minutos do fim da consulta.

Image

  • Em [1-3], a tabela [appointments] das consultas agendadas;
    • [id]: chave primária;
    • [version]: número de versão;
    • [day]: data da consulta;
    • [slot_id]: chave estrangeira que referencia a chave primária do horário da consulta. Como um horário está ligado a um médico, sabemos qual médico atende essa consulta;
    • [client_id]: chave estrangeira que referencia o número (chave primária) do paciente da consulta;

Image

  • em [1-3], a tabela [users], que lista os usuários autorizados a usar a aplicação [NestJS];
    • [id, version]: chave primária, número de versão;
    • [login, password]: credenciais do usuário;
    • [name]: nome do usuário;
    • [role]: o papel do usuário. [ADMIN] tem todos os direitos de acesso. [USER] tem acesso somente leitura. Esse usuário pode ver a agenda de um médico, mas não pode agendar nem cancelar uma consulta;

2.3. Iniciar o servidor [NestJS] pela primeira vez

Na pasta [rdvmedecins-nestjs-server], digite os seguintes comandos em um terminal:

npm install
cp .env.example .env

O arquivo [.env] define variáveis de ambiente:

# -----------------------------------------------------------------------
# Arquivo de configuração de exemplo.
# Copie este arquivo para [.env] e depois adapte os valores à sua máquina.
# O arquivo [.env] nunca deve ser compartilhado nem commitado (senhas).
# -----------------------------------------------------------------------

# porta de escuta do servidor NestJS (o servidor Spring original escutava na 8080)
PORT=8080

# parâmetros de conexão com o banco de dados MySQL [dbrdvmedecins]
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=
DB_DATABASE=dbrdvmedecins

# somente em desenvolvimento: o TypeORM pode criar/atualizar automaticamente
# as tabelas a partir das entidades. Está desativado aqui porque fornecemos nosso
# próprio script SQL [database/dbrdvmedecins.sql], como fazia o projeto Spring original.
DB_SYNCHRONIZE=false

# -----------------------------------------------------------------------
# autenticação (veja src/auth/)
# -----------------------------------------------------------------------
# chave secreta usada para assinar/verificar tokens JWT - DEVE ser alterada
# em produção (uma string aleatória longa, nunca commitada).
JWT_SECRET=change-me-to-a-long-random-string
# validade de um token JWT (veja a documentação da biblioteca [ms]:
# "60", "2h", "7d"...)
JWT_EXPIRES_IN=2h

Adapte o arquivo .env recém-criado à sua instalação do [MySQL] (nome de usuário, senha, porta). Como a autenticação foi adicionada (veja o Capítulo 3), esse arquivo contém também uma chave JWT_SECRET: o valor de exemplo serve para acompanhar este documento, mas deve ser substituído por uma cadeia aleatória exclusiva sua antes de qualquer uso real.

Em seguida, inicie o servidor:

npm run start:dev

O console exibe, em ordem: a inicialização do módulo [NestJS], a lista de rotas expostas pelos controllers (RdvMedecinsController, depois AuthController e sua rota /login) e, por fim, a confirmação da inicialização:

[Nest] RoutesResolver RdvMedecinsController {/}:
[Nest] RouterExplorer Mapped {/getAllDoctors, GET} route
[Nest] RouterExplorer Mapped {/getAllClients, GET} route
[Nest] RouterExplorer Mapped {/getAllSlots/:doctorId, GET} route
[Nest] RouterExplorer Mapped {/getDoctorAppointmentsOfDay/:doctorId/:day, GET} route
[Nest] RouterExplorer Mapped {/getDoctorScheduleOfDay/:doctorId/:day, GET} route
[Nest] RouterExplorer Mapped {/getDoctorById/:id, GET} route
[Nest] RouterExplorer Mapped {/getClientById/:id, GET} route
[Nest] RouterExplorer Mapped {/getSlotById/:id, GET} route
[Nest] RouterExplorer Mapped {/getAppointmentById/:id, GET} route
[Nest] RouterExplorer Mapped {/addAppointment, POST} route
[Nest] RouterExplorer Mapped {/deleteAppointment, POST} route
[Nest] RoutesResolver AuthController {/}:
[Nest] RouterExplorer Mapped {/login, POST} route
[Nest] NestApplication Nest application successfully started
[RdvMedecins] NestJS server started on http://localhost:8080

Essa saída do console confirma que o servidor está de fato escutando na porta 8080, exatamente a mesma porta do servidor Spring Boot do documento original, escolhida deliberadamente por esse motivo.

2.4. Testar o servidor com um navegador

Como a autenticação foi adicionada (Capítulo 3), todas as rotas de RdvMedecinsController exigem um token JWT válido: portanto, um navegador sozinho não pode mais ser usado para testá-las diretamente. Por exemplo:

http://localhost:[8080/getAllDoctors]

agora retorna um erro 401 Unauthorized sem token:

Image

Esse é o comportamento esperado: essa resposta confirma que o servidor protege corretamente suas rotas. O Postman (próxima seção) é necessário para obter um token e depois usá-lo.

2.5. Testar o servidor [NestJS] com o Postman

A ferramenta Postman está disponível na URL [https://www.postman.com/downloads/]. Talvez seja necessário criar uma conta.

Inicie todos os serviços do Laragon e depois abra o aplicativo de desktop do Postman:

  • Em [1-2], crie uma requisição HTTP para consultar o servidor de gerenciamento de consultas dos médicos;

2.5.1. Fazer login e obter um token

  1. Crie uma nova requisição no Postman com o método POST, URL http://localhost:8080/login;
  2. Na aba [Body], selecione “raw” e depois o formato JSON e digite: {"login": "admin", "password": "admin"} (ou “user/user” para testar o papel USER);
  3. Envie a requisição.

Image

  • em [1-2], a requisição POST ao servidor [NestJS] em execução na porta 8080;
  • em [3-5], o corpo da requisição. Ele transmite ao servidor a string JSON contendo as credenciais do usuário que tenta fazer login, no caso admin/admin;
  • em [6], a resposta do servidor;
  • em [7], o token de autenticação que as requisições seguintes devem enviar ao servidor para indicar “já me autentiquei”;

Copie o valor de accessToken: é o token que agora deve ser incluído em todas as requisições seguintes. No exemplo acima, o token a copiar é “eyJ...zoM” (sem as aspas).

2.5.2. Chamar uma rota protegida com o token

Para GET /getAllDoctors (ou qualquer outra rota de RdvMedecinsController), no Postman, na aba Authorization, selecione o tipo Bearer Token e cole o token copiado acima (o Postman adicionará então automaticamente o cabeçalho Authorization: Bearer <token>).

Image

  • em [1-2], a requisição enviada ao servidor. Ela solicita a lista de médicos do banco de dados;
  • Em [3-5], a requisição deve incluir o token de autenticação. Em [4], selecione [Bearer Token] e, em [5], cole o token de autenticação copiado anteriormente;
  • em [7], a resposta do servidor;

2.5.3. Testar as rotas POST (/addAppointment, /deleteAppointment)

Siga o mesmo procedimento acima (método POST, corpo JSON, Bearer Token), exatamente como o documento original usava a extensão do Chrome “Advanced Rest [Client]” para as mesmas rotas.

Nota: você encontra as seguintes requisições do Postman na coleção [rdvmedecins-nestJS.postman_collection.json]:

Image

No Postman, pressione Ctrl-0 para carregar a coleção:

Image

  • Clique em [1] para carregar a coleção e selecione o arquivo da coleção. Depois de carregada, ela exibe suas requisições:

Image

Para testar /addAppointment com o token de uma conta ADMIN:

  1. requisição do Postman, método POST, URLhttp://localhost:8080/addAppointment;
  2. aba Authorization: Bearer Token, token do admin;
  3. aba [Body], raw, JSON: {"day": "2026-09-13", "clientId": 1, "slotId": 5};
  4. Envie a requisição.

Image

Você pode verificar com o HeidiSQL que uma consulta foi adicionada ao banco de dados:

Image

Para testar /deleteAppointment, siga o mesmo procedimento com o corpo {"appointmentId": 2} (o id da consulta a cancelar (8) acima).

Image

  • em [4], onde o número acima é o da consulta a excluir;

Image

  • em [5-7], o token de autenticação;
  • em [9], a resposta do servidor. [status=0] indica que a operação foi bem-sucedida. Você pode verificar isso com o HeidiSQL:

Image

  • em [3], a consulta nº 2 não existe mais;

Experimente: repita a mesma requisição /addAppointment usando o token da conta USER (user/user) no lugar do token do admin: a resposta passa a ser 403 Forbidden, com a mensagem “role [USER] does not allow this action (required role: ADMIN)”, uma demonstração concreta do controle de acesso baseado em papéis implementado no Capítulo 3.

2.6. Iniciar o cliente [Angular] pela primeira vez

Na pasta rdvmedecins-angular-client (o servidor [NestJS] deve estar em execução antes):

npm install
npm start

Em seguida, abra http://localhost:4200 em um navegador: a tela de login aparece primeiro (veja o Capítulo 5).

Image

  • em [1], o servidor da URL que serve a aplicação [Angular];
  • [2], a URL do servidor [NestJS] que gerencia o banco de dados [rdvmedecins];

É importante entender que há aqui dois servidores web, um dos quais atua como cliente do outro.

Dois botões rotulados “FR” e “EN” no canto superior direito permitem mudar a interface para francês, mesmo antes do login. Entre com uma das duas contas de demonstração (admin/admin, acesso total, ou user/user, somente leitura) para acessar o restante da aplicação. O Capítulo 5 traz um guia detalhado de uso desse cliente, com capturas de tela para cada etapa.