Skip to main content

Agnes Kiosk — v0-Prompt (Idle & DOOH)

Ziel: v0-Layout für Agnes-Galerien (defaultSignageTemplate = agnes-kiosk) — schlanker interaktiver Kiosk mit Companion-Shell nach QR-Scan, optional konfigurierbarem Idle & DOOH-Modus.

Referenz-Verhalten: React-Template AIPremiumKioskShell.tsx (AI-Premium-Familie). Agnes nutzt dieselbe Options-Schema und Datenpipeline — reduzierte Module-Defaults, Companion-Shell konfigurierbar, ohne Einbettungen.

Verwandt: AI Premium v0-Parität · DOOH-Modus im Kiosk · v0 Config-Vertrag


Dashboard-Steuerung (Cockpit 0.1.398+)​

ReiterAgnes Kiosk
Darstellung, Farben, Medien, Module, Wayfinding, Bezeichnungensichtbar
Idle & DOOHsichtbar (seit 0.1.398)
Companion (Template)sichtbar (seit 0.1.617) — Shell nach QR-Scan
Einbettungenausgeblendet

Speicher: signageTemplateOptions['agnes-kiosk'].kiosk und .companion

API (öffentlich):

GET /api/centers/{centerId}/signage-surface
GET /api/centers/{centerId}/signage-template-options?template=agnes-kiosk
GET /api/centers/{centerId}/dooh/active
GET /api/centers/{centerId}/dooh/active?slug={playlistSlug}

Preset-Defaults (wenn Redaktion nichts ändert):

FeldAgnes-DefaultBedeutung
enableDoohIdlefalseDOOH-Ruhebildschirm — in Reiter Module aktivieren
idleTimeoutSeconds45Sekunden ohne Touch bis Idle-Aktion (30–120)
doohPersistentSlotBelowHeaderfalseKein dauerhafter 16:9-Slot unter dem Header
enableDoohIdleFullscreenOverlayfalseVollbild-DOOH nach Timeout (typisch: mit enableDoohIdle an)
enableHandoffQr / enableHandoffQrIdlefalseKein Handoff-QR (Agnes ohne Companion)
enableFood, enableHighlights, enableNearby, enableGroupSessionfalseReduziertes Modul-Set
enableServices, enableOffers, enableA11ytrueKern-Module Agnes

Zwei Idle-Ebenen (nicht verwechseln)​

EbeneSteuerungZweck
Datenschutz-Reset (~90 s)UX-Vorgabe (Teil H)Suche, Route, offene Overlays und Session-Zustand löschen — nächster Besucher sieht nichts vom Vorgänger
DOOH-IdleenableDoohIdle + idleTimeoutSeconds + Reiter Idle & DOOHNach konfiguriertem Timeout: Startseite + optional Vollbild-DOOH-Slideshow

Ablauf bei aktivem DOOH (enableDoohIdle === true):

  1. Besucher bedient den Kiosk interaktiv (Shops, Centerplan, Services, Aktuelles).
  2. Keine Berührung für idleTimeoutSeconds (Dashboard, Standard 45 s).
  3. Zuerst: Kiosk-Zustand auf Startseite zurücksetzen (kiosk-home) — alle Overlays, Route, Suche schließen.
  4. Dann: Wenn aktive Idle-Playlist existiert (GET …/dooh/active, Slug idle) → Vollbild-DOOH einblenden (Slideshow/Video).
  5. Berührung (irgendwo am Screen oder Button „Kiosk aktivieren“): DOOH verlassen, Startseite anzeigen, Idle-Timer neu starten.

Datenschutz unabhängig von DOOH: Auch wenn enableDoohIdle === false, nach ~90 s Inaktivität interaktive Session-Daten zurücksetzen (Teil H). Der kürzere idleTimeoutSeconds-Timer kann denselben Reset auslösen — wichtig ist, dass Route/Suche/Overlays spätestens vor dem nächsten Besucher weg sind.

Referenz AI Premium: Gleiche Logik in AIPremiumKioskShell.tsx — resetKioskState() beim Timeout, danach setIsIdle(true) wenn Playlist vorhanden und enableDoohIdle aktiv.


Inhaltsquellen​

Interaktiver Kiosk (signage-surface + public-visitor-surface)​

BereichQuelleToggle
Shopspublic-visitor-surface → Shops / apiHints—
ServicesservicesenableServices
News, Events, Angebotenews?published=true, Aktuelles-BundleenableOffers, showFeaturedNews
Centerplan / WayfindingFloors, signage-display-config?displayId=wayfindingSource, force2DMap, …
Mood / HerotemplateOptions.kiosk: heroMedia, heroImageFocus (CSS object-position, Default Agnes 70% 50%), bentoWelcomeMood, bentoMoodCards, bentoQuickLinkMoodsMedien-Reiter
Hot PickshotpicksenableHighlights (Agnes-Default: aus)

DOOH-Ruhebildschirm​

QuelleAPIHinweis
Idle-PlaylistGET …/dooh/active (Slug idle)Digital Experience → DOOH Video — Playlist aktiv + Items
Grid-Mood (optional)bentoQuickLinkMoods.* aus surfaceNur wenn enableGridMoodMedia — Mood aus Medien & Mood, kein DOOH für Grid
Local HeroDashboard DOOH-BereichIn AI-Premium-Kiosk kein separater Local-Hero-Balken — nur Playlist-Items

Playlist-Item-Typen: VIDEO, IMAGE, SLIDESHOW, IFRAME — Wiedergabe über @mall-os/ui DoohSlot (Referenz Monorepo).

Nicht für Signage-Kiosk: dooh/public/active — nur Center-Website-Kanal bei websiteEnabled.


Copy-Paste: v0 Chat-Prompt (Agnes Kiosk + DOOH)​

cockpitOS — Agnes Kiosk (agnes-kiosk) + Idle/DOOH

TEMPLATE & API
- defaultSignageTemplate: agnes-kiosk (configProfile ai-premium-family)
- Primär: GET …/signage-surface → templateOptions.kiosk (gemergte Defaults)
- Ergänzend: GET …/public-visitor-surface (Shops, News, apiHints)
- Stele: ?touchscreenId={uuid} → GET …/signage-display-config?displayId=
- Template-Optionen: GET …/signage-template-options?template=agnes-kiosk
- KEIN Companion, KEIN Handoff-QR (enableHandoffQr Default false)

INTERAKTIVER KIOSK (Module aus surface — nie hardcoden)
- enableServices, enableOffers, enableA11y, enableBottomQuickMenu: Agnes-Defaults an
- enableFood, enableHighlights, enableNearby, enableGroupSession, enableAiSearch, enableHandoffQr: Agnes-Defaults aus
- Agnes-Farben: accentColor, colors, quickLinkColors aus templateOptions.kiosk
- Inhalte: shops, services, news (published), heroMedia/bentoMood* aus kiosk-Optionen
- Centerplan-Hero, Etage aus touchscreens/display-config — nicht hardcoden

DATENSCHUTZ-IDLE (~90 s, Teil H)
- Nach ~90 s ohne Interaktion: Suche, Route, Overlays, Shop-Detail schließen → Startseite
- Nächster Besucher darf keine Session des Vorgängers sehen
- Unabhängig davon, ob DOOH aktiv ist

DOOH-IDLE (nur wenn enableDoohIdle === true aus surface)
- Toggle: Reiter Module → „Idle + DOOH Werbeslot“ (Default Agnes: false — live aus API lesen)
- Timeout: idleTimeoutSeconds (30–120, Default 45) aus Reiter Idle & DOOH
- Playlist: GET …/dooh/active (Slug idle) — apiHint doohSignageActiveGet
- Ablauf nach Timeout ohne Touch:
1) resetKioskState → kiosk-home, alle Overlays zu
2) wenn Playlist.items.length > 0 → Vollbild-DOOH (DoohSlot, zyklisch Video/Bild/Slideshow)
- Berührung oder „Kiosk aktivieren“: DOOH beenden, Startseite, Timer neu
- Agnes-Default: doohPersistentSlotBelowHeader false, enableDoohIdleFullscreenOverlay false
→ bei enableDoohIdle an: Vollbild nach Timeout wie AI Premium (nicht Wayfinding-Dauer-Slot)

IDLE & DOOH REITER (wenn Redaktion feinjustiert)
- idleTimeoutSeconds, autoRefreshMinutes
- doohPersistentSlotBelowHeader, enableDoohIdleFullscreenOverlay (nur wenn persistent Slot)
- enableGridMoodMedia (Agnes selten) — Inhalte aus bentoQuickLinkMoods; gridMoodMediaPlaylistSlug ignorieren (Legacy)

AUTO-REFRESH
- autoRefreshMinutes: Seiten-Reload nur bei anhaltender Inaktivität (Option aus Idle-Reiter)

VERBOTEN
- enable*-Toggles/Labels/Farben hardcoden
- DOOH ohne API-Playlist
- Companion/Handoff-URLs (Agnes ohne Companion)
- website-config ohne Auth

REFERENZ
- Verhalten: apps/digital-signage/…/AIPremiumKioskShell.tsx (Idle-Timer, resetKioskState, showIdleFullscreenOverlay)
- Doku: cockpit-docs/digital-signage/agnes-kiosk-v0-prompt.md, ai-premium-v0-paritaet-und-dashboard-steuerung.md

So testen​

  1. Center → Signage & Companion → Template Agnes Kiosk wählen.
  2. Digital Experience → DOOH: Playlist Slug idle anlegen, Items (Video/Bild) hinzufügen, aktivieren.
  3. Reiter Module → „Idle + DOOH Werbeslot“ aktivieren → Speichern.
  4. Reiter Idle & DOOH → Timeout z. B. 45 s → Speichern.
  5. v0-App neu laden; signage-surface prüfen: templateOptions.kiosk.enableDoohIdle === true.
  6. Kiosk bedienen, dann warten: nach Timeout → Startseite, dann DOOH-Vollbild.
  7. Touch: zurück zur Startseite, Timer läuft neu.
  8. Optional: enableDoohIdle aus — nach Timeout nur Reset/Startseite, kein DOOH.

Siehe auch​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/digital-signage/agnes-kiosk-v0-prompt