Skip to content

3. Capítulo 2 - Instalação do servidor [NestJS]

O cliente [Flutter] descrito neste documento precisa de um servidor para consultar: o servidor [NestJS] da aplicação [RdvMedecins], incluído com este documento na pasta [rdvmedecins-nestjs-server]. Como este documento se concentra no [Flutter], esse servidor é tratado como uma “caixa-preta”: este capítulo explica como instalá-lo, configurá-lo, criar seu banco de dados [MySQL], iniciá-lo e testá-lo, mas não examina seu código. Os leitores que quiserem aprender [NestJS] podem consultar o documento *Introdução à linguagem TypeScript e ao framework NestJS* (2026).

Este capítulo é essencialmente uma reedição do capítulo “Instalação de um servidor NestJS” do documento *Introdução à linguagem Dart por meio de exemplos* (2026), adaptado para outro servidor: o servidor de cálculo de imposto desse documento é substituído aqui pelo servidor [RdvMedecins], e seu banco de dados [dbimpots-2019] pelo banco de dados [dbrdvmedecins].

3.1. Instalação do Laragon

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 e o SGBD [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 corresponde à 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 [RdvMedecins];
  • Em [7], abre um terminal em que 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 inúmeras aplicações:
  • Em [1], o servidor web Apache;
  • em [2], um terminal de linha de comando;
  • em [3], um cliente [git] para versionar as diferentes versões de um projeto;
  • em [4], um gerenciador de banco de dados;
  • em [5], um gerenciador de e-mail;
  • em [6], o SGBD [MySQL];
  • [7], outro servidor web;
  • em [8], o [node.js] para executar scripts JavaScript;
  • [9], um editor de texto;
  • [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 a ferramenta [heidisql] para gerenciá-lo graficamente;

3.2. Instalação e configuração do servidor [NestJS]

A pasta [rdvmedecins-nestjs-server] tem a seguinte estrutura de diretórios:

rdvmedecins-nestjs-server/
├── package.json                  # dependências npm e scripts
├── tsconfig.json                 # configuração do compilador TypeScript
├── nest-cli.json                 # configuração do CLI do NestJS
├── .env.example                  # template do arquivo de configuração .env
├── database/
│   └── dbrdvmedecins.sql         # script de criação do banco de dados
└── src/
    ├── main.ts                   # ponto de entrada do servidor
    ├── app.module.ts             # módulo raiz
    ├── config/                   # conexão com o banco de dados
    ├── entities/                 # entidades TypeORM (uma classe por tabela)
    ├── domain/                   # objetos de negócio
    ├── repositories/             # acesso a dados (camada DAO)
    ├── business/                 # camada de negócio
    ├── web/                      # controller JSON e modelos de resposta
    └── auth/                     # autenticação JWT e papéis

Cada subpasta de [src/] contém seu próprio arquivo [README.md], que resume a finalidade dos arquivos que ela contém. O código-fonte desses arquivos não é abordado neste documento.

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 versionado (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 os tokens JWT - DEVE ser alterada
# em produção (uma string aleatória longa, nunca versionada).
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, esse arquivo também contém uma chave chamada JWT_SECRET: o valor de exemplo é adequado para acompanhar este documento, mas deve ser substituído por uma string aleatória só sua antes de qualquer uso real.

3.3. Criação do banco de dados

O banco de dados [dbrdvmedecins] reproduz a estrutura do documento original (2014, Spring 4 / [MySQL] 5): as mesmas tabelas ([doctors], [clients], [slots], [appointments], agora com nomes em inglês), as mesmas chaves estrangeiras e a mesma restrição de unicidade. A única adição nova, introduzida pela etapa de “autenticação” desta portabilidade, é a tabela [users]. As relações entre essas tabelas são as seguintes: um médico ([doctors]) tem vários horários ([slots], chave estrangeira [doctor_id]); uma consulta ([appointments]) associa um dia, um horário (e, portanto, um médico) e um cliente ([clients]); a tabela [users] é independente das outras quatro: ela serve exclusivamente para a autenticação.

3.3.1. [database/dbrdvmedecins.sql]

Image

  -- =========================================================================
  -- Banco de dados [dbrdvmedecins] - MySQL 8
  --
  -- Este script reproduz EXATAMENTE o esquema relacional do documento original
  -- (2014, Spring 4 / Spring Data / MySQL 5): mesmas tabelas, mesmas colunas,
  -- mesmas chaves estrangeiras, mesma restrição de unicidade. Apenas o mecanismo de banco de dados
  -- muda de nome (MySQL 5 -> MySQL 8), não a estrutura.
  --
  -- The original document used THREE tables (users, roles,
 -- users_roles) para permitir que um usuário tivesse VÁRIOS papéis.
 -- Como esta aplicação só conhece dois papéis mutuamente exclusivos
 -- (ADMIN, USER), simplificamos aqui para uma única coluna [role]
 -- na tabela [users] em vez de reconstruir a relação original
 -- muitos-para-muitos - uma simplificação didática deliberada, documentada
 -- no capítulo "Autenticação" do curso.
 -- =========================================================================

 -- recomeçamos de um banco de dados vazio a cada execução do script (prático em desenvolvimento)
 DROP TABLE IF EXISTS appointments;
 DROP TABLE IF EXISTS slots;
 DROP TABLE IF EXISTS clients;
 DROP TABLE IF EXISTS doctors;
 DROP TABLE IF EXISTS users;

 CREATE DATABASE IF NOT EXISTS dbrdvmedecins CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
 USE dbrdvmedecins;

 CREATE TABLE doctors (
   id         INT AUTO_INCREMENT PRIMARY KEY,
   version    INT NOT NULL DEFAULT 0,
   title      VARCHAR(5)  NOT NULL,
   last_name  VARCHAR(20) NOT NULL,
   first_name VARCHAR(20) NOT NULL
 );

 CREATE TABLE clients (
   id         INT AUTO_INCREMENT PRIMARY KEY,
   version    INT NOT NULL DEFAULT 0,
   title      VARCHAR(5)  NOT NULL,
   last_name  VARCHAR(20) NOT NULL,
   first_name VARCHAR(20) NOT NULL
 );

 CREATE TABLE slots (
   id           INT AUTO_INCREMENT PRIMARY KEY,
   version      INT NOT NULL DEFAULT 0,
   doctor_id    INT NOT NULL,
   start_hour   INT NOT NULL,
   start_minute INT NOT NULL,
   end_hour     INT NOT NULL,
   end_minute   INT NOT NULL,
   CONSTRAINT fk_slots_doctor FOREIGN KEY (doctor_id) REFERENCES doctors(id)
 );

 CREATE TABLE appointments (
   id         INT AUTO_INCREMENT PRIMARY KEY,
   version    INT NOT NULL DEFAULT 0,
   day        DATE NOT NULL,
   slot_id    INT NOT NULL,
   client_id  INT NOT NULL,
   CONSTRAINT fk_appointments_slot   FOREIGN KEY (slot_id)   REFERENCES slots(id),
   CONSTRAINT fk_appointments_client FOREIGN KEY (client_id) REFERENCES clients(id),
   CONSTRAINT unq1_appointments UNIQUE (day, slot_id)
 );

 CREATE TABLE users (
   id       INT AUTO_INCREMENT PRIMARY KEY,
   version  INT NOT NULL DEFAULT 0,
   login    VARCHAR(30) NOT NULL UNIQUE,
   password VARCHAR(100) NOT NULL,
   name     VARCHAR(40) NOT NULL,
   role     VARCHAR(10) NOT NULL
 );

 INSERT INTO doctors (title, last_name, first_name) VALUES
   ('Mme', 'PELISSIER', 'Marie'), ('Mr', 'TATOU', 'Paul'), ('Melle','DUPONT', 'Sophie');

 INSERT INTO clients (title, last_name, first_name) VALUES
   ('Mr', 'MARTIN', 'Jean'), ('Mme', 'DURAND', 'Alice'),
   ('Melle','BISTROU', 'Brigitte'), ('Mr', 'GERMAN', 'Luc');

 INSERT INTO slots (doctor_id, start_hour, start_minute, end_hour, end_minute) VALUES
   (1, 8, 0, 8, 20), (1, 8, 20, 8, 40), /* ... */ (1, 11, 40, 12, 0);

 INSERT INTO slots (doctor_id, start_hour, start_minute, end_hour, end_minute) VALUES
   (2, 14, 0, 14, 20), (2, 14, 20, 14, 40), /* ... */ (2, 17, 40, 18, 0);

 INSERT INTO appointments (day, slot_id, client_id) VALUES (CURDATE(), 2, 3);

 INSERT INTO users (login, password, name, role) VALUES
   ('admin', '$2b$10$YSNBJXXHX9mp13nPZb6YGu8M1jR6uvPwO1s2X73z0QAqBR7TOQjoq', 'Administrator', 'ADMIN'),
   ('user',  '$2b$10$6Cvoion7AgJkpYHw5N0jMuWPf8T90J28En56kWBL9PT0bXt7lwW7.', 'User',          'USER');

Vamos comentar esse código:

  • Linhas 19 a 23: [DROP TABLE IF EXISTS …] — o script começa com um banco de dados vazio a cada execução, na ordem inversa das dependências (começando por `appointments`, que referencia `[slots]` e `clients`, até chegar a `users`, que não é referenciada por ninguém): o [MySQL] recusaria excluir uma tabela ainda referenciada por uma chave estrangeira;
  • linha 47: [doctor_id INT NOT NULL], depois linha 52: [CONSTRAINT fk_slots_doctor FOREIGN KEY …] — um horário sempre pertence a um médico;
  • linha 63: [CONSTRAINT unq1_appointments UNIQUE (day, slot_id)] — a regra de negócio central da aplicação: o mesmo horário no mesmo dia só pode ser reservado uma vez. É essa restrição, e somente ela, que impede uma consulta duplicada; nem o controller nem a camada de negócio a verificam novamente de forma explícita;
  • linhas 66 a 73: [CREATE TABLE users (…)] — a tabela adicionada por esta etapa. `login` é UNIQUE (dois usuários não podem ter o mesmo login); `password` armazena uma senha com hash bcrypt (nunca em texto puro); role é 'ADMIN' ou 'USER', uma simples coluna de texto, enquanto o documento original usava três tabelas (users, roles, users_roles) para permitir vários papéis por usuário. Como esta aplicação só precisa de dois papéis mutuamente exclusivos, a relação muitos-para-muitos original seria excessiva;
  • linhas 90 a 92: [INSERT INTO users …] — duas contas de demonstração, admin/admin (papel ADMIN) e user/user (papel USER), com as senhas já protegidas por hash bcrypt (10 rounds de salt), nunca em texto puro, nem mesmo neste script de demonstração.

3.3.2. Execução do script com o HeidiSQL

Para criar o banco de dados [MySQL] exigido pelo servidor [NestJS], procedemos 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 diversos SGBDs. O valor padrão oferecido é MySQL. Ele serve;
  • em [2], você se conecta ao HeidiSQL;
  • Em [1-2], execute o arquivo SQL e 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:
    • [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 para o número (chave primária) do paciente que comparece à 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 marcar nem cancelar uma consulta;

3.4. Inicialização do servidor [NestJS]

Inicie todos os serviços do Laragon ([Start All]), se ainda não o fez. Depois, inicie o servidor NestJS em um terminal do VSCode no projeto NestJS:

npm run start:dev

O console exibe, em ordem: a inicialização do módulo [NestJS], a lista de rotas expostas pelos controllers 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, que foi escolhida deliberadamente por esse motivo.

Essas rotas constituem a API JSON que o cliente [Flutter] consumirá no Capítulo 4. [POST /login] é a única rota pública: ela devolve um token JWT que todas as outras rotas exigem no cabeçalho [Authorization: Bearer <token>]. As rotas somente leitura ([GET …]) são acessíveis aos papéis ADMIN e USER; as duas rotas que modificam dados, [POST /addAppointment] e [POST /deleteAppointment], são reservadas ao papel ADMIN. As respostas de negócio são encapsuladas em um objeto [{ status, data }], em que [status] vale 0 em caso de sucesso.

3.5. Teste do servidor com um navegador

Como a autenticação foi adicionada, todas as rotas do [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 um 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.

3.6. Teste do servidor [NestJS] com o Postman

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

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

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

3.6.1. Fazer login e obter um token

  1. Crie uma nova requisição no Postman com o método POST e a 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 para o 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, neste 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: esse é o token que você deve incluir agora em todas as requisições seguintes. No exemplo acima, o token a copiar é “eyJ...zoM” (sem as aspas).

3.6.2. Chamada de uma rota protegida com o token

Para GET /getAllDoctors (ou qualquer outra rota do 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 que você copiou antes;
  • em [7], a resposta do servidor;

3.6.3. Teste das rotas POST (/addAppointment, /deleteAppointment)

Siga o mesmo procedimento descrito 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 requisições do Postman a seguir 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 no Postman, método POST, URL http://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

  • em [3-5], o corpo da 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], em que o número acima é a 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) em vez 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 por papéis implementado pelo servidor.

3.7. Iniciar o cliente Flutter pela primeira vez

Na pasta [rdvmedecins_flutter_client] (o servidor [NestJS] deve ter sido iniciado antes):

flutter devices          # lista os alvos disponíveis nesta máquina
flutter run -d chrome    # web - o alvo mais simples para um primeiro teste

Image

A tela de login aparece primeiro, como nos clientes anteriores deste curso (veja o Capítulo 4): duas contas de demonstração acompanham o banco de dados do servidor, [admin]/[admin] (papel [ADMIN], acesso total) e [user]/[user] (papel [USER], somente leitura). Dois botões rotulados “FR” e “EN” no canto superior direito permitem alternar a interface para o francês, mesmo antes do login. O Capítulo 5 detalha os comandos equivalentes para desktop e mobile, bem como a única configuração específica dessas plataformas (o endereço do servidor; veja adiante neste capítulo).