7. Kapitel 6 - Fazit und nächste Schritte
7.1. Was gebaut wurde
Dieses Dokument hat die Kernfunktionen und die Authentifizierung der Anwendung [RdvMedecins] aus dem ursprünglichen Dokument von 2014 auf aktuelle Technologien portiert:
- ein vollständiger [NestJS]-Server (Entitäten [TypeORM], DAO, Geschäftsschicht, Web-Schicht), der dieselben 11 fachlichen JSON-Routen anbietet wie der ursprüngliche Spring-4-Server, auf demselben Port (8080), 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]) für die beiden Routen, die Daten ändern;
- ein [Angular]-Client (Standalone-Komponenten, Signale), der dieselben Funktionen bietet wie der ursprüngliche AngularJS-1.x-Client – Auswahl eines Arztes und eines Datums, Anzeige des Kalenders, Buchung und Stornierung eines Termins – ergänzt um einen Anmeldebildschirm, eine persistente Sitzung (localStorage), eine Bootstrap-Oberfläche, die sich an die Rolle des angemeldeten Benutzers anpasst (Buchungs-Buttons für die Rolle USER ausgeblendet), und die Möglichkeit, die Oberfläche zwischen Französisch und Englisch umzuschalten ([@ngx-translate/core] + [@ngx-translate/http-loader]).
Der Kern der Datenbank hat sich nicht verändert (dieselben Tabellen für Ärzte/Clients/Zeitfenster/Termine, dieselben Constraints), abgesehen von der Ergänzung der Tabelle [users]; auch die allgemeine Schichtenarchitektur ist unverändert – lediglich die Werkzeuge, die sie umsetzen, wurden aktualisiert.
Zwei bewusste Unterschiede zum Authentifizierungsmechanismus 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 einzelne Spalte [role] pro Benutzer statt einer Many-to-many-Beziehung über drei Tabellen. Ein dritter Unterschied – diesmal funktionaler Art – wurde für diesen Port bewusst gewählt: Die Rolle USER kann nun Kalender 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
Über das oben Genannte hinaus behandelte das ursprüngliche Dokument zwei weitere Themen – eines davon wurde nun umgesetzt, ein weiteres bewusst weggelassen, und das dritte auf eine spätere Phase verschoben:
7.2.1. Französisch/Englisch-Lokalisierung – in diesem Dokument umgesetzt
Das ursprüngliche Dokument schlug vor, die Oberfläche mithilfe der Bibliothek angular-translate zwischen Französisch und Englisch umzuschalten. Dieser Port setzt diese Funktion mit deren Äquivalent im aktuellen [Angular]-Ökosystem um, [@ngx-translate/core] (zusammen mit [@ngx-translate/http-loader], der die Wörterbücher fr.json/en.json per HTTP aus dem Ordner public/i18n lädt) – siehe Kapitel 5. @angular/localize, die andere mögliche Lösung, wurde verworfen: Sie erfordert eine separate Kompilierung pro Sprache, während ngx-translate den Sprachwechsel im laufenden Betrieb ohne Neuladen der Seite erlaubt – ein Verhalten, das dem des ursprünglichen Dokuments näherkommt.
7.2.2. Der „Debug“-Modus des Clients – bewusst 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 Ansicht bot – eine nützliche Funktion im Jahr 2014, als die verfügbaren Entwicklungswerkzeuge zur Untersuchung einer AngularJS-Anwendung noch begrenzt waren. Dieser Port bildet ihn nicht nach: die aktuellen [Angular]-Entwicklungswerkzeuge ([Angular] DevTools, die offizielle Browsererweiterung) bieten heute außerhalb der Anwendung selbst eine deutlich umfassendere Untersuchung der Komponenten, ihrer Signale und ihrer Ein- und Ausgaben, als es ein in die Oberfläche eingebautes eigenes Debug-Panel könnte. Ein solches Panel hinzuzufügen, käme dem Nachbau einer schwächeren Version eines Werkzeugs gleich, das das Ökosystem bereits bereitstellt – diese Entscheidung ist daher endgültig und keine bloße Zurückstellung.
7.2.3. Eine künstliche Netzwerkverzögerung – zurückgestellt
Das ursprüngliche Dokument erlaubte es, vor jeder Serverantwort eine künstliche Verzögerung festzulegen, um das Verhalten der Oberfläche in einem langsamen Netzwerk zu beobachten (Ladeanzeigen, vorübergehende Deaktivierung von Buttons usw.). Diese Funktion hat in diesem Port noch kein Äquivalent.
7.3. Ein Hinweis zur Methodik dieses Dokuments
Dieses Dokument wurde verfasst, indem systematisch auf den tatsächlich ausgeführten Code zurückgegriffen wurde: Jeder Serverpfad wurde getestet (einschließlich der Authentifizierungsszenarien: erfolgreiche/fehlgeschlagene Anmeldung, Zugriff ohne Token, Zugriff mit der falschen Rolle), und jeder Screenshot des Clients (Kapitel 5) wurde durch Interaktion mit der tatsächlich laufenden Anwendung gewonnen – einem automatisch gesteuerten Chromium-Browser mit Demodaten aus dem mitgelieferten SQL-Skript. Dieses Vorgehen deckte bei der Erstellung dieses Dokuments außerdem ein spezielles Problem bei der Verwendung von [TypeORM] mit berechneten Spalten ([@RelationId]) auf, 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 weiterzumachen
Während Sie auf die nächsten Schritte dieses Ports warten, bieten der mit diesem Dokument gelieferte Server und Client eine gebrauchsfertige Grundlage, auf der Sie selbstständig experimentieren können:
- einen neuen Arzt oder einen neuen Patienten hinzufügen (derzeit ist dies nur durch Änderung des SQL-Skripts möglich – eine Route /addDoctor, ebenfalls durch [@Roles]('ADMIN') geschützt, könnte eine gute erste Übung sein);
- eine dritte Rolle oder einen Benutzer mit mehreren Rollen hinzufügen – eine Gelegenheit, die Kosten des Verzichts auf die Vereinfachung mit einer einzelnen Spalte [role] ganz konkret einzuschätzen (siehe Kapitel 3);
- die Darstellung des Clients (Farben, Layout) ändern, ohne den Server zu verändern – eine gute Möglichkeit, zu überprüfen, dass die Schichtenarchitektur des Clients wie angekündigt funktioniert;
- die README-Datei jedes Ordners des gelieferten Servers und Clients lesen: Jede erklärt in ihrem Kontext die Rolle der darin enthaltenen Dateien.