n8n_node_librebooking/README.md

LibreBooking n8n Node

Integration von LibreBooking in n8n für automatisierte Reservierungs- und Ressourcenverwaltung.

📦 Installation via Git

# Repository klonen
git clone https://github.com/YOUR-USERNAME/n8n-nodes-librebooking.git
cd n8n-nodes-librebooking

# Dependencies installieren
npm install

# Bauen
npm run build

Quick Start nach Git Clone

# Option 1: Automatische Installation
./quick-install.sh n8n

# Option 2: Docker Compose
docker-compose up -d

# Option 3: Manuell in bestehenden n8n Container
docker cp dist n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/
docker cp package.json n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/
docker cp node_modules n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/
docker restart n8n

---

⚡ Schnellstart (EMPFOHLEN)

Die einfachste Methode: Auf dem Host bauen, in Docker kopieren

# 1. Repository klonen
git clone https://github.com/your-org/n8n-nodes-librebooking.git
cd n8n-nodes-librebooking

# 2. Bauen und installieren
./quick-install.sh n8n

# Fertig! ✔

Oder manuell:

# Dependencies & Build
npm install
npm run build

# In Container kopieren
docker cp dist n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/
docker cp package.json n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/
docker cp node_modules n8n:/home/node/.n8n/custom/n8n-nodes-librebooking/

# Container neustarten
docker restart n8n

🛠️ npm Scripts

npm run build          # Baut den Node
npm run docker:deploy  # Baut, kopiert & startet Container neu
npm run docker:copy    # Kopiert in Container
npm run docker:restart # Startet Container neu

🔑 Credentials einrichten

1. Öffne n8n: http://localhost:5678
2. Gehe zu: Einstellungen → Credentials → Add Credential
3. Suche: LibreBooking API
4. Eingabe:
   • URL: https://deine-librebooking-url.de
   • Benutzername: Admin-Benutzer
   • Passwort: Passwort

🌟 Features

LibreBooking Node

• Reservierungen erstellen, bearbeiten, löschen
• Ressourcen und Verfügbarkeit verwalten
• Benutzer und Gruppen administrieren
• Zeitpläne und Zubehör konfigurieren
• NEU v1.2.0: Benutzerdefinierte Attribute setzen

LibreBooking Trigger Node

• Neue Reservierungen überwachen
• Geänderte Reservierungen erfassen
• Filter nach Ressource/Zeitplan/Benutzer
• NEU v1.2.0: Korrektes Verhalten beim ersten Poll (keine Altdaten)
• NEU v1.2.0: Zuverlässige Änderungserkennung via Hash-Vergleich

LibreBooking Config (v1.2.0)

• Optionales Credential für zentrale Standardwerte
• Konfigurierbar: termsAccepted, allowParticipation, Zeitzone, Sprache

📚 Dokumentation

• INSTALLATION.md - Alle Installationsmethoden
• SCHNELLSTART.md - Ultra-kurze Anleitung
• TROUBLESHOOTING.md - Problemlösung
• DOCKER-INTEGRATION.md - Docker-spezifische Anleitung
• CUSTOM-ATTRIBUTES.md - Benutzerdefinierte Attribute verwenden
• CONFIG-NODE.md - Config Node für Standardwerte

🔄 Updates

# Nach Änderungen oder git pull
./update-node.sh n8n

# Oder mit npm
npm run docker:deploy

❓ Problemlösung

tsc not found?

→ Lösung: Auf dem Host bauen (siehe Schnellstart)

Read-only Volume?

→ Lösung: dist/ in Container kopieren statt npm im Container

npm audit Vulnerabilities?

→ Sind non-critical Dependencies von n8n-workflow. Siehe SECURITY.md

📄 Lizenz

MIT - Siehe LICENSE

🤝 Beitragen

Beiträge sind willkommen! Siehe CONTRIBUTING.md