Zum Hauptinhalt springen

v0 — Content-Kanäle (Signage/Companion-only)

Status: Feld signageCompanionOnly ist geplant (Spec WIP). Diese Seite beschreibt Zielverhalten und den Ist-Stand bis zur Cockpit-Lieferung.
Spec: Signage/Companion-only — Technische Spezifikation
API-Vertrag: Public Center-Website API — Vertrag


Kurzfassung für v0​

FrontendEndpunkteFilter
Center-Websiteaktuelles-bundle, …/news?published=true, …/events, …/offers, …/jobsAusblenden: signageCompanionOnly === true (nach Rollout); heute: kein Feld — siehe Workarounds
Signage / Kiosk / Stelesignage-surface, …/news?forSignage=true, ggf. dedizierte Content-AggregationEinblenden: signage-only-Items
Companion / NOW!aktuelles-bundle, center-overview, hotpicks, signage-surfaceSignage-only einschließen; NOW-Exklusiv weiter über toGoExclusive

Goldene Regel: Cockpit ist Source of Truth — nicht Kanäle im v0-Repo hardcoden.


Discovery (immer zuerst)​

GET https://dashboard.cockpit-os.de/api/centers/{centerId}/public-visitor-surface

Relevante Hints in data.apiHints (Namen können leicht variieren):

  • Aktuelles-Bundle
  • News / Events / Offers / Jobs
  • Hot Picks
  • Signage Surface

Für Signage/Kiosk zusätzlich:

GET https://dashboard.cockpit-os.de/api/centers/{centerId}/signage-surface

Details: Public Center-Website API — Vertrag.


Website (Center-Website v0)​

Primäre Endpunkte​

InhaltEndpunkt
Aktuelles gemischtGET /api/centers/{centerId}/aktuelles-bundle
NewsGET /api/centers/{centerId}/news?published=true
EventsGET /api/centers/{centerId}/events
AngeboteGET /api/centers/{centerId}/offers
JobsGET /api/centers/{centerId}/jobs

Standard-Query wie im API-Vertrag: status=Aktiv wo vorgesehen, kein forToGo auf der Website.

Filter nach Rollout (P0+)​

function isVisibleOnWebsite(item: { signageCompanionOnly?: boolean; toGoExclusive?: boolean }) {
if (item.signageCompanionOnly === true) return false;
if (item.toGoExclusive === true) return false;
return true;
}

// Beispiel Aktuelles
const bundle = await fetchAktuellesBundle(centerId);
const news = bundle.data.news.filter(isVisibleOnWebsite);
const events = bundle.data.events.filter(isVisibleOnWebsite);
const offers = bundle.data.offers.filter(isVisibleOnWebsite);
const jobs = bundle.data.jobs.filter(isVisibleOnWebsite);

Einzel-Detailseiten: Wenn Cockpit bei signage-only-Items 404 liefert, kein Fallback auf gecachte Listen. Deep-Links von Hot Picks prüfen.

Response-Feld (nach Rollout)​

{
"id": "…",
"title": "Kinowerbung KW 12",
"signageCompanionOnly": true,
"toGoExclusive": false,
"showOnSignage": false
}

Auf der Website sollte dieser Eintrag nicht erscheinen (Cockpit filtert serverseitig; v0-Filter ist Defense-in-depth).


Signage / Kiosk / Stele​

Konfiguration​

GET /api/centers/{centerId}/signage-surface

Layout, Farben, Companion-Optionen — keine Ersatz-Content-Liste; Inhalte weiter über Content-APIs.

News auf der Stele (heute + Ziel)​

GET /api/centers/{centerId}/news?published=true&forSignage=true
PhaseVerhalten
HeuteNur News mit showOnSignage: true
Nach P1Auch News mit signageCompanionOnly: true (ohne showOnSignage setzen zu müssen)

Events / Angebote / Jobs auf Signage​

Heute: gleiche Center-Routen wie Website, ohne forSignage-Filter bei Events/Offers/Jobs.

Nach Rollout: Signage-Apps sollten Inhalte laden mit:

GET /api/centers/{centerId}/aktuelles-bundle?includeSignageCompanionOnly=true

(Parameter-Name laut Spec — bis Implementierung: Bundle + clientseitig signageCompanionOnly === true behalten, Website-Items zusätzlich anzeigen.)

Optional nur Signage-only-Teaser:

GET /api/centers/{centerId}/aktuelles-bundle?forSignageCompanion=true

Companion / NOW!-App​

ZoneEndpunktFilter
Home / HeuteGET /api/center-overview?centerId={uuid}Signage-only in today.* einschließen (nach Rollout)
HighlightsGET /api/centers/{centerId}/hotpicksHot Pick kanalisiert über channels; referenzierter Content kann signage-only sein
NOW! ExklusivGET /api/centers/{centerId}/aktuelles-bundle?forToGo=trueNur toGoExclusive: true — nicht dasselbe wie signage-only
Allgemeiner Feedaktuelles-bundle (ohne Website-Ausschluss in Companion)signageCompanionOnly behalten; toGoExclusive nach UX trennen

Wichtig: toGoExclusive = NOW! Exklusiv (App-Badge). signageCompanionOnly = Website opt-out, Signage/Companion opt-in. Beide können parallel gesetzt sein — UI getrennt darstellen.

Siehe auch: v0 Companion Sidebar Briefing (Repo-intern).


Beispiel-JSON (Zielbild)​

Website-Bundle (Auszug)​

{
"success": true,
"data": {
"news": [
{
"id": "n1",
"title": "Neuer Shop eröffnet",
"signageCompanionOnly": false,
"toGoExclusive": false,
"showOnSignage": false
}
],
"events": [],
"offers": [],
"jobs": []
}
}

(Eintrag mit "signageCompanionOnly": true erscheint hier nicht.)

Signage-Consumer (gleiche API, anderer Kontext)​

{
"id": "n2",
"title": "Kinospot März",
"signageCompanionOnly": true,
"toGoExclusive": false,
"showOnSignage": false
}

Was v0 heute tun kann (Workarounds)​

Bis Cockpit signageCompanionOnly liefert, gibt es kein einheitliches Website-Opt-out:

WorkaroundGrenzen
toGoExclusiveSchließt von Website-Bundle aus, zielt aber auf NOW!-Exklusiv, nicht Signage/Kiosk allgemein
showOnSignage (News)Nur Opt-in Stele — News bleibt auf Website sichtbar
contentCategorySlug (z. B. kinowerbung)Website kann Kategorie ausblenden — hacky, nicht kanalneutral, gilt nicht für Events/Jobs
Hot Picks channelsKuratiert Links, steuert nicht automatisch Underlying-Content auf Website
Hardcoded ID-Listen in v0Nicht empfohlen — bricht bei Redaktionsänderungen

Empfehlung bis P0:

  1. Website: weiter aktuelles-bundle ohne Extra-Filter (alles Veröffentlichte außer toGoExclusive).
  2. Stele: news?forSignage=true für explizite Stele-News.
  3. Keine falsche Semantik — toGoExclusive nicht für reine Kinowerbung missbrauchen, wenn Inhalt auch auf Signage (nicht NOW) laufen soll.
  4. Nach Cockpit-Deploy: serverseitigen Filter nutzen + v0 Defense-in-depth.

Checkliste nach Rollout​

  • Website: signageCompanionOnly-Items aus Listen, Hero, Sitemap-Generierung filtern
  • Signage: signage-only-Items in Rotations-Feeds / Kiosk-Module laden
  • Companion: signage-only in „Heute im Center“ / Teaser; getrennt von NOW! Exklusiv
  • Detail-URLs: 404/leer behandeln, wenn API Item nicht liefert
  • Types/Interfaces in v0 um optionales signageCompanionOnly?: boolean erweitern
  • Keine Secrets; centerId aus Handoff/URL — nie hardcoden

Verwandte Dokumentation​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /center-website/v0-content-channels-signage-only