Mediathek & Social-Material (Asset Hub)
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.
| Was | Die Mediathek im Cockpit (Inhalte → Mediathek) wird zur zentralen Ablage für Social-Fotos, -Videos und Dokumente — statt großer Dateimengen in Microsoft Teams. |
| Warum | Teams 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. |
| Wer | Social-Redaktion, Org-Marketing, Center-Teams (Upload), KAM (Partner-Material), IT/Betrieb (Speicher). |
| Wo | Mediathek: /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_mediamitentityTypeals Ordner,cockpit_upload_media); Vorlagen:cockpit_social_templates
Bunny-CDN-Audit & Rehost (Claude / ChatGPT via MCP)
| Was | Agenten 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). |
| Warum | Alte Imports oder Fremd-URLs brechen auf der Website oder in Social; alles soll wie Dashboard-Uploads unter centers/{centerId}/general/… liegen. |
| Wer | Redaktion mit MCP-Zugang, SMG Coding Agents, Integrations-Team. |
| Wo | AgencyOS POST …/media/bunny-audit und POST …/media/rehost-external · MCP cockpit_audit_media_bunny, cockpit_rehost_external_media |
| So testen | 1) 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)
| Was | Jedes Bild in der Mediathek kann einen Alt-Text bekommen — eine kurze Beschreibung für Screenreader und Suchmaschinen. Dazu gibt es einen Button KI-Vorschlag. |
| Warum | Die SEO-Prüfung hat gezeigt: Bilder hatten bisher kein eigenes Alt-Feld; es wurden Titel oder Dateiname verwendet. |
| Wer | Redaktion und Center-Betrieb mit Zugriff auf die Mediathek. |
| Wo | Inhalte → Mediathek → Datei → Metadaten bearbeiten → Feld Alt-Text. |
| So testen | 1) 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. |
| Betrieb | Der 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
| Modul | Rolle |
|---|---|
| Social Media Freigabe | Veröffentlichung, Freigabe — bleibt unverändert im Cockpit |
| Partner-Medien-Einreichungen | Zufluss von Mieter-Material → Mediathek |
| Content Planner | Terminübersicht; ab Phase 2 enger mit Assets verknüpft |
| Claude & MCP | Lesen/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— Migration20260903140000_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 indb-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