7. Kapitel 6 - Fazit und nächste Schritte
7.1. Was gebaut wurde
Dieses Dokument hat die Kernfunktionalität und die Authentifizierung der [RdvMedecins]-Anwendung aus dem ursprünglichen Dokument von 2014 auf aktuelle Technologien übertragen:
- ein vollständiger [NestJS]-Server (diesem Dokument beigefügt, in Kapitel 2 installiert und getestet, dessen Code hier aber nicht behandelt wird), der dieselben 11 fachlichen JSON-Routen wie der ursprüngliche Spring-4-Server auf demselben Port (8080) bereitstellt, die nun alle durch ein JWT-Token geschützt sind;
- eine Authentifizierungsschicht ([@nestjs/passport] + [@nestjs/jwt]): Authentifizierung per Login/Passwort (POST /login), ein signiertes Token, das bei jeder folgenden Anfrage vorgelegt wird, und rollenbasierte Zugriffskontrolle ([@Roles]('ADMIN') + [RolesGuard]) auf den beiden Routen, die Daten ändern;
- ein [Flutter]-Client (Widgets [Material], Paket [provider]), der dieselben Funktionen wie der ursprüngliche AngularJS-1.x-Client bietet – Auswahl eines Arztes und eines Datums, Anzeige des Terminkalenders, Buchung und Stornierung eines Termins –, ergänzt um einen Anmeldebildschirm, eine persistente Sitzung ([shared_preferences]), eine auf die Rolle des angemeldeten Benutzers zugeschnittene Oberfläche (für die Rolle USER ausgeblendete Buchungsschaltflächen) und die Möglichkeit, die Oberfläche zwischen Französisch und Englisch umzuschalten ([TranslationsService], ohne Bibliothek eines Drittanbieters neu implementiert).
Der Kern der Datenbank hat sich nicht geändert (dieselben Tabellen [doctors/clients/slots/appointments], dieselben Constraints), abgesehen von der zusätzlichen Tabelle [users]; ebenso wenig die allgemeine Schichtenarchitektur – lediglich die Werkzeuge, die sie umsetzen, wurden aktualisiert.
Zwei bewusste Unterschiede zur Authentifizierung des ursprünglichen Dokuments, umgesetzt durch den mitgelieferten Server (siehe Kapitel 2): ein JWT-Token statt des bei jeder Anfrage gesendeten HTTP-Basic-Headers und eine einzige Spalte [role] pro Benutzer statt einer Many-to-Many-Beziehung über drei Tabellen. Ein dritter Unterschied – dieser funktionaler Art – wurde für diese Portierung bewusst gewählt: Die Rolle USER kann nun Terminkalender einsehen (nur lesend), während sie im Original lediglich dazu diente, eine vollständige Zugriffsverweigerung zu veranschaulichen.
7.2. Was außerhalb des Umfangs bleibt oder noch zu portieren ist
Darüber hinaus behandelte das ursprüngliche Dokument drei weitere Themen – eines davon wurde inzwischen umgesetzt, ein weiteres bewusst weggelassen und das dritte auf einen späteren Zeitpunkt verschoben:
7.2.1. Internationalisierung Französisch/Englisch – in diesem Dokument umgesetzt
Das ursprüngliche Dokument schlug vor, die Oberfläche mit der Bibliothek [angular-translate] zwischen Französisch und Englisch umzuschalten. Diese Portierung setzt die Funktion mit [TranslationsService] um (siehe Kapitel 4), der eigens für dieses Dokument geschrieben wurde, statt sie einem Plugin eines Drittanbieters zu überlassen: Die Wörterbücher fr.json/en.json, die in die Anwendung eingebettet sind (und nicht mehr von einem Webserver ausgeliefert werden), werden über [rootBundle.loadString(...)] geladen. Wie [angular-translate] und [vue-i18n] zuvor [TranslationsService] ermöglicht es, die Sprache im laufenden Betrieb ohne Neuladen der Anwendung zu wechseln – ein Verhalten, das dem des ursprünglichen Dokuments entspricht.
7.2.2. Der „Debug“-Modus des Clients – bewusst aus dem Umfang ausgeschlossen
Das ursprüngliche Dokument enthielt einen technischen Anzeigemodus, der über die Oberfläche aktiviert werden konnte und Zugriff auf das rohe Modell ($scope AngularJS 1.x) der aktuellen View gab – eine nützliche Funktion im Jahr 2014, als die verfügbaren Entwicklungswerkzeuge zur Untersuchung einer AngularJS-Anwendung noch begrenzt waren. Diese Portierung baut ihn nicht nach: Die aktuellen [Flutter]-Entwicklungswerkzeuge ([Flutter] DevTools, auf allen drei Zielen nutzbar – Mobilgeräte, Desktop, Web) bieten heute, abgesehen von der Anwendung selbst, eine viel umfassendere Untersuchung des Widget-Baums, ihres Zustands und ihrer Eigenschaften, als es ein in die Oberfläche integriertes eigenes Debugging-Panel leisten würde. Ein solches Panel hinzuzufügen, käme dem Bau einer schlechteren Version eines vom Ökosystem bereits bereitgestellten Werkzeugs gleich – diese Entscheidung ist daher endgültig und keine bloße Zurückstellung.
7.2.3. Künstliche Netzwerkverzögerung – zurückgestellt
Das ursprüngliche Dokument erlaubte es, vor jeder Serverantwort eine künstliche Verzögerung einzustellen, um das Verhalten der Oberfläche in einem langsamen Netzwerk zu beobachten (Ladeanzeigen, vorübergehende Deaktivierung von Schaltflächen usw.). Für diese Funktion gibt es in dieser Portierung noch kein Äquivalent.
7.3. Ein Hinweis zur Methodik dieses Dokuments
Dieses Dokument wurde unter systematischer Stützung auf den tatsächlich ausgeführten Code geschrieben: Jeder Serverpfad wurde getestet (einschließlich der Authentifizierungsszenarien: erfolgreiche/fehlgeschlagene Anmeldung, Zugriff ohne Token, Zugriff mit der falschen Rolle); der [Flutter]-Client (Kapitel 4) wurde dagegen Zeile für Zeile geprüft und verifiziert, aber nicht von Claude ausgeführt – die Umgebung, in der dieses Dokument entstand, hat keinen Zugriff auf einen Rechner, auf dem sich [Flutter] ausführen lässt (Mobilgerät, Desktop oder Web), anders als bei den vorherigen Web-Clients dieses Kurses, die direkt in einem automatisierten [Chromium]-Browser ausgeführt werden können. Die Screenshots des Clients in den Kapiteln 4 und 5 (Web, Windows-Desktop, Android-Emulator) hat der Autor auf seinem eigenen Rechner erstellt.
7.4. Um sofort weiterzugehen
Bis zu den nächsten Schritten dieser Portierung bieten der mitgelieferte Server und Client eine gebrauchsfertige Grundlage, auf der Sie selbst experimentieren können:
- einen neuen Arzt oder einen neuen Patienten hinzufügen (derzeit geschieht dies nur durch Änderung des SQL-Skripts – eine Route /addDoctor, die ebenfalls durch [@Roles]('ADMIN') geschützt ist, könnte eine erste Übung sein);
- eine dritte Rolle oder einen Benutzer mit mehreren Rollen hinzufügen – eine Gelegenheit, ganz konkret die Kosten des Verzichts auf die Ein-Spalten-Vereinfachung durch [role] zu ermessen (siehe Kapitel 2);
- die Darstellung des Clients (Farben, Layout) ändern, ohne den Server anzufassen – eine gute Möglichkeit zu überprüfen, dass die Schichtenarchitektur des Clients wie vorgesehen funktioniert;
- Lesen Sie die README-Datei jedes Ordners im mitgelieferten Server und Client: Jede erklärt im jeweiligen Kontext die Rolle der darin enthaltenen Dateien.