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
sourceloggen; Farben separat laut v0-Handoff Idle & Farben. - Besucher: Sehen im Leerlauf Werbung; Bedienung der Stele unverändert.
Wo
| Thema | Pfad im Dashboard |
|---|---|
| screenCockpit verbinden | Digital Experience → DOOH Video → Karte screenCockpit |
| Idle-Quelle & Playlist | DOOH Video → Idle-Quelle des Kiosks |
| DOOH am Kiosk aktivieren | Digital Experience → Signage → Stele → Reiter Idle & DOOH (enableDoohIdle) |
| Farben & Hintergrund | Signage → 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üfpunkt | Erwartung |
|---|---|---|
| A1 | screenCockpit-Standort verbunden | Karte screenCockpit zeigt Status Verbunden |
| A2 | API-Key mit playlists:read (oder content:push) | Playlist-Liste unter DOOH Video sichtbar; sonst neu verbinden |
| A3 | Advertiser-/Idle-Playlist in screenCockpit | Enthält abspielbare VIDEO- und/oder IMAGE-Items (keine reinen Website-/Vorlagen-Slots für den Kiosk) |
| A4 | Stele-URL | Kiosk mit gültiger ?display={touchscreenId} (UUID der Stele) |
| A5 | enableDoohIdle | Im Reiter Idle & DOOH aktiv |
| A6 | v0-Signage-Preview-Host | Unter 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. |
| A7 | Dashboard 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. | Befehl | Erwartung (ab 0.1.784) |
|---|---|---|
| D1 | curl -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) |
| D2 | curl -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: * |
| D3 | Optional: GET …/centers/by-domain?domain=petersbogen-signage.sawatzkimuehlenbruch-preview.de | success: 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. | Schritt | Erwartung |
|---|---|---|
| B1 | Idle-Quelle des Kiosks → screenCockpit-Playlist wählen, Playlist speichern | Speichern ohne Fehler |
| B2 | API (Browser oder Tool): GET /api/centers/{centerId}/dooh/active | Feld source: "screencockpit"; playlist.items mit URLs und Laufzeiten |
| B3 | Stele: Ruhezeit abwarten (Timeout laut Signage-Optionen, typisch 30–120 s) | Werbe-Clips aus der gewählten Playlist laufen |
| B4 | In screenCockpit Clip tauschen oder Reihenfolge ändern | Nach spätestens ~30 s (Kurz-Cache) sichtbar am Kiosk |
| B5 | Fallback: Verbindung trennen oder ungültige Playlist | source "cockpit"; Kiosk spielt cockpitOS-Playlist idle — kein schwarzer Bildschirm |
| B6 | Quelle zurück auf cockpitOS-Playlist | Verhalten 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. | Schritt | Erwartung |
|---|---|---|
| C1 | Reiter Farben & Verlauf → z. B. Hot Picks-Hintergrund in Farben (erweitert) setzen, speichern | GET …/signage-template-options?template=ai-premium enthält kiosk.colorTokens.* |
| C2 | Optional: Abdunklungsfarbe (overlayColor) + Abdunklung (%) am Hintergrund-Medium | API liefert backgroundMedia.overlayColor (Default #000000 wenn nicht gesetzt) |
| C3 | Stele visuell prüfen | Wenn v0 noch ohne colorTokens/overlayColor: Farben am Gerät unverändert — das ist erwartbar, kein Cockpit-Defekt |
| C4 | Nach v0-Release mit Farben-Parität | Gesetzte 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)
- A1–A7 abhaken (A6 Signage-URL, A7/D1–D2 CORS-Smoke).
- B1–B3 am Gerät; bei Problemen B5 (Fallback) und Key-Berechtigung prüfen.
- C1–C2 in der API; C3 dokumentieren („Farben warten auf v0“), wenn nötig C4 nach v0-Deploy wiederholen.
- 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: /digital-signage/petersbogen-pilot-checkliste