Skip to content

1. Introducción

El PDF del documento está |AQUÍ|.

Los códigos del documento están |AQUÍ|.

Este documento es producto de la IA Claude de Anthropic. Su objetivo es transponer el documento [Un ejemplo cliente/servidor - AngularJS 1.x / Spring 4] de dos maneras:

  • el cliente AngularJS 1.x se reemplaza por un cliente [React] 19;
  • el framework web Java Spring MVC se reemplaza por el framework web NestJS;

Claude de Anthropic (IA) realizó la mayor parte del trabajo (90 %):

  • generación del código: Claude generó todo el código. Yo me limité a probarlo siguiendo el curso generado;
  • generación del curso en formato ODT: Claude generó varias versiones a petición mía. Aquí fue donde intervine principalmente.

Nota 1: Si el objetivo principal del lector es “aprender NestJS”, hay un ejemplo más sencillo en el documento [Introducción al lenguaje TypeScript y al framework web NestJS mediante ejemplos]. Luego el lector puede volver a este documento para comprender la biblioteca cliente React.

Nota 2: Este documento hace referencia con frecuencia a la versión [Angular] de este curso. Se trata del curso [Un ejemplo cliente/servidor - Angular / NestJS (2026)];

Serge Tahé, septiembre de 2026

==

Este documento es la continuación del curso “Un ejemplo cliente/servidor - AngularJS 1.x / Spring 4,” escrito en 2014. Aquel documento original construía una pequeña aplicación de agenda de citas médicas (“[RdvMedecins]”) con un servidor Spring 4 / Spring Data / Spring MVC y un cliente AngularJS 1.x.

Doce años después, los dos frameworks utilizados han evolucionado de manera considerable, o incluso han sido reemplazados en el uso habitual:

  • en el lado del servidor, [NestJS] se ha consolidado como uno de los frameworks Node.js/TypeScript más utilizados para construir aplicaciones web estructuradas, con una filosofía similar a la de Spring (módulos, controladores, servicios, inyección de dependencias) pero dentro del ecosistema JavaScript/TypeScript;
  • en el lado del cliente, AngularJS 1.x fue reescrito por completo a partir de 2016 con el nombre de [Angular] (versiones 2, 4, 5… hasta la versión 22): es el enfoque adoptado por la variante [Angular] / [NestJS] de este curso. Este documento adopta un enfoque distinto y más radical: [React] (creado por Meta, 2013), una biblioteca de interfaces en lugar de un framework completo, en la que cada componente es una simple función JavaScript/TypeScript (véase el capítulo 4).

El propósito de este documento es retomar el caso de estudio original (la misma aplicación, las mismas funcionalidades, la misma base de datos) y reconstruirla con herramientas actuales, manteniendo en lo posible la misma progresión didáctica del documento de 2014.

1.1. Una reconstrucción paso a paso

El documento original tenía unas 300 páginas y abarcaba, además de la funcionalidad central de la aplicación y la autenticación basada en roles (Spring Security), doce ejemplos progresivos para aprender AngularJS 1.x paso a paso. Reconstruir todo ese contenido de una sola vez sería laborioso y difícil de asimilar.

Por lo tanto, este documento cubre las dos primeras etapas de la reconstrucción:

  • la arquitectura general de la aplicación (sin cambios en lo fundamental);
  • la base de datos (sin cambios, salvo por la adición de la tabla [users]);
  • el servidor [NestJS] completo, con todas las funcionalidades de consulta y de reserva/cancelación de citas;
  • la autenticación basada en tokens (JWT) y el control de acceso por roles (ADMIN/USER), equivalentes a la capa de Spring Security del documento original;
  • el cliente [React] correspondiente, con las mismas funcionalidades, una pantalla de inicio de sesión, una interfaz Bootstrap adaptada al rol del usuario conectado y la posibilidad de cambiar la interfaz entre francés e inglés ([i18next]/[react-i18next]).

Dos funcionalidades del documento original no se incluyen en esta etapa: el modo “debug” del cliente original (visualización de la plantilla sin procesar de la vista actual), que se ha omitido deliberadamente de esta adaptación (véase el capítulo 6 para los motivos de esta decisión), y la configuración de un retardo de red artificial, que se ha aplazado para una etapa posterior.

1.2. A quién está dirigido este documento

Este documento no presupone conocimientos previos de [NestJS] ni de [React]. Cada concepto nuevo (decorador, inyección de dependencias, componente, hook, etc.) se explica a medida que aparece, con el mayor detalle posible, incluso para lectores que nunca han escrito una sola línea de TypeScript.

Sin embargo, algunos conocimientos básicos ayudan a aprovechar mejor este documento:

  • nociones básicas del lenguaje JavaScript (variables, funciones, arreglos, objetos);
  • nociones básicas de los intercambios HTTP en una aplicación web (métodos GET/POST, formato JSON);
  • las etiquetas más comunes del lenguaje HTML;
  • el uso de la línea de comandos (cd, npm install…).

No es necesario conocer de antemano el lenguaje TypeScript (utilizado tanto en el servidor como en el cliente): es un superconjunto de JavaScript que añade un sistema de tipos, el cual se explica a lo largo del documento cada vez que se usa. Los lectores interesados pueden consultar [Introducción al lenguaje TypeScript y al framework NestJS (2026)], un documento que explica TypeScript en detalle.

1.3. La arquitectura de la aplicación

La arquitectura general de la aplicación no ha cambiado desde el documento original:

  • un servidor web entrega una única página HTML/CSS/JS, que contiene una aplicación [React] construida sobre el modelo de componentes (vista + lógica asociada), que se apoya en servicios para comunicarse con el servidor;
  • el usuario interactúa con las vistas mostradas en el navegador. Las acciones del usuario requieren a veces una solicitud al servidor [NestJS], que procesa la solicitud y devuelve una respuesta JSON (JavaScript Object Notation); esta respuesta se usa para actualizar la vista presentada al usuario.

La aplicación considerada tendrá la siguiente arquitectura:

Image

  • En [1], el usuario de la aplicación [React] consulta la capa [presentation] [2] de dicha aplicación;
  • para realizar la acción solicitada por el usuario, la capa [presentation] [2] puede consultar la capa [Services] [3];
  • para prestar el servicio solicitado, la capa [3] puede necesitar consultar [4], el servidor JSON remoto implementado por [NestJS];
  • Según la solicitud recibida en [5], pueden consultarse las capas [6-8];
  • la respuesta del servidor recorre las capas [2-8] en orden inverso;
  • la vista mostrada al usuario, [1], refleja esta respuesta;

Nota: Si la arquitectura del proyecto le resulta confusa, vuelva a consultar este diagrama. Tenga en cuenta que el SGBD lo procesa el servidor, no el cliente.

1.4. Herramientas utilizadas

Este documento utiliza las siguientes herramientas (su instalación se detalla en el capítulo 1):

  • Node.js (versión 22 o posterior) y su administrador de paquetes npm, el equivalente, en el ecosistema JavaScript, de lo que eran Java + Maven para el servidor Spring original;
  • Visual Studio Code, un editor de código gratuito, con sus extensiones para TypeScript, el equivalente de Spring Tool Suite (STS) y WebStorm utilizados en el documento original;
  • CLI de [NestJS] ([@nestjs/cli]), una herramienta de línea de comandos que genera la estructura del proyecto del servidor e inicia su servidor de desarrollo; en el lado del cliente, [Vite] no requiere ninguna instalación global: se puede usar directamente mediante npm en el proyecto incluido con este documento;
  • [MySQL] 8 para la base de datos (el documento original usaba [MySQL] 5; el esquema relacional en sí no cambia);
  • Postman (u otro cliente HTTP), para probar las URL del servidor que responden a solicitudes POST (/addAppointment, /deleteAppointment); un navegador solo puede probar solicitudes GET.

1.5. Funcionalidades de la aplicación

Las funcionalidades “de negocio” de la aplicación [RdvMedecins] se mantienen sin cambios respecto del documento original; el control de acceso, en cambio, es algo más robusto que en el original (véase la tabla siguiente):

  • Un consultorio médico emplea a varios médicos, cada uno con sus propias franjas horarias de consulta;
  • un usuario debe iniciar sesión (nombre de usuario/contraseña) para acceder a la aplicación;
  • Una vez iniciada la sesión, el usuario puede seleccionar un médico y un día, y ver la agenda del médico para ese día: cada franja horaria aparece como disponible o reservada;
  • un usuario con el rol ADMIN también puede reservar una franja horaria disponible para un paciente de su elección y cancelar una cita existente;
  • Un usuario con el rol USER puede consultar las agendas pero no puede reservar ni cancelar (acceso de solo lectura): una diferencia deliberada respecto del documento original, donde el rol USER servía únicamente para ilustrar una denegación de acceso y no podía ver nada (véase el capítulo 3, sección “Autenticación”, para los motivos de esta elección).

Image

1.6. Qué ha cambiado y qué no


Documento original (2014)
Este documento (2026)
Database
[MySQL] 5, tablas MEDECINS/CLIENTS/CRENEAUX/RV
[MySQL] 8, mismas tablas, mismas columnas (con nombres en inglés), mismas restricciones
Server
Java, Spring 4, Spring Data (JPA/Hibernate), Spring MVC
TypeScript, [NestJS], [TypeORM], mismas rutas (con nombres en inglés)
Client
JavaScript, AngularJS 1.x, Bower
TypeScript, [React] 19 (componentes de función, hooks), npm
CSS style
Bootstrap 3
Bootstrap 5
Authentication
Spring Security, HTTP Basic, roles en 3 tablas; solo ADMIN usa la aplicación
Passport/JWT ([@nestjs/passport], [@nestjs/jwt]), un token firmado que se presenta en cada solicitud, roles en una sola columna, ADMIN con acceso total y USER de solo lectura
FR/EN internationalization
biblioteca angular-translate
[i18next] + [react-i18next]

1.7. Organización de este documento

  1. Configuración del entorno de desarrollo: instalación de las herramientas, creación de la base de datos y primer inicio del servidor y del cliente.
  1. Introducción a [NestJS]: los fundamentos del framework (módulos, controladores, proveedores), con un miniproyecto para comenzar.
  2. El servidor [NestJS] de la aplicación [RdvMedecins]: la base de datos, las entidades de [TypeORM], la capa DAO, la capa de negocio, la capa web, y la autenticación basada en tokens (JWT) y los roles.
  3. Introducción a [React]: los fundamentos de la biblioteca (componentes de función, JSX, hooks, Context), con un repaso de los conceptos ya vistos en el lado de [Angular].
  4. El cliente [React] de la aplicación [RdvMedecins]: la arquitectura del cliente, cada uno de sus componentes (incluida la pantalla de inicio de sesión), la interfaz Bootstrap, el cambio entre francés e inglés en la interfaz y un recorrido paso a paso por la aplicación completa.
  5. Conclusión y próximos pasos.