Skip to main content

Petersbogen — Pilot-Checkliste (Idle & Farben)

Was​

Abgestimmte Prüfliste für den Pilot am Petersbogen: Touch-Stele (v0) soll im Ruhemodus optional Werbung aus screenCockpit zeigen, während Redaktion und IT die Einstellungen im Cockpit vornehmen. Zusätzlich können Farben (erweitert) und Abdunklungsfarbe im Dashboard gepflegt werden — sichtbar an der Stele erst, wenn v0 die Felder auswertet.

Warum​

Clips liegen in screenCockpit bereits für Wand-Player; der Kiosk soll dieselbe Advertiser-Playlist im Idle nutzen können, ohne Doppel-Upload in cockpitOS. Die Checkliste verhindert, dass ein fehlender v0-Stand oder ein vergessener Schalter als Cockpit-Fehler interpretiert wird.

Wer ist betroffen​

  • Redaktion / Center-Betrieb: Idle-Quelle, Playlist, DOOH-Schalter, Farben pflegen.
  • IT / Betrieb: screenCockpit-Verbindung, Key-Berechtigungen, Stele-URL mit ?display=.
  • v0 / QA: Netzwerk-Tab, optional source loggen; Farben separat laut v0-Handoff Idle & Farben.
  • Besucher: Sehen im Leerlauf Werbung; Bedienung der Stele unverändert.

Wo​

ThemaPfad im Dashboard
screenCockpit verbindenDigital Experience → DOOH Video → Karte screenCockpit
Idle-Quelle & PlaylistDOOH Video → Idle-Quelle des Kiosks
DOOH am Kiosk aktivierenDigital Experience → Signage → Stele → Reiter Idle & DOOH (enableDoohIdle)
Farben & HintergrundSignage → Stele → Reiter Farben & Verlauf (Basis, Farben (erweitert), Hintergrund inkl. Abdunklung)

Hintergrund: DOOH & Signage — Zuständigkeiten (Abschnitt Kiosk-Idle aus screenCockpit).


Checkliste A — Voraussetzungen​

Nr.PrüfpunktErwartung
A1screenCockpit-Standort verbundenKarte screenCockpit zeigt Status Verbunden
A2API-Key mit playlists:read (oder content:push)Playlist-Liste unter DOOH Video sichtbar; sonst neu verbinden
A3Advertiser-/Idle-Playlist in screenCockpitEnthält abspielbare VIDEO- und/oder IMAGE-Items (keine reinen Website-/Vorlagen-Slots für den Kiosk)
A4Stele-URLKiosk mit gültiger ?display={touchscreenId} (UUID der Stele)
A5enableDoohIdleIm Reiter Idle & DOOH aktiv
A6v0-Signage-Preview-HostUnter Website → Frontend-Kanäle ist signagePublicUrl gesetzt (z. B. https://petersbogen-signage.sawatzkimuehlenbruch-preview.de). Hostname ≠ {center-slug}.sawatzkimuehlenbruch-preview.de — sonst schlägt by-domain fehl, CORS allein reicht nicht.
A7Dashboard 0.1.784+ (CORS)Browser-Calls von der Preview-Origin auf dooh/active und handoff-sessions ohne CORS-Fehler (Smoke unten)

Checkliste D — CORS-Smoke (Preview-Origin)​

Ersetze {centerId} durch die Petersbogen-UUID und ORIGIN durch die echte v0-Signage-URL (A6).

Nr.BefehlErwartung (ab 0.1.784)
D1curl -sS -D - -o /dev/null -X OPTIONS 'https://dashboard.cockpit-os.de/api/public/handoff-sessions' -H "Origin: $ORIGIN" -H 'Access-Control-Request-Method: POST'HTTP 200 und access-control-allow-origin (* oder $ORIGIN)
D2curl -sS -D - -o /dev/null 'https://dashboard.cockpit-os.de/api/centers/{centerId}/dooh/active?slug=idle' -H "Origin: $ORIGIN"HTTP 200 und access-control-allow-origin: *
D3Optional: GET …/centers/by-domain?domain=petersbogen-signage.sawatzkimuehlenbruch-preview.desuccess: true, wenn A6 gesetzt — sonst bewusst 404 (Slug-Konvention passt nicht)

Hinweis: isStagingWebsiteOrigin erkennt *.sawatzkimuehlenbruch-preview.de (inkl. petersbogen-signage…) — seit 0.1.784 über Middleware/api-cors-origin für Signage-APIs.


Checkliste B — Idle aus screenCockpit​

Nr.SchrittErwartung
B1Idle-Quelle des Kiosks → screenCockpit-Playlist wählen, Playlist speichernSpeichern ohne Fehler
B2API (Browser oder Tool): GET /api/centers/{centerId}/dooh/activeFeld source: "screencockpit"; playlist.items mit URLs und Laufzeiten
B3Stele: Ruhezeit abwarten (Timeout laut Signage-Optionen, typisch 30–120 s)Werbe-Clips aus der gewählten Playlist laufen
B4In screenCockpit Clip tauschen oder Reihenfolge ändernNach spätestens ~30 s (Kurz-Cache) sichtbar am Kiosk
B5Fallback: Verbindung trennen oder ungültige Playlistsource "cockpit"; Kiosk spielt cockpitOS-Playlist idle — kein schwarzer Bildschirm
B6Quelle zurück auf cockpitOS-PlaylistVerhalten wie vor dem Pilot

Hinweis v0: Der Kiosk ruft weiter nur dooh/active auf — kein screenCockpit im Browser. Details: v0-Handoff Idle & Farben.


Checkliste C — Farben (Cockpit vs. Stele)​

Nr.SchrittErwartung
C1Reiter Farben & Verlauf → z. B. Hot Picks-Hintergrund in Farben (erweitert) setzen, speichernGET …/signage-template-options?template=ai-premium enthält kiosk.colorTokens.*
C2Optional: Abdunklungsfarbe (overlayColor) + Abdunklung (%) am Hintergrund-MediumAPI liefert backgroundMedia.overlayColor (Default #000000 wenn nicht gesetzt)
C3Stele visuell prüfenWenn v0 noch ohne colorTokens/overlayColor: Farben am Gerät unverändert — das ist erwartbar, kein Cockpit-Defekt
C4Nach v0-Release mit Farben-ParitätGesetzte Tokens und Overlay am Gerät sichtbar; Orientierungs-Overrides (Hoch/Quer) wie im Dashboard

Referenz Petersbogen-Werte (Beispiel aus alter App): AI Premium v0-Parität — colorTokens.


So testen (Kurz)​

  1. A1–A7 abhaken (A6 Signage-URL, A7/D1–D2 CORS-Smoke).
  2. B1–B3 am Gerät; bei Problemen B5 (Fallback) und Key-Berechtigung prüfen.
  3. C1–C2 in der API; C3 dokumentieren („Farben warten auf v0“), wenn nötig C4 nach v0-Deploy wiederholen.
  4. Ergebnis kurz festhalten: CORS ok / Idle ok / Fallback ok / Farben API ok / Stele-Farben offen.

Betrieb​

  • Keine zusätzlichen Env-Variablen für Idle-Quelle (bestehendes Pairing reicht).
  • Wand-Player bleiben in screenCockpit; diese Checkliste betrifft nur den Touch-Kiosk.
  • Geplanter Ausbau Content-Push Cockpit → screenCockpit: Epic PR-2 in project_specs.md (noch nicht produktiv).

Siehe auch​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/digital-signage/petersbogen-pilot-checkliste