2. 第 1 章 - 搭建工作环境
2.1. 安装工具
- Node.js:从 nodejs.org 下载并安装 22 版(或更高版本)。在终端中验证安装:
- Visual Studio Code (VSCode):可从 code.visualstudio.com 免费下载。安装“TypeScript and JavaScript Language Features”扩展(通常已内置)。
- [NestJS] CLI,一次性全局安装(客户端方面,[Vite] 不需要任何全局安装——参见简介)。在 VSCode 终端中:
- [MySQL] 8:例如通过 XAMPP、Laragon(在 Windows 上)安装,或直接通过 [MySQL] Community Server 安装。使用图形化管理工具(phpMyAdmin、[MySQL] Workbench、DBeaver、HeidiSQL……)可以简化操作。后文使用的是 Laragon 工具。
- Postman:可从 postman.com 免费下载。
如果你已下载代码,它位于两个文件夹中:

- 在 [1] 中是 [Vue.js] 客户端;
- 在 [2] 中是 [NestJS] 服务器;
用 Visual Studio 打开 [2] 文件夹 [File / Open Folder]:

2.2. 创建数据库
要创建 [MySQL] 数据库供 [NestJS] 服务器使用,我们将使用 Laragon 工具。截至 2026 年 9 月,Laragon 可从 URL [Download Laragon – Fast & Modern Dev Environment ] 获取。Laragon 包含可用于安装 PHP 服务器以及 DBMS 和 [MySQL] 服务器的工具:

- 在 [1] 中,一个 Apache Web 服务器;
- 在 [2] 中,DBMS 和 [MySQL];
- 在 [3] 中,一个我们不会使用的消息工具;
- [4] 启动所有服务(Apache、[MySQL]、MailPit);
- [5] 显示 URL [http://localhost] 对应的网页。默认情况下,该 URL 指向 <laragon-install>\www 文件夹,其中 <laragon-install> 是 Laragon 的安装文件夹;
- 在 [6] 中,启动 HeidiSQL 工具,用于管理 MySQL 数据库。我们将使用该工具创建 [NestJS] 服务器所使用的数据库;
- 在 [7] 中,打开终端;Laragon 所需的所有二进制文件都位于 PATH 中;
- 在 [8] 中,打开 Windows 资源管理器窗口,进入与 URL [http://localhost] 关联的文件夹;
Laragon 安装文件夹包含以下内容:
![]() |
- 在 [1] 中,[bin] 文件夹包含众多应用程序:
![]() |
- 在 [1] 中,Apache Web 服务器;
- 在 [2] 中,命令行终端;
- 在 [3] 中,一个 [git] 客户端,可用于管理项目的不同版本;
- 在 [4] 中,一个数据库管理器;
- 在 [5] 中,一个邮件管理器;
- 在 [6] 中,DBMS 和 [MySQL];
- [7],另一个 Web 服务器;
- 在 [8] 中,[node.js] 用于运行 JavaScript 脚本;
- 在 [9] 中,一个文本编辑器;
- 在 [10] 中,PHP 解释器;
- [11],[Python] 解释器;
- [12],一个缓存服务器;
Laragon 自带完整的开发环境。在本课程中,我们只使用 DBMS [MySQL],即 [6],以及用于以图形方式管理它的 [heidisql] 工具;
要创建 [MySQL] 数据库供 [NestJS] 服务器使用,请按以下步骤操作:
![]() |
- 在 [1] 中,所有服务都必须已启动;
- 在 [2] 中,[Database] 选项可用于管理数据库;
[Database] 选项会启动名为 HeidiSQL 的实用工具:
![]() |
- 在 [1] 中,可以选择各种 DBMS 选项。默认提供的值是 DBMS MySQL,这样就可以;
- 在 [2] 中,登录 HeidiSQL;
![]() | ![]() |
- 在 [1-2] 中,运行 SQL 文件,然后选择 [dbrdvmedecins.sql] 文件,该文件位于 [rdvmedecins-nestjs-server/database] 文件夹中:

运行 [3] 文件将创建 [dbrdvmedecins] 数据库,供 [NestJS] 服务器使用。要查看它,请在 HeidiSQL 中按 F5 刷新显示:

数据库 [dbrdvmedecins] 已创建。你可以查看其内容:

- 在 [1-3] 中,是表 [clients];
- [id] 是该表的主键;
- [version] 是该行的版本号。每次修改该行时,此编号都会递增;
- [title, last_name, first_name] 用于标识此人;

- 在 [1-3] 中,是表 [doctors];
- [id] 是该表的主键;
- [version] 是该行的版本号;
- [title, last_name, first_name] 用于标识此人;

- 在 [1-3] 中,是医生预约时间段表:
- [id]:主键;
- [version]:行版本号;
- [doctor_id]:外键,引用医生的主键;
- [start_hour, start_minute]:预约开始时间的小时和分钟。因此,[8,20] 表示上午 8:20。
- [end_hour, end_minute]:诊疗结束时间的小时和分钟。

- 在 [1-3] 中,是已安排预约的 [appointments] 表;
- [id]:主键;
- [version]:版本号;
- [day]:预约日期;
- [slot_id]:外键,引用预约时间段的主键。由于时间段与医生关联,因此我们可以知道由哪位医生负责这次预约;
- [client_id]:外键,指向前来就诊的患者的编号(主键);

- 在 [1-3] 中,是表 [users],其中列出了获准使用 [NestJS] 应用程序的用户;
- [id, version]:主键、版本号;
- [login, password]:用户凭据;
- [name]:用户名称;
- [role]:用户的角色。[ADMIN] 拥有完全访问权限。[USER] 拥有只读访问权限。该用户可以查看医生的日程,但不能安排或取消预约;
2.3. 首次启动 [NestJS] 服务器
在 [rdvmedecins-nestjs-server] 文件夹中,在终端中输入以下命令:
[.env] 文件用于设置环境变量:
根据你的 [.env] [MySQL] 安装情况(用户名、密码、端口)自定义新创建的文件。由于已加入身份验证(参见第 3 章),该文件还包含一个名为 JWT_SECRET 的键:示例值适合跟随本文档学习,但在任何实际使用之前,必须替换为你自己的唯一随机字符串。
启动所有 Laragon 服务 [Start All](如果尚未启动)。
然后启动服务器:
控制台依次显示:[NestJS] 模块的启动、控制器公开的路由列表,然后是启动确认信息:
此控制台输出确认服务器确实在 8080 端口上监听——与原始文档中的 Spring Boot 服务器端口完全相同,这是特意选择的。
2.4. 使用浏览器测试服务器
由于已加入身份验证(第 3 章),所有路由,[RdvMedecinsController] 中的路由都需要有效的 JWT 令牌:因此不能再单靠浏览器直接测试它们。例如:
现在在没有令牌时会返回 401 Unauthorized 错误:

这是预期的行为:该响应确认服务器正在妥善保护其路由。需要使用 Postman(下一节)来获取令牌并加以使用。
2.5. 使用 Postman 测试 [NestJS] 服务器
Postman 工具可从 URL [https://www.postman.com/downloads/] 获取。你可能需要创建一个账户。
启动所有 Laragon 服务,然后打开 Postman 桌面应用程序:
![]() | ![]() |
- 在 [1-2] 中,创建一个 HTTP 请求,用于查询医生预约管理服务器;
2.5.1. 登录并获取令牌
- 创建一个新的 Postman 请求,方法为 POST,URL 为 http://localhost:8080/login;
- 在 [Body] 选项卡中,选择“raw”,然后选择 JSON 格式,并输入:{"login": "admin", "password": "admin"}(或用 "user/user" 测试 USER 角色);
- 提交请求。

- 在 [1-2] 中,POST 请求发送到运行于 8080 端口的 [NestJS] 服务器;
- 在 [3-5] 中,是请求体。它向服务器传送一个 JSON 字符串,其中包含尝试登录的用户的凭据,此处为 admin/admin;
- 在 [6] 中,是服务器的响应;
- 在 [7] 中,是身份验证令牌,后续请求必须把它发送给服务器,以表明“我已经通过身份验证”;
复制 accessToken 的值:这就是之后每个请求都必须携带的令牌。在上面的示例中,需要复制的令牌是“eyJ...zoM”(不含引号)。
2.5.2. 使用令牌调用受保护的路由
对于 GET /getAllDoctors (或 RdvMedecinsController 的任何其他路由),在 Postman 的 Authorization 选项卡中,选择 Bearer Token 类型,并粘贴上面复制的令牌(Postman 随后会自动添加 Authorization: Bearer <token> 标头)。

- 在 [1-2] 中,是发送给服务器的请求。它请求数据库中的医生列表;
- 在 [3-5] 中,请求必须发送身份验证令牌。在 [4] 中选择 [Bearer Token],并在 [5] 中粘贴你之前复制的身份验证令牌;
- 在 [7] 中,是服务器的响应;
2.5.3. 测试 POST 路由(/addAppointment、/deleteAppointment)
按上述相同的步骤操作(方法 POST、JSON 请求体、Bearer Token),正如原始文档对这些路由使用 Chrome 扩展“Advanced Rest [Client]”一样。
注意:你可以在 [rdvmedecins-nestJS.postman_collection.json] 集合中找到以下 Postman 请求:

在 Postman 中,按 Ctrl-0 加载集合:

- 点击 [1] 加载集合,并选择集合文件。集合加载完成后,会显示其中的请求:

要使用 /addAppointment 结合 ADMIN 账户的令牌进行测试:
- Postman 请求,方法 POST,URL http://localhost:8080/addAppointment;
- Authorization 选项卡:Bearer Token,admin 令牌;
- [Body] 选项卡,raw,JSON:{"day": "2026-09-13", "clientId": 1, "slotId": 5};
- 发送请求。

你可以使用 HeidiSQL 验证数据库中是否已添加预约:

要测试 /deleteAppointment,按相同的步骤操作,请求体为 {"appointmentId": 2}(即上面 (8) 中要取消的预约的 ID)。

- 在 [4] 中,上面的编号是要删除的预约;

- 在 [5-7] 中,是身份验证令牌;
- 在 [9] 中,是服务器的响应。[status=0] 表示操作成功。你可以用 HeidiSQL 验证这一点:

- 在 [3] 中,2 号预约已不存在;
试一试:使用 USER 账户(user/user)的令牌而不是 admin 令牌,重复同一个 /addAppointment 请求:响应变为 403 Forbidden,并附带消息“角色 [USER] 不允许执行此操作(所需角色:ADMIN)”——这是对第 3 章中实现的基于角色的访问控制的具体演示。
2.6. 首次启动 [Vue.js] 客户端
在 rdvmedecins-vuejs-client 文件夹中(必须事先启动 [NestJS] 服务器):
然后在浏览器中打开 http://localhost:4200 :首先出现的是登录界面(参见第 5 章)。

- 在 [1] 中,是提供 [Vue.js] 应用程序的 URL 服务器;
- [2],是管理数据库 [dbrdvmedecins] 的 [NestJS] 服务器的 URL;
需要明白,这里有两台 Web 服务器,其中一台充当另一台的客户端。
右上角标有“FR”和“EN”的两个按钮可让你把界面切换为法语,甚至在登录之前也可以。使用两个演示账户之一(admin/admin,完全访问;或 user/user,只读)登录,即可访问应用程序的其余部分。第 5 章提供了使用该客户端的详细指南,每一步都附有屏幕截图。







