7. Kapitel 6 – Fazit und nächste Schritte
7.1. Was gebaut wurde
Dieses Dokument hat den funktionalen Kern und die Authentifizierung der Anwendung [RdvMedecins] aus dem ursprünglichen Dokument von 2014 an aktuelle Technologien angepasst:
- ein vollständiger [NestJS]-Server ([TypeORM]-Entitäten, DAO, Geschäftsschicht, Web-Schicht), der dieselben 11 Geschäftsrouten (JSON) wie der ursprüngliche Spring-4-Server auf demselben Port (8080) bereitstellt, nun alle durch ein Token (JWT) geschützt;
- eine Authentifizierungsschicht ([@nestjs/passport] + [@nestjs/jwt]): Authentifizierung per Login und 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 [React]-Client (funktionale Komponenten, Hooks), der dieselben Funktionen wie der ursprüngliche AngularJS-1.x-Client bietet – Auswahl eines Arztes und eines Datums, Anzeige des Terminkalenders, Buchen und Stornieren eines Termins – ergänzt um einen Anmeldebildschirm, eine persistente Sitzung (localStorage), eine Bootstrap-Oberfläche, die sich an die Rolle des angemeldeten Benutzers anpasst (Buchungsschaltflächen für eine bestimmte Rolle ausgeblendet), und die Möglichkeit, die Oberfläche zwischen Französisch und Englisch umzuschalten ([i18next] + [react-i18next]).
Der Kern der Datenbank hat sich nicht verändert (dieselben Tabellen [doctors/clients/slots/appointments], dieselben Constraints), abgesehen von der Ergänzung der Tabelle [users]; ebenso wenig die allgemeine Schichtenarchitektur – nur die Werkzeuge, die sie umsetzen, wurden aktualisiert.
Es gibt zwei bewusste Unterschiede zur Authentifizierungsmethode des ursprünglichen Dokuments, die in Kapitel 3 ausführlich dokumentiert sind: 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 darf nun Terminkalender einsehen (schreibgeschützt), während sie im Original nur dazu diente, eine vollständige Zugriffsverweigerung zu veranschaulichen.
7.2. Was außerhalb des Umfangs bleibt oder noch zu portieren ist
Über das Obige hinaus behandelte das ursprüngliche Dokument drei weitere Themen – eines davon wurde nun umgesetzt, ein weiteres bewusst ausgelassen und das dritte auf eine spätere Phase verschoben:
7.2.1. Lokalisierung Französisch/Englisch – in diesem Dokument umgesetzt
Das ursprüngliche Dokument schlug vor, die Oberfläche mithilfe der Bibliothek [angular-translate] zwischen Französisch und Englisch umzuschalten. Diese Portierung setzt die Funktion mit ihrem Gegenstück im aktuellen [React]-Ökosystem um, [i18next] (zusammen mit [react-i18next], das die Wörterbücher fr.json/en.json per HTTP aus dem Ordner [public/i18n/] lädt) – siehe Kapitel 5. Wie [angular-translate] zuvor [i18next] erlaubt es, die Sprache im laufenden Betrieb zu wechseln, ohne die Seite neu zu laden – 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 in AngularJS 1.x) der aktuellen View bot – eine nützliche Funktion im Jahr 2014, als die verfügbaren Entwicklungswerkzeuge zur Untersuchung einer AngularJS-Anwendung noch begrenzt waren. Diese Portierung bildet ihn nicht nach: aktuelle [React] Entwicklungswerkzeuge ([React] DevTools, die offizielle Browsererweiterung) bieten heute außerhalb der Anwendung selbst eine weitaus umfassendere Untersuchung der Komponenten, ihres Zustands (Hooks) und ihrer Props, als es ein in die Oberfläche reintegriertes benutzerdefiniertes Debug-Panel könnte. Ein solches Panel hinzuzufügen, käme der Erstellung einer schlechteren Version eines Werkzeugs gleich, das das Ökosystem bereits bereitstellt – diese Entscheidung ist daher endgültig und keine bloße Verschiebung.
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.). Diese Funktion hat in dieser Portierung noch keine Entsprechung.
7.3. Ein Hinweis zur Methodik dieses Dokuments
Dieses Dokument wurde vollständig auf Grundlage des tatsächlich ausgeführten Codes geschrieben: Jeder Server-Pfad wurde getestet (einschließlich Authentifizierungsszenarien: erfolgreiche/fehlgeschlagene Anmeldung, Zugriff ohne Token, Zugriff mit der falschen Rolle), und jeder Client-Screenshot (Kapitel 5) wurde durch Interaktion mit der tatsächlich laufenden Anwendung erstellt – einem automatisch gesteuerten Chromium-Browser mit Demodaten aus dem mitgelieferten SQL-Skript. Dieses Vorgehen brachte bei der Vorbereitung dieses Dokuments außerdem ein konkretes Problem bei der Verwendung von [TypeORM] mit berechneten Spalten ([@RelationId]) zutage – das in Kapitel 3 direkt im ausgelieferten Code gemeldet und behoben wurde. Diese Anforderung erklärt auch, warum in diesem Dokument keine Postman-Screenshots enthalten sind: Statt sie zu simulieren, schien es besser, diesen Schritt dem Autor des Dokuments zu überlassen, der sie direkt von seinem eigenen Arbeitsplatz aus erstellen kann.
7.4. Um sofort loszulegen
Bis zu den nächsten Schritten dieser Portierung bieten der mit diesem Dokument gelieferte Server und Client eine sofort nutzbare Grundlage, auf der Sie selbst experimentieren können:
- einen neuen Arzt oder einen neuen Patienten hinzufügen (derzeit ist das nur durch Ändern des SQL-Skripts möglich – eine Route namens /addDoctor, die ebenfalls durch [@Roles]('ADMIN') geschützt ist, könnte eine gute erste Übung sein);
- eine dritte Rolle oder einen Benutzer mit mehreren Rollen hinzufügen – eine Gelegenheit, ganz konkret die Kosten des Verzichts auf die Vereinfachung mit nur einer Spalte [role] einzuschätzen (siehe Kapitel 3);
- die Darstellung des Clients (Farben, Layout) ändern, ohne den Server zu ändern – eine gute Möglichkeit zu überprüfen, dass die Schichtenarchitektur des Clients wie vorgesehen funktioniert;
- Lesen Sie die README-Datei jedes Ordners im gelieferten Server und Client: Jede erklärt in ihrem Kontext die Rolle der darin enthaltenen Dateien.