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.
| Ebene | Heute | Ziel |
|---|---|---|
| Wahrheit | Paket pro organizationId | Katalog-Eintrag plattformweit (optional Org-Overlay) |
| Sichtbarkeit | Center-Scope innerhalb einer Org | Ketten- + Center-/Mandanten-Regeln aus globalem Katalog |
| Kanäle | vor allem News (Shop-Content) | News, Angebote, Events, Signage-Playlists |
| Import | Replikation in N Mandanten | Ein 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 (
contentPoolCatalogEntryIdo. ä.). - 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
| Rolle | Heute | Ziel |
|---|---|---|
| KAM / zentrales Marketing (SMG) | Import/Replikation über Plattform-Admins | Direkte Pflege im globalen Katalog |
| Org-Marketing / Center-Admin | Pakete nur im eigenen Mandanten | Katalog durchsuchen, in Inhalte übernehmen, ggf. lokales Overlay |
| Content-Editor / Redaktion | Shop-Content → News | Übernahme in News, Angebote, Events; Signage-Auswahl |
| Signage / DOOH-Betrieb | eigene Medien oder manuell | Katalog-Assets in Playlist-/Slot-Auswahl |
| Dev / Agenten (MCP/AgencyOS) | organizationId Pflicht | Katalog-API + bestehende Org-Pakete (Übergang) |
Ist-Analyse (Stand Code & Doku Okt 2026)
Datenmodell
| Tabelle | Zweck |
|---|---|
content_pool_packages | Pflichtfeld organization_id, shop_chain_id, Titel, Text, Gültigkeit, center_scope, Status |
content_pool_assets | Medien (Mediathek-Referenz oder URL), Rolle hero/gallery/attachment |
content_pool_package_centers | Bei 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, FilterorganizationId(Liste), MCPcockpit_content_pool_*. - Import: Noco Mietercontent; optional
replicateToAllOrgsWithChainlegt je Mandant ein Paket an.
Produkt-Anbindung
- News: Button Shop-Content bei Shop-Verknüpfung; speichert
contentPoolPackageIdin 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
| Begriff | Bedeutung |
|---|---|
| Katalog-Eintrag | Plattformweiter Datensatz: Kette, Titel, Text, Gültigkeit, Status, Asset-Set, optional Tags/Kampagne |
| Verfügbarkeit | Regeln, welche Center (über Org-Grenzen) den Eintrag sehen dürfen — default: alle Center mit aktiver Filiale der Kette |
| Übernahme | Redaktion 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
contentPoolPackageIdin 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
- Neue Tabellen (Namensvorschlag):
content_pool_catalog_entries— ohneorganization_id(Plattform-Scope).content_pool_catalog_assets— analog zucontent_pool_assets, Medien über plattform-weite oder dedizierte Katalog-Medien (Bunny/CDN-URL + optionalmedia_file_idmit klarem Owner).content_pool_catalog_entry_centers— optional, wenn nicht „alle Ketten-Center SMG-weit“.
- Felder Katalog (Minimum):
shop_chain_id,title,body_text,valid_from,valid_to,status,created_by,updated_by, Version/Zeitstempel. - Erweiterung bestehender Pakete: nullable
catalog_entry_id+catalog_snapshot_versionaufcontent_pool_packages(Legacy-Link oder „materialisierte Kopie“).
Phase DB-B — Backfill
- Job: Pro
(shop_chain_id, normalized_title, valid_from, valid_to)gruppieren über Org-Pakete mit identischem Inhalt (Hash aus Text + Asset-URLs). - Erzeugter Katalog-Eintrag; Org-Pakete zeigen per
catalog_entry_iddarauf. - Konflikte (unterschiedlicher Text pro Org): manuelle Review-Queue im Dashboard (Plattform).
Phase DB-C — Lesepfad umschalten
- Picker (News, später andere Kanäle) lesen primär Katalog, filtern nach Center/Kette/Datum.
- Org-Pakete ohne Katalog-Link: weiter anzeigen (Legacy).
- 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_idauf 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
| Phase | Fokus | Lieferung (groß) | Aufwand (grob) |
|---|---|---|---|
| 0 — Design & Doku | Alignment SMG | Diese Spec, project_specs, Changelog-Verweis bei Go-Live | erledigt (Doku) |
| 1 — Katalog MVP | Fundament 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 + Legacy | 2–3 Wochen |
| 2 — Import & Medien | Noco → Katalog statt Replikation | Import ein Ziel; Deprecation-Hinweis Replikation; Mediathek-Upload als Plattform-Asset | 1–2 Wochen |
| 3 — Mehrkanal | Angebote, Events | Gleicher Picker/Hook, Metadaten catalogEntryId, Freigabe unverändert | 2 Wochen |
| 4 — DOOH / Signage | Asset-Auswahl | Katalog-Assets in Signage-Modul / Playlist-Bausteine, Gültigkeit respektieren | 2–3 Wochen |
| 5 — Overlay & Sync | Org-Anpassungen | Optionale Teaser-Overrides; „Update verfügbar“ wenn Katalog-Version neu | Backlog |
| 6 — Cutover | DB-C/D | Legacy-Org-Pakete read-only, MCP v2, Agenten-Hints | nach 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→ generischisCatalogEntryVisibleForCenter). - 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_tound Signage-only-Flags an Ziel-Inhalt, nicht am Katalog. - Kein Ersatz für Kampagnen-Planungstools — Materialquelle, nicht Scheduler.
API, MCP & Rechte (Ziel)
| Aspekt | Heute | Ziel |
|---|---|---|
| Listen | organizationId required | Katalog: optional chainId, centerId, activeOn; Legacy: unverändert |
| Schreiben | Org + Rolle/KAM | Katalog: SUPER_ADMIN, PLATFORM_ADMIN, dedizierte Rolle „Content-Katalog-Editor“ (festzulegen) |
| Import | Replikation | importTarget: catalog default für Plattform |
| MCP | cockpit_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
| Thema | Optionen | Empfehlung |
|---|---|---|
| Medien-Owner | Plattform-Mediathek vs. reine CDN-URLs | Plattform-Bucket + media_file_id mit organizationId = null oder SMG-System-Org |
| Duplikat-Erkennung | Titel+Kette vs. Content-Hash | Hash + manuelle Merge-UI bei Konflikt |
| Freigabe | Katalog global „active“ vs. Center-Freigabe | Katalog = freigegebenes Filialisten-Material; Center-Inhalt behält bestehenden Freigabe-Workflow |
| DSGVO / Markenrechte | Nutzungsrechte pro Asset | Feld rightsNote / Ablaufdatum auf Katalog-Asset (Phase 2) |
| Performance | Viele Center pro Kette | Index (shop_chain_id, status, valid_from, valid_to); Liste paginiert |
So testen (nach Phase 1)
- Katalog-Eintrag für Kette X anlegen, Status aktiv, Hero-Bild anhängen.
- In Org A und Org B Center mit Filiale Kette X: News → Shop-Content → derselbe Eintrag sichtbar.
- Legacy-Org-Paket ohne Katalog-Link weiter übernehmbar.
- MCP
catalog_listmitcenterIdliefert denselben Eintrag wie UI. - Import Dry-Run: eine Zeile → ein Katalog-Eintrag, keine Mandanten-Replikation.
Verwandte Doku
- Content Pool im Dashboard — Ist-Bedienung org-gebunden
- Content Pool MCP
- Cockpit Pflege & Stammdaten
- Signage-only Inhalte (Kanaltrennung bei Übernahme)
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /plattform/content-pool-roadmap-global