149 lines
3.9 KiB
Markdown
149 lines
3.9 KiB
Markdown
# LibreBooking n8n Node
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Integration von LibreBooking in n8n für automatisierte Reservierungs- und Ressourcenverwaltung.
|
|
|
|
## 📦 Installation via Git
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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**
|
|
|
|
```bash
|
|
# 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:**
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
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](INSTALLATION.md)** - Alle Installationsmethoden
|
|
- **[SCHNELLSTART.md](SCHNELLSTART.md)** - Ultra-kurze Anleitung
|
|
- **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** - Problemlösung
|
|
- **[DOCKER-INTEGRATION.md](DOCKER-INTEGRATION.md)** - Docker-spezifische Anleitung
|
|
- **[CUSTOM-ATTRIBUTES.md](CUSTOM-ATTRIBUTES.md)** - Benutzerdefinierte Attribute verwenden
|
|
- **[CONFIG-NODE.md](CONFIG-NODE.md)** - Config Node für Standardwerte
|
|
|
|
## 🔄 Updates
|
|
|
|
```bash
|
|
# 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](SECURITY.md)
|
|
|
|
## 📄 Lizenz
|
|
|
|
MIT - Siehe [LICENSE](LICENSE)
|
|
|
|
## 🤝 Beitragen
|
|
|
|
Beiträge sind willkommen! Siehe [CONTRIBUTING.md](CONTRIBUTING.md)
|