homelab-brain/redax-wp/README.md
root 82eaa1e4bc feat(redax-wp): Multi-Publish, Dashboard-Verbesserungen, ESP32-Serie Teil 2
Redax-WP (Redakteur):
- WordPressMirrorClient: Multi-Publish an mehrere WP-Instanzen
- Target-Toggles im Dashboard (Checkbox, server-side rendering)
- WP-Admin Direktzugang via socat-Proxy (bypass Cloudflare WAF)
- Drag & Drop im Redaktionsplan
- Artikel-Karten mit Titel + SEO-Snippet sichtbar
- Entwürfe ohne Datum in separater Sektion
- DB-Cleanup-Job (Sonntag 03:00 Uhr)
- openrouter.py: sync generate() Wrapper
- mirror_posts Tabelle in DB

ESP32-Serie (Arakava News):
- Teil 1 veröffentlicht (Post 1209)
- Teil 2 als WP-Entwurf erstellt (Post 1340)
- Animiertes Hydraulikschema (SVG, 4 Betriebsmodi) in Teil 2 eingebaut
- Hardware liegt in DE, Einbau ab April nach Kambodscha-Rückkehr

Doku:
- STATE.md Redax-WP vollständig aktualisiert
- STATE.md Arakava-News: Serie-Status + Hardware-Timeline

Made-with: Cursor
2026-02-28 19:25:43 +07:00

90 lines
2.5 KiB
Markdown

# Redax-WP
KI-gestütztes Redaktionssystem für WordPress mit integriertem RSS-Feed-Manager.
## Was ist Redax-WP?
Redax-WP ersetzt das WordPress-Admin-Backend für redaktionelle Arbeit. Es kombiniert:
- **KI-Artikelgenerierung** (OpenRouter) mit automatischen SEO-Feldern
- **RSS-Feed-Import** mit konfigurierbarem Auto-Publish und optionalem KI-Rewrite
- **Redaktionsplanung** mit Kalender, Zeitslots und direktem Umplanen
- **WordPress-Veröffentlichung** via REST API (Publish / Entwurf / Einplanen)
- **Telegram-Benachrichtigung** nach Veröffentlichung von KI-Artikeln
## Schnellstart
### 1. Repository klonen
```bash
git clone https://git.orbitalo.net/orbitalo/redax-wp.git
cd redax-wp
```
### 2. Konfiguration
```bash
cp .env.example .env
# .env mit eigenen Werten befüllen (Editor öffnen)
nano .env
```
### 3. Starten
```bash
docker compose up -d
```
Dashboard: `http://localhost:8080`
### 4. WordPress einrichten
Nach dem ersten Start WordPress unter `http://localhost:81` (oder intern) einrichten:
1. WordPress-Installation abschließen
2. **Yoast SEO Plugin** installieren (für SEO-Meta-Tags)
3. In WordPress-Admin unter **Benutzer → Profil → Application Passwords** ein neues Passwort erstellen
4. Passwort in `.env` als `WP_APP_PASSWORD` eintragen
5. Container neu starten: `docker compose restart web`
## Konfiguration (.env)
| Variable | Beschreibung |
|----------|-------------|
| `DASHBOARD_USER` | Login-Name für das Dashboard |
| `DASHBOARD_PASSWORD` | Login-Passwort für das Dashboard |
| `WP_URL` | WordPress-URL (intern: `http://wordpress`) |
| `WP_USERNAME` | WordPress-Benutzername |
| `WP_APP_PASSWORD` | WordPress Application Password |
| `OPENROUTER_API_KEY` | API-Key von openrouter.ai |
| `TELEGRAM_BOT_TOKEN` | Telegram Bot-Token |
| `TELEGRAM_CHANNEL_ID` | Kanal für KI-Artikel Teaser |
| `TELEGRAM_REVIEWER_IDS` | Chat-IDs für Fehler-Alarm (kommagetrennt) |
| `TIMEZONE` | Zeitzone (Standard: `Europe/Berlin`) |
## Workflow
### KI-Artikel
1. Quelle eingeben + Ton wählen → KI generiert Artikel
2. In Vorschau prüfen, ggf. bearbeiten
3. Einplanen oder sofort veröffentlichen
4. → WordPress + automatischer Telegram-Teaser
### RSS-Artikel
1. Feed unter `/feeds` hinzufügen
2. Modus wählen: Manuell / Auto-Publish / KI-Rewrite
3. Neue Artikel landen in Queue oder werden direkt veröffentlicht
4. → Nur WordPress (kein Telegram)
## Architektur
```
docker-compose.yml
├── web Flask Dashboard (:8080)
├── wordpress WordPress + Apache (:80 intern)
└── db MySQL 8
```
## Lizenz
MIT