Skip to content

1. Einleitung

Das PDF des Dokuments finden Sie |HIER|.

Den Code des Dokuments finden Sie |HIER|.

Dieses Dokument ist ein Produkt von Claude, der KI von Anthropic. Sein Ziel ist es, das Dokument [A Client/Server Example - AngularJS 1.x / Spring 4] in zweifacher Hinsicht zu übertragen:

  • Der Client AngularJS 1.x wird durch einen Client [Vue.js] 3 ersetzt;
  • das Java-Web-Framework Spring MVC wird durch das Web-Framework NestJS ersetzt;

Claude von Anthropic (KI)hat den Großteil der Arbeit erledigt (90 %):

  • Codegenerierung: Claude hat den gesamten Code erzeugt. Ich habe ihn lediglich getestet, indem ich dem erzeugten Kurs gefolgt bin;
  • Erstellung des Kurses im ODT-Format: Claude hat auf meine Bitte hin mehrere Versionen erzeugt. Hier habe ich mich hauptsächlich eingebracht.

Hinweis 1: Wenn das Hauptziel des Lesers darin besteht, „NestJS zu lernen“, steht im Dokument [Introduction to the TypeScript Language and the NestJS Web Framework by Example] ein einfacheres Beispiel zur Verfügung. Anschließend kann der Leser zu diesem Dokument zurückkehren, um das Client-Framework Vue.js zu verstehen.

Hinweis 2: Dieses Dokument verweist häufig auf die Version [React] dieses Kurses. Gemeint ist der Kurs [A Client/Server Example - React / NestJS (2026)]. Außerdem wird die Version [Angular] dieses Kurses erwähnt: [A Client/Server Example - Angular / NestJS (2026)]

Serge Tahé, September 2026

==

Dieses Dokument ist eine Fortsetzung des Kurses „Ein Client-Server-Beispiel - AngularJS 1.x / Spring 4“, der 2014 verfasst wurde. Dieses ursprüngliche Dokument entwickelte eine kleine Anwendung zur Terminverwaltung in einer Arztpraxis („[RdvMedecins]“) mit einem Spring-4- / Spring-Data- / Spring-MVC-Server und einem AngularJS-1.x-Client.

Zwölf Jahre später haben sich die beiden verwendeten Frameworks stark weiterentwickelt – oder sind in der gängigen Praxis sogar ersetzt worden:

  • auf der Serverseite hat sich [NestJS] als eines der am häufigsten verwendeten Node.js/TypeScript-Frameworks für den Aufbau strukturierter Webanwendungen etabliert, mit einer ähnlichen Philosophie wie Spring (Module, Controller, Services, Dependency Injection), jedoch innerhalb des JavaScript/TypeScript-Ökosystems;
  • auf der Clientseite wurde AngularJS 1.x ab 2016 unter dem Namen [Angular] (2, 4, 5 … bis Version 22) komplett neu geschrieben – dieser Ansatz wird in der Variante [Angular] / [NestJS] dieses Kurses verfolgt. Dieses Dokument wählt einen anderen Weg: [Vue.js] (2014 von Evan You geschaffen, nach einem Experiment bei Google mit AngularJS), ein „progressives“ Framework: ein auf die View-Schicht konzentrierter Kern, ergänzt durch ein eigenes Komponentenformat – die .vue-Dateien (siehe Kapitel 4).

Ziel dieses Dokuments ist es, die ursprüngliche Fallstudie – dieselbe Anwendung, dieselben Funktionen, dieselbe Datenbank – noch einmal aufzugreifen und neu aufzubauen, und zwar mit aktuellen Werkzeugen, wobei die didaktische Abfolge des Dokuments von 2014 so weit wie möglich beibehalten wird.

1.1. Ein Neuaufbau Schritt für Schritt

Das ursprüngliche Dokument umfasste etwa 300 Seiten und behandelte neben den Kernfunktionen der Anwendung – der rollenbasierten Authentifizierung (Spring Security) – zwölf aufeinander aufbauende Beispiele, mit denen man AngularJS 1.x Schritt für Schritt lernte. Alle diese Inhalte auf einmal neu aufzubauen, wäre zeitaufwendig und schwer zu verdauen.

Dieses Dokument behandelt daher die ersten beiden Schritte des Neuaufbaus:

  • die allgemeine Architektur der Anwendung (im Prinzip unverändert);
  • die Datenbank (unverändert, abgesehen von der zusätzlichen Tabelle [users]);
  • der vollständige [NestJS]-Server mit allen Funktionen zum Anzeigen sowie zum Buchen und Stornieren von Terminen;
  • die tokenbasierte Authentifizierung (JWT) und die rollenbasierte Zugriffskontrolle (ADMIN/USER), das Äquivalent zur Spring-Security-Schicht des ursprünglichen Dokuments;
  • der zugehörige [Vue.js]-Client mit denselben Funktionen, einem Anmeldebildschirm, einer Bootstrap-Oberfläche, die auf die Rolle des angemeldeten Benutzers zugeschnitten ist, und der Möglichkeit, die Oberfläche zwischen Französisch und Englisch umzuschalten ([vue-i18n]).

Zwei Funktionen des ursprünglichen Dokuments sind in dieser Phase nicht Bestandteil dieses Dokuments: der „Debug“-Modus des ursprünglichen Clients (Anzeige des rohen Templates der aktuellen View), der in dieser Portierung bewusst weggelassen wurde (die Begründung für diese Entscheidung finden Sie in Kapitel 6), sowie die Konfiguration einer künstlichen Netzwerkverzögerung, die auf eine spätere Phase verschoben wurde.

1.2. An wen sich dieses Dokument richtet

Dieses Dokument setzt keine Vorkenntnisse in [NestJS] oder [Vue.js] voraus. Jedes neue Konzept (Dekorator, Dependency Injection, Komponente, Signal usw.) wird beim ersten Auftreten möglichst ausführlich erklärt – auch für Leser, die noch nie eine einzige Zeile TypeScript geschrieben haben.

Einige Grundkenntnisse sind jedoch hilfreich, um dieses Dokument optimal zu nutzen:

  • ein grundlegendes Verständnis der Sprache JavaScript (Variablen, Funktionen, Arrays, Objekte);
  • ein grundlegendes Verständnis des HTTP-Datenaustauschs in einer Webanwendung (GET-/POST-Methoden, JSON-Format);
  • gängige Tags der Sprache HTML;
  • die Arbeit mit der Befehlszeile (cd, npm install …).

Sie müssen die Sprache TypeScript (die sowohl auf der Server- als auch auf der Clientseite verwendet wird) nicht vorab kennen: Sie ist eine Obermenge von JavaScript, die ein Typsystem hinzufügt, und dieses wird im gesamten Dokument bei jeder Verwendung erläutert. Interessierte Leser können das Dokument [Introduction to the TypeScript Language and the NestJS Framework (2026)] lesen, das TypeScript ausführlich erklärt.

1.3. Die Architektur der Anwendung

Die allgemeine Architektur der Anwendung hat sich gegenüber dem ursprünglichen Dokument nicht geändert:

  • ein Webserver liefert eine einzelne HTML/CSS/JS-Seite aus, die eine [Vue.js]-Anwendung enthält, die auf dem Komponentenmodell (View + zugehörige Logik) aufbaut und Services nutzt, um mit dem Server zu kommunizieren;
  • der Benutzer interagiert mit den im Browser angezeigten Views. Die Aktionen des Benutzers erfordern mitunter eine Anfrage an den [NestJS]-Server, der die Anfrage verarbeitet und eine JSON-Antwort (JavaScript Object Notation) zurückgibt; diese Antwort dient dazu, die dem Benutzer angezeigte View zu aktualisieren.

Die betrachtete Anwendung hat die folgende Architektur:

Image

  • In [1] ruft der Benutzer der [Vue.js]-Anwendung die Schichten [presentation] und [2] dieser Anwendung auf;
  • um die vom Benutzer angeforderte Aktion auszuführen, können die Schichten [presentation] und [2] die Schichten [Services] und [3] aufrufen;
  • um den angeforderten Dienst zu erbringen, muss die Schicht [3] gegebenenfalls den entfernten JSON-Server abfragen – implementiert durch [NestJS] – und zwar über [4];
  • Je nach der in [5] empfangenen Anfrage werden gegebenenfalls die Schichten [6-8] aufgerufen;
  • die Antwort des Servers durchläuft die Schichten [2-8] in umgekehrter Reihenfolge;
  • Die dem Benutzer angezeigte View [1] spiegelt diese Antwort wider;

Hinweis: Wenn Sie die Projektarchitektur verwirrt, schauen Sie sich dieses Schema noch einmal an. Beachten Sie, dass das DBMS vom Server und nicht vom Client angesprochen wird.

1.4. Verwendete Werkzeuge

Dieses Dokument verwendet die folgenden Werkzeuge (ihre Installation wird in Kapitel 2 ausführlich beschrieben):

  • Node.js (Version 22 oder höher) und sein Paketmanager npm – im JavaScript-Ökosystem das Äquivalent zu dem, was Java + Maven für den ursprünglichen Spring-Server waren;
  • Visual Studio Code, ein kostenloser Code-Editor mit seinen TypeScript-Erweiterungen – das Äquivalent zu Spring Tool Suite (STS) und WebStorm, die im ursprünglichen Dokument verwendet wurden;
  • [NestJS] CLI ([@nestjs/cli]), ein Befehlszeilenwerkzeug, das die Projektstruktur des Servers erzeugt und dessen Entwicklungsserver startet; auf der Clientseite [Vite] erfordert keine globale Installation – es lässt sich direkt über npm im diesem Dokument beiliegenden Projekt verwenden;
  • [MySQL] 8 für die Datenbank (das ursprüngliche Dokument verwendete [MySQL] 5 – das relationale Schema selbst bleibt unverändert);
  • Postman (oder ein anderer HTTP-Client), um die URLs des Servers zu testen, die auf POST-Anfragen antworten (/addAppointment, /deleteAppointment) – ein Browser kann nur GET-Anfragen testen.

1.5. Funktionen der Anwendung

Die „fachlichen“ Funktionen der Anwendung [RdvMedecins] bleiben gegenüber dem ursprünglichen Dokument unverändert; die Zugriffskontrolle ist jedoch etwas robuster als im Original (siehe die Tabelle unten):

  • Eine Arztpraxis beschäftigt mehrere Ärzte, jeder mit eigenen Sprechzeiten;
  • ein Benutzer muss sich anmelden (Benutzername/Passwort), um auf die Anwendung zuzugreifen;
  • Nach der Anmeldung kann der Benutzer einen Arzt und einen Tag auswählen und den Terminkalender des Arztes für diesen Tag einsehen: Jedes Zeitfenster wird entweder als frei oder als gebucht angezeigt;
  • ein Benutzer mit der Rolle ADMIN kann zusätzlich ein freies Zeitfenster für einen Patienten seiner Wahl buchen und einen bestehenden Termin stornieren;
  • Ein Benutzer mit der Rolle USER kann die Terminkalender einsehen, aber weder buchen noch stornieren (Lesezugriff) – ein bewusster Unterschied zum ursprünglichen Dokument, in dem die Rolle USER nur dazu diente, eine Zugriffsverweigerung zu veranschaulichen, und überhaupt nichts anzeigen konnte (die Begründung für diese Entscheidung finden Sie in Kapitel 3, Abschnitt „Authentifizierung“).

Image

1.6. Was sich geändert hat und was nicht


Ursprüngliches Dokument (2014)
Dieses Dokument (2026)
Database
[MySQL] 5, Tabellen MEDECINS/CLIENTS/CRENEAUX/RV
[MySQL] 8, dieselben Tabellen, dieselben Spalten, dieselben Constraints (mit englischen Namen)
Server
Java, Spring 4, Spring Data (JPA/Hibernate), Spring MVC
TypeScript, [NestJS], [TypeORM], dieselben URLs (mit englischen Namen)
Client
JavaScript, AngularJS, 1.x, bower
TypeScript, [Vue.js] 3 (Composition API, Setup-Skript), npm
CSS style
Bootstrap 3
Bootstrap 5
Authentication
Spring Security, HTTP Basic, Rollen in 3 Tabellen; nur ADMIN nutzt die Anwendung
Passport/JWT ([@nestjs/passport], [@nestjs/jwt]), ein signiertes Token, das bei jeder Anfrage mitgesendet wird, Rollen in einer einzigen Spalte, ADMIN mit Vollzugriff und USER mit Lesezugriff
FR/EN internationalization
Bibliothek angular-translate
[vue-i18n]

1.7. Aufbau dieses Dokuments

  1. Einrichtung der Entwicklungsumgebung – Installation der Werkzeuge, Erstellung der Datenbank sowie erster Start von Server und Client.
  1. Einführung in [NestJS] – die Grundlagen des Frameworks (Module, Controller, Provider) mit einem Miniprojekt zum Einstieg.
  2. Der [NestJS]-Server für die Anwendung [RdvMedecins] – die Datenbank, die [TypeORM]-Entitäten, die DAO-Schicht, die Geschäftsschicht, die Web-Schicht sowie die JWT-Token-Authentifizierung und die Rollen.
  3. Einführung in [Vue.js] – die Grundlagen des Frameworks (Single-File-Komponenten, ref/reactive, Composables, provide/inject) mit einer Wiederholung von Konzepten, die bereits in [Angular] behandelt wurden.
  4. Der [Vue.js]-Client für die Anwendung [RdvMedecins] – die Architektur des Clients, jede seiner Komponenten (einschließlich des Anmeldebildschirms), die Bootstrap-Oberfläche, das Umschalten der Oberfläche zwischen Französisch und Englisch sowie ein Schritt-für-Schritt-Durchgang durch die vollständige Anwendung.
  5. Fazit und nächste Schritte.