Oliver G
de1d62c6f7
Die Freigabe ist jetzt der taegliche Arbeitsschritt und bekommt eine eigene Seite: /admin/freigabe listet alle wartenden Artikel mit Bild, Score, Tags und dem umgeschriebenen Text lesbar gerendert, dazu die drei Aktionen Freigeben, Neu schreiben, Verwerfen. Nach jeder Aktion geht es zurueck in die Liste, damit sich eine Warteschlange am Stueck abarbeiten laesst. Der Vorschautext ist Modell-Ausgabe ueber fremde Webseiten und laeuft deshalb durch einen Tag-Whitelist-Filter statt roh ins Template. Aufgeraeumt: - Artikelliste zeigte interne Kuerzel statt Klartext - Status `review` (Relevanz-Warnzone) wurde als "Rewrite" ausgegeben - `Rewrite -> Freigegeben` entfernt: zweiter Weg an der Freigabe vorbei - `Freigegeben -> Veroeffentlicht` entfernt: das macht der WP-Sync - API-Statusliste wird abgeleitet statt handgepflegt, sie kannte den neuen Status nicht und lehnte den Wechsel mit 422 ab Behoben: list_articles las content_rewritten nicht mit, die neue Seite haette nie einen Text angezeigt. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
224 lines
6.7 KiB
Markdown
224 lines
6.7 KiB
Markdown
# Automatischer Pipeline-Betrieb
|
||
|
||
## Überblick
|
||
|
||
Import, Bewertung und Rewrite laufen automatisch. **Veröffentlicht wird erst nach
|
||
deiner redaktionellen Freigabe im Portal** — siehe `docs/KI-VO.md` für den
|
||
rechtlichen Hintergrund (Art. 50 Abs. 4 KI-VO).
|
||
|
||
```
|
||
N8N (2× täglich, 08:00 + 16:00 Uhr)
|
||
└─► POST /api/n8n/pipeline (X-API-Key Header)
|
||
├── RSS Ingestion (alle aktivierten Feeds)
|
||
├── Relevanz-Score per GPT (0–100)
|
||
│ ├── Score ≥ 80 → Rewrite + Tags → Status "Wartet auf Freigabe"
|
||
│ ├── Score 60–79 → Telegram-Warnung + manueller Override möglich
|
||
│ └── Score < 60 → Abgelehnt + tägliche Telegram-Liste
|
||
└── Pipeline-Zusammenfassung via Telegram
|
||
|
||
Danach, manuell im Portal (news.vanityontour.de/admin/freigabe):
|
||
Artikel lesen → [✅ Freigeben] / [✏️ Neu schreiben] / [❌ Verwerfen]
|
||
├── Stempel: Prüfer + Systemzeit (nicht editierbar)
|
||
├── Publish-Slot reservieren
|
||
└── WordPress-Beitrag anlegen (Status "future" zum Slot)
|
||
```
|
||
|
||
Vor der Freigabe existiert **kein** WordPress-Beitrag und **kein** belegter
|
||
Publish-Slot. Wer das Gate abschalten will: `EDITORIAL_REVIEW_REQUIRED=false` —
|
||
dann gilt wieder der alte, vollautomatische Ablauf, und der KI-Hinweistext auf
|
||
dem Blog muss angepasst werden.
|
||
|
||
---
|
||
|
||
## Einrichtung
|
||
|
||
### 1. Umgebungsvariablen setzen
|
||
|
||
Kopiere `backend/.env.example` nach `backend/.env` und fülle alle Felder aus:
|
||
|
||
```bash
|
||
cp backend/.env.example backend/.env
|
||
nano backend/.env
|
||
```
|
||
|
||
Wichtige Variablen:
|
||
|
||
| Variable | Beschreibung |
|
||
|----------|-------------|
|
||
| `TELEGRAM_BOT_TOKEN` | Bot-Token von @BotFather |
|
||
| `TELEGRAM_CHAT_ID` | Deine persönliche Chat-ID |
|
||
| `TELEGRAM_WEBHOOK_SECRET` | Zufälliger String (≥ 20 Zeichen) |
|
||
| `N8N_API_KEY` | Starker zufälliger API-Key |
|
||
| `OPENAI_API_KEY` | OpenAI API-Key |
|
||
| `WP_BASE_URL` | WordPress-URL |
|
||
| `WP_USERNAME` | WordPress-Benutzername |
|
||
| `WP_PASSWORD` | WordPress App-Passwort |
|
||
|
||
### 2. Telegram-Webhook registrieren
|
||
|
||
Nach dem Deployment einmalig aufrufen:
|
||
|
||
```bash
|
||
curl -X POST https://news.vanityontour.de/api/telegram/setup-webhook \
|
||
-H "Cookie: rss_news_session=<dein-session-token>"
|
||
```
|
||
|
||
Oder über die Admin-UI: Settings → Telegram Webhook einrichten.
|
||
|
||
### 3. N8N Workflow einrichten
|
||
|
||
In N8N einen neuen Workflow erstellen:
|
||
|
||
**Trigger:** Cron
|
||
- Zeitplan 1: `0 8 * * *` (täglich 08:00)
|
||
- Zeitplan 2: `0 16 * * *` (täglich 16:00)
|
||
|
||
**Aktion:** HTTP Request
|
||
- Method: `POST`
|
||
- URL: `https://news.vanityontour.de/api/n8n/pipeline`
|
||
- Header: `X-API-Key: <dein-n8n-api-key>`
|
||
|
||
**Fehlerbehandlung:** Bei HTTP-Fehler → E-Mail/Telegram-Alert
|
||
|
||
---
|
||
|
||
## Telegram-Befehle
|
||
|
||
| Befehl | Funktion |
|
||
|--------|----------|
|
||
| `/run` | Pipeline manuell starten |
|
||
| `/rejected` | Abgelehnte Artikel der letzten 3 Tage anzeigen |
|
||
| `/status` | Aktuellen Pipeline-Status |
|
||
| `/help` | Alle Befehle anzeigen |
|
||
|
||
---
|
||
|
||
## Telegram-Benachrichtigungen
|
||
|
||
### Artikel wartet auf Freigabe
|
||
Wenn ein Artikel umgeschrieben wurde und geprüft werden muss:
|
||
|
||
```
|
||
📝 Neuer Artikel wartet auf Freigabe
|
||
📰 [Artikel-Titel]
|
||
🟢 Relevanz-Score: 87/100
|
||
📄 312 Wörter
|
||
🏷 #VanLife #Camping #Wohnmobil
|
||
🔗 Im Portal prüfen und freigeben
|
||
Erst nach der Freigabe geht der Beitrag nach WordPress und wird eingeplant.
|
||
```
|
||
|
||
Diese Nachricht trägt **bewusst keinen Freigabe-Button**: Der Sinn des Gates ist,
|
||
dass der Artikel gelesen wurde. Freigeben, neu schreiben und verwerfen passiert
|
||
auf der Artikelseite im Portal, einen Tipp auf den Link entfernt.
|
||
|
||
### Freigegeben und eingeplant
|
||
Bestätigung nach der Freigabe im Portal:
|
||
|
||
```
|
||
✅ Freigegeben und eingeplant
|
||
📰 [Artikel-Titel]
|
||
👤 Geprüft von: admin
|
||
📅 Veröffentlichung: Mo, 24.08.2026 um 09:00 Uhr
|
||
🔗 Beitrag in WordPress
|
||
```
|
||
|
||
### Relevanz-Warnung (Score 60–79)
|
||
```
|
||
⚠️ Artikel mit niedrigem Relevanz-Score
|
||
📰 [Artikel-Titel]
|
||
🟡 Score: 72/100
|
||
💬 Artikel behandelt hauptsächlich...
|
||
🔗 Originalartikel
|
||
|
||
[➕ Trotzdem verarbeiten] [❌ Ablehnen]
|
||
```
|
||
|
||
### Abgelehnte Artikel (Ende jedes Runs)
|
||
Liste aller abgelehnten Artikel mit Override-Buttons für jeden einzelnen.
|
||
|
||
---
|
||
|
||
## Relevanz-Score
|
||
|
||
Der GPT-basierte Score bewertet die Themenrelevanz für den VanLife/Camping-Blog:
|
||
|
||
| Score | Aktion |
|
||
|-------|--------|
|
||
| 80–100 | Rewrite, danach Warteschlange „Wartet auf Freigabe" |
|
||
| 60–79 | Telegram-Warnung, manueller Override (führt ebenfalls in die Warteschlange) |
|
||
| 0–59 | Automatisch abgelehnt |
|
||
|
||
Themen die hoch scored werden: Campingplätze, Stellplätze, Wohnmobile, Van-Ausbau,
|
||
Outdoor-Equipment, Wandern, Naturreisen, Roadtrips, Camping-Tipps.
|
||
|
||
Schwellwerte sind in `.env` konfigurierbar:
|
||
```
|
||
PIPELINE_RELEVANCE_AUTO=80
|
||
PIPELINE_RELEVANCE_WARN=60
|
||
```
|
||
|
||
---
|
||
|
||
## Veröffentlichungsplan
|
||
|
||
- Standardmäßig **09:00, 12:00, 15:00 und 18:00 Uhr**
|
||
- Maximal **4 Beiträge pro Tag** im Standard-Setup
|
||
- Zwischen den Slots liegen jeweils **3 Stunden Abstand**
|
||
- Veröffentlichungsfenster: **09:00 bis 19:00 Uhr** (`Europe/Berlin`)
|
||
- Gleichmäßig über die Woche verteilt
|
||
- Der Slot wird **im Moment der Freigabe** reserviert, nicht schon beim Rewrite —
|
||
ein wartender Artikel blockiert also keinen Sendeplatz
|
||
- Der zugeteilte Slot erscheint in der Freigabe-Bestätigung per Telegram
|
||
- WordPress veröffentlicht den Beitrag zum Slot selbst (Status `future`)
|
||
|
||
Einstellbar via:
|
||
```
|
||
PIPELINE_MAX_DRAFTS_PER_DAY=4
|
||
PIPELINE_PUBLISH_HOURS=9,12,15,18
|
||
PIPELINE_PUBLISH_START_HOUR=9
|
||
PIPELINE_PUBLISH_END_HOUR=19
|
||
PIPELINE_PUBLISH_MIN_GAP_HOURS=3
|
||
```
|
||
|
||
---
|
||
|
||
## API-Endpunkte (N8N / extern)
|
||
|
||
Alle externen Endpunkte benötigen den Header `X-API-Key: <N8N_API_KEY>`.
|
||
|
||
| Methode | Endpunkt | Funktion |
|
||
|---------|----------|----------|
|
||
| `POST` | `/api/n8n/pipeline` | Komplette Pipeline starten |
|
||
| `POST` | `/api/n8n/ingest` | Nur RSS-Import (ohne Rewrite) |
|
||
|
||
---
|
||
|
||
## Deployment (Hetzner via GitHub)
|
||
|
||
Das Deployment läuft automatisch über GitHub Actions beim Push auf `main`:
|
||
|
||
1. GitHub Action führt Tests aus
|
||
2. Bei Erfolg: SSH-Deploy auf Hetzner
|
||
3. `pip install -r requirements.txt`
|
||
4. Systemd-Dienst `rss-app` neu starten
|
||
|
||
Workflow-Dateien: `.github/workflows/test.yml` und `.github/workflows/deploy.yml`
|
||
|
||
---
|
||
|
||
## Troubleshooting
|
||
|
||
**Pipeline läuft, aber keine Telegram-Nachrichten:**
|
||
- `TELEGRAM_BOT_TOKEN` und `TELEGRAM_CHAT_ID` prüfen
|
||
- Webhook-Status prüfen: `GET https://api.telegram.org/bot<TOKEN>/getWebhookInfo`
|
||
|
||
**N8N bekommt 401:**
|
||
- `N8N_API_KEY` in `.env` und N8N-Workflow-Header müssen übereinstimmen
|
||
|
||
**Alle Artikel werden abgelehnt:**
|
||
- `PIPELINE_RELEVANCE_WARN` temporär auf 40 senken zum Testen
|
||
- Über `/rejected` + Override-Button manuell testen
|
||
|
||
**Artikel werden doppelt importiert:**
|
||
- Deduplication läuft über `source_url` (eindeutig). Bereits verarbeitete Artikel werden nie erneut als Draft angelegt.
|