OneStack Vollintegration

Das News-Recherche-Tool ist eine vollautonome (Level 5) Content-Pipeline für die Marken promptloop.de, idee-fuer-mich.de, maedchen.de sowie den Mandanten haustiermagazin.com. Es generiert täglich quellenbasierte, halluzinationsfreie und GEO/SEO-optimierte Artikel.

Status Quo

Aktuell existiert eine Stufe-1-Integration. Redakteure prüfen die generierten Artikel in einem Next.js-Dashboard und pushen sie per Klick via API (/api/onestack/push) an OneStack.

Zielbild (Vollintegration)

Das Frontend news.publishingheroes.de wird perspektivisch durch OneStack abgelöst. OneStack übernimmt das Redaktions-UI. Das bestehende Backend (Python-Worker, Supabase-DB, LLM-Router) wird entweder als Headless-Service beibehalten und tief an OneStack angebunden, oder die Logik wird vollständig nach OneStack migriert.

Das System läuft auf einem dedizierten Cloud Computer (Ubuntu 24.04) und besteht aus vier Schichten: Eingang (Discovery/Ideation), Recherche (Research), Produktion (Generator) und Distribution (Publisher).

2.1 Die zwei Themen-Pipelines

Das System hat zwei getrennte Wege für Themen, die in unterschiedlichen Tabellen leben:

2.2 Worker-Inventar (Python / systemd)

Die PostgreSQL-17-Datenbank in Supabase (EU/Frankfurt) umfasst 40 Tabellen. Row Level Security (RLS) stellt sicher, dass Nutzer nur auf Marken zugreifen können, für die sie in user_brand_access autorisiert sind.

Kern-Tabellen

Status-Lifecycle der Topics: proposed → researching → draft → review → approved → published.

Eine dedizierte Push-Route im Next.js-Frontend (apps/web/app/api/onestack/push/route.ts) sendet Artikel an OneStack. Dies ist der API-Contract, den OneStack heute erwartet:

4.1 Endpoints & Auth

• Base URL: https://onestack.quinta.tools/api/v1
• Ingest: POST /ingest/articles (Upsert via externalId)
• Validate: POST /ingest/articles/validate (Vorab-Check)
• Auth: Header X-API-Key; brand-spezifisch, verschlüsselt im Supabase Vault (z. B. onestack_api_key_haustiermagazin)

4.2 Daten-Format (TipTap JSON)

OneStack erwartet den Body nicht als HTML oder Markdown, sondern als strukturiertes TipTap-JSON. Eine eigene Logik (mdToTiptap()) wandelt Markdown in TipTap-Blöcke (H1–H4, Paragraphen, Listen, Blockquotes). Spezial-Blöcke wie das FAQ werden als dedizierte Block-Typen (type: "faq") in das content-Array eingebettet.

4.3 Feld-Mapping

5.1 Infrastruktur & Repositories

5.2 Secrets & Environment Variables

1. .secrets/-Verzeichnis (auf dem Cloud Computer): Pfad /home/ubuntu/news/.secrets/. Enthält .env-Dateien (z. B. supabase.env), die von systemd-Workern und dem Next.js-Build geladen werden — inkl. DB-Passwort und Service-Role-Key. Alle chmod 600, per .gitignore geschützt.

2. Supabase Vault (DB-intern): Hier liegen alle Drittanbieter-API-Keys (Anthropic, OpenAI, Perplexity, SerpAPI, DataForSEO) sowie die OneStack-Keys. Zugriff im Code über die RPC get_vault_secret('key_name'). Nur gelistete Keys (Allowlist in Migration 0049) sind auslesbar.

-- Beispiel: Secret aus dem Vault lesen (nur Service-Rolle / Admin)
SELECT get_vault_secret('onestack_api_key_haustiermagazin');

Empfohlener strategischer Pfad (Szenario C: Headless-Backend):

1. API-First: Python-Worker und Supabase-DB bleiben als robuster „Motor“ bestehen — optimiert für Prompt-Caching, Fallbacks und RAG.
2. OneStack als UI: Das Next.js-Frontend wird abgeschaltet. Redakteure arbeiten ausschließlich in OneStack.
3. Bidirektionaler Sync:
   • Push: Sobald generator_v1 einen Artikel fertigstellt (Status draft), wird er automatisch (statt manuell) an OneStack gepusht.
   • Pull/Webhooks: Redaktions-Änderungen in OneStack triggern Webhooks, die den Status in Supabase aktualisieren (z. B. published), damit das Backend den Lifecycle abschließt.
4. Code-Umzug: Die Logik aus onestack/push/route.ts wird in einen neuen Python-Worker (onestack_sync_worker.py) portiert, der auf DB-Änderungen reagiert.

Wichtige Befehle, falls Igor direkt auf der Maschine (35.195.248.50) operiert:

# Worker-Logs live mitlesen
journalctl -u news-generator-v1.timer -f

# Web-App bauen & neu starten
cd ~/news/apps/web && NODE_ENV=production pnpm build
sudo systemctl restart news-web.service

DB-Migrationen: liegen in infra/supabase/migrations/, ausgeführt via psql gegen den Pooler-Host aws-1-eu-central-1.pooler.supabase.com (der direkte db.*.supabase.co-Host ist IPv6-only und nicht erreichbar).

Backups: Täglicher logischer DB-Dump + Memory-Snapshot nach Cloudflare R2 (03:15 UTC). Supabase PITR zusätzlich aktiv.

Alle tiefen Details liegen versioniert im Repository unter /docs/ und /memory/ — optimal für Claude Code lesbar: