Erste Schritte

Voraussetzungen

• Node.js 20 oder neuer
• Docker und Docker Compose (für PostgreSQL und Keycloak)
• Git

Installation

1. Repository klonen

git clone https://github.com/altiros/resource-planer.git
cd resource-planer
npm install

2. Lokale Umgebung starten

Das Setup-Script startet PostgreSQL und Keycloak per Docker Compose, konfiguriert die Datenbank und legt einen Testbenutzer an:

bash scripts/setup.sh

Das Script erledigt automatisch:

• PostgreSQL und Keycloak Container starten
• Keycloak-Realm und -Client konfigurieren
• Testbenutzer guido.kroemer mit Passwort test1234 anlegen
• Datenbankschema anwenden
• Testdaten (Benutzer, Teams, Rollen, Buchungen) anlegen

3. App starten

npm run dev

Die App ist unter http://localhost:3000  erreichbar.

4. Anmelden

Klicken Sie auf Mit SSO anmelden und loggen Sie sich mit den Testdaten ein:

Erster Start (Produktion)

Bei einer frischen Installation ohne Seed-Daten erscheint nach dem ersten SSO-Login ein Setup-Wizard:

• Der erste Benutzer wird automatisch als Administrator eingerichtet
• Sie können wählen, ob Beispieldaten angelegt werden sollen
• Danach startet die App regulär

Umgebungsvariablen

Die Konfiguration erfolgt über die .env-Datei: