Skip to content

2. Capítulo 1 - Configuración del entorno de trabajo

2.1. Instalación de las herramientas

  1. Node.js: descargue e instale la versión 22 (o posterior) desde nodejs.org. Verifique la instalación en una terminal:
    node --version
    npm --version
    
  1. Visual Studio Code (VSCode): se puede descargar gratis desde code.visualstudio.com. Instale la extensión “TypeScript and JavaScript Language Features” (normalmente ya viene incluida).
  2. CLI de [NestJS], que se instala una sola vez (en el lado del cliente, [Vite] no requiere ninguna instalación global; véase la introducción). En una terminal de VSCode:
    npm install -g @nestjs/cli
    
  1. [MySQL] 8: instálelo, por ejemplo, mediante XAMPP, Laragon (en Windows) o directamente mediante [MySQL] Community Server. Una herramienta gráfica de administración (phpMyAdmin, [MySQL] Workbench, DBeaver, HeidiSQL…) facilita el trabajo. En lo sucesivo se utiliza la herramienta Laragon.
  2. Postman: se puede descargar gratis en postman.com.

Si ha descargado el código, este se encuentra en dos carpetas:

Image

  • en [1], el cliente [React];
  • en [2], el servidor [NestJS];

Abra la carpeta [2] con Visual Studio [File / Open Folder]:

Image

2.2. Creación de la base de datos

Para crear la base de datos [MySQL] utilizada por el servidor [NestJS], usaremos la herramienta Laragon. A 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 servidor 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 [NestJS];
  • En [7], abre una terminal; todos los binarios necesarios para Laragon están en el PATH;
  • En [8], abre una ventana del Explorador 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] que permite administrar las distintas versiones de un proyecto;
  • en [4], un administrador de bases de datos;
  • [5], un administrador de correo;
  • en [6], el SGBD [MySQL];
  • [7], otro servidor web;
  • en [8], [node.js] para ejecutar scripts 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 solo utilizaremos el SGBD [MySQL] [6] y [heidisql] para administrarlo gráficamente;

Para crear la base de datos [MySQL] requerida por el servidor [NestJS], proceda 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], puede seleccionar distintas opciones de SGBD. El valor predeterminado es MySQL. Es adecuado;
  • en [2], se inicia sesión en HeidiSQL;
  • En [1-2], ejecute el archivo SQL y seleccione el archivo [dbrdvmedecins.sql], que encontrará en la carpeta [rdvmedecins-nestjs-server/database]:

Image

Al ejecutar el archivo [3] se 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] ha sido creada. 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 [slots] de 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 referencia 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 citas programadas;
    • [id]: clave primaria;
    • [version]: número de versión;
    • [day]: fecha de la cita;
    • [slot_id]: clave externa que referencia 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] enumera los usuarios autorizados a 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;

2.3. Primer inicio del servidor [NestJS]

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 incluirse en el control de versiones (contiene contraseñas).
# -----------------------------------------------------------------------

# puerto de escucha del servidor NestJS (el servidor Spring original escuchaba en el 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 (vea src/auth/)
# -----------------------------------------------------------------------
# clave secreta usada para firmar/verificar los tokens JWT - DEBE cambiarse
# en producción (una cadena aleatoria larga, nunca incluida en el control de versiones).
JWT_SECRET=change-me-to-a-long-random-string
# validez de un token JWT (vea la documentación de la biblioteca [ms]:
# "60", "2h", "7d"...)
JWT_EXPIRES_IN=2h

Personalice el archivo [.env] recién creado para que coincida con su instalación de [MySQL] (usuario, contraseña, puerto). Como se agregó la autenticación (véase el capítulo 3), este archivo también contiene una clave llamada JWT_SECRET: el valor de ejemplo sirve para seguir este documento, pero debe reemplazarse por una cadena aleatoria única propia antes de cualquier uso real.

Inicie todos los servicios de Laragon [Start All], si aún no lo ha hecho.

Luego inicie el servidor:

npm run start:dev

La consola muestra, en orden: el inicio del módulo [NestJS], la lista de rutas expuestas por el controlador y, por último, la confirmación de 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 efectivamente escucha en el puerto 8080, exactamente el mismo puerto que el servidor Spring Boot del documento original, que se eligió deliberadamente por esa razón.

2.4. Prueba del servidor con un navegador

Como se agregó la autenticación (capítulo 3), 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 usarlo.

2.5. 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 Postman:

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

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

  1. Cree una nueva solicitud en Postman con el método POST, URL http://localhost:8080/login;
  2. En la pestaña [Body], seleccione "raw" y 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 autentiqué”;

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

2.5.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 enviar el token de autenticación. En [4], seleccione [Bearer Token], y en [5], pegue el token de autenticación que copió antes;
  • en [7], la respuesta del servidor;

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

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

Nota: Puede 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

Puede verificar con HeidiSQL que se agregó una cita a la base de datos:

Image

Para probar /deleteAppointment, siga el mismo procedimiento con el cuerpo {"appointmentId": 2} (el ID de la cita que se va a cancelar (8) arriba).

Image

  • en [4], donde el número anterior es la cita que se va a 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ó con éxito. Puede verificarlo con HeidiSQL:

Image

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

Pruébelo: repita la misma solicitud /addAppointment usando 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 por roles implementado en el capítulo 3.

2.6. Primer inicio del cliente [React]

En la carpeta rdvmedecins-react-client (el servidor [NestJS] debe estar iniciado de antemano):

npm install
npm start

Luego abra http://localhost:4200 en un navegador: primero aparece la pantalla de inicio de sesión (véase el capítulo 5).

Image

  • en [1], el servidor de la URL que sirve la aplicación [React];
  • en [2], la URL del servidor [NestJS] que administra la base de datos [dbrdvmedecins];

Es importante entender que aquí hay dos servidores web, uno de los cuales actúa como cliente del otro.

Dos botones con las etiquetas “FR” y “EN” en la esquina superior derecha permiten cambiar la interfaz a francés (se muestra en inglés de forma predeterminada, o en francés si el navegador está configurado en francés), incluso antes de iniciar sesión. Inicie sesión con una de las dos cuentas de demostración (admin/admin, acceso total, o user/user, solo lectura) para acceder al resto de la aplicación. El capítulo 5 ofrece una guía detallada del uso de este cliente, con capturas de pantalla de cada paso.