Skip to content

7. 第 6 章 - 结论与后续步骤

7.1. 已构建的内容

本文档把 2014 年原始文档中 [RdvMedecins] 应用程序的功能核心和身份验证部分改编到了当前的技术上:

  • 一个完整的 [NestJS] 服务器([TypeORM] 实体、DAO、业务层、Web 层),公开与原始 Spring 4 服务器相同的 11 个业务路由(JSON),端口也相同(8080),现在全部受令牌(JWT)保护;
  • 一个身份验证层([@nestjs/passport] + [@nestjs/jwt]):登录名/密码身份验证(POST /login)、随每个后续请求提交的已签名令牌,以及对两个修改数据的路由实施的基于角色的访问控制([@Roles]('ADMIN') + [RolesGuard]);
  • 一个 [Vue.js] 客户端(组合式 API,setup 脚本),提供与原始 AngularJS 1.x 客户端相同的功能——选择医生和日期、查看日程表、预约和取消预约——并补充了登录界面、持久会话(localStorage)、适应已登录用户角色的 Bootstrap 界面(对于特定的 USER 角色,预约按钮被隐藏),以及在法语和英语之间切换界面的能力([vue-i18n])。

数据库的核心没有变化(相同的表 [doctors/clients/slots/appointments],相同的约束),只是增加了表 [users];总体的分层架构也没有变化——只是实现它的工具得到了更新。

与原始文档中的身份验证过程相比,有两处有意的差异,已在第 3 章详细说明:使用 JWT 令牌,而不是随每个请求发送 HTTP Basic 标头;每个用户使用单个 [role] 列,而不是跨三张表的多对多关系。第三处差异——这一处是功能上的——是本次移植有意选择的:USER 角色现在可以查看日程表(只读),而在原文档中它仅用于演示完全拒绝访问。

7.2. 未纳入范围或有待移植的内容

除上述内容之外,原始文档还涵盖了另外两个主题——其中一个现已解决,另一个被有意排除,而第三个则推迟到后续阶段:

7.2.1. 法语/英语国际化——已在本文档中解决

原始文档提出使用 [angular-translate] 库在法语和英语之间切换界面。本次移植使用当前 [Vue.js] 生态系统中与之对应的库 [vue-i18n] 实现了这一功能(其字典 fr.json/en.json 通过 HTTP 从 [public/i18n/] 文件夹加载,使用的是为本次移植编写的一个小型加载函数,因为没有与 React 一侧所用插件对应的官方 HTTP 插件)——参见第 5 章。与此前的 [angular-translate] 一样,[vue-i18n] 允许你即时切换语言,而无需重新加载页面——这一行为与原始文档忠实一致。

7.2.2. 客户端的“调试”模式——有意排除在范围之外

原始文档包含一种可从界面激活的技术显示模式,通过它可以访问当前视图的原始模型(AngularJS 1.x 的 $scope)——这在 2014 年是一项有用的功能,当时可用于检查 AngularJS 应用程序的开发工具还很有限。本次移植不再重建它:当前的 [Vue.js] 开发工具([Vue.js] DevTools,官方浏览器扩展)现在可以在应用程序之外,对组件、其状态及其 props 提供比重新集成到界面中的自定义调试面板全面得多的检查。添加这样一个面板,就等于重新做出一个生态系统已经提供的工具的缩水版——因此这一决定是最终的,而不只是推迟。

7.2.3. 人为网络延迟——已推迟

原始文档允许在每次服务器响应之前设置一个人为延迟,以观察界面在慢速网络下的行为(加载指示器、临时禁用按钮等)。这个功能在本次移植中尚无对应的实现。

7.3. 关于本文档所用方法的说明

本文档完全基于实际执行过的代码编写:每条服务器路径都经过测试(包括身份验证场景:登录成功/失败、不带令牌访问、使用错误角色访问),每张客户端屏幕截图(第 5 章)都是通过与实际运行的应用程序交互获得的——使用由自动控制的 Chromium 浏览器,并采用所提供 SQL 脚本中的演示数据。这种方法还在编写本文档期间发现了一个有关将 [TypeORM] 用于计算列([@RelationId])的具体问题——该问题已被报告,并直接在随附的代码中于第 3 章得到修正。这一要求也解释了为什么 Postman 的屏幕截图不是模拟出来的:这一步留给了文档作者,由他直接在自己的工作站上创建(参见第 1 章)。

7.4. 立即进一步实践

在等待本次移植的后续步骤期间,本文档附带的服务器和客户端提供了一个现成的基础,供你自行试验:

  • 添加新的医生或新的患者(目前只能通过修改 SQL 脚本来完成——一个名为 /addDoctor、同样受 [@Roles]('ADMIN') 保护的路由,可以作为一个很好的入门练习);
  • 添加第三个角色,或拥有多个角色的用户——这是一个以非常具体的方式评估放弃由 [role] (参见第 3 章)所提供的单列简化的代价的机会;
  • 修改客户端的呈现方式(颜色、布局)而不改动服务器——这是验证客户端的分层架构是否如宣称的那样运行的好办法;
  • 查看所交付的服务器和客户端中每个文件夹的 README 文件:每个文件都在其上下文中说明了其中所含文件的作用。