Skip to content

1. Einführung

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. Es soll das Dokument [A Client/Server Example - AngularJS 1.x / Spring 4] in zweierlei Hinsicht übertragen:

  • der Client AngularJS 1.x wird durch einen Client [React] 19 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 generiert. Ich habe ihn lediglich getestet, indem ich dem generierten Kurs gefolgt bin;
  • Generierung des Kurses im ODT-Format: Claude hat auf meine Bitte hin mehrere Versionen erstellt. Hier habe ich vor allem mitgewirkt.

Hinweis 1: Wenn Ihr Hauptziel ist, „NestJS zu lernen“, finden Sie im Dokument [Introduction to the TypeScript Language and the NestJS Web Framework by Example] ein einfacheres Beispiel. Anschließend können Sie zu diesem Dokument zurückkehren, um die React-Client-Bibliothek zu verstehen.

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

Serge Tahé, September 2026

==

Dieses Dokument ist die Fortsetzung des Kurses „Ein Client-Server-Beispiel - AngularJS 1.x / Spring 4,“ aus dem Jahr 2014. Dieses ursprüngliche Dokument entwickelte eine kleine Anwendung zur Terminvergabe 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 erheblich weiterentwickelt – oder wurden im allgemeinen Gebrauch sogar ersetzt:

  • auf der Serverseite hat sich [NestJS] als eines der am weitesten verbreiteten Node.js/TypeScript-Frameworks für den Bau 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] vollständig neu geschrieben (Versionen 2, 4, 5 … bis Version 22) – diesen Weg beschreitet die Variante [Angular] / [NestJS] dieses Kurses. Das vorliegende Dokument geht einen anderen, radikaleren Weg: [React] (von Meta 2013 geschaffen), eine Bibliothek für Benutzeroberflächen statt eines vollständigen Frameworks, in der jede Komponente eine einfache JavaScript/TypeScript-Funktion ist (siehe Kapitel 4).

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

1.1. Ein schrittweiser Wiederaufbau

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, um AngularJS 1.x Schritt für Schritt zu erlernen. Diesen gesamten Inhalt auf einmal neu aufzubauen, wäre sowohl zeitaufwendig als auch schwer zu verdauen.

Dieses Dokument behandelt daher die ersten beiden Schritte des Wiederaufbaus:

  • 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;
  • tokenbasierte Authentifizierung (JWT) und rollenbasierte Zugriffskontrolle (ADMIN/USER), entsprechend der Spring-Security-Schicht des ursprünglichen Dokuments;
  • der entsprechende [React]-Client mit denselben Funktionen, einem Anmeldebildschirm, einer auf die Rolle des angemeldeten Benutzers zugeschnittenen Bootstrap-Oberfläche und der Möglichkeit, die Oberfläche zwischen Französisch und Englisch umzuschalten ([i18next]/[react-i18next]).

Zwei Funktionen des ursprünglichen Dokuments sind in diesem Dokument zum jetzigen Zeitpunkt nicht enthalten: der „Debug“-Modus des ursprünglichen Clients (Anzeige des Roh-Templates der aktuellen Ansicht), der in dieser Portierung bewusst ausgelassen wurde (die Begründung dafür finden Sie in Kapitel 6), sowie die Konfiguration einer künstlichen Netzwerkverzögerung, die auf einen späteren Schritt verschoben wurde.

1.2. Für wen dieses Dokument gedacht ist

Dieses Dokument setzt keine Vorkenntnisse in [NestJS] oder [React] voraus. Jedes neue Konzept (Dekorator, Dependency Injection, Komponente, Hook usw.) wird bei seinem Auftreten so ausführlich wie möglich 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 der HTTP-Interaktionen in einer Webanwendung (GET-/POST-Methoden, JSON-Format);
  • gängige Tags der Sprache HTML;
  • die Verwendung der Kommandozeile (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; dieses wird im gesamten Dokument überall dort erklärt, wo es verwendet wird. Interessierte Leser finden im Dokument [Introduction to the TypeScript Language and the NestJS Framework (2026)] eine ausführliche Erklärung von TypeScript.

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 einzige HTML-/CSS-/JS-Seite aus, die eine [React]-Anwendung enthält, die auf dem Komponentenmodell (Ansicht + zugehörige Logik) beruht und zur Kommunikation mit dem Server Services nutzt;
  • der Benutzer interagiert mit den im Browser angezeigten Ansichten. Seine Aktionen erfordern mitunter eine Anfrage an den Server [NestJS], der die Anfrage verarbeitet und eine JSON-Antwort (JavaScript Object Notation) zurückgibt; mit dieser Antwort wird die dem Benutzer präsentierte Ansicht aktualisiert.

Die betrachtete Anwendung hat die folgende Architektur:

Image

  • In [1] richtet der Benutzer der [React]-Anwendung Anfragen an die Schicht [presentation] [2] dieser Anwendung;
  • um die vom Benutzer angeforderte Aktion auszuführen, kann die Schicht [presentation] [2] die Schicht [Services] [3] ansprechen;
  • Um den angeforderten Dienst bereitzustellen, muss die Schicht [3] möglicherweise [4] abfragen, den entfernten JSON-Server, der mit [NestJS] implementiert ist;
  • Je nach der in [5] empfangenen Anfrage können die Schichten [6-8] abgefragt werden;
  • die Antwort des Servers durchläuft die Schichten [2-8] in umgekehrter Reihenfolge;
  • die dem Benutzer angezeigte Ansicht [1] spiegelt diese Antwort wider;

Hinweis: Wenn Sie die Architektur des Projekts verwirrt, schauen Sie sich dieses Diagramm erneut 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 1 beschrieben):

  • Node.js (Version 22 oder höher) und sein Paketmanager npm – das Äquivalent im JavaScript-Ökosystem 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 Kommandozeilenwerkzeug, das die Projektstruktur des Servers generiert und dessen Entwicklungsserver startet; auf der Clientseite benötigt [Vite] keine globale Installation – es kann direkt über npm im diesem Dokument beiliegenden Projekt verwendet werden;
  • [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 unverändert gegenüber dem ursprünglichen Dokument; die Zugriffskontrolle ist jedoch etwas robuster als im Original (siehe die Tabelle unten):

  • Eine Arztpraxis beschäftigt mehrere Ärzte, jeder mit eigenen Sprechzeitfenstern;
  • 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 außerdem 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 (nur Lesezugriff) – ein bewusster Unterschied zum ursprünglichen Dokument, in dem die Rolle USER lediglich 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 (mit englischen Namen), dieselben Einschränkungen
Server
Java, Spring 4, Spring Data (JPA/Hibernate), Spring MVC
TypeScript, [NestJS], [TypeORM], dieselben Routen (mit englischen Namen)
Client
JavaScript, AngularJS 1.x, Bower
TypeScript, [React] 19 (Funktionskomponenten, Hooks), 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 mit jeder Anfrage übermittelt wird, Rollen in einer einzigen Spalte, ADMIN mit vollem Zugriff und USER nur lesend
FR/EN internationalization
angular-translate-Bibliothek
[i18next] + [react-i18next]

1.7. Aufbau dieses Dokuments

  1. Einrichtung der Entwicklungsumgebung – Installation der Werkzeuge, Erstellung der Datenbank und 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 tokenbasierte Authentifizierung (JWT) und Rollen.
  3. Einführung in [React] – die Grundlagen der Bibliothek (Funktionskomponenten, JSX, Hooks, Context) mit einer Wiederholung von Konzepten, die auf der [Angular]-Seite bereits behandelt wurden.
  4. Der [React]-Client für die Anwendung [RdvMedecins] – die Client-Architektur, jede ihrer Komponenten (einschließlich des Anmeldebildschirms), die Bootstrap-Oberfläche, das Umschalten der Oberfläche zwischen Französisch und Englisch und ein Schritt-für-Schritt-Rundgang durch die vollständige Anwendung.
  5. Fazit und nächste Schritte.