Skip to content

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 fachlichen Routen (JSON) wie der ursprüngliche Spring-4-Server auf demselben Port (8080) bereitstellt, nun alle durch einen Token (JWT) geschützt;
  • eine Authentifizierungsschicht ([@nestjs/passport] + [@nestjs/jwt]): Authentifizierung per Login/Passwort (POST /login), ein signierter Token, der bei jeder weiteren Anfrage vorgelegt wird, und rollenbasierte Zugriffskontrolle ([@Roles]('ADMIN') + [RolesGuard]) auf den beiden Routen, die Daten ändern;
  • ein [Vue.js] -Client (Composition API, Setup-Skript), der dieselbe Funktionalität 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 (Buchungs-Buttons für die Rolle USER ausgeblendet), und die Möglichkeit, die Oberfläche zwischen Französisch und Englisch umzuschalten ([vue-i18n]).

Der Kern der Datenbank hat sich nicht geändert (dieselben Tabellen [doctors/clients/slots/appointments], dieselben Constraints), abgesehen von der Ergänzung der Tabelle [users]; ebenso wenig hat sich die allgemeine Schichtenarchitektur geändert – nur die Werkzeuge, die sie umsetzen, wurden aktualisiert.

Es gibt zwei bewusste Unterschiede zur Authentifizierung im ursprünglichen Dokument, die in Kapitel 3 ausführlich dokumentiert sind: einen JWT-Token statt des bei jeder Anfrage gesendeten HTTP-Basic-Headers und eine einzige [role]-Spalte 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

Über das Obige hinaus behandelte das ursprüngliche Dokument zwei weitere Themen – von denen eines nun behandelt wurde, ein anderes bewusst ausgelassen und das dritte auf eine spätere Etappe verschoben wurde:

7.2.1. Internationalisierung Französisch/Englisch – in diesem Dokument behandelt

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 Äquivalent im aktuellen [Vue.js]-Ökosystem um, [vue-i18n] (dessen Wörterbücher fr.json/en.json per HTTP aus dem Ordner [public/i18n/] über eine kleine, für diese Portierung geschriebene Ladefunktion geladen werden, da es kein offizielles HTTP-Plugin gibt, das dem auf der React-Seite verwendeten entspricht) – siehe Kapitel 5. Wie [angular-translate] zuvor [vue-i18n] erlaubt es, die Sprache im laufenden Betrieb umzuschalten, 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 zum Untersuchen einer AngularJS-Anwendung verfügbaren Entwicklungswerkzeuge noch begrenzt waren. Diese Portierung bildet sie nicht nach: die aktuellen [Vue.js]-Entwicklungswerkzeuge ([Vue.js] DevTools, die offizielle Browsererweiterung) bieten heute außerhalb der Anwendung selbst eine wesentlich umfassendere Inspektion von Komponenten, ihrem Zustand und ihren Props, als es ein in die Oberfläche zurückintegriertes eigenes 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 nicht bloß eine 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 Buttons usw.). Für diese Funktion gibt es in dieser Portierung noch kein Äquivalent.

7.3. Eine Anmerkung zur in diesem Dokument verwendeten Methodik

Dieses Dokument wurde vollständig auf Grundlage des tatsächlich ausgeführten Codes geschrieben: Jeder Serverpfad wurde getestet (einschließlich der 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 hat bei der Erstellung dieses Dokuments außerdem ein spezifisches Problem bei der Verwendung von [TypeORM] mit berechneten Spalten ([@RelationId]) aufgedeckt – das gemeldet und in Kapitel 3 direkt im mitgelieferten Code korrigiert wurde. Diese Anforderung erklärt auch, warum die Postman-Screenshots nicht simuliert wurden: Dieser Schritt blieb dem Autor des Dokuments überlassen, der sie direkt an seinem eigenen Arbeitsplatz erstellt hat (siehe Kapitel 1).

7.4. Um direkt weiterzumachen

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 Änderung des SQL-Skripts möglich – eine Route namens /addDoctor, ebenfalls geschützt durch [@Roles]('ADMIN'), könnte eine gute erste Übung sein);
  • eine dritte Rolle oder einen Benutzer mit mehreren Rollen hinzufügen – eine Gelegenheit, die Kosten für den Verzicht auf die Vereinfachung durch die einzelne Spalte [role] (siehe Kapitel 3) ganz konkret zu bewerten;
  • die Darstellung des Clients (Farben, Layout) ändern, ohne den Server anzufassen – eine gute Möglichkeit zu überprüfen, ob die Schichtenarchitektur des Clients wie versprochen funktioniert;
  • Lesen Sie die README-Datei jedes Ordners im mitgelieferten Server und Client: Jede erklärt in ihrem Kontext die Rolle der darin enthaltenen Dateien.