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] 中,客户端是 [React];
  • 在 [2] 中,服务器是 [NestJS];

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

Image

2.2. 创建数据库

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

Image

  • 在 [1] 中,是 Apache Web 服务器;
  • 在 [2] 中,是 [MySQL] DBMS;
  • 在 [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] 中,是 [MySQL] DBMS;
  • [7],另一个 Web 服务器;
  • 在 [8] 中,是 [node.js] ,用于运行 JavaScript 脚本;
  • [9],文本编辑器;
  • [10],PHP 解释器;
  • [11],[Python] 解释器;
  • [12],缓存服务器;

Laragon 自带完整的开发环境。在本课程中,我们只使用 [MySQL] DBMS [6] 和 [heidisql] 以图形方式管理它;

要创建 [MySQL] 数据库,供 [NestJS] 服务器使用,请按以下步骤操作:

 
  • 在 [1] 中,必须启动所有服务;
  • 在 [2] 中,[Database] 选项可用于管理数据库;

选项 [Database] 会启动名为 HeidiSQL 的实用工具:

  • 在 [1] 中,可以选择各种 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] 中,是医生预约时间段表 [slots]:
    • [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] 中,是发往运行在 8080 端口的 [NestJS] 服务器的 POST 请求;
  • 在 [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

要使用 ADMIN 账户的令牌测试 /addAppointment:

  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. 首次启动 [React] 客户端

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

npm install
npm start

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

Image

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

必须理解,这里有两个 Web 服务器,其中一个充当另一个的客户端。

右上角标有“FR”和“EN”的两个按钮可以将界面切换为法语(默认显示英语,如果浏览器设置为法语则显示法语),登录前也可以切换。使用两个演示账户之一登录(admin/admin 拥有完全访问权限,user/user 为只读),即可访问应用的其余部分。第 5 章详细介绍了该客户端的使用方法,每个步骤都配有截图。