Arquitectura de Software para Aplicaciones Web: Construyendo con Node.js y MySQL

Este plan de clase está diseñado para que los estudiantes de Ingeniería de Sistemas comprendan y apliquen los principios fundamentales de la arquitectura de software, con un enfoque práctico en el desarrollo de aplicaciones web utilizando Node.js y MySQL. A través de un enfoque de Aprendizaje Basado en Proyectos, los estudiantes trabajarán colaborativamente para diseñar y desarrollar una aplicación web funcional que resuelva un problema real, integrando conceptos arquitectónicos, manejo de bases de datos y programación backend. Este aprendizaje es altamente relevante porque permite a los estudiantes conectar la teoría con la práctica de tecnologías demandadas en la industria, facilitando su inserción profesional. Además, el proyecto promueve el desarrollo de competencias técnicas y de trabajo en equipo, habilidades esenciales para su futuro profesional.

• Analizar los principios y patrones de arquitectura de software aplicables a aplicaciones web con Node.js y MySQL.
• Diseñar la arquitectura de una aplicación web modular y escalable utilizando Node.js como backend y MySQL para la gestión de datos.
• Implementar funcionalidades backend que interactúen eficazmente con la base de datos MySQL, asegurando integridad y seguridad.
• Colaborar de manera eficaz en equipo para desarrollar y documentar un proyecto de aplicación web real.
• Evaluar y optimizar el rendimiento y la seguridad de la aplicación desarrollada.

• Computadoras con acceso a internet y entorno de desarrollo instalado (Visual Studio Code, Node.js, npm, MySQL, MySQL Workbench).
• Servidor local (XAMPP o similar) para gestión de base de datos MySQL.
• Repositorio en GitHub para control de versiones y colaboración.
• Material impreso o digital con documentación básica sobre arquitectura de software, Node.js y MySQL.
• Proyector y pantalla para presentaciones y demostraciones.
• Acceso a tutoriales y documentación oficial de Node.js y MySQL.
• Herramientas para comunicación grupal (por ejemplo, Slack, Microsoft Teams o similar).

• Conocimientos básicos de programación en JavaScript y manejo de bases de datos relacionales.
• Familiaridad con conceptos fundamentales de desarrollo web (HTTP, cliente-servidor).
• Experiencia previa con algún sistema operativo y herramientas de desarrollo.
• Comprensión elemental de estructuras de datos y algoritmos.

Sesión 1: Introducción y Diseño Inicial de Arquitectura

Fase de Inicio

Propósito de la sesión: Dar la bienvenida a los estudiantes, activar conocimientos previos y presentar el proyecto que desarrollarán, estableciendo la importancia de la arquitectura de software en aplicaciones web con Node.js y MySQL.

• Docente: Presenta la pregunta detonadora: "¿Cuáles son los principales componentes que creen que conforman una aplicación web moderna y cómo se comunican entre sí?"
• Estudiantes: Responden en plenaria y discuten brevemente sus ideas, anotándolas en una pizarra o documento compartido.

• Docente: Expone un caso real de éxito en la industria donde una arquitectura bien diseñada permitió escalar una aplicación web con Node.js y MySQL, mostrando datos de uso y crecimiento.
• Estudiantes: Reflexionan sobre la relevancia de la arquitectura para resolver problemas reales y participan con preguntas.

• Docente: Conecta el tema con aplicaciones cotidianas que usan tecnologías similares (redes sociales, tiendas en línea, sistemas de reservas), destacando la importancia de conocer la arquitectura para crear soluciones eficientes.
• Estudiantes: Comparten ejemplos personales de aplicaciones que utilizan y reflexionan sobre su estructura.

Fase de Desarrollo

Presentación del contenido: Se introduce la arquitectura de software para aplicaciones web, enfatizando en patrones como MVC, separación de capas y comunicación cliente-servidor, con ejemplos en Node.js y MySQL.

• Objetivo: Analizar patrones arquitectónicos aplicados en aplicaciones web reales.
• Instrucciones: En grupos de 3-4, los estudiantes reciben diagramas simplificados de arquitecturas de aplicaciones web. Deben identificar componentes, patrones y describir la función de cada capa.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Breve informe grupal con el análisis y una presentación oral de 5 minutos.
• Tiempo: 90 minutos (60 para análisis y elaboración, 30 para presentaciones).
• Rol del docente: Facilita el material, supervisa discusiones, formula preguntas para profundizar y orienta el análisis.

• Objetivo: Diseñar el alcance y requerimientos básicos del proyecto de aplicación web a desarrollar.
• Instrucciones: En los mismos grupos, los estudiantes discuten y definen el problema que su aplicación resolverá, los usuarios objetivo y las funcionalidades principales.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Documento con definición de problema, usuarios y funcionalidades.
• Tiempo: 90 minutos.
• Rol del docente: Modera, orienta preguntas para delimitar alcance y asegura que los proyectos sean viables.

• Estudiantes que terminan antes pueden investigar ejemplos adicionales de arquitecturas y compartir hallazgos.
• Quienes requieren apoyo reciben guías escritas con preguntas específicas para facilitar el análisis y definición.

El docente resume las definiciones de proyecto y prepara a los estudiantes para el diseño arquitectónico detallado en la siguiente sesión.

Fase de Cierre

• Síntesis: Cada grupo comparte en plenaria la definición de su proyecto y componentes básicos de arquitectura.
• Reflexión metacognitiva:
  • ¿Cuál fue el mayor desafío al definir la arquitectura inicial?
  • ¿Cómo creen que la arquitectura impactará en el desarrollo y mantenimiento de su aplicación?
  • ¿Qué aprendieron sobre la importancia de planificar antes de programar?
• Retroalimentación: El docente ofrece comentarios constructivos, destacando puntos fuertes y áreas de mejora.
• Transferencia: Se anticipa que en la próxima sesión se profundizará en el diseño de bases de datos y estructuras backend.
• Tarea: Investigar y traer ejemplos de aplicaciones web que usen Node.js y MySQL para discusión.

Sesión 2: Diseño de Base de Datos y Modelado Backend

Fase de Inicio

Propósito de la sesión: Revisar tareas, activar conocimientos sobre bases de datos y preparar para modelar la base de datos del proyecto.

• Docente: Pregunta en plenaria: "¿Qué elementos creen que son esenciales en la estructura de una base de datos para una aplicación web?"
• Estudiantes: Responden, y se registra consenso.

• Docente: Muestra un ejemplo de un problema real causado por una mala estructura de base de datos y cómo se solucionó.
• Estudiantes: Reflexionan y comentan sobre la importancia de un buen modelado.

Fase de Desarrollo

Presentación del contenido: Se introduce el modelado entidad-relación, normalización y conexión con Node.js usando librerías como Sequelize o mysql2.

• Objetivo: Crear el modelo entidad-relación para la base de datos del proyecto.
• Instrucciones: En grupos, con papel o herramienta digital, diseñan el modelo entidad-relación que refleje las funcionalidades definidas.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Diagrama entidad-relación completo.
• Tiempo: 120 minutos.
• Rol del docente: Asiste con preguntas guía, revisa avances y asegura comprensión de conceptos.

• Objetivo: Implementar la conexión entre Node.js y la base de datos MySQL.
• Instrucciones: En grupos, configuran el entorno de desarrollo y escriben el código para conectar Node.js con MySQL, validando la conexión.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Código funcional para conexión a base de datos.
• Tiempo: 90 minutos.
• Rol del docente: Supervisa, resuelve dudas técnicas y refuerza buenas prácticas.

• Quienes avanzan rápido pueden explorar la creación de modelos de datos usando ORM.
• Los que necesitan ayuda reciben apoyo adicional con ejemplos guiados y acompañamiento individual.

El docente conecta este trabajo con la creación de rutas y controladores en la próxima sesión para construir la lógica backend.

Fase de Cierre

• Síntesis: Resumen colectivo de pasos para modelar y conectar la base de datos.
• Reflexión metacognitiva:
  • ¿Qué dificultades enfrentaron al modelar la base de datos?
  • ¿Cómo aseguraron que el modelo reflejara los requerimientos del proyecto?
  • ¿Por qué es importante una conexión estable entre backend y base de datos?
• Retroalimentación: Comentarios positivos y recomendaciones para fortalecer el diseño.
• Transferencia: Se prepara a los estudiantes para implementar la lógica del backend en la siguiente sesión.
• Tarea: Documentar el modelo y preparar preguntas para la implementación backend.

Sesión 3: Implementación de Rutas y Controladores en Node.js

Fase de Inicio

Propósito de la sesión: Recordar conceptos previos y presentar la programación de rutas y controladores para la aplicación.

• Docente: Solicita a los estudiantes explicar en breve qué es una ruta y un controlador en una aplicación web.
• Estudiantes: Responden en plenaria.

• Docente: Demuestra una ruta sencilla en Node.js y cómo responde a una petición.
• Estudiantes: Observan y hacen preguntas.

Fase de Desarrollo

Presentación del contenido: Se explica la estructura de rutas y controladores en Node.js, manejo de middlewares y conexión con la base de datos.

• Objetivo: Crear rutas para las operaciones básicas (CRUD) de la aplicación.
• Instrucciones: En grupos, escriben código para definir rutas GET, POST, PUT y DELETE, con validación simple.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Código con rutas funcionales y pruebas locales.
• Tiempo: 120 minutos.
• Rol del docente: Asiste con debugging, sugiere mejoras y verifica comprensión.

• Objetivo: Desarrollar controladores que gestionen la lógica y manipulen la base de datos.
• Instrucciones: Implementan funciones controladoras para cada ruta, realizan pruebas con herramientas como Postman.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Controladores funcionando y reportes de pruebas.
• Tiempo: 90 minutos.
• Rol del docente: Supervisa pruebas, fomenta buenas prácticas y apoyo técnico.

• Quienes terminen antes pueden agregar manejo de errores y validaciones avanzadas.
• Quienes necesiten apoyo reciben ejemplos codificados y acompañamiento personalizado.

El docente introduce la importancia de la seguridad y autenticación, tema central de la próxima sesión.

Fase de Cierre

• Síntesis: Discusión guiada para consolidar el flujo de peticiones y respuestas en la aplicación.
• Reflexión metacognitiva:
  • ¿Cómo la estructura de rutas facilita el desarrollo colaborativo?
  • ¿Qué aprendieron sobre la interacción entre rutas y controladores?
  • ¿Qué aspectos mejorarían en su implementación actual?
• Retroalimentación: Se ofrecen observaciones específicas y se motivan a documentar el código.
• Transferencia: Se anuncia que en la próxima sesión abordarán seguridad y autenticación.
• Tarea: Investigar conceptos básicos de autenticación en Node.js.

Sesión 4: Seguridad y Autenticación en Aplicaciones Web

Fase de Inicio

Propósito de la sesión: Introducir conceptos de seguridad y autenticación, vitales para proteger aplicaciones web.

• Docente: Pregunta: "¿Qué riesgos de seguridad conocen en aplicaciones web y cómo se podrían mitigar?"
• Estudiantes: Discuten ejemplos y comparten experiencias.

• Docente: Presenta un breve video o caso de estudio sobre vulnerabilidades comunes y ataques reales.
• Estudiantes: Analizan el caso y expresan inquietudes.

Fase de Desarrollo

Presentación del contenido: Explicación de mecanismos de autenticación (JWT, sesiones), encriptación de contraseñas y prácticas de seguridad en Node.js.

• Objetivo: Desarrollar funcionalidades de registro y login con encriptación y autenticación JWT.
• Instrucciones: En grupos, codifican endpoints para registro y login, implementando bcrypt para contraseñas y JWT para tokens.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Código funcional con pruebas exitosas.
• Tiempo: 120 minutos.
• Rol del docente: Apoya con troubleshooting, fomenta buenas prácticas y seguridad.

• Objetivo: Validar la seguridad de la autenticación y detectar posibles fallas.
• Instrucciones: Los grupos prueban ataques básicos (inyección, autenticación incorrecta) y documentan resultados.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Informe de pruebas y recomendaciones para mejorar.
• Tiempo: 80 minutos.
• Rol del docente: Supervisa, corrige y guía análisis.

• Quienes finalicen antes exploran integración de middlewares de seguridad adicionales (helmet, cors).
• Quienes requieran apoyo reciben tutoriales paso a paso y acompañamiento.

Se prepara a los estudiantes para integrar frontend y trabajar en interfaces en la próxima sesión.

Fase de Cierre

• Síntesis: Creación conjunta de un mapa mental sobre seguridad en aplicaciones web.
• Reflexión metacognitiva:
  • ¿Cómo la autenticación mejora la seguridad de su aplicación?
  • ¿Qué aprendieron sobre la importancia de proteger los datos de los usuarios?
  • ¿Qué desafíos encontraron al implementar estos mecanismos?
• Retroalimentación: Comentarios específicos y énfasis en prácticas seguras.
• Transferencia: Se anticipa la integración del backend con frontend, tema de la siguiente sesión.
• Tarea: Preparar un esquema de interfaz para la aplicación.

Sesión 5: Integración Backend-Frontend y Pruebas Funcionales

Fase de Inicio

Propósito de la sesión: Recordar conceptos y presentar la importancia de la integración y pruebas.

• Docente: Pregunta: "¿Qué elementos necesitan para que el backend y frontend trabajen juntos armoniosamente?"
• Estudiantes: Responden y discuten.

• Docente: Muestra una demo sencilla de integración exitosa.
• Estudiantes: Observan y comentan.

Fase de Desarrollo

Presentación del contenido: Explicación sobre APIs REST, consumo desde frontend, manejo de estados y pruebas funcionales.

• Objetivo: Crear interfaces básicas que consuman las APIs desarrolladas.
• Instrucciones: En grupos, diseñan páginas HTML/JavaScript que interactúen con el backend para mostrar y enviar datos.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Interfaces funcionales que consumen la API.
• Tiempo: 120 minutos.
• Rol del docente: Asiste en integración y depuración.

• Objetivo: Realizar pruebas funcionales y documentar resultados y procesos.
• Instrucciones: Ejecutan pruebas de usabilidad y funcionalidad, registrando errores y sugerencias.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Informe de pruebas y documentación técnica.
• Tiempo: 85 minutos.
• Rol del docente: Facilita discusión sobre resultados y retroalimentación.

• Quienes terminan antes pueden explorar mejoras en la interfaz o automatización de pruebas.
• Apoyo adicional para quienes lo necesiten con ejemplos y tutorías.

Se introduce que la última sesión será para cerrar el proyecto, optimizar y presentar.

Fase de Cierre

• Síntesis: Resumen en plenaria de avances y dificultades.
• Reflexión metacognitiva:
  • ¿Qué aprendieron sobre la integración entre frontend y backend?
  • ¿Qué pruebas consideran más importantes para garantizar calidad?
  • ¿Cómo pueden mejorar su proyecto antes de la presentación final?
• Retroalimentación: Comentarios para mejorar y motivación para la sesión final.
• Transferencia: Preparación para la presentación y evaluación final.
• Tarea: Preparar presentación del proyecto.

Sesión 6: Optimización, Presentación y Reflexión Final

Fase de Inicio

Propósito de la sesión: Revisión rápida de objetivos y organización para cierre del proyecto.

• Docente: Solicita que cada grupo haga un breve resumen de lo que ha logrado y lo que falta.
• Estudiantes: Comparten en plenaria.

• Docente: Anima a los estudiantes destacando la importancia de la mejora continua y la presentación clara.
• Estudiantes: Se motivan para finalizar.

Fase de Desarrollo

Presentación del contenido: Se orienta sobre técnicas para optimizar código, mejorar documentación y preparar presentaciones efectivas.

• Objetivo: Mejorar código, corregir errores y documentar adecuadamente el proyecto.
• Instrucciones: En grupos, revisan su código, aplican optimizaciones y completan documentación técnica y de usuario.
• Organización: Grupos de 3-4 estudiantes.
• Producto: Código optimizado y documentación completa.
• Tiempo: 100 minutos.
• Rol del docente: Asiste en revisión, sugiere mejoras y valida la calidad.

• Objetivo: Exponer el proyecto, demostrando funcionalidades y explicando diseño y aprendizajes.
• Instrucciones: Cada grupo realiza presentación de 10 minutos ante la clase.
• Organización: Plenaria.
• Producto: Presentación oral y demostración práctica.
• Tiempo: 90 minutos (incluye preguntas y retroalimentación).
• Rol del docente: Evalúa, fomenta preguntas y ofrece retroalimentación final.

• Estudiantes con mayor dominio pueden apoyar a sus compañeros en la revisión final.
• Quienes necesiten pueden recibir apoyo para la preparación de la presentación.

Se concluye el proyecto y se invita a reflexionar sobre su experiencia y aplicación futura.

Fase de Cierre

• Síntesis: Mapa mental colectivo con aprendizajes clave y desafíos superados.
• Reflexión metacognitiva:
  • ¿Qué competencias desarrollaron durante este proyecto?
  • ¿Cómo aplicarían lo aprendido en un entorno profesional real?
  • ¿Qué mejorarían en un proyecto futuro similar?
• Retroalimentación: Comentarios finales del docente, destacando crecimiento y recomendaciones.
• Transferencia: Invitación a continuar explorando tecnologías y prácticas de arquitectura.
• Tarea: Autoevaluación y coevaluación del proyecto.

Tipo de evaluación:

• Diagnóstica: En la Sesión 1, mediante la activación de conocimientos previos y discusión inicial.
• Formativa: Durante todas las sesiones, a través de observación directa, revisión de productos parciales, discusiones y retroalimentación continua.
• Sumativa: En la Sesión 6, con la presentación final del proyecto, revisión de documentación y auto/coevaluación.

Criterios de evaluación:

• Capacidad para analizar y aplicar principios de arquitectura de software (Objetivo 1).
• Diseño coherente y escalable de la arquitectura y base de datos (Objetivo 2).
• Implementación funcional y segura de backend con Node.js y MySQL (Objetivo 3).
• Colaboración efectiva en equipo y documentación clara (Objetivo 4).
• Capacidad para evaluar y optimizar la aplicación, incluyendo seguridad y rendimiento (Objetivo 5).

Instrumentos sugeridos:

• Rúbrica para evaluación de proyecto final (código, documentación, presentación).
• Lista de cotejo para seguimiento de actividades formativas.
• Observación directa durante actividades grupales.
• Portafolio digital con todos los productos generados.
• Autoevaluación y coevaluación mediante cuestionarios guiados.

Evidencias de aprendizaje:

• Informes de análisis y diseño arquitectónico.
• Diagramas entidad-relación y documentación técnica.
• Código fuente funcional del backend y pruebas de conexión.
• Implementación de mecanismos de seguridad y autenticación.
• Interfaces web integradas y pruebas funcionales.
• Presentación final y documentación completa del proyecto.