orbitalo/homelab-brain
1
0
Fork 0
Code Issues 37 Pull requests Projects Releases Packages Wiki Activity Actions

redax-wp: Projekt vorläufig abgeschlossen

Browse source 
Made-with: Cursor
This commit is contained in:
root 2026-02-27 11:06:09 +07:00
parent 62f6e393b9
commit a2658c6673
2 changed files with 123 additions and 98 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
redakteur/STATE.md
View file

@ -5,7 +5,7 @@
## Status
✅ **Rohzustand läuft — Basis-Setup abgeschlossen**
🏁 **Vorläufig abgeschlossen — 27.02.2026**
---

219
redax-wp/README.md
View file

@ -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