Zum Hauptinhalt springen

Content Pool — SMG-globaler Katalog (Spec & Roadmap)

Stand: 2026-10-17 · Status: Design / vor Implementierung
Bezug: Content Pool (Dashboard) · Content Pool MCP


Was​

Heute liegt jedes Content-Pool-Paket in genau einer Organisation. Filialisten-Material (Texte, Medien, Gültigkeit, Ketten-Bezug) wird pro Mandant gepflegt oder per Import in alle Mandanten mit derselben Kette repliziert — faktisch dieselben Inhalte mehrfach in der Datenbank.

Ziel: Ein SMG-globaler Katalog (Plattform-Ebene, nicht org-gebunden), in dem KAM und zentrales Marketing einmal pflegen. Center und Mandanten beziehen passende Einträge für News, Angebote, Events und Digital Signage (DOOH) — ohne Copy-Paste und ohne N-fache Replikation.

EbeneHeuteZiel
WahrheitPaket pro organizationIdKatalog-Eintrag plattformweit (optional Org-Overlay)
SichtbarkeitCenter-Scope innerhalb einer OrgKetten- + Center-/Mandanten-Regeln aus globalem Katalog
Kanälevor allem News (Shop-Content)News, Angebote, Events, Signage-Playlists
ImportReplikation in N MandantenEin Import → ein Katalog-Eintrag, automatische Verfügbarkeit

Warum​

  • Filialisten-Inhalte sind ketten- und markenbezogen, nicht mandantenspezifisch — SMG betreibt viele Center unter verschiedenen Organisationen mit denselben Ketten.
  • Replikation skaliert schlecht: Dry-Run und Import erzeugen pro Mandant Duplikate; Änderungen müssten N Pakete aktualisieren.
  • Mehrkanal-Nutzung: Derselbe Hero-Text und dieselben Assets sollen konsistent auf Website-News, Angebotsmodul, Event-Hinweise und DOOH-Slots landen — mit einer Herkunftsreferenz (contentPoolCatalogEntryId o. ä.).
  • Governance: Plattform-Rollen pflegen den globalen Katalog; Org-Rollen dürfen optional lokale Anpassungen (Overlay) oder Opt-out pro Center — ohne den globalen Stammsatz zu überschreiben.

Wer ist betroffen​

RolleHeuteZiel
KAM / zentrales Marketing (SMG)Import/Replikation über Plattform-AdminsDirekte Pflege im globalen Katalog
Org-Marketing / Center-AdminPakete nur im eigenen MandantenKatalog durchsuchen, in Inhalte übernehmen, ggf. lokales Overlay
Content-Editor / RedaktionShop-Content → NewsÜbernahme in News, Angebote, Events; Signage-Auswahl
Signage / DOOH-Betriebeigene Medien oder manuellKatalog-Assets in Playlist-/Slot-Auswahl
Dev / Agenten (MCP/AgencyOS)organizationId PflichtKatalog-API + bestehende Org-Pakete (Übergang)

Ist-Analyse (Stand Code & Doku Okt 2026)​

Datenmodell​

TabelleZweck
content_pool_packagesPflichtfeld organization_id, shop_chain_id, Titel, Text, Gültigkeit, center_scope, Status
content_pool_assetsMedien (Mediathek-Referenz oder URL), Rolle hero/gallery/attachment
content_pool_package_centersBei explicit_centers die Center-Zuordnung innerhalb der Org

Indizes und Duplikat-Regeln sind org-lokal (gleicher Titel + gleiche Kette pro Organisation).

Dashboard & API​

  • Pfad: Mall Cockpit → Content Pool (/dashboard/content/content-pool).
  • Plattform-Admins: Organisations-Filter; ohne Org keine Liste.
  • REST / AgencyOS: /api/content-pool, Filter organizationId (Liste), MCP cockpit_content_pool_*.
  • Import: Noco Mietercontent; optional replicateToAllOrgsWithChain legt je Mandant ein Paket an.

Produkt-Anbindung​

  • News: Button Shop-Content bei Shop-Verknüpfung; speichert contentPoolPackageId in Metadaten.
  • Angebote / Events / DOOH: kein einheitlicher Pool-Bezug; Medien und Texte werden getrennt gepflegt.

Stärken (behalten)​

  • Ketten-Matching und Batch-Import-Pipeline (scripts/content-pool/).
  • Sichtbarkeitslogik (center_scope, Gültigkeit, aktive Filialen).
  • Rollenmodell (KAM-Schreiben, Plattform-Replikation).
  • MCP-Parität und JSON-Schema für Agenten.

Schwächen (adressieren)​

  • Keine Single Source of Truth über Mandanten hinweg.
  • Medien: Org-gebundene Mediathek-IDs passen schlecht zu globalem Katalog (Speicher-/Mandanten-Kontext).
  • Center-Scope ist org-relative („alle Ketten-Center in diesem Mandanten“), nicht „alle SMG-Center mit dieser Kette“.
  • Kanal-Enge: nur News-Picker; Angebote/Events/Signage fehlen.

Zielbild​

Architektur (logisch)​

Kernbegriffe​

BegriffBedeutung
Katalog-EintragPlattformweiter Datensatz: Kette, Titel, Text, Gültigkeit, Status, Asset-Set, optional Tags/Kampagne
VerfügbarkeitRegeln, welche Center (über Org-Grenzen) den Eintrag sehen dürfen — default: alle Center mit aktiver Filiale der Kette
ÜbernahmeRedaktion kopiert Felder in ein Center-Inhaltsobjekt und speichert Herkunft + optional Snapshot-Version
Overlay (später)Org-spezifische Abweichung (z. B. anderer Teaser), ohne den globalen Eintrag zu ändern

Nicht-Ziele (v1 Katalog)​

  • Kein Ersatz für center-lokale Redaktion (Events ohne Filialist bleiben lokal).
  • Kein automatisches Publish in alle Center ohne menschliche oder workflow-gestützte Freigabe (v1: explizite Übernahme).
  • Kein Breaking Change für bestehende News mit contentPoolPackageId in Phase 0–1.

Expand-Contract-Migration​

Prinzip: additive Schema-Schritte, bestehende Org-Pakete bleiben lesbar und nutzbar, bis Cutover.

Phase DB-A — Katalog-Schicht anlegen​

  1. Neue Tabellen (Namensvorschlag):
    • content_pool_catalog_entries — ohne organization_id (Plattform-Scope).
    • content_pool_catalog_assets — analog zu content_pool_assets, Medien über plattform-weite oder dedizierte Katalog-Medien (Bunny/CDN-URL + optional media_file_id mit klarem Owner).
    • content_pool_catalog_entry_centers — optional, wenn nicht „alle Ketten-Center SMG-weit“.
  2. Felder Katalog (Minimum): shop_chain_id, title, body_text, valid_from, valid_to, status, created_by, updated_by, Version/Zeitstempel.
  3. Erweiterung bestehender Pakete: nullable catalog_entry_id + catalog_snapshot_version auf content_pool_packages (Legacy-Link oder „materialisierte Kopie“).

Phase DB-B — Backfill​

  1. Job: Pro (shop_chain_id, normalized_title, valid_from, valid_to) gruppieren über Org-Pakete mit identischem Inhalt (Hash aus Text + Asset-URLs).
  2. Erzeugter Katalog-Eintrag; Org-Pakete zeigen per catalog_entry_id darauf.
  3. Konflikte (unterschiedlicher Text pro Org): manuelle Review-Queue im Dashboard (Plattform).

Phase DB-C — Lesepfad umschalten​

  1. Picker (News, später andere Kanäle) lesen primär Katalog, filtern nach Center/Kette/Datum.
  2. Org-Pakete ohne Katalog-Link: weiter anzeigen (Legacy).
  3. Schreibpfad: neue Einträge nur noch im Katalog (Plattform-Rollen); Org-Paket-Anlage deprecated (UI-Hinweis).

Phase DB-D — Aufräumen (optional, später)​

  • Nach Metriken/Freeze: reine Duplikat-Org-Pakete archivieren.
  • organization_id auf Paketen nur noch für Overlays oder entfernen, wenn Overlays eigene Tabelle haben.

Datenverlust: verboten — nur Archivierung/Status archived, keine harten Löschungen ohne Export.


Phasen-Roadmap​

PhaseFokusLieferung (groß)Aufwand (grob)
0 — Design & DokuAlignment SMGDiese Spec, project_specs, Changelog-Verweis bei Go-Liveerledigt (Doku)
1 — Katalog MVPFundament seit 0.1.745 (DB-A Tabellen, Liste/Anlegen, MCP list/get/create); Rest offen: DB-A/B, Plattform-UI „Globaler Katalog“CRUD Katalog, Ketten-Filter, Medien-Strategie (CDN-URL), News-Picker liest Katalog + Legacy2–3 Wochen
2 — Import & MedienNoco → Katalog statt ReplikationImport ein Ziel; Deprecation-Hinweis Replikation; Mediathek-Upload als Plattform-Asset1–2 Wochen
3 — MehrkanalAngebote, EventsGleicher Picker/Hook, Metadaten catalogEntryId, Freigabe unverändert2 Wochen
4 — DOOH / SignageAsset-AuswahlKatalog-Assets in Signage-Modul / Playlist-Bausteine, Gültigkeit respektieren2–3 Wochen
5 — Overlay & SyncOrg-AnpassungenOptionale Teaser-Overrides; „Update verfügbar“ wenn Katalog-Version neuBacklog
6 — CutoverDB-C/DLegacy-Org-Pakete read-only, MCP v2, Agenten-Hintsnach Pilot

Phase 1 — Akzeptanzkriterien (Auszug)​

  • Plattform-Rolle kann Katalog-Eintrag anlegen ohne Organisationswahl.
  • Center-Redakteur sieht im News Shop-Content Katalog-Treffer für Kette + Center + Stichtag.
  • Übernahme setzt Herkunft auf Katalog-ID; bestehende contentPoolPackageId-News funktionieren unverändert.
  • AgencyOS/MCP: cockpit_content_pool_catalog_* (list/get/create) parallel zu Legacy-Tools.

Phase 3 — Angebote & Events​

  • Gleiche Sichtbarkeitsfunktion wie News (isPackageVisibleForCenter → generisch isCatalogEntryVisibleForCenter).
  • Shop-/Ketten-Verknüpfung analog News (wo Modul Shop-Bezug hat).
  • Kein Zwang: lokale Angebote/Events ohne Katalog bleiben möglich.

Phase 4 — DOOH​

  • Katalog liefert Assets + Kurztext für Slots (Hero, Galerie-Rotation).
  • Respektiert valid_from/valid_to und Signage-only-Flags an Ziel-Inhalt, nicht am Katalog.
  • Kein Ersatz für Kampagnen-Planungstools — Materialquelle, nicht Scheduler.

API, MCP & Rechte (Ziel)​

AspektHeuteZiel
ListenorganizationId requiredKatalog: optional chainId, centerId, activeOn; Legacy: unverändert
SchreibenOrg + Rolle/KAMKatalog: SUPER_ADMIN, PLATFORM_ADMIN, dedizierte Rolle „Content-Katalog-Editor“ (festzulegen)
ImportReplikationimportTarget: catalog default für Plattform
MCPcockpit_content_pool_*+ cockpit_content_pool_catalog_*; Hints in content-pool-mcp.md

Parität: bei jeder Phase MCP-Schema, Tool-Export und AgencyOS-Doku mitliefern (mcp-parity-with-changes).


Risiken & offene Entscheidungen​

ThemaOptionenEmpfehlung
Medien-OwnerPlattform-Mediathek vs. reine CDN-URLsPlattform-Bucket + media_file_id mit organizationId = null oder SMG-System-Org
Duplikat-ErkennungTitel+Kette vs. Content-HashHash + manuelle Merge-UI bei Konflikt
FreigabeKatalog global „active“ vs. Center-FreigabeKatalog = freigegebenes Filialisten-Material; Center-Inhalt behält bestehenden Freigabe-Workflow
DSGVO / MarkenrechteNutzungsrechte pro AssetFeld rightsNote / Ablaufdatum auf Katalog-Asset (Phase 2)
PerformanceViele Center pro KetteIndex (shop_chain_id, status, valid_from, valid_to); Liste paginiert

So testen (nach Phase 1)​

  1. Katalog-Eintrag für Kette X anlegen, Status aktiv, Hero-Bild anhängen.
  2. In Org A und Org B Center mit Filiale Kette X: News → Shop-Content → derselbe Eintrag sichtbar.
  3. Legacy-Org-Paket ohne Katalog-Link weiter übernehmbar.
  4. MCP catalog_list mit centerId liefert denselben Eintrag wie UI.
  5. Import Dry-Run: eine Zeile → ein Katalog-Eintrag, keine Mandanten-Replikation.

Verwandte Doku​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /plattform/content-pool-roadmap-global