# LibreBooking n8n Node

![Version](https://img.shields.io/badge/version-1.2.0-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![n8n](https://img.shields.io/badge/n8n-compatible-orange.svg)
![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)

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)