# n8n Customer Provisioning System

## Status: ✅ Phase 1-4 Complete

---

## Implementierte Features

### Phase 1: n8n API Funktionen (libsupabase.sh)

- [x] `n8n_api_login()` - Login mit `emailOrLdapLoginId` (nicht `email`)
- [x] `n8n_api_create_postgres_credential()` - PostgreSQL Credential erstellen
- [x] `n8n_api_create_ollama_credential()` - Ollama Credential erstellen
- [x] `n8n_api_import_workflow()` - Workflow importieren
- [x] `n8n_api_activate_workflow()` - Workflow aktivieren mit `versionId`
- [x] `n8n_generate_rag_workflow_json()` - Built-in Workflow Template
- [x] `n8n_setup_rag_workflow()` - Hauptfunktion für komplettes Setup

### Phase 2: install.sh - Workflow Import

- [x] Login durchführen
- [x] PostgreSQL Credential erstellen und ID speichern
- [x] Ollama Credential erstellen und ID speichern
- [x] Workflow JSON mit korrekten Credential-IDs generieren
- [x] Workflow importieren
- [x] Workflow aktivieren mit `POST /rest/workflows/{id}/activate` + `versionId`

### Phase 3: Externe Workflow-Datei Support

- [x] `--workflow-file <path>` Option hinzugefügt (default: `RAGKI-BotPGVector.json`)
- [x] `--ollama-model <model>` Option hinzugefügt (default: `ministral-3:3b`)
- [x] `--embedding-model <model>` Option hinzugefügt (default: `nomic-embed-text:latest`)
- [x] Python-Script für dynamische Credential-ID-Ersetzung
- [x] Entfernung von `id`, `versionId`, `meta`, `tags`, `active`, `pinData` beim Import
- [x] `RAGKI-BotPGVector.json` als Standard-Workflow-Template

### Phase 4: Tests & Git

- [x] Container sb-1769174647 - Workflow aktiviert ✅
- [x] Container sb-1769180683 - Externe Workflow-Datei ✅
- [x] Git Commits gepusht

---

## Verwendung

### Standard-Installation (mit Default-Workflow)

```bash
bash install.sh --debug
```

### Mit benutzerdefiniertem Workflow

```bash
bash install.sh --debug \
  --workflow-file /path/to/custom-workflow.json \
  --ollama-model "llama3.2:3b" \
  --embedding-model "nomic-embed-text:v1.5"
```

### Verfügbare Optionen

| Option | Default | Beschreibung |
|--------|---------|--------------|
| `--workflow-file` | `RAGKI-BotPGVector.json` | Pfad zur n8n Workflow JSON-Datei |
| `--ollama-model` | `ministral-3:3b` | Ollama Chat-Modell |
| `--embedding-model` | `nomic-embed-text:latest` | Ollama Embedding-Modell |

---

## Technische Details

### n8n REST API Endpoints

| Endpoint | Methode | Beschreibung |
|----------|---------|--------------|
| `/rest/login` | POST | Login (Feld: `emailOrLdapLoginId`, nicht `email`) |
| `/rest/credentials` | POST | Credential erstellen |
| `/rest/workflows` | POST | Workflow importieren |
| `/rest/workflows/{id}/activate` | POST | Workflow aktivieren (benötigt `versionId`) |

### Credential Types

- `postgres` - PostgreSQL Datenbank
- `ollamaApi` - Ollama API

### Workflow-Verarbeitung

Das Python-Script `/tmp/process_workflow.py` im Container:
1. Liest die Workflow-Template-Datei
2. Entfernt Felder: `id`, `versionId`, `meta`, `tags`, `active`, `pinData`
3. Ersetzt alle `postgres` Credential-IDs mit der neuen ID
4. Ersetzt alle `ollamaApi` Credential-IDs mit der neuen ID
5. Schreibt die verarbeitete Workflow-Datei

---

## Git Commits

1. `ff1526c` - feat: Auto-import n8n RAG workflow with credentials
2. `f663708` - fix: Workflow activation with versionId
3. `26f5a73` - feat: External workflow file support with dynamic credential replacement

---

## Phase 5: Workflow Auto-Reload bei LXC-Neustart ✅

- [x] Systemd-Service für automatisches Workflow-Reload
- [x] Reload-Script mit vollständigem Logging
- [x] Workflow-Template persistent speichern
- [x] Integration in install.sh
- [x] Hilfsfunktionen in libsupabase.sh
- [x] Dokumentation (WORKFLOW_RELOAD_README.md)

### Details

Der Workflow wird jetzt bei jedem LXC-Neustart automatisch neu geladen:

1. **Systemd-Service**: `/etc/systemd/system/n8n-workflow-reload.service`
2. **Reload-Script**: `/opt/customer-stack/reload-workflow.sh`
3. **Workflow-Template**: `/opt/customer-stack/workflow-template.json`
4. **Logs**: `/opt/customer-stack/logs/workflow-reload.log`

**Funktionsweise**:
- Beim LXC-Start wird der Systemd-Service ausgeführt
- Service wartet auf Docker und n8n-Container
- Reload-Script löscht alten Workflow
- Importiert Workflow aus Template
- Aktiviert Workflow
- Loggt alle Aktionen

**Siehe**: `WORKFLOW_RELOAD_README.md` für vollständige Dokumentation

---

## Nächste Schritte (Optional)

- [ ] Workflow-Validierung vor Import
- [ ] Mehrere Workflows unterstützen
- [ ] Workflow-Update bei bestehenden Containern
- [ ] Backup/Export von Workflows
- [ ] Tests für Auto-Reload-Feature durchführen