Skip to content

7. Capítulo 6 - Conclusión y próximos pasos

7.1. Lo que se ha construido

Este documento ha portado la funcionalidad principal y la autenticación de la aplicación [RdvMedecins] del documento original de 2014 a tecnologías actuales:

  • un servidor [NestJS] completo (entidades [TypeORM], DAO, capa de negocio, capa web), que expone las mismas 11 rutas de negocio JSON que el servidor Spring 4 original, en el mismo puerto (8080), ahora todas protegidas por un token JWT;
  • una capa de autenticación ([@nestjs/passport] + [@nestjs/jwt]): autenticación por usuario/contraseña (POST /login), un token firmado que se presenta con cada solicitud posterior, y control de acceso basado en roles ([@Roles]('ADMIN') + [RolesGuard]) en las dos rutas que modifican datos;
  • un cliente [Angular] (componentes standalone, signals) que ofrece la misma funcionalidad que el cliente AngularJS 1.x original (selección de un médico y una fecha, visualización del calendario, reserva y cancelación de una cita), complementado con una pantalla de inicio de sesión, una sesión persistente (localStorage), una interfaz Bootstrap que se adapta al rol del usuario conectado (botones de reserva ocultos para el rol USER) y la posibilidad de cambiar la interfaz entre francés e inglés ([@ngx-translate/core] + [@ngx-translate/http-loader]).

El núcleo de la base de datos no ha cambiado (mismas tablas de médicos/clientes/franjas horarias/citas, mismas restricciones), salvo por la adición de la tabla [users]; tampoco ha cambiado la arquitectura general en capas: solo se han actualizado las herramientas que la implementan.

Dos diferencias intencionales con respecto al mecanismo de autenticación del documento original, documentadas en detalle en el capítulo 3: un token JWT en lugar del encabezado HTTP Basic enviado con cada solicitud, y una única columna [role] por usuario en lugar de una relación muchos a muchos entre tres tablas. Una tercera diferencia, esta vez funcional, se eligió deliberadamente para este port: el rol USER ahora puede ver los calendarios (solo lectura), mientras que en el original servía únicamente para ilustrar una denegación total de acceso.

7.2. Lo que queda fuera del alcance o por portar

Más allá de lo anterior, el documento original abordaba dos temas adicionales, uno de los cuales ya se ha tratado, otro se dejó fuera deliberadamente y el tercero se aplazó a una etapa posterior:

7.2.1. Localización francés/inglés: abordada en este documento

El documento original proponía cambiar la interfaz entre francés e inglés mediante la biblioteca angular-translate. Este port implementa esta funcionalidad con su equivalente en el ecosistema actual de [Angular], [@ngx-translate/core] (acompañado de [@ngx-translate/http-loader], que carga los diccionarios fr.json/en.json con HTTP desde la carpeta public/i18n); véase el capítulo 5. @angular/localize, la otra solución posible, se descartó: requiere una compilación independiente por idioma, mientras que ngx-translate permite cambiar de idioma sobre la marcha sin recargar la página, un comportamiento más cercano al del documento original.

7.2.2. El modo “debug” del cliente: deliberadamente excluido del alcance

El documento original incluía un modo de visualización técnico, activable desde la interfaz, que daba acceso al modelo sin procesar ($scope de AngularJS 1.x) de la vista actual, una funcionalidad útil en 2014, cuando las herramientas de desarrollo disponibles para inspeccionar una aplicación AngularJS aún eran limitadas. Este port no lo recrea: las herramientas de desarrollo actuales de [Angular] ([Angular] DevTools, extensión oficial del navegador) ofrecen ahora, fuera de la propia aplicación, una inspección mucho más completa de los componentes, sus signals y sus entradas/salidas que la que ofrecería un panel de depuración personalizado reintegrado en la interfaz. Agregar un panel así equivaldría a crear una versión inferior de una herramienta que ya proporciona el ecosistema; por lo tanto, esta decisión es definitiva, no un simple aplazamiento.

7.2.3. Un retraso de red artificial: aplazado

El documento original permitía configurar un retraso artificial antes de cada respuesta del servidor, con el fin de observar el comportamiento de la interfaz en una red lenta (indicadores de carga, desactivación temporal de botones, etc.). Esta funcionalidad aún no tiene un equivalente en este port.

7.3. Una nota sobre la metodología utilizada en este documento

Este documento se redactó apoyándose sistemáticamente en el código que realmente se ejecutó: se probó cada ruta del servidor (incluidos los escenarios de autenticación: inicio de sesión exitoso/fallido, acceso sin token, acceso con el rol equivocado), y cada captura de pantalla del cliente (capítulo 5) se obtuvo interactuando con la aplicación real en ejecución: un navegador Chromium controlado automáticamente, con datos de demostración del script SQL proporcionado. Este enfoque también reveló, durante la preparación de este documento, un problema específico relacionado con el uso de [TypeORM] con columnas calculadas ([@RelationId]), que se informó y se corrigió en el capítulo 3, directamente en el código entregado. Esta exigencia también explica por qué en este documento no se incluyen capturas de pantalla de Postman: en lugar de simularlas, pareció preferible dejar este paso al autor del documento, quien puede crearlas directamente desde su propio puesto de trabajo.

7.4. Para ir más allá desde ahora

A la espera de los próximos pasos de este port, el servidor y el cliente incluidos con este documento ofrecen una base lista para usar con la que puede experimentar por su cuenta:

  • agregar un nuevo médico o un nuevo paciente (por ahora, esto solo se puede hacer modificando el script SQL; una ruta /addDoctor, también protegida por [@Roles]('ADMIN'), podría ser un buen primer ejercicio);
  • agregar un tercer rol, o un usuario con varios roles: una oportunidad para evaluar, de forma muy concreta, el costo de abandonar la simplificación de la columna única [role] (véase el capítulo 3);
  • modificar la presentación del cliente (colores, diseño) sin cambiar el servidor: una buena manera de comprobar que la arquitectura en capas del cliente funciona como se anuncia;
  • revisar el archivo README de cada carpeta del servidor y del cliente entregados: cada uno explica, en su contexto, el papel de los archivos que contiene.