Skip to main content

Mediathek & Social-Material (Asset Hub)

Stand

Phase 1 (0.1.237 + 0.1.243): Status, Kampagne, Filter, Vorschauen und Ordner in der Mediathek. Phase 2 (Verknüpfung mit Social-Posts) folgt.

WasDie Mediathek im Cockpit (Inhalte → Mediathek) wird zur zentralen Ablage für Social-Fotos, -Videos und Dokumente — statt großer Dateimengen in Microsoft Teams.
WarumTeams eignet sich schlecht für Rohmaterial im GB-Bereich; im Cockpit liegen Medien bereits an BunnyCDN, sind centerbezogen und an Social-Editor, Website und Partner-Einreichungen angebunden.
WerSocial-Redaktion, Org-Marketing, Center-Teams (Upload), KAM (Partner-Material), IT/Betrieb (Speicher).
WoMediathek: /dashboard/content/media · Social: Social Cockpit → Post-Editor („Aus Mediathek“) · Partner: Medien-Einreichungen
So testen (heute)1) Mediathek öffnen, Datei hochladen und Ordner wählen (Shop/Event oder neuer Name). 2) Vorschau auf Karten prüfen. 3) Als Center-Login keine Dateien anderer Kunden (z. B. MEC) sehen. 4) Social → Neuer Post → Mediathek wählen.

Heute schon möglich​

  • Bilder und Videos hochladen und in News, Events, Shops und Social-Posts wiederverwenden
  • Ordner zuweisen (Shop, Event, News, …) oder einen neuen Ordner anlegen — beim Upload, in den Metadaten oder über Mehrfachauswahl „In Ordner“
  • Mandantentrennung: Ein Center sieht nur die eigenen Dateien. Dateien von Kunde A sind für Kunde B unsichtbar. Der Schalter „Geteilte an“ gilt nur für Super-Admin (alte Dateien ohne Center).
  • Partner-Material über MallCrew/Einreichungen mit Freigabe-Workflow
  • KI-Bild im Social-Editor (Bild-Assistent) — mit oder ohne eigene Fotos aus der Mediathek als Vorlage
  • Social-Bildvorlagen (Canva-Rahmen) pro Center unter Social-Kanäle; Auswahl im Post-Editor — siehe Social-Media-Freigabe → Bildvorlagen
  • Claude/MCP: Mediathek listen und hochladen (cockpit_list_media mit entityType als Ordner, cockpit_upload_media); Vorlagen: cockpit_social_templates

Bunny-CDN-Audit & Rehost (Claude / ChatGPT via MCP)​

WasAgenten können prüfen, ob Mediathek-Dateien wirklich auf Bunny CDN liegen — und externe URLs nach Bunny spiegeln inkl. DB-Update (url, cdnUrl, cdnPath, isCdnFile).
WarumAlte Imports oder Fremd-URLs brechen auf der Website oder in Social; alles soll wie Dashboard-Uploads unter centers/{centerId}/general/… liegen.
WerRedaktion mit MCP-Zugang, SMG Coding Agents, Integrations-Team.
WoAgencyOS POST …/media/bunny-audit und POST …/media/rehost-external · MCP cockpit_audit_media_bunny, cockpit_rehost_external_media
So testen1) In Claude: „Prüfe die Mediathek von Center … auf Bunny.“ 2) Tool cockpit_audit_media_bunny mit centerId — summary.external_url ansehen. 3) „Rehost dry run“ mit cockpit_rehost_external_media (dryRun: true). 4) Nach Freigabe: gleiches Tool mit dryRun: false (max. 20 Dateien pro Aufruf).

Beispiel-Prompts (Deutsch):

  • „Audit: Liegen alle Medien von Center {centerId} auf Bunny? Zeig mir externe URLs.“
  • „Rehost die externen Medien von Center {centerId} — erst Dry-Run, dann anwenden.“
  • „Rehost MediaFile-IDs … auf Bunny (dry run).“

Details: AgencyOS API — Mediathek.

Alt-Text für Bilder (SEO & Barrierefreiheit)​

WasJedes Bild in der Mediathek kann einen Alt-Text bekommen — eine kurze Beschreibung für Screenreader und Suchmaschinen. Dazu gibt es einen Button KI-Vorschlag.
WarumDie SEO-Prüfung hat gezeigt: Bilder hatten bisher kein eigenes Alt-Feld; es wurden Titel oder Dateiname verwendet.
WerRedaktion und Center-Betrieb mit Zugriff auf die Mediathek.
WoInhalte → Mediathek → Datei → Metadaten bearbeiten → Feld Alt-Text.
So testen1) Bild in der Mediathek bearbeiten. 2) KI-Vorschlag klicken — der Text erscheint im Feld, ohne gespeichert zu werden. 3) Text prüfen oder ändern, Speichern. 4) Feld leeren und speichern: der Alt-Text ist wieder entfernt.
BetriebDer KI-Vorschlag nutzt die im Cockpit hinterlegte OpenAI-Konfiguration (Bild-fähiges Modell); ohne Konfiguration erscheint eine Fehlermeldung.

Kein Datenverlust: Bestehende Bilder behalten ihre Daten; das Alt-Feld ist zunächst leer. Es wird nichts automatisch befüllt oder überschrieben. Solange kein Alt-Text gepflegt ist, wird wie bisher der Titel (sonst der Dateiname) als Fallback genutzt — im Dialog steht dann „Titel wird als Fallback genutzt“.

Empfehlung: höchstens 125 Zeichen, nur beschreiben, was zu sehen ist, nicht mit „Bild von“ beginnen.

Agenten (MCP/AgencyOS): cockpit_list_media liefert altText (gepflegt oder leer) und altTextResolved (wirksam, inkl. Fallback); setzen oder entfernen mit cockpit_update_media_alt_text. Der Content Pool liefert pro Asset den wirksamen Alt-Text.

→ Damit Bilder auf Center-Websites barrierefrei und für Suchmaschinen verständlich sind, ohne dass bestehende Daten angefasst werden.

Geplant — in vier Phasen​

Phase 1 — Mediathek als Standard-Ablage​

  • Status pro Datei: Rohmaterial → Bereit → In Bearbeitung → Veröffentlicht → Archiv
  • Filter nach Status, Kampagne/Thema, Dateityp
  • Teams-Regel: Dateien ins Cockpit, in Teams nur noch Links und Abstimmung

→ Damit das Social-Team Material zentral findet, ohne von Teams-Ordnern abhängig zu sein.

Phase 2 — Verknüpfung mit Posts​

  • Beim Social-Post wird das Medium fest mit der Mediathek-Datei verknüpft (nicht nur URL)
  • Anzeige „Verwendet in …“ an der Datei
  • Filter „Noch nicht veröffentlicht“
  • Kalender/Planner zeigt geplante Posts mit zugehörigen Assets
  • Agenten (Claude): Social-Entwurf aus Mediathek anlegen (Freigabe wie gewohnt)

→ Damit Wiederholungen reduziert werden und vorhandenes Material besser ausgeschöpft wird.

Phase 3 — Intelligente Suche​

  • Automatische Schlagwörter (KI) für Bilder/Videos
  • Suche z. B. „ungenutzte Fotos Weihnachten“ oder „Videos mit Team“
  • Vorschläge: passendes Material zu geplanten Beiträgen

→ Damit große Rohmaterial-Mengen ohne manuelle Ordnerpflege durchsuchbar sind.

Phase 4 — optional (später)​

  • Automatische Kurzclips aus Langvideos, plattformspezifische Zuschnitte
  • Erweiterte KI-Bearbeitung echter Fotos

→ Nur wenn Phase 1–3 im Alltag sitzen und der Mehrwert den Aufwand rechtfertigt.

Zusammenspiel mit anderen Modulen​

ModulRolle
Social Media FreigabeVeröffentlichung, Freigabe — bleibt unverändert im Cockpit
Partner-Medien-EinreichungenZufluss von Mieter-Material → Mediathek
Content PlannerTerminübersicht; ab Phase 2 enger mit Assets verknüpft
Claude & MCPLesen/Schreiben Mediathek; Social-Entwürfe ab Phase 2 erweiterbar

Betrieb​

  • Medien liegen auf BunnyCDN (skalierbar für Video)
  • Keine Secrets in der Mediathek — Upload nur mit Cockpit-Login
  • Archiv- und Speicher-Richtlinien mit IT abstimmen (besonders Rohvideo)
  • Schema: media_files.workflow_status, campaign_label, usage_notes — Migration 20260903140000_add_media_file_workflow_SAFE.sql. Fehlen die Spalten, schlagen Speichern und Liste fehl (Upload kann trotzdem auf Bunny landen). Anwenden: pnpm db:migrate:media-workflow (steht auch in db-push-render.sh).

Technische Detail-Spec (Team)​

Interne Epic-Spec im Repo: docs/MEDIATHEK-SOCIAL-ASSET-HUB-EPIC.md (User Stories, Schema-Skizze, MCP-Plan).

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/dashboard/mediathek-social-asset-hub