feat: secure and document book reviews system

Added rate limiting to APIs, cleaned up docs, implemented fallback logic for reviews without text, and added comprehensive n8n guide.
2026-02-15 22:32:49 +01:00
parent 0766b46cc8
commit 6998a0e7a1
22 changed files with 3141 additions and 4135 deletions
@@ -0,0 +1,146 @@
+# 🔧 n8n Chat Setup für Production
+
+## Problem: AI Chat funktioniert nicht auf Production
+
+Wenn der AI Chat auf Production nicht funktioniert, liegt es meist an fehlenden Environment-Variablen.
+
+## ✅ Lösung: Environment-Variablen in Gitea setzen
+
+### Schritt 1: Gehe zu Gitea Repository Settings
+
+1. Öffne: `https://git.dk0.dev/denshooter/portfolio/settings`
+2. Klicke auf **"Variables"** im linken Menü
+
+### Schritt 2: Setze die n8n Variables
+
+#### Variables (öffentlich):
+- **Name:** `N8N_WEBHOOK_URL`
+- **Value:** `https://n8n.dk0.dev`
+- **Protect:** ✅ (optional)
+
+- **Name:** `N8N_API_KEY` (optional, falls dein n8n eine API-Key benötigt)
+- **Value:** Dein n8n API Key
+- **Protect:** ✅
+
+#### Secrets (verschlüsselt):
+- **Name:** `N8N_SECRET_TOKEN`
+- **Value:** Dein n8n Secret Token (falls du einen verwendest)
+- **Protect:** ✅
+
+### Schritt 3: Prüfe die n8n Webhook URL
+
+Stelle sicher, dass dein n8n Workflow:
+1. **Aktiv** ist (Toggle oben rechts)
+2. Den Webhook-Pfad `/webhook/chat` hat
+3. Die vollständige URL ist: `https://n8n.dk0.dev/webhook/chat`
+
+### Schritt 4: Teste die Webhook-URL direkt
+
+```bash
+curl -X POST https://n8n.dk0.dev/webhook/chat \
+  -H "Content-Type: application/json" \
+  -d '{"message": "Hello"}'
+```
+
+Wenn du einen `N8N_SECRET_TOKEN` verwendest:
+
+```bash
+curl -X POST https://n8n.dk0.dev/webhook/chat \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_SECRET_TOKEN" \
+  -d '{"message": "Hello"}'
+```
+
+### Schritt 5: Deploy neu starten
+
+Nach dem Setzen der Variablen:
+1. Push einen Commit zum `production` Branch
+2. Oder manuell den Workflow in Gitea starten
+3. Die Variablen werden automatisch an den Container übergeben
+
+## 🔍 Debugging
+
+### Prüfe Container-Logs
+
+```bash
+docker logs portfolio-app | grep -i n8n
+```
+
+### Prüfe Environment-Variablen im Container
+
+```bash
+docker exec portfolio-app env | grep N8N
+```
+
+Sollte zeigen:
+```
+N8N_WEBHOOK_URL=https://n8n.dk0.dev
+N8N_SECRET_TOKEN=*** (wenn gesetzt)
+N8N_API_KEY=*** (wenn gesetzt)
+```
+
+### Prüfe Browser-Konsole
+
+Öffne die Browser-Konsole (F12) und schaue nach Fehlern beim Senden einer Chat-Nachricht.
+
+### Prüfe Server-Logs
+
+Die Chat-API loggt jetzt detaillierter:
+- Ob `N8N_WEBHOOK_URL` gesetzt ist
+- Die vollständige Webhook-URL (ohne Credentials)
+- HTTP-Fehler mit Status-Codes
+
+## 🐛 Häufige Probleme
+
+### Problem 1: "N8N_WEBHOOK_URL not configured"
+
+**Lösung:** Variable in Gitea setzen (siehe Schritt 2)
+
+### Problem 2: "n8n webhook failed: 404"
+
+**Lösung:** 
+- Prüfe, ob der n8n Workflow aktiv ist
+- Prüfe, ob der Webhook-Pfad `/webhook/chat` ist
+- Teste die URL direkt mit curl
+
+### Problem 3: "n8n webhook failed: 401/403"
+
+**Lösung:**
+- Prüfe, ob `N8N_SECRET_TOKEN` in Gitea Secrets gesetzt ist
+- Prüfe, ob der Token im n8n Workflow korrekt konfiguriert ist
+
+### Problem 4: "Connection timeout"
+
+**Lösung:**
+- Prüfe, ob n8n erreichbar ist: `curl https://n8n.dk0.dev`
+- Prüfe Firewall-Regeln
+- Prüfe, ob n8n im gleichen Netzwerk ist (Docker Network)
+
+## 📝 Aktuelle Konfiguration
+
+Die Chat-API verwendet:
+- **Webhook URL:** `${N8N_WEBHOOK_URL}/webhook/chat`
+- **Authentication:** 
+  - `Authorization: Bearer ${N8N_SECRET_TOKEN}` (wenn gesetzt)
+  - `X-API-Key: ${N8N_API_KEY}` (wenn gesetzt)
+- **Timeout:** 30 Sekunden
+- **Fallback:** Wenn n8n nicht erreichbar ist, werden intelligente Fallback-Antworten verwendet
+
+## ✅ Checkliste
+
+- [ ] `N8N_WEBHOOK_URL` in Gitea Variables gesetzt
+- [ ] `N8N_SECRET_TOKEN` in Gitea Secrets gesetzt (falls benötigt)
+- [ ] `N8N_API_KEY` in Gitea Variables gesetzt (falls benötigt)
+- [ ] n8n Workflow ist aktiv
+- [ ] Webhook-Pfad ist `/webhook/chat`
+- [ ] Container wurde nach dem Setzen der Variablen neu deployed
+- [ ] Container-Logs zeigen keine n8n-Fehler
+
+## 🚀 Nach dem Setup
+
+Nach dem Setzen der Variablen und einem neuen Deployment sollte der Chat funktionieren. Falls nicht:
+
+1. Prüfe die Container-Logs: `docker logs portfolio-app`
+2. Prüfe die Browser-Konsole für Client-seitige Fehler
+3. Teste die n8n Webhook-URL direkt mit curl
+4. Prüfe, ob die Environment-Variablen im Container gesetzt sind