oliver/rss-news
1
0
Fork 0
Code Issues 3 Pull requests Projects Releases 12 Packages Wiki Activity Actions 2
rss-news/docs/AUTOMATION.md
Oliver G 208940da3f
Some checks are pending
🚀 Deploy to Hetzner / deploy (push) Waiting to run
Details
Backend Tests / backend-tests (push) Waiting to run
Details
feat(telegram): Link zum Artikel und zur Freigabe-Warteschlange 
Die Freigabe-Meldung fuehrte nur in den einzelnen Artikel. Stehen mehrere
an, will man in die Liste - beide Wege stehen jetzt in der Nachricht, und
die Pipeline-Zusammenfassung verlinkt die Warteschlange, sobald etwas
darauf wartet.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-24 16:39:06 +02:00

6.9 KiB
Raw Blame History

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:

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:

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
🔗 Diesen Artikel prüfen
📋 Alle wartenden Artikel
Erst nach der Freigabe geht der Beitrag nach WordPress und wird eingeplant.

Zwei Links: der erste springt direkt in den gemeldeten Artikel, der zweite auf die Freigabe-Warteschlange /admin/freigabe, wenn mehrere Artikel anstehen.

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.