Skip to content

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

7.1. Lo que se ha construido

Este documento ha adaptado 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 (incluido con este documento, instalado y probado en el Capítulo 2, pero cuyo código no se trata aquí), que expone las mismas 11 rutas de negocio JSON que el servidor Spring 4 original, en el mismo puerto (8080), todas ellas ahora protegidas por un token JWT;
  • una capa de autenticación ([@nestjs/passport] + [@nestjs/jwt]): autenticación por usuario y contraseña (POST /login), un token firmado presentado con cada solicitud posterior y control de acceso basado en roles ([@Roles]('ADMIN') + [RolesGuard]) en las dos rutas que modifican datos;
  • un cliente [Flutter] (widgets [Material], paquete [provider]) que ofrece las mismas funcionalidades que el cliente AngularJS 1.x original (seleccionar un médico y una fecha, ver el calendario, reservar y cancelar una cita), complementado con una pantalla de inicio de sesión, una sesión persistente ([shared_preferences]), una interfaz adaptada al rol del usuario con sesión iniciada (botones de reserva ocultos para el rol USER) y la posibilidad de cambiar la interfaz entre francés e inglés ([TranslationsService], reimplementado sin una biblioteca de terceros).

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.

Dos diferencias intencionales con respecto a la autenticación del documento original, implementadas por el servidor entregado (véase el Capítulo 2): 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 de muchos a muchos entre tres tablas. Una tercera diferencia, esta de tipo funcional, se eligió deliberadamente para este port: el rol USER ahora puede ver los calendarios (solo lectura), mientras que en el original solo servía para ilustrar una denegación total de acceso.

7.2. Lo que queda fuera del alcance o por portar

Además de lo anterior, el documento original abarcaba tres temas adicionales: uno de los cuales ya se ha abordado, otro se dejó fuera deliberadamente y el tercero se difirió a una etapa posterior:

7.2.1. Internacionalizació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 [TranslationsService] (véase el Capítulo 4), escrito específicamente para este documento en lugar de delegarlo a un complemento de terceros: los diccionarios fr.json/en.json, integrados en la aplicación (y ya no servidos por un servidor web), se cargan mediante [rootBundle.loadString(...)]. Al igual que [angular-translate] y [vue-i18n] antes, [TranslationsService] permite cambiar de idioma sobre la marcha sin recargar la aplicación, 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 en bruto ($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 todavía eran limitadas. Este port no lo reconstruye: las herramientas de desarrollo actuales de [Flutter] ([Flutter] DevTools, utilizables en los tres destinos: móvil, escritorio y web) ofrecen ahora, aparte de la propia aplicación, una inspección mucho más completa del árbol de widgets, su estado y sus propiedades que la que proporcionarí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 ofrece el ecosistema; por lo tanto, esta decisión es definitiva y no un simple aplazamiento.

7.2.3. Retraso de red artificial: pospuesto

El documento original permitía configurar un retraso 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 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 realmente ejecutado: se probó cada ruta del servidor (incluidos los escenarios de autenticación: inicio de sesión exitoso o fallido, acceso sin token, acceso con un rol incorrecto); en cambio, el cliente [Flutter] (Capítulo 4) fue revisado y verificado línea por línea, en lugar de ser ejecutado por Claude: el entorno que produjo este documento no tiene acceso a una máquina capaz de ejecutar [Flutter] (móvil, escritorio o web), a diferencia de los clientes web anteriores de este curso, que pueden ejecutarse directamente en un navegador [Chromium] automatizado. Las capturas de pantalla del cliente en los Capítulos 4 y 5 (web, escritorio Windows, emulador de Android) fueron tomadas por el autor en su propia máquina.

7.4. Para ir más lejos desde ahora

Mientras se esperan 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 (actualmente, esto se hace solo modificando el script SQL; una ruta /addDoctor, también protegida por [@Roles]('ADMIN'), podría ser un 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 columna única que aporta [role] (véase el Capítulo 2);
  • 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 pretende;
  • Revise 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.