1. Introducción
El PDF del documento está |AQUÍ|.
Los códigos del documento están |AQUÍ|.
Este documento es un producto de Claude, la IA de Anthropic. Su propósito 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 [Angular] 22;
- el framework web MVC Java Spring se reemplaza por el framework web NestJS;
Claude de Anthropic (IA) hizo 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 participé principalmente.
Nota: al leer el curso generado por la IA de Claude, me di cuenta de que había muchos conceptos que comprender. 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 (2026)]. El lector puede volver después a este documento para comprender el framework del lado del cliente Angular.
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. Ese 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 forma 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] (2, 4, 5… hasta la versión 22 utilizada en este documento), con una arquitectura basada en componentes y, más recientemente, un sistema de reactividad basado en signals que reemplaza el mecanismo de observación ($watch) de AngularJS 1.x.
El objetivo de este documento es retomar el caso de estudio original (la misma aplicación, las mismas funcionalidades, la misma base de datos) y reconstruirlo con las herramientas actuales, manteniendo en lo posible la misma progresión pedagógica del documento de 2014.
1.1. Una reconstrucción paso a paso
El documento original tenía unas 300 páginas y cubría, 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 a la vez largo y difícil de asimilar.
Por lo tanto, este documento cubre los dos primeros pasos de la reconstrucción:
- la arquitectura general de la aplicación (sin cambios en principio);
- 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 basado en roles (ADMIN/USER), equivalente a la capa Spring Security del documento original;
- el cliente [Angular] 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 ([@ngx-translate/core]).
Dos funcionalidades del documento original quedan, en esta etapa, fuera de este documento: el modo «debug» del cliente original (visualización de la plantilla sin procesar de la vista actual), que ha sido deliberadamente omitido de esta adaptación (véase el capítulo 6 para conocer los motivos de esta decisión), y la configuración de un retardo de red artificial, que se ha pospuesto para una etapa posterior.
1.2. A quién está dirigido este documento
Este documento no supone conocimientos previos de [NestJS] ni de Angular. Cada concepto nuevo (decorador, inyección de dependencias, componente, signal, etc.) se explica a medida que aparece, con el mayor detalle posible, incluso para lectores que nunca hayan escrito una sola línea de TypeScript.
No obstante, algunos conocimientos básicos ayudan a aprovechar mejor este documento:
- una comprensión básica del lenguaje JavaScript (variables, funciones, arreglos, objetos);
- una comprensión básica de las interacciones HTTP en una aplicación web (métodos GET/POST, formato JSON);
- las etiquetas habituales 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 el documento [Introducción al lenguaje TypeScript y al framework web NestJS mediante ejemplos (2026)], 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 un único documento HTML/CSS/JS que contiene una aplicación [Angular] 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 utiliza para actualizar la vista presentada al usuario.
La aplicación considerada tendrá la siguiente arquitectura:

- En [1], el usuario de la aplicación [Angular] consulta la capa [presentation] y [2] de esa 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 este esquema. Observe que el SGBD es procesado por el servidor, no por el cliente.
1.4. Herramientas utilizadas
Este documento utiliza las siguientes herramientas (su instalación se detalla en el capítulo 2):
- Node.js (versión 22 o posterior) y su administrador de paquetes npm, el equivalente, dentro del ecosistema JavaScript, de lo que Java + Maven eran 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;
- la CLI de [NestJS] ([@nestjs/cli]) y la CLI de [Angular] ([@angular/cli]), dos herramientas de línea de comandos que generan la estructura del proyecto e inician los servidores de desarrollo;
- [MySQL] 8 para la base de datos (el documento original utilizaba [MySQL] 5; el esquema relacional en sí no cambia);
- Postman (u otro cliente HTTP), para probar las respuestas del servidor a las URL de 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] no cambian respecto al documento original; el control de acceso, en cambio, es algo más robusto que en el original (véase la tabla a continuación):
- 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 ver las agendas, pero no puede reservar ni cancelar (acceso de solo lectura); es una diferencia deliberada respecto al documento original, donde el rol USER se usaba únicamente para ilustrar una denegación de acceso y no podía ver nada en absoluto (véase el capítulo 3, sección «Autenticación», para conocer los motivos de esta elección).

1.6. Qué ha cambiado y qué no
Documento original (2014) | Este documento (2026) | |
[MySQL] 5, tablas MEDECINS/CLIENTS/CRENEAUX/RV | [MySQL] 8, las mismas tablas, las mismas columnas, las mismas restricciones | |
Java, Spring 4, Spring Data (JPA/Hibernate), Spring MVC | TypeScript, [NestJS], [TypeORM], las mismas URL (ahora con nombres en inglés) | |
JavaScript, AngularJS 1.x, Bower | TypeScript, [Angular] 22 (componentes standalone, signals), npm | |
Bootstrap 3 | Bootstrap 5 | |
Spring Security, HTTP Basic, roles en 3 tablas; solo ADMIN utiliza la aplicación | Passport/JWT ([@nestjs/passport], [@nestjs/jwt]), un token firmado que se presenta con cada solicitud, roles en una sola columna, acceso total para ADMIN y de solo lectura para USER | |
biblioteca angular-translate | [@ngx-translate/core] + [@ngx-translate/http-loader] |
1.7. Organización de este documento
- 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.
- Introducción a [NestJS]: los fundamentos del framework (módulos, controladores, proveedores), con un miniproyecto para empezar.
- El servidor [NestJS] de la aplicación [RdvMedecins]: la base de datos, las entidades [TypeORM], la capa DAO, la capa de negocio, la capa web, y la autenticación y los roles basados en tokens JWT.
- Introducción a [Angular]: los fundamentos del framework actual (componentes, signals, servicios y comunicación HTTP).
- El cliente [Angular] de la aplicación [RdvMedecins]: arquitectura del cliente, cada uno de sus componentes (incluida la pantalla de inicio de sesión), la interfaz Bootstrap, el cambio de la interfaz entre francés e inglés y un recorrido paso a paso por toda la aplicación.
- Conclusión y próximos pasos.