Skip to content

3. Kapitel 2 - Installation des [NestJS]-Servers

Der in diesem Dokument beschriebene [Flutter]-Client benötigt einen Server, den er abfragen kann: den [NestJS]-Server für die Anwendung [RdvMedecins], der diesem Dokument im Ordner [rdvmedecins-nestjs-server] beiliegt. Da sich dieses Dokument auf [Flutter] konzentriert, wird dieser Server als „Blackbox“ behandelt: Dieses Kapitel erklärt, wie Sie ihn installieren, konfigurieren, seine [MySQL]-Datenbank erstellen, ihn starten und testen, untersucht aber seinen Code nicht. Leser, die [NestJS] lernen möchten, finden das Dokument *Einführung in die Sprache TypeScript und das Framework NestJS* (2026).

Dieses Kapitel ist im Wesentlichen ein Nachdruck des Kapitels „Installation eines NestJS-Servers“ aus dem Dokument *Einführung in die Sprache Dart anhand von Beispielen* (2026), angepasst an einen anderen Server: Der Server zur Steuerberechnung aus jenem Dokument wird hier durch den [RdvMedecins]-Server ersetzt und seine Datenbank [dbimpots-2019] durch die Datenbank [dbrdvmedecins].

3.1. Laragon installieren

Um die [MySQL]-Datenbank zu erstellen, die der [NestJS]-Server verwendet, nutzen 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 sich ein PHP-Server und das DBMS [MySQL] installieren lassen:

Image

  • in [1] ein Apache-Webserver;
  • in [2] das DBMS [MySQL];
  • in [3] ein Nachrichtenwerkzeug, das wir nicht verwenden werden;
  • [4] startet alle Dienste (Apache, [MySQL], MailPit);
  • [5] zeigt die Webseite zur 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] wird das Werkzeug HeidiSQL gestartet, mit dem Sie MySQL-Datenbanken verwalten können. Wir verwenden dieses Werkzeug, um die Datenbank zu erstellen, die vom Server [RdvMedecins] verwendet wird;
  • In [7] wird ein Terminal geöffnet, in dem alle für Laragon benötigten Binärdateien im PATH liegen;
  • In [8] wird der Windows-Datei-Explorer im Ordner geöffnet, der zur URL [http://localhost] gehört;

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 Befehlszeilen-Terminal;
  • in [3] ein [git]-Client zur Versionsverwaltung der verschiedenen Stände eines Projekts;
  • in [4] ein Datenbankverwaltungswerkzeug;
  • in [5] ein Mailverwaltungswerkzeug;
  • 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 das Werkzeug [heidisql] zu seiner grafischen Verwaltung;

3.2. Installation und Konfiguration des [NestJS]-Servers

Der Ordner [rdvmedecins-nestjs-server] hat die folgende Verzeichnisstruktur:

rdvmedecins-nestjs-server/
├── package.json                  # npm-Abhängigkeiten und Skripte
├── tsconfig.json                 # Konfiguration des TypeScript-Compilers
├── nest-cli.json                 # Konfiguration der NestJS CLI
├── .env.example                  # Vorlage der .env-Konfigurationsdatei
├── database/
│   └── dbrdvmedecins.sql         # Skript zur Datenbankerstellung
└── src/
    ├── main.ts                   # Einstiegspunkt des Servers
    ├── app.module.ts             # Wurzelmodul
    ├── config/                   # Datenbankverbindung
    ├── entities/                 # TypeORM-Entitäten (eine Klasse pro Tabelle)
    ├── domain/                   # Geschäftsobjekte
    ├── repositories/             # Datenzugriff (DAO-Schicht)
    ├── business/                 # Geschäftsschicht
    ├── web/                      # JSON-Controller und Antwortmodelle
    └── auth/                     # JWT-Authentifizierung und Rollen

Jeder Unterordner von [src/] enthält eine eigene [README.md]-Datei, die den Zweck der enthaltenen Dateien zusammenfasst. Der Quellcode dieser Dateien wird in diesem Dokument nicht behandelt.

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:

# -----------------------------------------------------------------------
# Beispielkonfigurationsdatei.
# Diese Datei nach [.env] kopieren und die Werte 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 der 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 das deaktiviert, da wir wie das ursprüngliche
# Spring-Projekt ein eigenes SQL-Skript [database/dbrdvmedecins.sql] bereitstellen.
DB_SYNCHRONIZE=false

# -----------------------------------------------------------------------
# Authentifizierung (siehe src/auth/)
# -----------------------------------------------------------------------
# geheimer Schlüssel zum Signieren/Verifizieren der JWT-Token - MUSS geändert werden
# in der Produktion (eine lange Zufallszeichenkette, 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 eine Authentifizierung hinzugekommen ist, enthält diese Datei außerdem einen Schlüssel namens JWT_SECRET: Der Beispielwert genügt, um diesem Dokument zu folgen, muss aber vor jedem tatsächlichen Einsatz durch eine zufällige, nur Ihnen bekannte Zeichenfolge ersetzt werden.

3.3. Erstellen der Datenbank

Die Datenbank [dbrdvmedecins] spiegelt die Struktur des ursprünglichen Dokuments (2014, Spring 4 / [MySQL] 5) wider: dieselben Tabellen – [doctors], [clients], [slots], [appointments], jetzt mit englischen Namen –, dieselben Fremdschlüssel, dieselbe Eindeutigkeitsbedingung. Die einzige Neuerung, die durch den Schritt „Authentifizierung“ dieser Portierung hinzukommt, ist die Tabelle [users]. Die Beziehungen zwischen diesen Tabellen sind folgende: Ein Arzt ([doctors]) hat mehrere Zeitslots ([slots], Fremdschlüssel [doctor_id]); ein Termin ([appointments]) verknüpft einen Tag, einen Zeitslot (und damit einen Arzt) und einen Client ([clients]); die Tabelle [users] ist von den anderen vier unabhängig: Sie dient ausschließlich der Authentifizierung.

3.3.1. [database/dbrdvmedecins.sql]

Image

  -- =========================================================================
  -- Datenbank [dbrdvmedecins] - MySQL 8
  --
  -- Dieses Skript bildet das relationale Schema des ursprünglichen Dokuments EXAKT nach
  -- (2014, Spring 4 / Spring Data / MySQL 5): dieselben Tabellen, dieselben Spalten,
  -- dieselben Fremdschlüssel, dieselbe Eindeutigkeitsbedingung. Nur die Datenbank-Engine
  -- ändert ihren Namen (MySQL 5 -> MySQL 8), nicht die Struktur.
  --
  -- The original document used THREE tables (users, roles,
 -- users_roles), damit ein Benutzer MEHRERE Rollen haben kann.
 -- Da diese Anwendung nur zwei sich gegenseitig ausschließende Rollen kennt
 -- (ADMIN, USER), vereinfachen wir hier auf eine einzige Spalte [role]
 -- in der Tabelle [users], statt die ursprüngliche Many-to-
 -- Many-Beziehung nachzubauen - eine bewusste didaktische Vereinfachung, dokumentiert
 -- im Kapitel „Authentication“ des Kurses.
 -- =========================================================================

 -- bei jedem Lauf des Skripts beginnen wir wieder mit einer leeren Datenbank (praktisch in der Entwicklung)
 DROP TABLE IF EXISTS appointments;
 DROP TABLE IF EXISTS slots;
 DROP TABLE IF EXISTS clients;
 DROP TABLE IF EXISTS doctors;
 DROP TABLE IF EXISTS users;

 CREATE DATABASE IF NOT EXISTS dbrdvmedecins CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
 USE dbrdvmedecins;

 CREATE TABLE doctors (
   id         INT AUTO_INCREMENT PRIMARY KEY,
   version    INT NOT NULL DEFAULT 0,
   title      VARCHAR(5)  NOT NULL,
   last_name  VARCHAR(20) NOT NULL,
   first_name VARCHAR(20) NOT NULL
 );

 CREATE TABLE clients (
   id         INT AUTO_INCREMENT PRIMARY KEY,
   version    INT NOT NULL DEFAULT 0,
   title      VARCHAR(5)  NOT NULL,
   last_name  VARCHAR(20) NOT NULL,
   first_name VARCHAR(20) NOT NULL
 );

 CREATE TABLE slots (
   id           INT AUTO_INCREMENT PRIMARY KEY,
   version      INT NOT NULL DEFAULT 0,
   doctor_id    INT NOT NULL,
   start_hour   INT NOT NULL,
   start_minute INT NOT NULL,
   end_hour     INT NOT NULL,
   end_minute   INT NOT NULL,
   CONSTRAINT fk_slots_doctor FOREIGN KEY (doctor_id) REFERENCES doctors(id)
 );

 CREATE TABLE appointments (
   id         INT AUTO_INCREMENT PRIMARY KEY,
   version    INT NOT NULL DEFAULT 0,
   day        DATE NOT NULL,
   slot_id    INT NOT NULL,
   client_id  INT NOT NULL,
   CONSTRAINT fk_appointments_slot   FOREIGN KEY (slot_id)   REFERENCES slots(id),
   CONSTRAINT fk_appointments_client FOREIGN KEY (client_id) REFERENCES clients(id),
   CONSTRAINT unq1_appointments UNIQUE (day, slot_id)
 );

 CREATE TABLE users (
   id       INT AUTO_INCREMENT PRIMARY KEY,
   version  INT NOT NULL DEFAULT 0,
   login    VARCHAR(30) NOT NULL UNIQUE,
   password VARCHAR(100) NOT NULL,
   name     VARCHAR(40) NOT NULL,
   role     VARCHAR(10) NOT NULL
 );

 INSERT INTO doctors (title, last_name, first_name) VALUES
   ('Mme', 'PELISSIER', 'Marie'), ('Mr', 'TATOU', 'Paul'), ('Melle','DUPONT', 'Sophie');

 INSERT INTO clients (title, last_name, first_name) VALUES
   ('Mr', 'MARTIN', 'Jean'), ('Mme', 'DURAND', 'Alice'),
   ('Melle','BISTROU', 'Brigitte'), ('Mr', 'GERMAN', 'Luc');

 INSERT INTO slots (doctor_id, start_hour, start_minute, end_hour, end_minute) VALUES
   (1, 8, 0, 8, 20), (1, 8, 20, 8, 40), /* ... */ (1, 11, 40, 12, 0);

 INSERT INTO slots (doctor_id, start_hour, start_minute, end_hour, end_minute) VALUES
   (2, 14, 0, 14, 20), (2, 14, 20, 14, 40), /* ... */ (2, 17, 40, 18, 0);

 INSERT INTO appointments (day, slot_id, client_id) VALUES (CURDATE(), 2, 3);

 INSERT INTO users (login, password, name, role) VALUES
   ('admin', '$2b$10$YSNBJXXHX9mp13nPZb6YGu8M1jR6uvPwO1s2X73z0QAqBR7TOQjoq', 'Administrator', 'ADMIN'),
   ('user',  '$2b$10$6Cvoion7AgJkpYHw5N0jMuWPf8T90J28En56kWBL9PT0bXt7lwW7.', 'User',          'USER');

Kommentieren wir diesen Code:

  • Zeilen 19–23: [DROP TABLE IF EXISTS …] – Das Skript beginnt bei jeder Ausführung mit einer leeren Datenbank, und zwar in umgekehrter Reihenfolge der Abhängigkeiten (beginnend mit `appointments`, das auf `[slots]` und `clients` verweist, bis hinunter zu `users`, auf das niemand verweist): [MySQL] würde sich weigern, eine Tabelle zu löschen, die noch von einem Fremdschlüssel referenziert wird;
  • Zeile 47: [doctor_id INT NOT NULL], dann Zeile 52: [CONSTRAINT fk_slots_doctor FOREIGN KEY …] – Ein Zeitslot gehört immer zu einem Arzt;
  • Zeile 63: [CONSTRAINT unq1_appointments UNIQUE (day, slot_id)] – die zentrale Geschäftsregel der Anwendung: Derselbe Zeitslot am selben Tag kann nur einmal gebucht werden. Es ist diese Constraint, und nur sie, die einen doppelten Termin verhindert – weder der Controller noch die Geschäftsschicht prüfen dies noch einmal ausdrücklich;
  • Zeilen 66–73: [CREATE TABLE users (…)] – die Tabelle, die in diesem Schritt hinzukommt. `login` ist UNIQUE (zwei Benutzer können nicht dieselbe Anmeldekennung haben); `password` speichert ein mit bcrypt gehashtes Passwort (niemals im Klartext); role ist entweder 'ADMIN' oder 'USER' – eine einfache Textspalte, während das ursprüngliche Dokument drei Tabellen (users, roles, users_roles) verwendete, um mehrere Rollen pro Benutzer zu ermöglichen. Da diese Anwendung nur zwei sich gegenseitig ausschließende Rollen benötigt, wäre die ursprüngliche Many-to-many-Beziehung überdimensioniert gewesen;
  • Zeilen 90–92: [INSERT INTO users …] – zwei Demokonten, admin/admin (Rolle ADMIN) und user/user (Rolle USER), deren Passwörter bereits mit bcrypt gehasht sind (10 Salt-Runden) – niemals im Klartext, auch nicht in diesem Demoskript.

3.3.2. Das Skript mit HeidiSQL ausführen

Um die [MySQL]-Datenbank zu erstellen, die der [NestJS]-Server benötigt, gehen wir 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. Der vorgegebene Wert ist MySQL. Das ist in Ordnung;
  • 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 der Terminzeitslots 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 Terminbeginns. So bedeutet [8,20] 8:20 Uhr;
    • [end_hour, end_minute]: Stunde und Minuten des Endes der Sprechstunde.

Image

  • In [1-3] die Tabelle [appointments] der vereinbarten Termine;
    • [id]: Primärschlüssel;
    • [version]: Versionsnummer;
    • [day]: Datum des Termins;
    • [slot_id]: Fremdschlüssel, der auf den Primärschlüssel des Terminzeitslots verweist. Da ein Zeitslot 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], die die Benutzer auflistet, die die Anwendung [NestJS] verwenden dürfen;
    • [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 Lesezugriff. Dieser Benutzer kann den Terminkalender eines Arztes einsehen, aber keinen Termin buchen oder stornieren;

3.4. Den [NestJS]-Server starten

Starten Sie alle Laragon-Dienste ([Start All]), falls noch nicht geschehen. Starten Sie anschließend den NestJS-Server in einem VSCode-Terminal für das NestJS-Projekt:

npm run start:dev

Die Konsole zeigt der Reihe nach an: den Start des [NestJS]-Moduls, die Liste der von den Controllern bereitgestellten Routen und schließlich die Bestätigung des Starts:

[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 – exakt derselbe Port wie beim Spring-Boot-Server im ursprünglichen Dokument, der aus diesem Grund bewusst gewählt wurde.

Diese Routen bilden die JSON-API, die der Client [Flutter] in Kapitel 4 nutzen wird. [POST /login] ist die einzige öffentliche Route: Sie liefert ein JWT-Token, das alle anderen Routen im Header [Authorization: Bearer <token>] verlangen. Die lesenden Routen ([GET …]) stehen den Rollen ADMIN und USER offen; die beiden Routen, die Daten ändern, [POST /addAppointment] und [POST /deleteAppointment], sind der Rolle ADMIN vorbehalten. Fachliche Antworten sind in ein Objekt [{ status, data }] eingebettet, in dem [status] bei Erfolg auf 0 gesetzt ist.

3.5. Den Server mit einem Browser testen

Da eine Authentifizierung hinzugekommen ist, erfordern alle Routen von [RdvMedecinsController] ein gültiges JWT-Token; ein Browser allein reicht daher nicht mehr aus, um sie direkt zu testen. Zum Beispiel:

http://localhost:8080/getAllDoctors

liefert jetzt ohne Token den Fehler 401 Unauthorized:

Image

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

3.6. Den [NestJS]-Server mit Postman testen

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

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

  • Erstellen Sie in [1-2] eine HTTP-Anfrage, um den Server für die Terminverwaltung der Ärzte abzufragen;

3.6.1. Anmelden und ein Token erhalten

  1. Erstellen Sie in Postman eine neue 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 [NestJS]-Server, der auf Port 8080 läuft;
  • in [3-5] der Body der Anfrage. Er übermittelt dem Server den JSON-String mit den Zugangsdaten des Benutzers, der sich anmelden möchte, hier admin/admin;
  • in [6] die Antwort des Servers;
  • in [7] das Authentifizierungstoken, 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 aufnehmen müssen. Im obigen Beispiel ist das zu kopierende Token „eyJ...zoM“ (ohne die Anführungszeichen).

3.6.2. Eine geschützte Route mit dem Token aufrufen

Wählen Sie für GET /getAllDoctors (oder jede andere Route von RdvMedecinsController) 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 Authentifizierungstoken enthalten. Wählen Sie in [4] [Bearer Token], und fügen Sie in [5] das zuvor kopierte Authentifizierungstoken ein;
  • in [7] die Antwort des Servers;

3.6.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 für dieselben Routen die Chrome-Erweiterung „Advanced Rest [Client]“ verwendet hat.

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

Image

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

Image

  • Klicken Sie auf [1], um die Sammlung zu laden, und wählen Sie die Sammlungsdatei aus. Nach dem Laden zeigt die Sammlung ihre Anfragen an:

Image

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

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

Image

  • in [3-5] der Body der Anfrage;

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} (die Kennung des zu stornierenden Termins (8) oben).

Image

  • in [4] ist die obige Nummer der Termin, der gelöscht werden soll;

Image

  • in [5-7] das Authentifizierungstoken;
  • 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 es aus: Wiederholen Sie dieselbe Anfrage /addAppointment mit dem Token des Kontos USER (user/user) statt mit dem Token von admin: Die Antwort lautet dann 403 Forbidden mit der Meldung „role [USER] does not allow this action (required role: ADMIN)“ – eine anschauliche Demonstration der rollenbasierten Zugriffskontrolle, die der Server umsetzt.

3.7. Den Flutter-Client zum ersten Mal starten

Im Ordner [rdvmedecins_flutter_client] (der [NestJS]-Server muss zuvor gestartet worden sein):

flutter devices          # listet die auf diesem Rechner verfügbaren Ziele auf
flutter run -d chrome    # Web - das einfachste Ziel für einen ersten Versuch

Image

Zuerst erscheint der Anmeldebildschirm, genau wie bei den vorherigen Clients dieses Kurses (siehe Kapitel 4): In der Datenbank des Servers werden zwei Demokonten mitgeliefert, [admin]/[admin] (Rolle [ADMIN], voller Zugriff) und [user]/[user] (Rolle [USER], nur Lesezugriff). Mit zwei Schaltflächen „FR“ und „EN“ in der oberen rechten Ecke können Sie die Oberfläche schon vor der Anmeldung auf Französisch umschalten. Kapitel 5 beschreibt die entsprechenden Befehle für Desktop und Mobilgeräte sowie die einzige Einstellung, die für diese Plattformen spezifisch ist (die Serveradresse; siehe weiter unten in diesem Kapitel).