11. 部署
在开发环境中,有两个服务器协同工作:[Vite] 开发服务器(客户端)和 JSON 服务器(API)。在生产环境中,只有一个服务器:

1. 构建客户端。在 [rdvmedecins-react] 文件夹中:
控制台显示:
首先,[tsc --noEmit] 检查整个项目的类型:[Vite] 不做这件事;它只是去掉 [TypeScript] 的语法。类型错误会使构建中止。然后 [Vite] 在 [dist/] 文件夹中构建整个应用:一个 [index.html] 页面、样式表,以及经过优化的 [JavaScript] 文件:
- [libraries-....js]:库的代码([React]、[React Router]、[TanStack Query]、[i18next]……),由 [vite.config.ts] 的配置存放在单独的文件中。它很少变化:在应用的不同版本之间,浏览器会把它保留在缓存中。[libraries-....css]:[Bootstrap] 的样式表;
- [index-....js]:我们自己的代码,用于立即加载的页面(登录、日程)以及应用的其余部分;
- 每个按需加载的页面([lazy],见 [routes.tsx])都有自己的文件([MyAccount-....js]……),在第一次访问时下载;[PersonFields-....js] 和 [persons.config-....js] 包含其中几个页面共用的代码;
- 启动时,浏览器会下载大约 170 KB(经服务器压缩后,见 gzip 列),其中 150 KB 是库;
- 每个文件的名称都包含其内容的哈希值([index-D-CLbbe-.js]):新版本会有不同的名称,浏览器就永远不会缓存过时的版本。只有 [index.html] 保留它的名称:正是这个文件引用其他文件。
你可以用 [npm run preview] 试用构建好的版本(http://localhost:4173,使用同样的代理指向 JSON 服务器)。
2. 把它上传到服务器。把 [dist/] 文件夹的内容复制到 JSON 服务器根目录下的 [client/] 文件夹中([rdvmedecins-nestjs-json/client/index.html]、[rdvmedecins-nestjs-json/client/assets/...]),然后重启服务器。它会显示:
现在,完整的应用可以在 http://localhost:8080 访问。服务器提供客户端的文件,并对 /api 之外的任何其他 URL 返回 [index.html] :重新加载 /schedule 页面可以正常工作(显示它的是客户端的浏览器)。对于好奇的读者,服务器上负责这项任务的是 [src/web/client-spa.ts] 文件。
3. 在真实的生产环境中,别忘了服务器上的 [.env] 文件:
- 一个长而随机的 [JWT_SECRET];
- 一个为空的 [CAPTCHA_TEST];
- [COOKIE_SECURE=true] 如果站点通过 HTTPS 提供服务(必须如此:因为要传输密码);
- [TRUST_PROXY=true] 如果服务器位于代理([nginx]……)之后,这样尝试次数限制才能看到客户端的真实 IP 地址。
然后我们启动编译后的服务器:[npm run build],再执行 [npm run start:prod]。