1. Einführung
Das PDF des Dokuments finden Sie |HIER|.
Den Code dieses Dokuments finden Sie |HIER|.
Dieses Dokument ist ein Produkt der KI Claude von Anthropic. Sein Zweck ist es, das Dokument „Ein Client-Server-Beispiel - AngularJS 1.x / Spring 4“ in zweierlei Hinsicht anzupassen:
- Der Client AngularJS 1.x wird durch eine native Android-Anwendung ersetzt, die in [Kotlin] unter Verwendung von [Jetpack Compose] geschrieben ist;
- Das Java-Web-Framework Spring MVC wird durch das Web-Framework [NestJS] ersetzt;
Dazu folgt es Kapitel für Kapitel dem Dokument „Ein Client-Server-Beispiel - Flutter / NestJS (2026)“: gleicher Server, gleiche Datenbank, gleiche Client-Architektur – nur das Client-Framework ändert sich, Flutter (Dart) wird durch Jetpack Compose (Kotlin) ersetzt.
Claude von Anthropic (KI) hat den Großteil der Arbeit übernommen:
- Codegenerierung: Claude hat den gesamten Kotlin-Client-Code erzeugt. Er hat ihn selbst kompiliert und mit Erlaubnis des Prüfers in einem Android-Emulator auf dessen Rechner getestet; die Emulator-Screenshots wurden bei diesen Tests aufgenommen;
- Erstellung des Kurses im ODT-Format: Claude hat das Dokument erzeugt, das der Prüfer Korrektur gelesen und durch Nachvollziehen getestet hat.
Hinweis 1: Wenn das Hauptziel des Lesers darin besteht, „NestJS zu lernen“, finden Sie eine Einführung in 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 er zu verwenden ist, sein Code wird jedoch nicht beschrieben.
Hinweis 2: Die in diesem Dokument verwendete Programmiersprache ist [Kotlin]. Ihre Grundlagen (Klassen, Data Classes, Nullability, Lambdas, Erweiterungsfunktionen, Collections usw.) werden als bekannt vorausgesetzt: Sie werden im Kotlin-Kurs behandelt. Konzepte, die speziell Android oder Jetpack Compose betreffen, sowie Coroutinen werden im Verlauf des Dokuments erklärt.
Hinweis 3: Claude verweist häufig auf den [Flutter]-Client aus dem Kurs „Ein Client-Server-Beispiel - Flutter / NestJS“ (2026), dessen Portierung dieses Dokument ist, und gelegentlich auf die Web-Clients Angular, React und Vue.js für dieselbe Anwendung. Diese Vergleiche helfen Lesern, die mit einem dieser Frameworks vertraut sind; Kenntnisse in einem davon sind jedoch nicht erforderlich, um diesem Dokument zu folgen.
Hinweis 4: Wenn Ihnen die Erklärungen von Claude nicht ausreichen, richten Sie eine Anfrage an Claude und bitten Sie um Klärung eines bestimmten Punkts seines Kurses. Das ist oft hilfreich.
Serge Tahé, Oktober 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 Verwaltung von Arztterminen („[RdvMedecins]“) mit einem Server auf Basis von Spring 4 / Spring Data / Spring MVC und einem Client auf Basis von AngularJS 1.x.
Zwölf Jahre später haben sich die beiden verwendeten Frameworks erheblich weiterentwickelt – oder werden in der Praxis sogar nicht mehr verwendet:
- Auf der Serverseite hat sich [NestJS] als eines der am weitesten verbreiteten Node.js/TypeScript-Frameworks für strukturierte Webanwendungen etabliert, mit einer ähnlichen Philosophie wie Spring (Module, Controller, Services, Dependency Injection);
- Auf der Clientseite wird zunehmend vom Smartphone aus auf Anwendungen zugegriffen. Dieses Dokument beschreibt daher eine NATIVE Android-App: geschrieben in [Kotlin], der von Google seit 2019 für Android empfohlenen Sprache, mit einer Oberfläche, die mit [Jetpack Compose] beschrieben wird, der deklarativen UI-Bibliothek von Android (stabil seit 2021), die das alte, in XML beschriebene View-System ablöst.
Ziel dieses Dokuments ist es, die ursprüngliche Fallstudie – dieselbe App, dieselben Funktionen, dieselbe Datenbank – noch einmal aufzugreifen und mit aktuellen Werkzeugen neu aufzubauen, wobei die didaktische Progression des Dokuments von 2014 und seiner Flutter-Variante von 2026 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 der Kernfunktionalität der Anwendung – rollenbasierte Authentifizierung (Spring Security) – zwölf aufeinander aufbauende Beispiele, um AngularJS 1.x Schritt für Schritt zu erlernen. Wie die Flutter-Variante behandelt dieses Dokument:
- die allgemeine Architektur der Anwendung (im Prinzip unverändert);
- die Datenbank (unverändert, bis auf die zusätzliche Tabelle [users]);
- die Installation des vollständigen [NestJS]-Servers, dessen Funktionen zur Anzeige sowie zur Buchung und Stornierung von Terminen mit Postman getestet werden – sein Code wird hier nicht behandelt;
- die tokenbasierte Authentifizierung (JWT) und die rollenbasierte Zugriffskontrolle (ADMIN/USER) für diesen Server – wir lernen lediglich, sie zu verwenden, zuerst über Postman und dann über den Client;
- den entsprechenden Android-Client mit denselben Funktionen, einem Anmeldebildschirm, einer an die Rolle des angemeldeten Benutzers angepassten Oberfläche (Material Design 3) und der Möglichkeit, die Oberfläche zwischen Französisch und Englisch umzuschalten ([TranslationsService]).
Zwei Funktionen des ursprünglichen Dokuments entfallen in diesem Dokument, wie in der Flutter-Version: der „Debug“-Modus des ursprünglichen Clients, auf den bewusst verzichtet wurde (siehe Kapitel 6), und die Konfiguration einer künstlichen Netzwerkverzögerung, die auf einen späteren Zeitpunkt verschoben wurde.
1.2. Für wen dieses Dokument gedacht ist
Dieses Dokument setzt keine Vorkenntnisse in Android, Jetpack Compose oder [NestJS] voraus. Jedes neue Konzept (Activity, @Composable-Funktion, Zustand, ViewModel, Coroutine, HTTP-Interceptor usw.) wird erklärt, sobald es auftritt. Einige Grundkenntnisse sind dennoch hilfreich:
- Grundkenntnisse der Sprache Kotlin (siehe den Kotlin-Kurs);
- Grundkenntnisse über HTTP-Austausch (Methoden GET/POST, JSON-Format);
- Erfahrung im Umgang mit der Befehlszeile (cd, npm install ...).
Kenntnisse in Flutter sind nicht erforderlich: Die zahlreichen Vergleiche mit dem Flutter-Client richten sich an Leser, die diesen Kurs absolviert haben, aber jedes Konzept wird zunächst für sich erklärt.
1.3. Die Architektur der Anwendung
Die Gesamtarchitektur der Anwendung hat sich gegenüber dem ursprünglichen Dokument nicht geändert:
- Der Client bietet dem Benutzer eine einzige Oberfläche, die auf dem Komponentenmodell (View + zugehörige Logik) aufbaut und über Services mit dem Server kommuniziert – hier eine Android-App, die auf dem System des Smartphones läuft;
- Der Benutzer interagiert mit den Bildschirmen der Anwendung. Die Aktionen des Benutzers erfordern mitunter das Senden einer Anfrage an den Server [NestJS], der die Anfrage verarbeitet und eine JSON-Antwort zurückgibt; diese Antwort wird verwendet, um den dem Benutzer angezeigten Bildschirm zu aktualisieren.
Die untersuchte Anwendung hat die folgende Architektur:

- In [1] befragt der Benutzer der Android-Anwendung die Schicht [Presentation] [2] der Anwendung;
- Um die vom Benutzer angeforderte Aktion auszuführen, kann die Schicht [Presentation] [2] die Schicht [Services] [3] befragen;
- Um den angeforderten Dienst zu erbringen, kann die Schicht [3] den entfernten JSON-Server [4] befragen müssen, der von [NestJS] implementiert wird;
- Je nach der in [5] empfangenen Anfrage können die Schichten [6-8] befragt werden;
- Die Antwort des Servers durchläuft die Schichten [2-8] in umgekehrter Reihenfolge;
- Der dem Benutzer angezeigte Bildschirm ([1]) spiegelt diese Antwort wider.
Hinweis: Wenn Ihnen die Architektur des Projekts unklar ist, schauen Sie sich dieses Schema noch einmal an. Beachten Sie, dass das DBMS vom Server verwaltet wird, nicht vom Client.
1.4. Verwendete Werkzeuge
Dieses Dokument verwendet die folgenden Werkzeuge (ihre Installation wird in den Kapiteln 1 und 2 im Detail beschrieben):
- Node.js (Version 22 oder höher) und npm, um den [NestJS]-Server auszuführen;
- [Android Studio], die Entwicklungsumgebung von Google für Android. Sie liefert alles, was der Client benötigt: den Code-Editor (aufbauend auf IntelliJ IDEA), das Android-SDK, ein JDK (die JetBrains Runtime), den Android-Emulator und das Build-Werkzeug [Gradle]. Anders als im Flutter-Kurs, in dem Android Studio nur zur Installation des Android-SDK diente, fungiert es hier als Editor für den Client;
- Visual Studio Code (oder ein anderer Editor) für den NestJS-Server, wenn Sie dessen Code ansehen möchten;
- [MySQL] 8 für die Datenbank, installiert mit Laragon;
- Postman (oder ein anderer HTTP-Client), um die URLs des Servers zu testen;
- ein Android-Smartphone (optional): Ein Emulator genügt, um diesem gesamten Dokument zu folgen.
1.5. Funktionen der Anwendung
Die „fachlichen“ Funktionen der App [RdvMedecins] sind dieselben wie in den vorherigen Versionen:
- Eine Arztpraxis beschäftigt mehrere Ärzte, jeder mit eigenen Sprechzeitfenstern;
- Ein Benutzer muss sich anmelden (Benutzername/Passwort), um auf die App 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 erscheint entweder als frei oder als gebucht;
- 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 keine Termine buchen oder stornieren (nur Lesezugriff).


Oben sehen Sie die App im Android-Emulator: den Anmeldebildschirm, dann den Terminkalender eines Arztes und schließlich den Bildschirm nach der Buchung eines Zeitfensters.
1.6. Was sich geändert hat, was nicht
Ursprüngliches Dokument (2014) | Flutter-Variante (2026) | Dieses Dokument (2026) | |
MySQL 5 | MySQL 8, dieselben Tabellen | identisch mit der Flutter-Variante | |
Java, Spring 4 | TypeScript, NestJS | derselbe NestJS-Server | |
JavaScript, AngularJS 1.x | Dart, Flutter (mobil, Desktop, Web) | Kotlin, Jetpack Compose (Android) | |
Browser | nativer Code, von Flutter kompiliert | virtuelle Android-Maschine (ART) | |
Bower | Flutter / Pub | Gradle | |
Spring Security, HTTP Basic | Passport/JWT | Passport/JWT (derselbe Server) | |
angular-translate | TranslationsService (selbst geschrieben) | TranslationsService (selbst geschrieben, dieselben Wörterbücher) |
1.7. Aufbau dieses Dokuments
- Kapitel 1 - Einrichtung der Arbeitsumgebung: Android Studio und das Android-SDK installieren, das Projekt des Clients öffnen, einen Emulator erstellen und ein Smartphone einrichten.
- Kapitel 2 - Installation des [NestJS]-Servers: Laragon und die MySQL-Datenbank installieren, den Server konfigurieren, starten und testen und anschließend den Client zum ersten Mal ausführen.
- Kapitel 3 - Einführung in Android und Jetpack Compose: Activities, @Composable-Funktionen, Zustand und Recomposition, CompositionLocal, Coroutinen, Lebenszyklus und ViewModel – jeweils mit dem Flutter-Äquivalent.
- Kapitel 4 - Der Kotlin-Client für die App [RdvMedecins]: die Architektur des Clients, jede seiner Dateien und ein Rundgang Schritt für Schritt durch die vollständige App.
- Kapitel 5 - Ausführen der App: Emulator, Smartphone, APK – und was Sie über Netzwerk, unverschlüsselten HTTP-Verkehr, Bildschirmrotation und schmale Bildschirme wissen müssen; schließlich, was nötig wäre, um zusätzlich iOS, den Desktop und das Web anzusteuern.
- Kapitel 6 - Fazit und nächste Schritte.