Zum Inhalt

Lokales Backend-Setup

Stand: 01.08.2026 14:55 Branch: docs/einheitliche-kopfbereiche Status: Anleitung

Datum, Uhrzeit Version Änderung Autor
01.08.2026 14:55 1.0 Kopfbereich vereinheitlicht David Mittig

Diese Anleitung beschreibt den lokalen Start des DiveLogix360-Backends für den Branch stabilize-uc00-backend.

Ziel ist nicht die Produktivinstallation, sondern die technische Prüfung des vorhandenen UC00-Backend-Kerns gegen die bestehende Supabase-Dev-Datenbank.

Voraussetzungen

Auf dem Entwicklungs-PC sollten vorhanden sein:

  • Node.js LTS
  • npm
  • Git
  • Visual Studio Code oder eine vergleichbare IDE
  • Zugriff auf das GitHub-Repository dmittig/divelogix360
  • Supabase-Verbindungsdaten für die Dev-Datenbank

Repository vorbereiten

git clone https://github.com/dmittig/divelogix360.git
cd divelogix360
git checkout stabilize-uc00-backend

Falls das Repository bereits lokal vorhanden ist:

cd divelogix360
git fetch
git checkout stabilize-uc00-backend
git pull

Backend vorbereiten

cd backend
npm install

Umgebungsvariablen einrichten

Die Datei backend/.env.example als Vorlage verwenden:

copy .env.example .env

Danach die Datei .env mit den echten Entwicklungswerten befüllen.

Wichtig:

  • .env darf nicht in Git committet werden.
  • Supabase-Passwörter und JWT-Schlüssel bleiben lokal.
  • Produktivwerte dürfen nicht in die Entwicklungsdatei eingetragen werden.

Supabase-Verbindung prüfen

Die 18 Tabellen sind bereits in Supabase installiert. Deshalb wird das Schema nicht neu installiert, sondern zuerst abgeglichen.

Empfohlene Prüfreihenfolge:

npm run prisma:generate
npx prisma db pull
npm run prisma:generate

Bedeutung:

  • npm run prisma:generate erzeugt den Prisma Client aus dem vorhandenen Repository-Schema.
  • npx prisma db pull liest den realen Supabase-Stand ein und zeigt Abweichungen zum lokalen Schema.
  • Das zweite npm run prisma:generate prüft, ob der Prisma Client nach dem Abgleich weiterhin erzeugt werden kann.

Wichtig:

Wenn npx prisma db pull die Datei backend/prisma/schema.prisma verändert, diese Änderung nicht ungeprüft übernehmen. Zuerst prüfen, ob die Änderung fachlich korrekt ist.

Build und Tests prüfen

npm run build
npm test

Ziel:

  • TypeScript kompiliert fehlerfrei.
  • Vorhandene Tests laufen.
  • Fehlende oder fehlerhafte Tests werden sichtbar.

Entwicklungsserver starten

npm run start:dev

Erwarteter Standard:

http://localhost:3000/v1

Der genaue Port und API-Prefix hängen von den Werten in .env ab.

Erste technische Abnahme

Folgende Punkte sollten dokumentiert werden:

Prüfung Erwartung Ergebnis
npm install läuft ohne kritische Fehler offen
npm run prisma:generate Prisma Client wird erzeugt offen
npx prisma db pull Supabase-Schema wird gelesen offen
npm run build Backend kompiliert offen
npm test Tests laufen oder Fehler sind dokumentiert offen
npm run start:dev API startet lokal offen

Nächster Schritt nach erfolgreichem Start

Nach erfolgreichem lokalem Start folgt UC00-Testlogik:

  • SuperAdmin per Seed anlegen
  • SuperAdmin-Login testen
  • Test-Tenant anlegen
  • Tenant-Admin-Einladung erzeugen
  • Einladung einlösen
  • Tenant-Admin-Login testen
  • Refresh Token testen
  • Logout testen