11. Despliegue
En desarrollo, dos servidores trabajan juntos: el servidor de desarrollo de [Vite] (el cliente) y el servidor JSON (la API). En producción, solo hay uno:

1. Construir el cliente. En la carpeta [rdvmedecins-react]:
La consola muestra:
Primero, [tsc --noEmit] verifica los tipos de todo el proyecto: [Vite] no hace esto; simplemente elimina la sintaxis de [TypeScript]. Un error de tipos detiene la compilación. Luego, [Vite] construye toda la aplicación en la carpeta [dist/]: una página [index.html], hojas de estilo y archivos [JavaScript] optimizados:
- [libraries-....js]: el código de las bibliotecas ([React], [React Router], [TanStack Query], [i18next]...), guardado en un archivo aparte por la configuración de [vite.config.ts]. Rara vez cambia: de una versión de la aplicación a la siguiente, el navegador lo conserva en la caché. [libraries-....css]: la hoja de estilo de [Bootstrap];
- [index-....js]: NUESTRO código, usado para las páginas que se cargan de inmediato (inicio de sesión, agenda) y el resto de la aplicación;
- Cada página cargada bajo demanda ([lazy], véase [routes.tsx]) tiene su propio archivo ([MyAccount-....js]...), que se descarga en la primera visita; [PersonFields-....js] y [persons.config-....js] contienen código común a varias de estas páginas;
- Al iniciar, el navegador descarga aproximadamente 170 KB una vez comprimidos por el servidor (columna gzip), de los cuales 150 KB corresponden a bibliotecas;
- El nombre de cada archivo contiene un hash de su contenido ([index-D-CLbbe-.js]): una nueva versión tendrá un nombre distinto y un navegador nunca podrá conservar en la caché una versión desactualizada. Solo [index.html] conserva su nombre: es este archivo el que hace referencia a los demás.
Se puede probar la versión construida con [npm run preview] (http://localhost:4173, con el mismo proxy hacia el servidor JSON).
2. Subirla al servidor. Copie el CONTENIDO de la carpeta [dist/] en una carpeta [client/] en la raíz del servidor JSON ([rdvmedecins-nestjs-json/client/index.html], [rdvmedecins-nestjs-json/client/assets/...]) y luego reinicie el servidor. Este muestra:
La aplicación completa ya está disponible en http://localhost:8080. El servidor sirve los archivos del cliente y devuelve [index.html] para cualquier otra URL fuera de /api: recargar la página /schedule funciona (es el navegador del cliente el que la muestra). Para el lector curioso, es el archivo [src/web/client-spa.ts] del servidor el que realiza esta tarea.
3. En un entorno de producción real, no olvide el archivo [.env] en el servidor:
- un [JWT_SECRET] largo y aleatorio;
- un [CAPTCHA_TEST] vacío;
- [COOKIE_SECURE=true] si el sitio se sirve mediante HTTPS (debe hacerse así: se transmiten contraseñas);
- [TRUST_PROXY=true] si el servidor está detrás de un proxy ([nginx]...), para que el límite de intentos vea la dirección IP real de los clientes.
Luego se inicia el servidor compilado: [npm run build], seguido de [npm run start:prod].