v0 — Content-Kanäle (Signage/Companion-only)
Status: Feld
signageCompanionOnlyist 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
| Frontend | Endpunkte | Filter |
|---|---|---|
| Center-Website | aktuelles-bundle, …/news?published=true, …/events, …/offers, …/jobs | Ausblenden: signageCompanionOnly === true (nach Rollout); heute: kein Feld — siehe Workarounds |
| Signage / Kiosk / Stele | signage-surface, …/news?forSignage=true, ggf. dedizierte Content-Aggregation | Einblenden: signage-only-Items |
| Companion / NOW! | aktuelles-bundle, center-overview, hotpicks, signage-surface | Signage-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
| Inhalt | Endpunkt |
|---|---|
| Aktuelles gemischt | GET /api/centers/{centerId}/aktuelles-bundle |
| News | GET /api/centers/{centerId}/news?published=true |
| Events | GET /api/centers/{centerId}/events |
| Angebote | GET /api/centers/{centerId}/offers |
| Jobs | GET /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
| Phase | Verhalten |
|---|---|
| Heute | Nur News mit showOnSignage: true |
| Nach P1 | Auch 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
| Zone | Endpunkt | Filter |
|---|---|---|
| Home / Heute | GET /api/center-overview?centerId={uuid} | Signage-only in today.* einschließen (nach Rollout) |
| Highlights | GET /api/centers/{centerId}/hotpicks | Hot Pick kanalisiert über channels; referenzierter Content kann signage-only sein |
| NOW! Exklusiv | GET /api/centers/{centerId}/aktuelles-bundle?forToGo=true | Nur toGoExclusive: true — nicht dasselbe wie signage-only |
| Allgemeiner Feed | aktuelles-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:
| Workaround | Grenzen |
|---|---|
toGoExclusive | Schließ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 channels | Kuratiert Links, steuert nicht automatisch Underlying-Content auf Website |
| Hardcoded ID-Listen in v0 | Nicht empfohlen — bricht bei Redaktionsänderungen |
Empfehlung bis P0:
- Website: weiter
aktuelles-bundleohne Extra-Filter (alles Veröffentlichte außertoGoExclusive). - Stele:
news?forSignage=truefür explizite Stele-News. - Keine falsche Semantik —
toGoExclusivenicht für reine Kinowerbung missbrauchen, wenn Inhalt auch auf Signage (nicht NOW) laufen soll. - 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?: booleanerweitern - Keine Secrets;
centerIdaus Handoff/URL — nie hardcoden
Verwandte Dokumentation
- Public Center-Website API — Vertrag — Query-Parameter
forToGo,forSignage, Aktuelles-Bundle - Signage/Companion-only — Technische Spezifikation — DB, Dashboard, MCP, Rollout
- Cockpit steuert Frontends — Architektur Source of Truth
- Feature-Katalog — Aktuelles-Hub pro Template
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /center-website/v0-content-channels-signage-only