From a2658c6673749d2bfa73420e9518b1e08c5f3f9d Mon Sep 17 00:00:00 2001
From: root <root@pve1.takeo.lan>
Date: Fri, 27 Feb 2026 11:06:09 +0700
Subject: [PATCH] =?UTF-8?q?redax-wp:=20Projekt=20vorl=C3=A4ufig=20abgeschl?=
 =?UTF-8?q?ossen?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Made-with: Cursor
---
 redakteur/STATE.md |   2 +-
 redax-wp/README.md | 219 +++++++++++++++++++++++++--------------------
 2 files changed, 123 insertions(+), 98 deletions(-)

diff --git a/redakteur/STATE.md b/redakteur/STATE.md
index f01c8963..c2aab10c 100644
--- a/redakteur/STATE.md
+++ b/redakteur/STATE.md
@@ -5,7 +5,7 @@
 
 ## Status
 
-✅ **Rohzustand läuft — Basis-Setup abgeschlossen**
+🏁 **Vorläufig abgeschlossen — 27.02.2026**
 
 ---
 
diff --git a/redax-wp/README.md b/redax-wp/README.md
index 9a37ae44..6ad2ee82 100644
--- a/redax-wp/README.md
+++ b/redax-wp/README.md
@@ -1,9 +1,24 @@
 # Redax-WP
 
-KI-gestützter WordPress-Redakteur mit Dashboard, RSS-Feed-Integration und Telegram-Anbindung.
+> KI-gestützter WordPress-Redakteur — selbst gehostet, Docker-basiert, template-ready.
 
-**Was ist Redax-WP?**
-Ein selbst gehostetes System aus WordPress + einem Flask-Dashboard, das KI-Artikel generiert, einplant und veröffentlicht. RSS-Feeds können automatisch importiert werden. KI-Artikel landen in WordPress **und** Telegram, RSS-Artikel nur in WordPress.
+Redax-WP ist ein vollständiges Redaktionssystem aus **WordPress + einem Flask-Dashboard**. Es generiert KI-Artikel, importiert RSS-Feeds und veröffentlicht automatisch in WordPress und optional auf Telegram.
+
+---
+
+## Was kann Redax-WP?
+
+| Feature | Beschreibung |
+|---------|-------------|
+| ✍️ KI-Artikel | Artikel per KI generieren (OpenRouter / GPT-4o, Claude, Mistral...) |
+| 📰 RSS-Import | Feeds automatisch importieren, prüfen und veröffentlichen |
+| 📅 Redaktionskalender | 7-Tage-Planung mit Drag & Drop |
+| 🔍 Yoast SEO | SEO-Titel, Meta-Beschreibung, Focus-Keyword direkt im Editor |
+| 📲 Telegram | KI-Artikel als Teaser auf Telegram posten |
+| ⏰ Morgen-Briefing | Tägliche Zusammenfassung um 10:00 Uhr |
+| 🚨 Fehler-Alarm | Sofortbenachrichtigung bei Veröffentlichungsfehlern |
+| 🗂️ Kategorie-Routing | KI-Artikel → WordPress + Telegram / RSS-Artikel → nur WordPress |
+| 🐳 Docker | Kompletter Stack per Docker Compose |
 
 ---
 
@@ -11,21 +26,23 @@ Ein selbst gehostetes System aus WordPress + einem Flask-Dashboard, das KI-Artik
 
 ```bash
 # 1. Repository klonen
-git clone https://github.com/DEIN_USER/redax-wp mein-blog
+git clone https://github.com/Orbitalo/Redax-Wordpress.git mein-blog
 cd mein-blog
 
-# 2. Interaktives Setup starten
+# 2. Setup starten (interaktiv)
 chmod +x setup.sh
 ./setup.sh
 ```
 
 Das Setup-Skript erledigt automatisch:
-- `.env` generieren (mit zufälligen Passwörtern)
-- Docker Stack starten
+- `.env` mit zufälligen Passwörtern generieren
+- Docker Stack starten (MySQL + WordPress + Dashboard)
 - WordPress installieren (6.9+)
 - Blocksy Theme + Yoast SEO installieren
-- Kategorien & Navigation anlegen
-- Application Password für REST-API generieren
+- Kategorien & Navigationsmenü anlegen
+- WordPress Application Password für die REST-API generieren
+
+**Danach:** API-Keys in `.env` eintragen und `make restart` ausführen.
 
 ---
 
@@ -36,22 +53,41 @@ Das Setup-Skript erledigt automatisch:
 | Docker | 24+ |
 | Docker Compose | 2.x |
 | Freie Ports | 80 (WordPress), 8080 (Dashboard) |
+| Betriebssystem | Linux (Debian/Ubuntu empfohlen) |
 
 ---
 
-## Manuelle Konfiguration
-
-Falls `setup.sh` nicht verwendet wird:
+## Konfiguration
 
 ```bash
 cp .env.example .env
-# .env anpassen
-docker compose up -d --build
+nano .env  # Pflichtfelder ausfüllen
 ```
 
+### Pflichtfelder
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `DASHBOARD_USER` | Login für das Redax-WP Dashboard |
+| `DASHBOARD_PASSWORD` | Passwort für das Dashboard |
+| `WP_URL` | Öffentliche URL des WordPress-Blogs |
+| `WP_USERNAME` | WordPress Admin-Benutzername |
+| `WP_APP_PASSWORD` | WordPress Application Password (auto via setup.sh) |
+| `OPENROUTER_API_KEY` | API-Key für KI-Generierung ([openrouter.ai](https://openrouter.ai)) |
+| `MYSQL_ROOT_PASSWORD` | MySQL Root-Passwort |
+| `MYSQL_PASSWORD` | MySQL Benutzer-Passwort |
+
+### Optionale Felder (Telegram)
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `TELEGRAM_BOT_TOKEN` | Bot-Token von [@BotFather](https://t.me/BotFather) |
+| `TELEGRAM_CHANNEL_ID` | Kanal-ID für Artikel-Teaser |
+| `TELEGRAM_REVIEWER_IDS` | Chat-IDs für Fehler-Alarm (kommagetrennt) |
+
 ---
 
-## Nützliche Befehle
+## Befehle
 
 ```bash
 make help          # Alle Befehle anzeigen
@@ -60,22 +96,22 @@ make stop          # Stack stoppen
 make restart       # Dashboard neustarten (nach .env-Änderung)
 make logs          # Live-Logs aller Container
 make logs-web      # Nur Dashboard-Logs
-make status        # Container-Status
-make shell-web     # Shell im Dashboard
-make shell-db      # MySQL-Shell
-make backup        # Datensicherung nach ./backups/
+make status        # Container-Status anzeigen
+make shell-web     # Shell im Dashboard-Container
+make shell-db      # MySQL-Shell öffnen
+make backup        # Datensicherung → ./backups/
 make update        # Docker-Images aktualisieren
+make clean         # Alle Daten löschen (Vorsicht!)
 ```
 
----
-
-## WP-CLI Befehle
+### WP-CLI
 
 ```bash
 # Beliebige WP-CLI Befehle ausführen:
 make wp plugin list
 make wp user list
 make wp cache flush
+make wp post list
 ```
 
 ---
@@ -83,104 +119,93 @@ make wp cache flush
 ## Architektur
 
 ```
-┌─────────────────────────────────────────────────┐
-│  Docker Stack                                    │
-│                                                  │
-│  ┌──────────────┐    ┌───────────────────────┐  │
-│  │  redax-web   │    │   redax-wordpress     │  │
-│  │  Flask :8080 │◄──►│   Apache/PHP :80      │  │
-│  └──────┬───────┘    └──────────┬────────────┘  │
-│         │                       │               │
-│         └──────────┬────────────┘               │
-│                    ▼                             │
-│             ┌──────────────┐                    │
-│             │   redax-db   │                    │
-│             │   MySQL :3306│                    │
-│             └──────────────┘                    │
-└─────────────────────────────────────────────────┘
-        │                      │
-        ▼                      ▼
- https://redax.           https://blog.
- example.com              example.com
- (Dashboard)              (Blog)
+┌─────────────────────────────────────────────────────┐
+│  Docker Stack                                        │
+│                                                      │
+│  ┌────────────────┐    ┌─────────────────────────┐  │
+│  │   redax-web    │    │    redax-wordpress       │  │
+│  │  Flask :8080   │◄──►│    Apache/PHP :80        │  │
+│  │  Dashboard     │    │    WordPress 6.9+        │  │
+│  └──────┬─────────┘    └────────────┬────────────┘  │
+│         │                           │               │
+│         └──────────────┬────────────┘               │
+│                        ▼                             │
+│                ┌───────────────┐                    │
+│                │   redax-db    │                    │
+│                │  MySQL 8 :3306│                    │
+│                └───────────────┘                    │
+└──────────────────────┬──────────────────────────────┘
+         │                           │
+         ▼                           ▼
+  https://redax.              https://blog.
+  example.com                 example.com
+  (Dashboard)                 (Blog)
 ```
 
 ---
 
-## Cloudflare Tunnel einrichten
+## Öffentlicher Zugang via Cloudflare Tunnel
 
-Für öffentliche Erreichbarkeit ohne offene Ports:
+Für öffentliche Erreichbarkeit ohne offene Firewall-Ports:
 
-1. [Cloudflare Zero Trust](https://one.dash.cloudflare.com) → Networks → Tunnels → Create
+1. **[Cloudflare Zero Trust](https://one.dash.cloudflare.com)** → Networks → Tunnels → Create
 2. **Tunnel 1** (Dashboard):
-   - Hostname: `redax.example.com`
+   - Public Hostname: `redax.example.com`
    - Service: `http://localhost:8080`
 3. **Tunnel 2** (Blog):
-   - Hostname: `blog.example.com`
+   - Public Hostname: `blog.example.com`
    - Service: `http://localhost:80`
-4. Docker-Befehle aus Cloudflare kopieren und ausführen
+4. Den `docker run cloudflare/cloudflared ...`-Befehl aus dem CF-Dashboard ausführen
 
 ---
 
-## Nach dem Setup
-
-### Pflichtfelder nachträglich setzen
-
-Nach dem Setup unbedingt in `.env` eintragen:
-
-```bash
-nano .env
-# OPENROUTER_API_KEY=sk-or-v1-...
-# TELEGRAM_BOT_TOKEN=...
-# TELEGRAM_CHANNEL_ID=...
-
-make restart  # Änderungen übernehmen
-```
-
-### WordPress konfigurieren
-
-- **WP-Admin:** `https://blog.example.com/wp-admin`
-- Kategorien umbenennen: WP-Admin → Beiträge → Kategorien
-- Yoast SEO einrichten: SEO → Allgemein
-
----
-
-## Daten & Verzeichnisse
+## Verzeichnisstruktur
 
 ```
 redax-wp/
-├── data/
-│   ├── mysql/        # MySQL-Datenbank (persistent)
-│   ├── wordpress/    # WordPress-Dateien + Uploads
-│   └── db/           # Redax-WP SQLite-Datenbank
-├── logs/             # Anwendungs-Logs
-├── src/              # Dashboard-Quellcode (Flask)
-├── .env              # Konfiguration (nicht ins Git!)
-├── .env.example      # Vorlage
-├── docker-compose.yml
-├── setup.sh          # Automatisches Ersteinrichtungs-Skript
-└── Makefile          # Komfort-Befehle
+├── setup.sh               ← Automatisches Ersteinrichtungs-Skript
+├── Makefile               ← Komfort-Befehle
+├── docker-compose.yml     ← Docker Stack Definition
+├── .env.example           ← Konfigurationsvorlage
+├── README.md              ← Diese Datei
+├── .gitignore             ← .env, data/, logs/ ausgeschlossen
+└── src/
+    ├── app.py             ← Flask Dashboard (Haupt-App)
+    ├── database.py        ← SQLite Datenbankschicht
+    ├── wordpress.py       ← WordPress REST API Client
+    ├── rss_fetcher.py     ← RSS Feed Import
+    ├── logger.py          ← Strukturiertes JSON-Logging
+    ├── requirements.txt   ← Python-Abhängigkeiten
+    ├── Dockerfile.web     ← Container-Definition
+    └── templates/         ← HTML-Templates (Jinja2)
+        ├── base.html
+        ├── index.html     ← Studio / Editor
+        ├── feeds.html     ← RSS Feed-Verwaltung
+        ├── history.html   ← Veröffentlichungs-Historie
+        ├── prompts.html   ← KI-Prompt Bibliothek
+        ├── settings.html  ← Einstellungen
+        ├── hilfe.html     ← Hilfe-Seite
+        └── login.html
 ```
 
 ---
 
-## Features
+## Datensicherung
 
-| Feature | Status |
-|---------|--------|
-| KI-Artikel generieren (OpenRouter) | ✅ |
-| WordPress REST API Integration | ✅ |
-| Yoast SEO Felder | ✅ |
-| RSS Feed Import | ✅ |
-| Redaktionskalender (7 Tage) | ✅ |
-| Telegram Benachrichtigungen | ✅ |
-| Morgen-Briefing (10:00 Uhr) | ✅ |
-| Featured Image (og:image) | ✅ |
-| Strukturierte Logs | ✅ |
-| Multi-Reviewer Support | ✅ |
+```bash
+make backup
+# → Erstellt: ./backups/redax-wp-YYYYMMDD_HHMMSS.tar.gz
+# Enthält: MySQL-Daten, WordPress-Dateien, SQLite-DB, .env
+```
 
 ---
 
 ## Lizenz
 
-MIT — frei verwendbar, anpassbar, weitergabe erlaubt.
+MIT — frei verwendbar, anpassbar und weitergabe erlaubt.
+
+---
+
+## Entwickelt von
+
+[Orbitalo](https://github.com/Orbitalo) — Homelab & Automatisierungsprojekte