7. 第 6 章 - 结论与后续步骤
7.1. 已完成的内容
本文档将 2014 年原始文档中 [RdvMedecins] 应用的核心功能和身份验证改造为当前的技术:
- 一个完整的 [NestJS] 服务器(随本文档提供,已在第 2 章安装并测试,但其代码不在此介绍),在同一端口(8080)上提供与原 Spring 4 服务器相同的 11 个 JSON 业务路由,现在全部由 JWT 令牌保护;
- 一个 身份验证层([@nestjs/passport] + [@nestjs/jwt]):登录名/密码身份验证(POST /login)、后续每个请求都需出示的签名令牌,以及对两个修改数据的路由实施的基于角色的访问控制([@Roles]('ADMIN') + [RolesGuard]);
- 一个 [Flutter] 客户端(组件 [Material],包 [provider]),提供与原 AngularJS 1.x 客户端相同的功能——选择医生和日期、查看日历、预约和取消预约——并增加了登录界面、持久会话([shared_preferences])、根据已登录用户角色定制的界面(USER 角色看不到预约按钮),以及在法语和英语之间切换界面的功能([TranslationsService],不借助第三方库重新实现)。
数据库的核心没有变化(相同的表 [doctors/clients/slots/appointments]、相同的约束),只是增加了表 [users];整体的分层架构也没有变化——更新的只是实现它的工具。
与原始文档的身份验证相比有两处有意为之的差异,由随附的服务器实现(参见第 2 章):使用 JWT 令牌,而不是每个请求都发送 HTTP Basic 头;每个用户只有一个 [role] 列,而不是跨三张表的多对多关系。第三处差异属于功能层面,是本次移植特意做出的选择:USER 角色现在可以查看日历(只读),而在原版中,它只是用来演示完全拒绝访问。
7.2. 不在范围内或有待移植的内容
除上述内容外,原始文档还涵盖了另外三个主题——其中一个现已完成,另一个被有意舍弃,第三个则推迟到后续阶段:
7.2.1. 法语/英语国际化——已在本文档中实现
原始文档使用 [angular-translate] 库来实现界面在法语和英语之间的切换。本次移植使用 [TranslationsService] (参见第 4 章)实现这一功能,该服务专为本文档编写,而不是交给第三方插件:fr.json/en.json 字典内嵌在应用中(不再由 Web 服务器提供),通过 [rootBundle.loadString(...)] 加载。与之前的 [angular-translate] 和 [vue-i18n] 一样,[TranslationsService] 允许你即时切换语言而无需重新加载应用——其行为与原始文档忠实一致。
7.2.2. 客户端的“调试”模式——有意排除在范围之外
原始文档包含一种可从界面激活的技术显示模式,可访问当前视图的原始模型(AngularJS 1.x 的 $scope)——这在 2014 年是一项很有用的功能,当时可用于检查 AngularJS 应用的开发工具还很有限。本次移植没有重建它:当前的 [Flutter] 开发工具([Flutter] DevTools,可用于全部三个目标平台——移动端、桌面端、Web)除应用本身之外,能提供比重新集成到界面中的自定义调试面板全面得多的检查能力,可检查组件树、组件的状态及其属性。添加这样一个面板,等于重复制造一个生态系统中已有工具的简陋版本——因此这一决定是最终的,而不只是推迟。
7.2.3. 人为网络延迟——推迟
原始文档允许在每次服务器响应之前设置人为延迟,以观察界面在慢速网络下的行为(加载指示器、按钮临时禁用等)。本次移植中尚无与之对应的功能。
7.3. 关于本文档所用方法的说明
本文档的编写系统性地依赖实际执行的代码:每条服务器路径都经过测试(包括身份验证场景:登录成功/失败、不带令牌访问、使用错误角色访问);而 [Flutter] 客户端(第 4 章)则是逐行审阅和核对的,并未由 Claude 运行——生成本文档的环境无法使用能够运行 [Flutter](移动端、桌面端或 Web)的机器,这与本课程之前的 Web 客户端不同,后者可以在自动化的 [Chromium] 浏览器中直接运行。第 4 章和第 5 章中的客户端截图(Web、Windows 桌面、Android 模拟器)由作者在自己的机器上截取。
7.4. 立即进一步实践
在等待本次移植的后续步骤期间,随本文档提供的服务器和客户端为你自己动手实验提供了一个现成的基础:
- 添加新医生或新患者(目前只能通过修改 SQL 脚本来完成——同样受 [@Roles]('ADMIN') 保护的 /addDoctor 路由,可以作为第一个练习);
- 添加第三种角色,或拥有多个角色的用户——这是一个很好的机会,可以非常具体地评估放弃 [role] 单列简化方案的代价(参见第 2 章);
- 修改客户端的呈现方式(颜色、布局)而不改动服务器——这是验证客户端分层架构按预期工作的好办法;
- 请查阅随附服务器和客户端中每个文件夹的 README 文件:每个文件都在各自的上下文中说明了其所含文件的作用。