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 adaptar el documento “Un ejemplo cliente/servidor - AngularJS 1.x / Spring 4” en dos aspectos:
- el cliente AngularJS 1.x se reemplaza por un cliente [Flutter] 3;
- el framework web Java Spring MVC 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 1: Si el objetivo principal del lector es “aprender NestJS”, en el documento Introducción al lenguaje TypeScript y al framework web NestJS mediante ejemplos se encuentra una presentación general de este framework web. En el presente documento, el servidor NestJS se trata como una caja negra. Se le muestra cómo utilizarlo, pero no se describe su código.
Nota 2: El lenguaje de programación de Flutter es Dart. Los lectores interesados en aprender los fundamentos del lenguaje Dart pueden leer el curso “Introducción al lenguaje Dart mediante ejemplos” (2026).
Nota 3: Claude hace referencia con frecuencia a los frameworks Angular, React y Vue.js. Claude ha escrito tres cursos sobre estos frameworks y los recuerda bien. Por eso hace referencia a ellos:
- [Un ejemplo cliente/servidor con Angular/NestJS (2026)];
- [Un ejemplo cliente/servidor con React/NestJS (2026)];
- [Un ejemplo cliente/servidor con Vue.js/NestJS (2026)];
Nota 4: Si considera que las explicaciones de Claude no son suficientes, acuda a Claude para pedirle aclaraciones sobre un punto específico de su curso. Esto suele ayudar.
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 para la gestión de citas médicas (“[RdvMedecins]”) utilizando 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 significativa, o incluso han sido reemplazados en el uso habitual:
- del 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;
- Del 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). El enfoque adoptado por la variante [Angular] / [NestJS] de este curso: Un ejemplo cliente/servidor - Angular / NestJS (2026). Este documento adopta un enfoque diferente: [Flutter] (creado por Google, primera versión estable en diciembre de 2018), un framework “multiplataforma” : a partir de un único código base escrito en el lenguaje [Dart], genera aplicaciones móviles, de escritorio y web, cuya interfaz no se describe mediante plantillas HTML, sino mediante un árbol de widgets (véase el capítulo 3).
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 la medida de 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 alrededor de 300 páginas y cubría, además de la funcionalidad central de la aplicación (autenticación basada en roles con Spring Security), doce ejemplos progresivos para aprender AngularJS 1.x paso a paso. Reconstruir todo este 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 lo esencial);
- la base de datos (sin cambios, salvo por la adición de la tabla [users]);
- la instalación del servidor [NestJS] completo que acompaña a este documento, cuyas funcionalidades de consulta y de reserva/cancelación de citas se prueban con Postman; su código no se trata aquí, ya que este documento está dedicado a [Flutter];
- la autenticación basada en tokens (JWT) y el control de acceso basado en roles (ADMIN/USER) para este servidor, equivalentes a la capa de Spring Security del documento original; solo aprenderemos a utilizarlos, primero con Postman y luego mediante el cliente;
- el cliente [Flutter] correspondiente, con las mismas funcionalidades: una pantalla de inicio de sesión, una interfaz adaptada al rol del usuario conectado ([Material Design]) y la posibilidad de cambiar la interfaz entre francés e inglés ([TranslationsService]).
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 omitido deliberadamente de esta adaptación (véase el capítulo 6 para conocer las razones 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 ningún conocimiento previo de [NestJS] ni de [Flutter]. Cada concepto nuevo (decorador, inyección de dependencias, componente, signal, etc.) se explica a medida que aparece, con el mayor detalle posible, incluso para los lectores que nunca han escrito una sola línea de TypeScript o de Dart.
Sin embargo, algunos conocimientos básicos son útiles para aprovechar al máximo este documento:
- una comprensión básica del lenguaje Dart (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 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 del lado del servidor): es un superconjunto de JavaScript que agrega un sistema de tipos, el cual se explica a lo largo del documento cada vez que se utiliza. Lo mismo se aplica al lenguaje [Dart], utilizado del lado del cliente, que se presenta en el capítulo 3. Los lectores interesados pueden consultar el documento *Introducción al lenguaje Dart mediante ejemplos* (2026), que explica Dart 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 proporciona al cliente una interfaz única, construida sobre el modelo de componentes (vista + lógica asociada), que se apoya en servicios para comunicarse con el servidor: un navegador para los clientes [Angular]/[React]/[Vue.js] de este curso o, para este cliente [Flutter], un navegador, un sistema operativo móvil o un sistema operativo de escritorio (véase el capítulo 5);
- el usuario interactúa con las vistas mostradas en el navegador. Sus acciones 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 en estudio tendrá la siguiente arquitectura:

- En [1], el usuario de la aplicación [Flutter] 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], es posible que se consulten las capas [6-8];
- la respuesta del servidor asciende por 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 utiliza el servidor, no el cliente.
1.4. Herramientas utilizadas
Este documento utiliza las siguientes herramientas (su instalación se detalla en los capítulos 1 y 2):
- Node.js (versión 22 o posterior) y su gestor de paquetes npm, el equivalente, dentro del ecosistema JavaScript, de lo que eran Java + Maven para el servidor Spring original;
- Visual Studio Code (VSCode), un editor de código gratuito, junto con sus extensiones para TypeScript, el equivalente de Spring Tool Suite (STS) y WebStorm utilizados en el documento original;
- el SDK de [Flutter] (que incluye el SDK de [Dart]) se instala una sola vez, para todo el sistema, a diferencia de [Vite], utilizado por los clientes web anteriores de este curso, que no requería ninguna instalación en todo el sistema;
- [MySQL] 8 para la base de datos (el documento original utilizaba [MySQL] 5; el esquema relacional en sí no cambia);
- [Android Studio] (junto con su SDK de [Android] y sus herramientas de línea de comandos), para compilar la aplicación en un teléfono [Android], el destino móvil de este curso; las instrucciones detalladas de instalación se encuentran en el capítulo 1;
- Postman (o cualquier otro cliente HTTP), para probar las URL del servidor que responden a solicitudes POST (/addAppointment, /deleteAppointment); un navegador web solo puede probar solicitudes GET.
1.5. Funcionalidades de la aplicación
Las funcionalidades “de negocio” de la aplicación [RdvMedecins] permanecen 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 ver las agendas, pero no puede reservar ni cancelar (acceso de solo lectura); una diferencia deliberada respecto del documento original, donde el rol USER se utilizaba únicamente para ilustrar una denegación de acceso y no podía ver nada en absoluto (véase el capítulo 2, sección “Creación de la base de datos”, para conocer las razones de esta decisión).

1.6. Qué ha cambiado y qué no ha cambiado
Documento original (2014) | Este documento (2026) | |
[MySQL] 5, tablas MEDECINS/CLIENTS/CRENEAUX/RV | [MySQL] 8, las mismas tablas, las mismas columnas, las mismas restricciones (ahora con nombres en inglés) | |
Java, Spring 4, Spring Data (JPA/Hibernate), Spring MVC | TypeScript, [NestJS], [TypeORM], las mismas URL expuestas | |
JavaScript, AngularJS 1.x, Bower | Dart, [Flutter] (widgets Material, paquete [provider]), pub | |
Bootstrap 3 | Ninguno ([Material Design] integrado en los widgets de [Flutter]) | |
Spring Security, HTTP Basic, roles en 3 tablas; solo ADMIN utiliza la aplicación | Passport/JWT ([@nestjs/passport], [@nestjs/jwt]), un token firmado presentado con cada solicitud, roles en una sola columna, ADMIN con acceso total y USER de solo lectura | |
biblioteca angular-translate | [TranslationsService] (hecho a mano, diccionarios incorporados) |
1.7. Organización de este documento
- Configuración del entorno de trabajo: instalar las herramientas y crear el proyecto [Flutter].
- Instalación del servidor [NestJS]: instalar Laragon y la base de datos [MySQL], configurar, iniciar y probar el servidor, y luego ejecutar por primera vez el cliente [Flutter].
- Introducción a [Flutter]: los fundamentos del framework (widgets, StatelessWidget/StatefulWidget, provider), con un repaso de los conceptos ya vistos en [Angular], [React] y [Vue.js].
- El cliente [Flutter] de la aplicación [RdvMedecins]: la arquitectura del cliente, cada uno de sus archivos (incluida la pantalla de inicio de sesión) y un recorrido paso a paso por toda la aplicación.
- Portar la aplicación [Flutter] a móvil, escritorio y web: cómo un único código fuente se compila para estas tres familias de destinos y qué es necesario saber para cada una de ellas (red, restricciones propias de los dispositivos móviles).
- Conclusión y próximos pasos.