Skip to content

3. Capítulo 2 - Instalación del servidor [NestJS]

El cliente [Flutter] descrito en este documento requiere un servidor al que consultar: el servidor [NestJS] de la aplicación [RdvMedecins], incluido con este documento en la carpeta [rdvmedecins-nestjs-server]. Dado que este documento se centra en [Flutter], ese servidor se trata como una “caja negra”: este capítulo explica cómo instalarlo, configurarlo, crear su base de datos [MySQL], iniciarlo y probarlo, pero no examina su código. Los lectores que deseen aprender [NestJS] pueden consultar el documento *Introducción al lenguaje TypeScript y al framework NestJS* (2026).

Este capítulo es, en esencia, una reproducción del capítulo “Instalación de un servidor NestJS” del documento *Introducción al lenguaje Dart mediante ejemplos* (2026), adaptado a otro servidor: el servidor de cálculo de impuestos de ese documento se reemplaza aquí por el servidor [RdvMedecins] y su base de datos [dbimpots-2019] por la base de datos [dbrdvmedecins].

3.1. Instalación de Laragon

Para crear la base de datos [MySQL] utilizada por el servidor [NestJS], usaremos la herramienta Laragon. En septiembre de 2026, Laragon está disponible en la URL [Download Laragon – Fast & Modern Dev Environment ]. Laragon incluye herramientas que permiten instalar un servidor PHP y el SGBD [MySQL]:

Image

  • en [1], un servidor web Apache;
  • en [2], el SGBD [MySQL];
  • en [3], una herramienta de mensajería que no utilizaremos;
  • [4] inicia todos los servicios (Apache, [MySQL], MailPit);
  • [5] muestra la página web de la URL [http://localhost]. De forma predeterminada, esta URL corresponde a la carpeta <laragon-install>\www, donde <laragon-install> es la carpeta de instalación de Laragon;
  • en [6], inicia la herramienta HeidiSQL, que permite administrar bases de datos MySQL. Usaremos esta herramienta para crear la base de datos utilizada por el servidor [RdvMedecins];
  • en [7], abre una terminal en la que todos los binarios necesarios para Laragon están en el PATH;
  • en [8], abre el Explorador de archivos de Windows en la carpeta asociada a la URL [http://localhost];

La carpeta de instalación de Laragon contiene los siguientes elementos:

 
  • En [1], la carpeta [bin] contiene numerosas aplicaciones:
  • en [1], el servidor web Apache;
  • en [2], una terminal de línea de comandos;
  • en [3], un cliente [git] para el control de versiones de un proyecto;
  • en [4], un administrador de bases de datos;
  • en [5], un administrador de correo;
  • en [6], el SGBD [MySQL];
  • [7], otro servidor web;
  • en [8], [node.js] para ejecutar scripts de JavaScript;
  • [9], un editor de texto;
  • [10], el intérprete de PHP;
  • [11], el intérprete de [Python];
  • [12], un servidor de caché;

Laragon incluye un entorno de desarrollo completo. En este curso, utilizaremos únicamente el SGBD [MySQL] [6] y la herramienta [heidisql] para administrarlo gráficamente;

3.2. Instalación y configuración del servidor [NestJS]

La carpeta [rdvmedecins-nestjs-server] tiene la siguiente estructura de directorios:

rdvmedecins-nestjs-server/
├── package.json                  # dependencias y scripts de npm
├── tsconfig.json                 # configuración del compilador de TypeScript
├── nest-cli.json                 # configuración de la CLI de NestJS
├── .env.example                  # plantilla del archivo de configuración .env
├── database/
│   └── dbrdvmedecins.sql         # script de creación de la base de datos
└── src/
    ├── main.ts                   # punto de entrada del servidor
    ├── app.module.ts             # módulo raíz
    ├── config/                   # conexión a la base de datos
    ├── entities/                 # entidades de TypeORM (una clase por tabla)
    ├── domain/                   # objetos de negocio
    ├── repositories/             # acceso a datos (capa DAO)
    ├── business/                 # capa de negocio
    ├── web/                      # controlador JSON y modelos de respuesta
    └── auth/                     # autenticación JWT y roles

Cada subcarpeta de [src/] contiene su propio archivo [README.md], que resume la función de los archivos que contiene. El código fuente de estos archivos no se trata en este documento.

En la carpeta [rdvmedecins-nestjs-server], escriba los siguientes comandos en una terminal:

npm install
cp .env.example .env

El archivo [.env] define variables de entorno:

# -----------------------------------------------------------------------
# Archivo de configuración de ejemplo.
# Copie este archivo a [.env] y luego adapte los valores a su máquina.
# El archivo [.env] nunca debe compartirse ni subirse al repositorio (contiene contraseñas).
# -----------------------------------------------------------------------

# puerto de escucha del servidor NestJS (el servidor Spring original escuchaba en 8080)
PORT=8080

# parámetros de conexión a la base de datos MySQL [dbrdvmedecins]
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=
DB_DATABASE=dbrdvmedecins

# solo en desarrollo: TypeORM puede crear/actualizar automáticamente
# las tablas a partir de las entidades. Aquí está desactivado porque proporcionamos nuestro
# propio script SQL [database/dbrdvmedecins.sql], como hacía el proyecto Spring original.
DB_SYNCHRONIZE=false

# -----------------------------------------------------------------------
# autenticación (ver src/auth/)
# -----------------------------------------------------------------------
# clave secreta usada para firmar/verificar los tokens JWT - DEBE cambiarse
# en producción (una cadena aleatoria larga, nunca subida al repositorio).
JWT_SECRET=change-me-to-a-long-random-string
# validez de un token JWT (ver la documentación de la biblioteca [ms]:
# "60", "2h", "7d"...)
JWT_EXPIRES_IN=2h

Adapte el archivo [.env] recién creado a su instalación de [MySQL] (nombre de usuario, contraseña, puerto). Dado que se agregó la autenticación, este archivo también contiene una clave llamada JWT_SECRET: el valor de ejemplo es adecuado para seguir este documento, pero debe reemplazarse por una cadena aleatoria exclusivamente suya antes de cualquier uso real.

3.3. Creación de la base de datos

La base de datos [dbrdvmedecins] reproduce la estructura del documento original (2014, Spring 4 / [MySQL] 5): las mismas tablas ([doctors], [clients], [slots], [appointments], ahora con nombres en inglés), las mismas claves externas y la misma restricción de unicidad. La única adición nueva, introducida por el paso de “autenticación” de esta adaptación, es la tabla [users]. Las relaciones entre estas tablas son las siguientes: un médico ([doctors]) tiene varias franjas horarias ([slots], clave externa [doctor_id]); una cita ([appointments]) vincula un día, una franja horaria (y, por lo tanto, un médico) y un cliente ([clients]); la tabla [users] es independiente de las otras cuatro: se utiliza únicamente para la autenticación.

3.3.1. [database/dbrdvmedecins.sql]

Image

  -- =========================================================================
  -- Base de datos [dbrdvmedecins] - MySQL 8
  --
  -- Este script reproduce EXACTAMENTE el esquema relacional del documento original
  -- (2014, Spring 4 / Spring Data / MySQL 5): mismas tablas, mismas columnas,
  -- mismas claves externas, misma restricción de unicidad. Solo el motor de base de datos
  -- cambia de nombre (MySQL 5 -> MySQL 8), no la estructura.
  --
  -- The original document used THREE tables (users, roles,
 -- users_roles) para permitir que un usuario tuviera VARIOS roles.
 -- Como esta aplicación solo conoce dos roles mutuamente excluyentes
 -- (ADMIN, USER), aquí simplificamos a una sola columna [role]
 -- en la tabla [users] en lugar de reconstruir la relación original de muchos a
 -- muchos - una simplificación didáctica deliberada, documentada
 -- en el capítulo "Authentication" del curso.
 -- =========================================================================

 -- se parte de una base de datos vacía en cada ejecución del script (práctico en desarrollo)
 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');

Comentemos este código:

  • Líneas 19–23: [DROP TABLE IF EXISTS …] : el script comienza con una base de datos vacía en cada ejecución, eliminando las tablas en el orden inverso de las dependencias (empezando por `appointments`, que hace referencia a `[slots]` y `clients`, hasta llegar a `users`, a la que nadie hace referencia): [MySQL] se negaría a eliminar una tabla a la que aún hace referencia una clave externa;
  • línea 47: [doctor_id INT NOT NULL], luego línea 52: [CONSTRAINT fk_slots_doctor FOREIGN KEY …] : una franja horaria siempre pertenece a un médico;
  • línea 63: [CONSTRAINT unq1_appointments UNIQUE (day, slot_id)] : la regla de negocio central de la aplicación: una misma franja horaria en un mismo día solo puede reservarse una vez. Es esta restricción, y solo ella, la que impide una cita duplicada; ni el controlador ni la capa de negocio lo vuelven a verificar explícitamente;
  • líneas 66–73: [CREATE TABLE users (…)] : la tabla agregada en este paso. `login` es UNIQUE (dos usuarios no pueden compartir el mismo identificador de inicio de sesión); `password` almacena una contraseña con hash mediante bcrypt (nunca en texto plano); role es 'ADMIN' o 'USER': una simple columna de texto, mientras que el documento original utilizaba tres tablas (users, roles, users_roles) para permitir varios roles por usuario. Como esta aplicación solo requiere dos roles mutuamente excluyentes, la relación original de muchos a muchos habría sido excesiva;
  • líneas 90–92: [INSERT INTO users …] : dos cuentas de demostración, admin/admin (rol ADMIN) y user/user (rol USER), con sus contraseñas ya procesadas con hash mediante bcrypt (10 rondas de salt); nunca en texto plano, tampoco en este script de demostración.

3.3.2. Ejecución del script con HeidiSQL

Para crear la base de datos [MySQL] que necesita el servidor [NestJS], se procede de la siguiente manera:

 
  • En [1], deben estar iniciados todos los servicios;
  • en [2], la opción [Database] permite administrar la base de datos;

La opción [Database] inicia una utilidad llamada HeidiSQL:

  • En [1], se pueden seleccionar diversas opciones de SGBD. El valor predeterminado es MySQL. Es aceptable;
  • en [2], se inicia sesión en HeidiSQL;
  • En [1-2], ejecute el archivo SQL y luego seleccione el archivo [dbrdvmedecins.sql], que encontrará en la carpeta [rdvmedecins-nestjs-server/database]:

Image

La ejecución del archivo [3] creará la base de datos [dbrdvmedecins] utilizada por el servidor [NestJS]. Para verla, presione F5 en HeidiSQL para actualizar la pantalla:

Image

La base de datos [dbrdvmedecins] se ha creado. Puede ver su contenido:

Image

  • En [1-3], la tabla [clients];
    • [id] es la clave primaria de la tabla;
    • [version] es el número de versión de la fila. Este número se incrementa cada vez que se modifica la fila;
    • [title, last_name, first_name] identifica a la persona;

Image

  • en [1-3], la tabla [doctors];
    • [id] es la clave primaria de la tabla;
    • [version] es el número de versión de la fila;
    • [title, last_name, first_name] identifica a la persona;

Image

  • En [1-3], la tabla de las franjas horarias de citas de los médicos:
    • [id]: clave primaria;
    • [version]: número de versión de la fila;
    • [doctor_id]: clave externa que hace referencia a la clave primaria del médico;
    • [start_hour, start_minute]: hora y minutos del inicio de la cita. Así, [8,20] significa 8:20 a. m.
    • [end_hour, end_minute]: hora y minutos del fin de la consulta.

Image

  • En [1-3], la tabla [appointments] de las citas programadas;
    • [id]: clave primaria;
    • [version]: número de versión;
    • [day]: fecha de la cita;
    • [slot_id]: clave externa que hace referencia a la clave primaria de la franja horaria de la cita. Como una franja horaria está vinculada a un médico, sabemos qué médico atiende esta cita;
    • [client_id]: clave externa al número (clave primaria) del paciente que asiste a la cita;

Image

  • en [1-3], la tabla [users], que enumera los usuarios autorizados para utilizar la aplicación [NestJS];
    • [id, version]: clave primaria, número de versión;
    • [login, password]: credenciales del usuario;
    • [name]: nombre del usuario;
    • [role]: el rol del usuario. [ADMIN] tiene todos los derechos de acceso. [USER] tiene acceso de solo lectura. Este usuario puede ver la agenda de un médico, pero no puede programar ni cancelar una cita;

3.4. Inicio del servidor [NestJS]

Inicie todos los servicios de Laragon ([Start All]), si aún no lo ha hecho. Luego inicie el servidor NestJS en una terminal de VSCode para el proyecto NestJS:

npm run start:dev

La consola muestra, en orden: el inicio del módulo [NestJS], la lista de rutas expuestas por los controladores y, por último, la confirmación del inicio:

[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

Esta salida de la consola confirma que el servidor está efectivamente escuchando en el puerto 8080, exactamente el mismo puerto que el servidor Spring Boot del documento original, que se eligió deliberadamente por este motivo.

Estas rutas constituyen la API JSON que el cliente [Flutter] consumirá en el capítulo 4. [POST /login] es la única ruta pública: devuelve un token JWT que todas las demás rutas exigen en el encabezado [Authorization: Bearer <token>]. Las rutas de solo lectura ([GET …]) son accesibles para los roles ADMIN y USER; las dos rutas que modifican datos, [POST /addAppointment] y [POST /deleteAppointment], están reservadas para el rol ADMIN. Las respuestas de negocio se envuelven en un objeto [{ status, data }], donde [status] vale 0 en caso de éxito.

3.5. Prueba del servidor con un navegador

Dado que se agregó la autenticación, todas las rutas de [RdvMedecinsController] requieren un token JWT válido; por lo tanto, ya no es posible probarlas directamente solo con un navegador. Por ejemplo:

http://localhost:8080/getAllDoctors

ahora devuelve un error 401 Unauthorized sin un token:

Image

Este es el comportamiento esperado: esta respuesta confirma que el servidor protege correctamente sus rutas. Se necesita Postman (siguiente sección) para obtener un token y luego utilizarlo.

3.6. Prueba del servidor [NestJS] con Postman

La herramienta Postman está disponible en la URL [https://www.postman.com/downloads/]. Es posible que deba crear una cuenta.

Inicie todos los servicios de Laragon y luego abra la aplicación de escritorio de Postman:

  • En [1-2], cree una solicitud HTTP para consultar el servidor de gestión de citas médicas;

3.6.1. Inicio de sesión y obtención de un token

  1. Cree una nueva solicitud en Postman con el método POST y la URL http://localhost:8080/login;
  2. En la pestaña [Body], seleccione "raw", luego el formato JSON e ingrese: {"login": "admin", "password": "admin"} (o "user/user" para probar el rol USER);
  3. Envíe la solicitud.

Image

  • en [1-2], la solicitud POST al servidor [NestJS] que se ejecuta en el puerto 8080;
  • en [3-5], el cuerpo de la solicitud. Este transmite al servidor la cadena JSON con las credenciales del usuario que intenta iniciar sesión, en este caso admin/admin;
  • en [6], la respuesta del servidor;
  • en [7], el token de autenticación que las solicitudes posteriores deben enviar al servidor para indicar “ya me he autenticado”;

Copie el valor de accessToken: es el token que ahora debe incluir en cada solicitud posterior. En el ejemplo anterior, el token que se debe copiar es “eyJ...zoM” (sin las comillas).

3.6.2. Llamada a una ruta protegida con el token

Para GET /getAllDoctors (o cualquier otra ruta de RdvMedecinsController), en Postman, en la pestaña Authorization, seleccione el tipo Bearer Token y pegue el token copiado anteriormente (Postman agregará entonces automáticamente el encabezado Authorization: Bearer <token>).

Image

  • en [1-2], la solicitud enviada al servidor. Solicita la lista de médicos de la base de datos;
  • En [3-5], la solicitud debe incluir el token de autenticación. En [4], seleccione [Bearer Token], y en [5], pegue el token de autenticación que copió anteriormente;
  • en [7], la respuesta del servidor;

3.6.3. Prueba de las rutas POST (/addAppointment, /deleteAppointment)

Siga el mismo procedimiento que antes (método POST, cuerpo JSON, Bearer Token), exactamente como el documento original utilizaba la extensión de Chrome “Advanced Rest [Client]” para las mismas rutas.

Nota: Encontrará las siguientes solicitudes de Postman en la colección [rdvmedecins-nestJS.postman_collection.json]:

Image

En Postman, presione Ctrl-0 para cargar la colección:

Image

  • Haga clic en [1] para cargar la colección y seleccione el archivo de la colección. Una vez cargada, se muestran sus solicitudes:

Image

Para probar /addAppointment con el token de una cuenta ADMIN:

  1. Solicitud de Postman, método POST, URL http://localhost:8080/addAppointment;
  2. Pestaña Authorization: Bearer Token, token de admin;
  3. Pestaña [Body], raw, JSON: {"day": "2026-09-13", "clientId": 1, "slotId": 5};
  4. Envíe la solicitud.

Image

  • en [3-5], el cuerpo de la solicitud;

Image

Puede verificar con HeidiSQL que se ha agregado una cita a la base de datos:

Image

Para probar /deleteAppointment, siga el mismo procedimiento con el cuerpo {"appointmentId": 2} (el identificador de la cita que se cancelará (8) anterior).

Image

  • en [4], donde el número anterior es la cita que se eliminará;

Image

  • en [5-7], el token de autenticación;
  • en [9], la respuesta del servidor. [status=0] indica que la operación se realizó correctamente. Puede verificarlo con HeidiSQL:

Image

  • en [3], la cita n.º 2 ya no existe;

Pruebe esto: repita la misma solicitud /addAppointment utilizando el token de la cuenta USER (user/user) en lugar del token de admin: la respuesta pasa a ser 403 Forbidden, con el mensaje “role [USER] does not allow this action (required role: ADMIN)”, una demostración concreta del control de acceso basado en roles implementado por el servidor.

3.7. Primer inicio del cliente Flutter

En la carpeta [rdvmedecins_flutter_client] (el servidor [NestJS] debe haberse iniciado previamente):

flutter devices          # lista los destinos disponibles en esta máquina
flutter run -d chrome    # web: el destino más simple para una primera prueba

Image

Primero aparece la pantalla de inicio de sesión, igual que en los clientes anteriores de este curso (véase el capítulo 4): con la base de datos del servidor se proporcionan dos cuentas de demostración, [admin]/[admin] (rol [ADMIN], acceso total) y [user]/[user] (rol [USER], solo lectura). Dos botones etiquetados “FR” y “EN” en la esquina superior derecha permiten cambiar la interfaz a francés, incluso antes de iniciar sesión. El capítulo 5 detalla los comandos equivalentes para escritorio y móvil, así como el único ajuste específico de estas plataformas (la dirección del servidor; véase más adelante en este capítulo).