Skip to content

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. Sigue al curso “Introducción paso a paso al framework web NestJS”, del cual cambia la perspectiva:

  • en el curso [NestJS], el servidor genera las páginas HTML (motor de vistas [Handlebars]); el navegador simplemente las muestra;
  • en este curso, las páginas se generan en el navegador mediante una aplicación [Vue.js]; el servidor, ahora reducido a un simple servidor JSON, solo proporciona datos.

Sin embargo, las páginas de la aplicación permanecen sin cambios: son las de la aplicación [RdvMedecins] ya presentada con los otros frameworks (inicio de sesión con CAPTCHA, agenda del médico, ventana de citas, portal del paciente, gestión de médicos y clientes, creación de cuentas, francés e inglés).

El documento sigue la misma estructura que sus predecesores: primero, numerosos ejemplos breves, cada uno centrado en un concepto específico de [Vue.js], seguidos de un caso de estudio completo —el cliente [Vue.js] de la aplicación [RdvMedecins]— con todos los archivos completamente comentados.

Ya existen dos cursos disponibles sobre [Vue.js]: “Introducción al framework VUE.JS mediante ejemplos” (2019), escrito para [Vue.js] 2, y “Un ejemplo cliente/servidor con Vue.js / NestJS (2026), que abarca tanto el servidor como el cliente. Este documento se diferencia de aquellos en su enfoque: el servidor se trata como una caja negra, de la cual solo nos interesan la API y el JSON, y aprendemos [Vue.js] paso a paso antes de abordar el cliente completo.

1.1. El papel de Vue.js en una aplicación web

La aplicación tiene dos partes, que se comunican entre sí únicamente mediante solicitudes HTTP:

Image

  • 1: La aplicación [Vue.js], que se ejecuta en el navegador, envía una solicitud HTTP al servidor, por ejemplo, [GET /api/schedule?doctorId=1&day=2026-10-05];
  • 2: El servidor responde con datos JSON: la agenda de ese médico para ese día. No genera ninguna página;
  • 3: Con estos datos, [Vue.js] actualiza la página mostrada en el navegador sin recargarla.

El siguiente diagrama compara las dos arquitecturas:

Image

Al inicio, el navegador carga solo una única página HTML, casi vacía. Todo lo demás lo genera código [JavaScript]: esto se conoce como aplicación de página única (SPA, por [Single Page Application]). Cuando el usuario hace clic en un enlace interno, no se solicita ninguna página al servidor: el enrutador de [Vue.js] cambia la URL mostrada y reemplaza el contenido de la página.

[Vue.js] es un framework [JavaScript] creado en 2014 por Evan You. Se basa en dos ideas:

  • componentes: la interfaz se divide en piezas reutilizables (una barra de navegación, un campo de formulario, una ventana de confirmación, etc.), cada una escrita en un archivo [.vue] que combina su HTML, su código y su estilo;
  • reactividad: los datos de un componente son “observados”. Cuando alguno cambia, [Vue.js] actualiza automáticamente las partes de la página que lo muestran. Nunca escribimos código que modifique directamente la página.

Usaremos [Vue.js] 3, escrito en [TypeScript], con su versión más reciente: la Composition API y la etiqueta [<script setup>].

1.2. Herramientas utilizadas

Los ejemplos se escribieron y probaron con las siguientes herramientas (su instalación se describe en el apéndice):

  • [Node.js] 22 (o al menos 20.19) y su administrador de paquetes [npm];
  • el editor [Visual Studio Code], con la extensión [Vue (Official)];
  • un navegador reciente ([Chrome], [Firefox], [Edge]), si es posible con la extensión [Vue.js devtools];
  • la herramienta de línea de comandos [curl], que muestra las respuestas HTTP sin procesar;
  • el SGBD [MySQL] (o [MariaDB]), por ejemplo, el de [Laragon] en [Windows]: es necesario para el servidor JSON, como se describe en el capítulo que lo presenta.

Las bibliotecas son las de los archivos [package.json]: [Vue.js] 3.5, [Vite] 7 (la herramienta de desarrollo y compilación), [vue-router] 4 (el enrutador), [Pinia] 3 (estado compartido), [vue-i18n] 11 (idiomas), [TypeScript] 5.9, [Bootstrap] 5.3.

1.3. Ejemplos

Los códigos del documento están organizados en tres carpetas:

1
2
3
4
deliverable/
├── examples-vuejs/          the 20 small Vue.js examples
├── rdvmedecins-nestjs-json/ the RdvMedecins JSON server (the "black box")
└── rdvmedecins-vuejs/       the Vue.js client of the case study

La carpeta examples contiene una subcarpeta por ejemplo:

examples-vuejs/
├── 01-first-application/
├── 02-reactivity/
├── ...
├── 20-server-errors/
├── common/              code shared by examples 19 and 20
├── node_modules/
├── index.html           the table of contents of the examples
├── package.json
├── tsconfig.json
└── vite.config.ts

Todos los ejemplos comparten las mismas bibliotecas, que se declaran en [examples-vuejs/package.json]. Se instalan una sola vez, en una consola abierta en la carpeta [examples-vuejs] (en [VS Code]: menú Terminal / Nueva terminal):

npm install

Luego, inicie el servidor de desarrollo de [Vite]:

npm run dev

Un solo servidor, en el puerto 5173, sirve los veinte ejemplos. La dirección http://localhost:5173/ muestra su resumen:

Image

Puede navegar de un ejemplo a otro siguiendo los enlaces (http://localhost:5173/01-first-application/, http://localhost:5173/02-reactivity/...). No es necesario reiniciar el servidor de [Vite]: cada archivo que se modifica y se guarda se recompila de inmediato, y la página del navegador se actualiza automáticamente. Puede detenerlo ingresando [Ctrl-C] en la consola.

Los ejemplos 17 a 20 consultan los servidores JSON y [RdvMedecins]: deberá tenerlos instalados y en ejecución, como se explica en el capítulo dedicado a ellos.

1.4. Contenido del documento

Capítulo
Contenido
Ejemplos
Primeros pasos
Un proyecto Vite, reactividad, directivas, eventos, formularios, validación
01 a 06
Componentes
props, eventos, v-model, slots, ciclo de vida, composables, cuadro de diálogo de confirmación
07–12
Enrutamiento
el enrutador, las guardias de navegación
13 y 14
Estado compartido
Stores de Pinia
15
Internacionalización
Una aplicación en francés e inglés
16
El servidor: una caja negra
Instalación del servidor JSON, su API, ejemplos con curl
-
Interacción con el servidor
fetch, conexión y cookies; la capa de acceso a la API; errores del servidor
17–20
Caso de estudio
El cliente Vue.js de la aplicación RdvMedecins
-
Despliegue
El cliente compilado, servido por el servidor JSON
-

Cada ejemplo se presenta con su código completo, comentado línea por línea, y una captura de pantalla de su ejecución. El propio código está ampliamente comentado: estos comentarios forman parte del curso.