7. Capítulo 6 - Conclusión y próximos pasos
7.1. Lo que se construyó
Este documento adaptó el núcleo funcional y la autenticación de la aplicación [RdvMedecins] del documento original de 2014 a tecnologías actuales:
- un servidor [NestJS] completo (entidades de [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), y ahora todas protegidas por un token (JWT);
- una capa de autenticación ([@nestjs/passport] + [@nestjs/jwt]): autenticación con 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 [React] (componentes funcionales, hooks) que ofrece las mismas funcionalidades que el cliente AngularJS 1.x original (seleccionar un médico y una fecha, ver la agenda, reservar y cancelar 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 que inició sesión (botones de reserva ocultos para un rol específico) y la posibilidad de cambiar la interfaz entre francés e inglés ([i18next] + [react-i18next]).
El núcleo de la base de datos no ha cambiado (las mismas tablas [doctors/clients/slots/appointments], las mismas restricciones), salvo por el agregado de la tabla [users]; tampoco ha cambiado la arquitectura general en capas: solo se actualizaron las herramientas que la implementan.
Hay dos diferencias intencionales con respecto al método 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 sola columna [role] por usuario en lugar de una relación de muchos a muchos entre tres tablas. Una tercera diferencia, esta de carácter funcional, se eligió deliberadamente para esta adaptación: el rol USER ahora puede ver las agendas (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 pendiente de adaptar
Además de lo anterior, el documento original abordaba tres temas adicionales: uno de los cuales ya se ha tratado, otro se dejó fuera deliberadamente y el tercero se pospuso para una etapa posterior:
7.2.1. Localización francés/inglés: tratada en este documento
El documento original proponía cambiar la interfaz entre francés e inglés mediante la biblioteca [angular-translate]. Esta adaptación implementa esta funcionalidad con su equivalente en el ecosistema actual de [React], [i18next] (junto con [react-i18next], que carga los diccionarios fr.json/en.json por HTTP desde la carpeta [public/i18n/]); vea el Capítulo 5. Al igual que [angular-translate] antes, [i18next] permite cambiar de idioma sobre la marcha, sin recargar la página; un comportamiento fiel al del documento original.
7.2.2. El modo «debug» del cliente: excluido deliberadamente 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 eran todavía limitadas. Esta adaptación no la recrea: las herramientas de desarrollo actuales de [React] ([React] DevTools, extensión oficial del navegador) ofrecen ahora, fuera de la propia aplicación, una inspección mucho más completa de los componentes, su estado (hooks) y sus props 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 el ecosistema ya proporciona; por lo tanto, esta decisión es definitiva, no un simple aplazamiento.
7.2.3. Retardo de red artificial: pospuesto
El documento original permitía configurar un retardo artificial antes de cada respuesta del servidor, para observar el comportamiento de la interfaz en una red lenta (indicadores de carga, desactivación temporal de botones, etc.). Esta funcionalidad todavía no tiene un equivalente en esta adaptación.
7.3. Una nota sobre la metodología utilizada en este documento
Este documento se redactó basándose por completo en el código que realmente se ejecutó: se probaron todas las rutas 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 corrigió en el Capítulo 3, directamente en el código entregado. Esta exigencia también explica por qué no se incluyen capturas de pantalla de Postman en este documento: en lugar de simularlas, pareció preferible dejar este paso al autor del documento, quien puede crearlas directamente desde su propia estación de trabajo.
7.4. Para empezar de inmediato
Mientras se esperan los próximos pasos de esta adaptación, 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 (actualmente, esto solo puede hacerse modificando el script SQL; una ruta llamada /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 manera muy concreta, el costo de abandonar la simplificación de la columna única [role] (vea el Capítulo 3);
- modificar la presentación del cliente (colores, diseño) sin cambiar el servidor: una buena manera de verificar que la arquitectura en capas del cliente funciona como se pretende;
- 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.