Skip to content

2. 第 1 章 - 搭建工作环境

2.1. 安装工具

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

如果你已下载代码,它位于两个文件夹中:

Image

  • 在 [1] 中是 [Vue.js] 客户端;
  • 在 [2] 中是 [NestJS] 服务器;

用 Visual Studio 打开 [2] 文件夹 [File / Open Folder]:

Image

2.2. 创建数据库

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

Image

  • 在 [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] 文件夹中:

Image

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

Image

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

Image

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

Image

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

Image

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

Image

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

Image

  • 在 [1-3] 中,是表 [users],其中列出了获准使用 [NestJS] 应用程序的用户;
    • [id, version]:主键、版本号;
    • [login, password]:用户凭据;
    • [name]:用户名称;
    • [role]:用户的角色。[ADMIN] 拥有完全访问权限。[USER] 拥有只读访问权限。该用户可以查看医生的日程,但不能安排或取消预约;

2.3. 首次启动 [NestJS] 服务器

在 [rdvmedecins-nestjs-server] 文件夹中,在终端中输入以下命令:

npm install
cp .env.example .env

[.env] 文件用于设置环境变量:

# -----------------------------------------------------------------------
# 示例配置文件。
# 将此文件复制为 [.env],然后根据你的机器调整其中的值。
# [.env] 文件绝不能共享或提交(含密码)。
# -----------------------------------------------------------------------

# NestJS 服务器的监听端口(原 Spring 服务器监听 8080)
PORT=8080

# MySQL 数据库 [dbrdvmedecins] 的连接参数
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=
DB_DATABASE=dbrdvmedecins

# 仅在开发环境中:TypeORM 可以根据实体自动创建/更新
# 数据库表。此处已禁用该功能,因为我们像原 Spring 项目一样,提供
# 自己的 SQL 脚本 [database/dbrdvmedecins.sql]。
DB_SYNCHRONIZE=false

# -----------------------------------------------------------------------
# 身份验证(参见 src/auth/)
# -----------------------------------------------------------------------
# 用于签名/验证 JWT 令牌的密钥——必须修改
# 在生产环境中(一个足够长的随机字符串,绝不提交)。
JWT_SECRET=change-me-to-a-long-random-string
# JWT 令牌的有效期(参见 [ms] 库的文档:
# "60"、"2h"、"7d"……)
JWT_EXPIRES_IN=2h

根据你的 [.env] [MySQL] 安装情况(用户名、密码、端口)自定义新创建的文件。由于已加入身份验证(参见第 3 章),该文件还包含一个名为 JWT_SECRET 的键:示例值适合跟随本文档学习,但在任何实际使用之前,必须替换为你自己的唯一随机字符串。

启动所有 Laragon 服务 [Start All](如果尚未启动)。

然后启动服务器:

npm run start:dev

控制台依次显示:[NestJS] 模块的启动、控制器公开的路由列表,然后是启动确认信息:

[Nest] RoutesResolver RdvMedecinsController {/}:
[Nest] RouterExplorer Mapped {/getAllDoctors, GET} route
[Nest] RouterExplorer Mapped {/getAllClients, GET} route
[Nest] RouterExplorer Mapped {/getAllSlots/:doctorId, GET} route
[Nest] RouterExplorer Mapped {/getDoctorAppointmentsOfDay/:doctorId/:day, GET} route
[Nest] RouterExplorer Mapped {/getDoctorScheduleOfDay/:doctorId/:day, GET} route
[Nest] RouterExplorer Mapped {/getDoctorById/:id, GET} route
[Nest] RouterExplorer Mapped {/getClientById/:id, GET} route
[Nest] RouterExplorer Mapped {/getSlotById/:id, GET} route
[Nest] RouterExplorer Mapped {/getAppointmentById/:id, GET} route
[Nest] RouterExplorer Mapped {/addAppointment, POST} route
[Nest] RouterExplorer Mapped {/deleteAppointment, POST} route
[Nest] RoutesResolver AuthController {/}:
[Nest] RouterExplorer Mapped {/login, POST} route
[Nest] NestApplication Nest application successfully started
[RdvMedecins] NestJS server started on http://localhost:8080

此控制台输出确认服务器确实在 8080 端口上监听——与原始文档中的 Spring Boot 服务器端口完全相同,这是特意选择的。

2.4. 使用浏览器测试服务器

由于已加入身份验证(第 3 章),所有路由,[RdvMedecinsController] 中的路由都需要有效的 JWT 令牌:因此不能再单靠浏览器直接测试它们。例如:

http://localhost:[8080/getAllDoctors]

现在在没有令牌时会返回 401 Unauthorized 错误:

Image

这是预期的行为:该响应确认服务器正在妥善保护其路由。需要使用 Postman(下一节)来获取令牌并加以使用。

2.5. 使用 Postman 测试 [NestJS] 服务器

Postman 工具可从 URL [https://www.postman.com/downloads/] 获取。你可能需要创建一个账户。

启动所有 Laragon 服务,然后打开 Postman 桌面应用程序:

  • 在 [1-2] 中,创建一个 HTTP 请求,用于查询医生预约管理服务器;

2.5.1. 登录并获取令牌

  1. 创建一个新的 Postman 请求,方法为 POST,URL 为 http://localhost:8080/login;
  2. 在 [Body] 选项卡中,选择“raw”,然后选择 JSON 格式,并输入:{"login": "admin", "password": "admin"}(或用 "user/user" 测试 USER 角色);
  3. 提交请求。

Image

  • 在 [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> 标头)。

Image

  • 在 [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 请求:

Image

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

Image

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

Image

要使用 /addAppointment 结合 ADMIN 账户的令牌进行测试:

  1. Postman 请求,方法 POST,URL http://localhost:8080/addAppointment;
  2. Authorization 选项卡:Bearer Token,admin 令牌;
  3. [Body] 选项卡,raw,JSON:{"day": "2026-09-13", "clientId": 1, "slotId": 5};
  4. 发送请求。

Image

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

Image

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

Image

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

Image

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

Image

  • 在 [3] 中,2 号预约已不存在;

试一试:使用 USER 账户(user/user)的令牌而不是 admin 令牌,重复同一个 /addAppointment 请求:响应变为 403 Forbidden,并附带消息“角色 [USER] 不允许执行此操作(所需角色:ADMIN)”——这是对第 3 章中实现的基于角色的访问控制的具体演示。

2.6. 首次启动 [Vue.js] 客户端

在 rdvmedecins-vuejs-client 文件夹中(必须事先启动 [NestJS] 服务器):

npm install
npm start

然后在浏览器中打开 http://localhost:4200 :首先出现的是登录界面(参见第 5 章)。

Image

  • 在 [1] 中,是提供 [Vue.js] 应用程序的 URL 服务器;
  • [2],是管理数据库 [dbrdvmedecins] 的 [NestJS] 服务器的 URL;

需要明白,这里有两台 Web 服务器,其中一台充当另一台的客户端。

右上角标有“FR”和“EN”的两个按钮可让你把界面切换为法语,甚至在登录之前也可以。使用两个演示账户之一(admin/admin,完全访问;或 user/user,只读)登录,即可访问应用程序的其余部分。第 5 章提供了使用该客户端的详细指南,每一步都附有屏幕截图。