Skip to content

1. Einleitung

Das PDF des Dokuments finden Sie |HIER|.

Die Codes des Dokuments finden Sie |HIER|.

Dieses Dokument ist ein Produkt von Claude, der KI von Anthropic. Sein Ziel ist es, das Dokument „Ein Client-Server-Beispiel - AngularJS 1.x / Spring 4“ in zweierlei Hinsicht anzupassen:

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

Claude von Anthropic (KI) hat den größten 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 mich hauptsächlich eingebracht.

Hinweis 1: Wenn das Hauptziel des Lesers darin besteht, „NestJS zu lernen“, finden Sie einen Überblick über dieses Web-Framework im Dokument Einführung in die Sprache TypeScript und das Web-Framework NestJS anhand von Beispielen. In diesem Dokument wird der NestJS-Server als Blackbox behandelt. Es wird gezeigt, wie Sie ihn verwenden, sein Code wird jedoch nicht beschrieben.

Hinweis 2: Die Programmiersprache von Flutter ist Dart. Leser, die sich für die Grundlagen der Sprache Dart interessieren, können den Kurs „Einführung in die Sprache Dart anhand von Beispielen“ (2026) lesen.

Hinweis 3: Claude verweist häufig auf die Frameworks Angular, React und Vue.js. Claude hat drei Kurse zu diesen Frameworks geschrieben und kennt sie gut. Deshalb nimmt er darauf Bezug:

Hinweis 4: Wenn Ihnen die Erklärungen von Claude nicht ausreichen, wenden Sie sich an Claude und bitten Sie um Klärung eines bestimmten Punkts seines Kurses. Das hilft oft.

Serge Tahé, September 2026

==

Dieses Dokument ist die 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 Terminplanung 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 abgelöst:

  • 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] (Versionen 2, 4, 5 … bis Version 22) komplett neu geschrieben. Diesen Ansatz verfolgt die Variante [Angular] / [NestJS] dieses Kurses: Ein Client-Server-Beispiel - Angular / NestJS (2026). Dieses Dokument wählt einen anderen Weg: [Flutter] (von Google entwickelt, erste stabile Version im Dezember 2018), ein „plattformübergreifendes“ Framework: Aus einer einzigen Codebasis, die in der Sprache [Dart] geschrieben ist, erzeugt es mobile, Desktop- und Webanwendungen, deren Oberfläche nicht durch HTML-Templates, sondern durch einen Widget-Baum beschrieben wird (siehe Kapitel 3).

Ziel dieses Dokuments ist es, die ursprüngliche Fallstudie – dieselbe Anwendung, dieselben Funktionen, dieselbe Datenbank – erneut 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 schrittweiser Neuaufbau

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 verdaulich.

Dieses Dokument behandelt daher die ersten beiden Schritte des Neuaufbaus:

  • die allgemeine Architektur der Anwendung (grundsätzlich unverändert);
  • die Datenbank (unverändert, abgesehen von der zusätzlichen Tabelle [users]);
  • die Installation des vollständigen, diesem Dokument beiliegenden [NestJS]-Servers, dessen Funktionen zum Anzeigen und zum Buchen bzw. Stornieren von Terminen mit Postman getestet werden – sein Code wird hier nicht behandelt, da sich dieses Dokument auf [Flutter] konzentriert;
  • die tokenbasierte Authentifizierung (JWT) und die rollenbasierte Zugriffskontrolle (ADMIN/USER) für diesen Server, das Pendant zur Spring-Security-Schicht des ursprünglichen Dokuments – wir lernen nur, sie zu verwenden, zunächst über Postman und dann über den Client;
  • der zugehörige [Flutter]-Client mit denselben Funktionen: ein Anmeldebildschirm, eine Oberfläche, die an die Rolle des angemeldeten Benutzers angepasst ist ([Material Design]), und die Möglichkeit, die Oberfläche zwischen Französisch und Englisch umzuschalten ([TranslationsService]).

Zwei Funktionen des ursprünglichen Dokuments sind in diesem Dokument vorerst ausgeschlossen: 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 einen späteren Schritt verschoben wurde.

1.2. Für wen dieses Dokument gedacht ist

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

Einige Grundkenntnisse sind jedoch hilfreich, um dieses Dokument bestmöglich zu nutzen:

  • ein grundlegendes Verständnis der Sprache Dart (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 Befehlszeile (cd, npm install …).

Sie müssen die Sprache TypeScript (serverseitig verwendet) nicht im Voraus kennen: Sie ist eine Obermenge von JavaScript, die ein Typsystem hinzufügt, und dieses wird im gesamten Dokument überall dort erklärt, wo es verwendet wird. Dasselbe gilt für die Sprache [Dart], die clientseitig verwendet und in Kapitel 3 vorgestellt wird. Interessierte Leser können das Dokument *Einführung in die Sprache Dart anhand von Beispielen* (2026) lesen, das Dart ausführlich erklärt.

1.3. Die Architektur der Anwendung

Die Gesamtarchitektur der Anwendung hat sich seit dem ursprünglichen Dokument nicht geändert:

  • Ein Webserver stellt dem Client eine einzige Oberfläche bereit, die auf dem Komponentenmodell (View + zugehörige Logik) beruht und sich auf Services stützt, um mit dem Server zu kommunizieren – bei den Clients [Angular]/[React]/[Vue.js] dieses Kurses ein Browser, bei diesem Client [Flutter] hingegen entweder ein Browser, ein mobiles Betriebssystem oder ein Desktop-Betriebssystem (siehe Kapitel 5);
  • Der Benutzer interagiert mit den im Browser angezeigten Views. Seine Aktionen erfordern mitunter eine Anfrage an den Server [NestJS], der die Anfrage verarbeitet und eine Antwort im Format JSON (JavaScript Object Notation) zurückgibt; diese Antwort dient dazu, die dem Benutzer angezeigte View zu aktualisieren.

Die betrachtete Anwendung hat folgende Architektur:

Image

  • In [1] richtet der Benutzer der [Flutter]-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] abfragen;
  • Um den angeforderten Dienst zu erbringen, muss die Schicht [3] gegebenenfalls [4] abfragen, den entfernten JSON-Server, der von [NestJS] implementiert wird;
  • 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 View [1] spiegelt diese Antwort wider;

Hinweis: Wenn Ihnen die Architektur des Projekts unklar ist, schauen Sie sich dieses Diagramm noch einmal an. Beachten Sie, dass das DBMS vom Server verwendet wird, nicht vom Client.

1.4. Verwendete Werkzeuge

Dieses Dokument verwendet die folgenden Werkzeuge (ihre Installation wird in den Kapiteln 1 und 2 beschrieben):

  • Node.js (Version 22 oder höher) und sein Paketmanager npm – im JavaScript-Ökosystem das Pendant dessen, was Java + Maven für den ursprünglichen Spring-Server waren;
  • Visual Studio Code (VSCode), ein kostenloser Code-Editor, samt seinen TypeScript-Erweiterungen – das Pendant zu Spring Tool Suite (STS) und WebStorm im ursprünglichen Dokument;
  • das [Flutter]-SDK (das das [Dart]-SDK enthält) wird einmalig systemweit installiert – anders als [Vite], das von den früheren Web-Clients dieses Kurses verwendet wurde und keine systemweite Installation erforderte;
  • [MySQL] 8 für die Datenbank (das ursprüngliche Dokument verwendete [MySQL] 5 – das relationale Schema selbst ändert sich nicht);
  • [Android Studio] (samt seinem [Android]-SDK und seinen Befehlszeilenwerkzeugen), um die Anwendung für ein [Android]-Smartphone zu kompilieren, das mobile Ziel dieses Kurses – eine ausführliche Installationsanleitung finden Sie in Kapitel 1;
  • Postman (oder ein anderer HTTP-Client), um die Server-URLs zu testen, die auf POST-Anfragen antworten (/addAppointment, /deleteAppointment) – ein Webbrowser 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 folgende Tabelle):

  • 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: Jeder Zeitslot erscheint entweder als frei oder als gebucht;
  • Ein Benutzer mit der Rolle ADMIN kann außerdem einen freien Zeitslot 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 lediglich dazu diente, eine Zugriffsverweigerung zu veranschaulichen, und überhaupt nichts einsehen konnte (die Begründung für diese Entscheidung finden Sie in Kapitel 2, Abschnitt „Erstellen der Datenbank“).

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 (jetzt mit englischen Namen)
Server
Java, Spring 4, Spring Data (JPA/Hibernate), Spring MVC
TypeScript, [NestJS], [TypeORM], dieselben bereitgestellten URLs
Client
JavaScript, AngularJS 1.x, Bower
Dart, [Flutter] (Material-Widgets, Paket [provider]), pub
CSS style
Bootstrap 3
Keines ([Material Design] in die [Flutter]-Widgets integriert)
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 vollem Zugriff und USER mit Lesezugriff
FR/EN internationalization
Bibliothek angular-translate
[TranslationsService] (selbst entwickelt, eingebettete Wörterbücher)

1.7. Aufbau dieses Dokuments

  1. Einrichtung der Arbeitsumgebung – die Werkzeuge installieren und das [Flutter]-Projekt erstellen.
  1. Installation des Servers [NestJS] – Laragon und die Datenbank [MySQL] installieren, den Server konfigurieren, starten und testen und anschließend den Client [Flutter] zum ersten Mal ausführen.
  2. Einführung in [Flutter] – die Grundlagen des Frameworks (Widgets, StatelessWidget/StatefulWidget, provider) mit einer Wiederholung von Konzepten, die bereits in [Angular], [React] und [Vue.js] behandelt wurden.
  3. Der [Flutter]-Client für die Anwendung [RdvMedecins] – die Architektur des Clients, jede seiner Dateien (einschließlich des Anmeldebildschirms) und ein Schritt-für-Schritt-Durchgang durch die gesamte Anwendung.
  4. Portierung der [Flutter]-Anwendung auf Mobilgeräte, Desktop und Web – wie ein einziger Quellcode für diese drei Zielfamilien kompiliert wird und was Sie für jede davon wissen müssen (Netzwerk, mobilspezifische Einschränkungen).
  5. Fazit und nächste Schritte.