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+)
| Reiter | Agnes Kiosk |
|---|---|
| Darstellung, Farben, Medien, Module, Wayfinding, Bezeichnungen | sichtbar |
| Idle & DOOH | sichtbar (seit 0.1.398) |
| Companion (Template) | sichtbar (seit 0.1.617) — Shell nach QR-Scan |
| Einbettungen | ausgeblendet |
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):
| Feld | Agnes-Default | Bedeutung |
|---|---|---|
enableDoohIdle | false | DOOH-Ruhebildschirm — in Reiter Module aktivieren |
idleTimeoutSeconds | 45 | Sekunden ohne Touch bis Idle-Aktion (30–120) |
doohPersistentSlotBelowHeader | false | Kein dauerhafter 16:9-Slot unter dem Header |
enableDoohIdleFullscreenOverlay | false | Vollbild-DOOH nach Timeout (typisch: mit enableDoohIdle an) |
enableHandoffQr / enableHandoffQrIdle | false | Kein Handoff-QR (Agnes ohne Companion) |
enableFood, enableHighlights, enableNearby, enableGroupSession | false | Reduziertes Modul-Set |
enableServices, enableOffers, enableA11y | true | Kern-Module Agnes |
Zwei Idle-Ebenen (nicht verwechseln)
| Ebene | Steuerung | Zweck |
|---|---|---|
| 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-Idle | enableDoohIdle + idleTimeoutSeconds + Reiter Idle & DOOH | Nach konfiguriertem Timeout: Startseite + optional Vollbild-DOOH-Slideshow |
Ablauf bei aktivem DOOH (enableDoohIdle === true):
- Besucher bedient den Kiosk interaktiv (Shops, Centerplan, Services, Aktuelles).
- Keine Berührung für
idleTimeoutSeconds(Dashboard, Standard 45 s). - Zuerst: Kiosk-Zustand auf Startseite zurücksetzen (
kiosk-home) — alle Overlays, Route, Suche schließen. - Dann: Wenn aktive Idle-Playlist existiert (
GET …/dooh/active, Slugidle) → Vollbild-DOOH einblenden (Slideshow/Video). - 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)
| Bereich | Quelle | Toggle |
|---|---|---|
| Shops | public-visitor-surface → Shops / apiHints | — |
| Services | services | enableServices |
| News, Events, Angebote | news?published=true, Aktuelles-Bundle | enableOffers, showFeaturedNews |
| Centerplan / Wayfinding | Floors, signage-display-config?displayId= | wayfindingSource, force2DMap, … |
| Mood / Hero | templateOptions.kiosk: heroMedia, heroImageFocus (CSS object-position, Default Agnes 70% 50%), bentoWelcomeMood, bentoMoodCards, bentoQuickLinkMoods | Medien-Reiter |
| Hot Picks | hotpicks | enableHighlights (Agnes-Default: aus) |
DOOH-Ruhebildschirm
| Quelle | API | Hinweis |
|---|---|---|
| Idle-Playlist | GET …/dooh/active (Slug idle) | Digital Experience → DOOH Video — Playlist aktiv + Items |
| Grid-Mood (optional) | bentoQuickLinkMoods.* aus surface | Nur wenn enableGridMoodMedia — Mood aus Medien & Mood, kein DOOH für Grid |
| Local Hero | Dashboard DOOH-Bereich | In 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
- Center → Signage & Companion → Template Agnes Kiosk wählen.
- Digital Experience → DOOH: Playlist Slug
idleanlegen, Items (Video/Bild) hinzufügen, aktivieren. - Reiter Module → „Idle + DOOH Werbeslot“ aktivieren → Speichern.
- Reiter Idle & DOOH → Timeout z. B. 45 s → Speichern.
- v0-App neu laden;
signage-surfaceprüfen:templateOptions.kiosk.enableDoohIdle === true. - Kiosk bedienen, dann warten: nach Timeout → Startseite, dann DOOH-Vollbild.
- Touch: zurück zur Startseite, Timer läuft neu.
- Optional:
enableDoohIdleaus — nach Timeout nur Reset/Startseite, kein DOOH.
Siehe auch
- AI Premium v0-Parität — vollständige Feature-Checkliste und Startup-APIs
- DOOH-Modus im Kiosk — Playlists, Local Hero, Item-Typen
- Teil H (Kiosk) — Terminal-Layout und Datenschutz-Idle
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/digital-signage/agnes-kiosk-v0-prompt