Skip to content

2. Kapitel 1 - Einrichtung der Arbeitsumgebung

2.1. Die Werkzeuge installieren

  1. Node.js: Laden Sie Version 22 (oder höher) von nodejs.org herunter und installieren Sie sie. Überprüfen Sie die Installation in einem Terminal:
    node --version
    npm --version
    
  1. Visual Studio Code (VSCode): kostenlos erhältlich unter code.visualstudio.com. Installieren Sie die Erweiterung „TypeScript and JavaScript Language Features“ (normalerweise bereits enthalten).
  2. [NestJS] CLI, einmalig und dauerhaft installiert (auf der Clientseite braucht [Vite] keine globale Installation – siehe Einführung). In einem VSCode-Terminal:
    npm install -g @nestjs/cli
    
  1. [MySQL] 8: Installieren Sie es zum Beispiel über XAMPP, Laragon (unter Windows) oder direkt über [MySQL] Community Server. Ein grafisches Administrationswerkzeug (phpMyAdmin, [MySQL] Workbench, DBeaver, HeidiSQL …) erleichtert die Arbeit. Im Folgenden wird das Werkzeug Laragon verwendet.
  2. Postman: kostenlos erhältlich unter postman.com.

Wenn Sie den Code heruntergeladen haben, befindet er sich in zwei Ordnern:

Image

  • in [1] der Client [React];
  • in [2] der Server [NestJS];

Öffnen Sie den Ordner [2] mit Visual Studio [File / Open Folder]:

Image

2.2. Die Datenbank erstellen

Um die [MySQL]-Datenbank zu erstellen, die vom [NestJS]-Server verwendet wird, verwenden wir das Werkzeug Laragon. Im September 2026 ist Laragon unter der URL [Download Laragon – Fast & Modern Dev Environment ] verfügbar. Laragon enthält Werkzeuge, mit denen Sie einen PHP-Server und den [MySQL]-DBMS-Server installieren können:

Image

  • in [1] ein Apache-Webserver;
  • in [2] das DBMS [MySQL];
  • in [3] ein Messaging-Werkzeug, das wir nicht verwenden werden;
  • [4] startet alle Dienste (Apache, [MySQL], MailPit);
  • [5] zeigt die Webseite der URL [http://localhost] an. Standardmäßig verweist diese URL auf den Ordner <laragon-install>\www, wobei <laragon-install> der Installationsordner von Laragon ist;
  • in [6] startet das Werkzeug HeidiSQL, mit dem Sie MySQL-Datenbanken verwalten können. Mit diesem Werkzeug erstellen wir die vom [NestJS]-Server verwendete Datenbank;
  • in [7] öffnen Sie ein Terminal; alle für Laragon benötigten Binärdateien befinden sich im PATH;
  • in [8] öffnen Sie ein Windows-Explorer-Fenster im Ordner, der der URL [http://localhost] zugeordnet ist;

Der Installationsordner von Laragon enthält die folgenden Elemente:

 
  • In [1] enthält der Ordner [bin] zahlreiche Anwendungen:
  • in [1] der Apache-Webserver;
  • in [2] ein Kommandozeilen-Terminal;
  • in [3] ein [git]-Client, mit dem Sie verschiedene Versionen eines Projekts verwalten können;
  • in [4] ein Datenbankverwaltungswerkzeug;
  • [5] ein Mail-Manager;
  • in [6] das DBMS [MySQL];
  • [7] ein weiterer Webserver;
  • in [8] [node.js] zum Ausführen von JavaScript-Skripten;
  • [9] ein Texteditor;
  • [10] der PHP-Interpreter;
  • [11] der [Python]-Interpreter;
  • [12] ein Cache-Server;

Laragon bringt eine umfassende Entwicklungsumgebung mit. In diesem Kurs verwenden wir nur das DBMS [MySQL] [6] und [heidisql] zu seiner grafischen Verwaltung;

Um die [MySQL]-Datenbank zu erstellen, die vom [NestJS]-Server benötigt wird, gehen Sie wie folgt vor:

 
  • In [1] müssen alle Dienste gestartet sein;
  • In [2] ermöglicht die Option [Database] die Verwaltung der Datenbank;

Die Option [Database] startet ein Hilfsprogramm namens HeidiSQL:

  • In [1] können Sie verschiedene DBMS-Optionen auswählen. Als Standardwert ist MySQL vorgegeben. Das passt so;
  • in [2] melden Sie sich bei HeidiSQL an;
  • Führen Sie in [1-2] die SQL-Datei aus und wählen Sie dann die Datei [dbrdvmedecins.sql] aus, die Sie im Ordner [rdvmedecins-nestjs-server/database] finden:

Image

Die Ausführung der Datei [3] erstellt die Datenbank [dbrdvmedecins], die vom [NestJS]-Server verwendet wird. Um sie anzuzeigen, drücken Sie in HeidiSQL F5, um die Anzeige zu aktualisieren:

Image

Die Datenbank [dbrdvmedecins] wurde erstellt. Sie können ihren Inhalt ansehen:

Image

  • In [1-3] die Tabelle [clients];
    • [id] ist der Primärschlüssel der Tabelle;
    • [version] ist die Versionsnummer der Zeile. Diese Nummer wird bei jeder Änderung der Zeile erhöht;
    • [title, last_name, first_name] identifizieren die Person;

Image

  • in [1-3] die Tabelle [doctors];
    • [id] ist der Primärschlüssel der Tabelle;
    • [version] ist die Versionsnummer der Zeile;
    • [title, last_name, first_name] identifizieren die Person;

Image

  • In [1-3] die Tabelle [slots] mit den Terminzeitfenstern der Ärzte:
    • [id]: Primärschlüssel;
    • [version]: Versionsnummer der Zeile;
    • [doctor_id]: Fremdschlüssel, der auf den Primärschlüssel des Arztes verweist;
    • [start_hour, start_minute]: Stunde und Minuten des Beginns des Termins. So bedeutet [8,20] 8:20 Uhr.
    • [end_hour, end_minute]: Stunde und Minuten des Endes der Konsultation.

Image

  • In [1-3] die Tabelle [appointments] mit den vereinbarten Terminen;
    • [id]: Primärschlüssel;
    • [version]: Versionsnummer;
    • [day]: Datum des Termins;
    • [slot_id]: Fremdschlüssel, der auf den Primärschlüssel des Terminzeitfensters verweist. Da ein Zeitfenster mit einem Arzt verknüpft ist, wissen wir, welcher Arzt diesen Termin wahrnimmt;
    • [client_id]: Fremdschlüssel auf die Nummer (Primärschlüssel) des Patienten, der den Termin wahrnimmt;

Image

  • in [1-3] die Tabelle [users] mit den Benutzern, die berechtigt sind, die [NestJS]-Anwendung zu nutzen;
    • [id, version]: Primärschlüssel, Versionsnummer;
    • [login, password]: Zugangsdaten des Benutzers;
    • [name]: Name des Benutzers;
    • [role]: die Rolle des Benutzers. [ADMIN] hat volle Zugriffsrechte. [USER] hat nur Lesezugriff. Dieser Benutzer kann den Terminkalender eines Arztes einsehen, aber keinen Termin vereinbaren oder stornieren;

2.3. Den [NestJS]-Server zum ersten Mal starten

Geben Sie im Ordner [rdvmedecins-nestjs-server] in einem Terminal die folgenden Befehle ein:

npm install
cp .env.example .env

Die Datei [.env] legt Umgebungsvariablen fest:

# -----------------------------------------------------------------------
# Beispiel-Konfigurationsdatei.
# Diese Datei nach [.env] kopieren und die Werte anschließend an den eigenen Rechner anpassen.
# Die Datei [.env] darf niemals weitergegeben oder committet werden (Passwörter).
# -----------------------------------------------------------------------

# Listening-Port des NestJS-Servers (der ursprüngliche Spring-Server lauschte auf 8080)
PORT=8080

# Verbindungsparameter für die MySQL-Datenbank [dbrdvmedecins]
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=
DB_DATABASE=dbrdvmedecins

# nur in der Entwicklung: TypeORM kann die Tabellen automatisch aus den Entitäten
# erstellen/aktualisieren. Hier ist dies deaktiviert, da wir ein eigenes
# SQL-Skript [database/dbrdvmedecins.sql] bereitstellen, wie es das ursprüngliche Spring-Projekt tat.
DB_SYNCHRONIZE=false

# -----------------------------------------------------------------------
# Authentifizierung (siehe src/auth/)
# -----------------------------------------------------------------------
# geheimer Schlüssel zum Signieren/Verifizieren von JWT-Tokens - MUSS geändert werden
# in der Produktion (eine lange Zufallszeichenfolge, niemals committen).
JWT_SECRET=change-me-to-a-long-random-string
# Gültigkeitsdauer eines JWT-Tokens (siehe die Dokumentation der Bibliothek [ms]:
# "60", "2h", "7d"...)
JWT_EXPIRES_IN=2h

Passen Sie die neu erstellte Datei [.env] an Ihre [MySQL]-Installation an (Benutzername, Passwort, Port). Da die Authentifizierung hinzugefügt wurde (siehe Kapitel 3), enthält diese Datei auch einen Schlüssel namens JWT_SECRET: Der Beispielwert genügt, um diesem Dokument zu folgen, muss aber vor jedem echten Einsatz durch eine eigene eindeutige Zufallszeichenfolge ersetzt werden.

Starten Sie alle Laragon-Dienste [Start All], falls Sie dies noch nicht getan haben.

Starten Sie dann den Server:

npm run start:dev

Die Konsole zeigt der Reihe nach an: den Start des [NestJS]-Moduls, die Liste der vom Controller bereitgestellten Routen und anschließend die Startbestätigung:

[Nest] RoutesResolver RdvMedecinsController {/}:
[Nest] RouterExplorer Mapped {/getAllDoctors, GET} route
[Nest] RouterExplorer Mapped {/getAllClients, GET} route
[Nest] RouterExplorer Mapped {/getAllSlots/:doctorId, GET} route
[Nest] RouterExplorer Mapped {/getDoctorAppointmentsOfDay/:doctorId/:day, GET} route
[Nest] RouterExplorer Mapped {/getDoctorScheduleOfDay/:doctorId/:day, GET} route
[Nest] RouterExplorer Mapped {/getDoctorById/:id, GET} route
[Nest] RouterExplorer Mapped {/getClientById/:id, GET} route
[Nest] RouterExplorer Mapped {/getSlotById/:id, GET} route
[Nest] RouterExplorer Mapped {/getAppointmentById/:id, GET} route
[Nest] RouterExplorer Mapped {/addAppointment, POST} route
[Nest] RouterExplorer Mapped {/deleteAppointment, POST} route
[Nest] RoutesResolver AuthController {/}:
[Nest] RouterExplorer Mapped {/login, POST} route
[Nest] NestApplication Nest application successfully started
[RdvMedecins] NestJS server started on http://localhost:8080

Diese Konsolenausgabe bestätigt, dass der Server tatsächlich auf Port 8080 lauscht – genau derselbe Port wie beim Spring-Boot-Server des ursprünglichen Dokuments, der aus diesem Grund bewusst gewählt wurde.

2.4. Den Server mit einem Browser testen

Seit der Einführung der Authentifizierung (Kapitel 3) erfordern alle Routen von [RdvMedecinsController] ein gültiges JWT-Token: Ein Browser allein kann sie daher nicht mehr direkt testen. Zum Beispiel:

http://localhost:[8080/getAllDoctors]

liefert jetzt ohne Token den Fehler 401 Unauthorized zurück:

Image

Das ist das erwartete Verhalten: Diese Antwort bestätigt, dass der Server seine Routen ordnungsgemäß schützt. Postman (nächster Abschnitt) ist erforderlich, um ein Token zu erhalten und es anschließend zu verwenden.

2.5. Den [NestJS]-Server mit Postman testen

Das Werkzeug Postman ist unter der URL [https://www.postman.com/downloads/] verfügbar. Möglicherweise müssen Sie ein Konto erstellen.

Starten Sie alle Laragon-Dienste und öffnen Sie dann die Desktop-Anwendung Postman:

  • In [1-2] wird eine HTTP-Anfrage erstellt, um den Terminverwaltungsserver der Ärzte abzufragen;

2.5.1. Anmelden und ein Token erhalten

  1. Erstellen Sie eine neue Postman-Anfrage mit der Methode POST und der URL http://localhost:8080/login;
  2. Wählen Sie auf der Registerkarte [Body] die Option „raw“, dann das Format JSON und geben Sie ein: {"login": "admin", "password": "admin"} (oder „user/user“, um die Rolle USER zu testen);
  3. Senden Sie die Anfrage ab.

Image

  • in [1-2] die POST-Anfrage an den Server [NestJS] , der auf Port 8080 läuft;
  • in [3-5] der Body der Anfrage. Damit wird dem Server der JSON-String mit den Zugangsdaten des Benutzers übermittelt, der sich anmelden möchte, hier admin/admin;
  • in [6] die Antwort des Servers;
  • in [7] das Authentifizierungs-Token, das nachfolgende Anfragen an den Server senden müssen, um anzuzeigen: „Ich habe mich bereits authentifiziert“;

Kopieren Sie den Wert von accessToken: Dies ist das Token, das Sie nun in jede weitere Anfrage einfügen müssen. Im obigen Beispiel ist das zu kopierende Token „eyJ...zoM“ (ohne die Anführungszeichen).

2.5.2. Eine geschützte Route mit dem Token aufrufen

Wählen Sie für GET /getAllDoctors (oder jede andere Route, die mit RdvMedecinsController beginnt) in Postman auf der Registerkarte Authorization den Typ Bearer Token aus und fügen Sie das zuvor kopierte Token ein (Postman fügt dann automatisch den Header Authorization: Bearer <token> hinzu).

Image

  • in [1-2] die an den Server gesendete Anfrage. Sie fordert die Liste der Ärzte in der Datenbank an;
  • In [3-5] muss die Anfrage das Authentifizierungs-Token senden. Wählen Sie in [4] [Bearer Token], und fügen Sie in [5] das zuvor kopierte Authentifizierungs-Token ein;
  • in [7] die Antwort des Servers;

2.5.3. Die POST-Routen testen (/addAppointment, /deleteAppointment)

Gehen Sie genauso vor wie oben (Methode POST, Body JSON, Bearer Token), so wie das ursprüngliche Dokument die Chrome-Erweiterung „Advanced Rest [Client]“ für dieselben Routen verwendete.

Hinweis: Die folgenden Postman-Anfragen finden Sie in der Collection [rdvmedecins-nestJS.postman_collection.json]:

Image

Drücken Sie in Postman Strg-0, um die Collection zu laden:

Image

  • Klicken Sie auf [1], um die Collection zu laden, und wählen Sie die Collection-Datei aus. Nach dem Laden der Collection werden ihre Anfragen angezeigt:

Image

So testen Sie /addAppointment mit dem Token eines Kontos ADMIN:

  1. Postman-Anfrage, Methode POST, URL http://localhost:8080/addAppointment;
  2. Authorization-Registerkarte: Bearer Token, Token des Admin-Kontos;
  3. [Body]-Registerkarte, raw, JSON: {"day": "2026-09-13", "clientId": 1, "slotId": 5};
  4. Senden Sie die Anfrage ab.

Image

Mit HeidiSQL können Sie überprüfen, dass der Datenbank ein Termin hinzugefügt wurde:

Image

Um /deleteAppointment zu testen, gehen Sie genauso vor, mit dem Body {"appointmentId": 2} (der ID des Termins, der storniert werden soll, siehe (8) oben).

Image

  • in [4], wo die oben stehende Nummer der zu löschende Termin ist;

Image

  • in [5-7] das Authentifizierungs-Token;
  • in [9] die Antwort des Servers. [status=0] zeigt an, dass der Vorgang erfolgreich war. Sie können dies mit HeidiSQL überprüfen:

Image

  • in [3] existiert der Termin Nr. 2 nicht mehr;

Probieren Sie Folgendes aus: Wiederholen Sie dieselbe Anfrage /addAppointment mit dem Token des Kontos USER (user/user) statt mit dem Admin-Token: Die Antwort lautet nun 403 Forbidden mit der Meldung „role [USER] does not allow this action (required role: ADMIN)“ – eine anschauliche Demonstration der in Kapitel 3 umgesetzten rollenbasierten Zugriffskontrolle.

2.6. Den [React]-Client zum ersten Mal starten

Im Ordner rdvmedecins-react-client (der [NestJS]-Server muss zuvor gestartet sein):

npm install
npm start

Öffnen Sie dann http://localhost:4200 in einem Browser: Zuerst erscheint der Anmeldebildschirm (siehe Kapitel 5).

Image

  • in [1] die URL des Servers, der die [React]-Anwendung ausliefert;
  • in [2] die URL des Servers [NestJS] , der die Datenbank [dbrdvmedecins] verwaltet;

Wichtig ist, zu verstehen, dass es hier zwei Webserver gibt, von denen einer als Client des anderen fungiert.

Zwei Schaltflächen mit den Beschriftungen „FR“ und „EN“ oben rechts ermöglichen es, die Oberfläche auf Französisch umzuschalten (standardmäßig wird sie auf Englisch angezeigt, oder auf Französisch, wenn der Browser auf Französisch eingestellt ist), noch vor der Anmeldung. Melden Sie sich mit einem der beiden Demokonten an (admin/admin mit vollem Zugriff oder user/user mit Lesezugriff), um auf den Rest der Anwendung zuzugreifen. Kapitel 5 enthält eine ausführliche Anleitung zur Verwendung dieses Clients mit Screenshots zu jedem Schritt.