AI Premium: v0-Parität & Dashboard-Steuerung
Ziel: Das React-Template (apps/digital-signage/…/ai-premium) durch eine v0-App ersetzen. Cockpit bleibt Source of Truth für Inhalte, Touchscreens, Wayfinding und App-Konfiguration — v0 entscheidet über Routen/URLs und UI-Design.
Für v0 mitgeben: Signage/Companion Config-Vertrag (empfohlen: signage-surface + Copy-Prompt aus Frontend-Kanäle) · Teil H + I (Terminal + Companion) · Teil F (Centerplan) · Plan-Varianten: packages/mcp-cockpit-os/V0_SIGNAGE_PLAN_VARIANTS.md · Teil K (Chat-Prompt + diese Seite) · System-Infos Kiosk+Companion
1. Rollenverteilung
| Wer | Was |
|---|---|
| Cockpit Dashboard | Inhalte, Touchscreens, Centerplan, DOOH, AI-Premium-Optionen (Feature-Toggles, Farben, Labels) |
| Dashboard-API | Öffentliche GETs — v0 lädt beim Start / bei Refresh |
| v0-App | UI, Routing, Terminal-Layout — keine festen Pfade wie /ai-premium nötig |
| React-Template (Monorepo) | Referenz für Verhalten und Feature-Liste — nicht mehr hosten, wenn v0 Parität hat |
Template-ID (intern, API): ai-premium — nur für signage-template-options?template=ai-premium und defaultSignageTemplate. Nicht als URL-Pfad vorschreiben.
Variante Agnes Kiosk: agnes-kiosk — gleiches Options-Schema, reduzierte Module/Defaults, kein Companion. Idle & DOOH ab 0.1.398 konfigurierbar — siehe Agnes Kiosk v0-Prompt.
2. URLs: v0 bestimmt die Routen
Cockpit schreibt v0 keine Pfade vor. Das Monorepo nutzt historisch /ai-premium und /companion/t/premium — v0 darf z. B. /kiosk, /stele, /now, /app wählen.
v0-Seite
- Env (Beispiel):
NEXT_PUBLIC_KIOSK_PATH=/kiosk,NEXT_PUBLIC_COMPANION_PATH=/now - Handoff-QR: Ziel =
{origin}{NEXT_PUBLIC_COMPANION_PATH}?centerId=&sessionKey=&screen=…&shop=… - Gleiches v0-Projekt: Kiosk + Companion unter einer Origin (empfohlen) — dann reicht
window.location.origin+ Companion-Pfad - Getrennte Deployments: Companion-Basis aus Cockpit lesen →
signage-config.companionPublicUrl
Cockpit-Seite (nach v0-Deploy)
- Website-Management → Frontend-Kanäle (v0) — Kanäle
signageundcompanionauf die v0-Produktions-URLs setzen (Teil J) - Optional:
signagePublicUrl/companionPublicUrlmanuell pflegen — erscheinen inGET …/signage-config - Touchscreens im Dashboard verweisen auf die öffentliche Kiosk-URL (mit
?touchscreenId=…)
Handoff-Vertrag (plattformweit, unabhängig vom Pfad): Query-Parameter centerId, sessionKey, optional shop, screen, floorNumber — siehe Kiosk + Companion NOW!.
3. Dashboard-Steuerung (was Redaktion sieht)
Pfad: Dashboard → Content → Center → Tab Kiosk → Reiter Wartungsmodus (immer sichtbar, alle Templates) bzw. AI Premium Kiosk / AI Premium Companion (nur bei defaultSignageTemplate = ai-premium).
Speicherort: ShoppingCenter.signageTemplateOptions['ai-premium'].kiosk bzw. .companion
Orientierung (Hoch-/Querformat): Flat-Felder unter kiosk gelten als Fallback für beide Orientierungen. Abweichende Werte optional unter kiosk.byOrientation.portrait bzw. kiosk.byOrientation.landscape (Partial-Overrides). Runtime-Merge: Defaults → flat → byOrientation[effectiveLayout]. Bestehende Center ohne byOrientation verhalten sich unverändert.
API (öffentlich, kein Login):
GET /api/centers/{centerId}/signage-surface (empfohlen — gemergt inkl. v0CustomInstructions)
GET /api/centers/{centerId}/signage-template-options?template=ai-premium
→ { success: true, centerLogoUrl, options: { kiosk: { … }, companion: { … } } }
GET …/signage-template-options?template=ai-premium&orientation=portrait
→ options.kiosk bereits für Hochformat aufgelöst (Preview/v0)
Leere oder fehlende Felder sind mit Dashboard-Defaults (DEFAULT_AI_PREMIUM_*) vorbelegt — v0 kann direkt options.kiosk.enableOffers etc. lesen. centerLogoUrl ist das Center-Logo aus den Stammdaten (Fallback: GET …/signage-config → logoUrl).
So testen (Dashboard): Center → Signage & Companion → Stele-Reiter (z. B. Module) → Tabs Allgemein | Hochformat | Querformat. Allgemein setzt Fallback; Hochformat/Querformat nur Überschreibungen. Speichern, dann Kiosk mit screenOrientation=portrait bzw. landscape am Touchscreen prüfen.
Medien & Mood: Reiter Medien & Mood — Logo/Hero plus Mood-Zeilen in derselben Reihenfolge wie die neun Kernmodule (Centerplan … Jobs) unter bentoQuickLinkMoods.*, davor Willkommensbereich (bentoWelcomeMood) und danach drei optionale Mood-Karten. Bezeichnungen aus dem Reiter Bezeichnungen werden für die Modul-Zeilen übernommen (z. B. searchLabel, trafficLabel).
Mood-Medien-Schema (v0): Jedes Mood-Feld ist ein Objekt MoodMedia:
| Feld | Typ | Bedeutung |
|---|---|---|
type | 'image' | 'video' | 'slideshow' | Medientyp |
url | string? | Einzelnes Bild oder Video |
urls | string[]? | Slideshow: mehrere Bild-URLs |
slideDuration | number? | Sekunden pro Bild (Slideshow, Default 8) |
transitionType | 'fade' | 'slide' | 'none'? | Übergang (optional) |
fallbackImageUrl | string? | Fallback/Poster bei video oder slideshow (Ladezustand, Fehler) |
Speicherpfad: signage-surface → templateOptions.kiosk.bentoWelcomeMood, bentoQuickLinkMoods.{centerplan|shops|food|services|search|aktuelles|traffic|socialFeed|jobs}, bentoMoodCards[]. Hero-Playlist separat über heroMedia[] (gleiche Typen, plus Zeitfenster).
So testen (Fallback-Bild): Reiter Medien & Mood → Modul-Zeile mit Video oder Slideshow → Abschnitt Fallback-Bild erscheint → Bild hochladen → Speichern → GET …/signage-template-options?template=ai-premium prüfen: options.kiosk.bentoQuickLinkMoods.shops.fallbackImageUrl gesetzt.
Regel für v0: Jeder Schalter im Dashboard muss live wirken — Feature-Toggles, Labels und Farben nicht im v0-Code hardcoden. Die GET-Response liefert für template=ai-premium bereits mit Dashboard-Defaults gemergte options.kiosk / options.companion (leere DB-Felder = Standardwerte).
Kiosk-Optionen → v0-Verhalten
| Dashboard-Feld | Wirkung in der App |
|---|---|
accentColor | Buttons, Links, Akzente |
kioskColorScheme | light / dark — Theme-Tokens |
locationLabel | Header-Standort (Fallback wenn kein Display-Config) |
hotPicksLimit | Max. Hot Picks auf Start |
showFeaturedNews | News/Highlights-Bereich |
wayfindingSource | auto / svg / dashboard — Routing-Quelle |
force2DMap, routeColor, routeSmoothing, preferSteleFloorForRoute | Centerplan-Darstellung; Etage der Stele für Route bevorzugen |
enableOfferPins, enableIdleTour, idleTourDelaySeconds, enableOfferFloorFollow | Angebots-Marker und optionaler Rundgang im Ruhemodus — pro Orientierung (byOrientation) |
promoBox | Info-Box unter dem Plan (Hochformat): Text, Bild, QR, Zeitraum — Reiter Wayfinding |
backgroundMedia | Vollflächiger Hintergrund (Bild/Video) mit Abdunklung: dimPercent (0–80, Stärke) und overlayColor (#rrggbb, Farbe, Default #000000) — Reiter Farben, pro Orientierung |
colorTokens | Feinsteuerung der Farben einzelner Bereiche (24 optionale Felder) — Reiter Farben, Abschnitt Farben (erweitert); nur ai-premium / ai-wayfinding |
a11yDefault | Start mit Aufzug-Routing |
idleTimeoutSeconds | DOOH / Idle (30–120 s) |
autoRefreshMinutes | Reload bei Inaktivität |
startViewModule | Ansicht beim Kiosk-Start (centerplan, idle, … jobs, Default centerplan). idle = DOOH-Playlist beim Boot. Nach Idle-Timeout → Centerplan (nicht startViewModule). Fallback wenn Voraussetzung fehlt |
enableOffers … enableBottomQuickMenu | Feature-Toggles (siehe Checkliste §4) |
*Label, youAreHereLabel | Titel der Quick-Icons; Karten-Marker (leer → „Sie sind hier“) |
enableTraffic + trafficMapEmbedUrl | Verkehrs-Slide-up |
enableAiSearch | KI-Suche / Concierge — nur wirksam, wenn data.bots.companion.companionChatEnabled (Companion aktiv + KI-Assistent) |
enableKeyboardSearch | Klassische Suche mit Bildschirmtastatur (Default true); greift, wenn KI-Suche nicht angeboten wird; beide aus = keine Suche an der Stele. Pro Orientierung (byOrientation) |
enableShopModal | Shop-Detail-Modal beim Antippen (Default false): aus = Tipp führt direkt zur Route; an = Modal mit Button „Route“. Alle Templates, pro Orientierung (byOrientation). Dashboard: Stele → Darstellung & Startseite |
enableHeader | Kopfzeile mit Logo (Default true); false blendet sie aus. Flaches Feld kiosk.enableHeader (Stele) — nicht kiosk.nonTouch.enableHeader (Non-Touch-Display). Dashboard: Stele → Darstellung & Startseite |
enableSocialFeed | Social-Modul (siehe Social-Feed v0 unten) |
enableTransitMonitor + transitMonitorEmbedUrl | ÖPNV-Embed |
enableDoohIdle, doohPersistentSlotBelowHeader, enableDoohIdleFullscreenOverlay | DOOH aus GET …/dooh/active (Signage) — alternativ dooh/public/active nur bei websiteEnabled |
idleTouchHint | Button „Berühren zum Starten“ im DOOH-Vollbild-Ruhemodus: enabled, text (max. 40), backgroundColor, textColor, animation (pulse | none) — Reiter Idle & DOOH, pro Orientierung |
quickMenuLayout | Darstellung der Modul-Navigation: bar (Menüleiste, Default) oder grid (Kachel-Raster) — Reiter Module, Abschnitt Quick-Menü-Darstellung; fehlend/null/leer/bar = Leiste; nur grid wird dauerhaft gespeichert; pro Orientierung überschreibbar (explizites bar im Override möglich) |
quickMenuOrder | Reihenfolge der Quick-Menüleiste (11 Keys: centerplan, shops, offers, food, services, nearby, groupSession, traffic, transit, social, jobs) — Reiter Module, Abschnitt Reihenfolge der Menüpunkte; leeres Array [] oder fehlendes Feld = v0-Standardreihenfolge; pro Orientierung überschreibbar |
enableGridMoodMedia | Querformat-Grid-Split (Shops/Food/Services/Angebote/Nearby): links Mood-Medien aus bentoQuickLinkMoods.* (Reiter Medien & Mood), rechts Grid — kein DOOH für Grid in v0 |
gridMoodMediaPlaylistSlug | Legacy (apps/digital-signage only) — v0 ignorieren; DOOH-Playlists nur für Idle (GET …/dooh/active) |
(global) maintenanceModeEnabled | Wartungsmodus für alle Signage-Templates — Reiter Wartungsmodus oder GET …/signage-global-options |
(global) maintenanceMessage | Hinweistext unter dem Logo (Logo: centerLogoUrl / signage-config.logoUrl) |
(global) kioskLanguages | Sprachumschalter am Kiosk (z. B. ["de","en"]) — Reiter Stele → Bezeichnungen → Kiosk-Sprachen; öffentlich auch signage-surface.languages |
promoBox und backgroundMedia sind ab 0.1.779 immer im GET enthalten (Defaults: Box aus, leere Hintergrund-URL = kein Medium); gespeicherte Werte werden unverändert durchgereicht.
idleTouchHint ist ab 0.1.785 immer im GET enthalten (Default: Button an, leerer Text = „Berühren zum Starten“, leere Farben = Akzent bzw. dunkle Grundfarbe, Animation pulse). Ungültige Farben oder Text über 40 Zeichen liefern beim Speichern HTTP 400 mit Feldnamen.
quickMenuLayout (ab 0.1.819): Im GET fehlt das Feld, wenn die Menüleiste gilt (Default). Gespeichert wird nur grid auf Top-Level; in byOrientation kann zusätzlich explizit bar stehen, um vom allgemeinen Raster zurück zur Leiste zu wechseln. Ungültige Werte → HTTP 400 (kiosk.quickMenuLayout bzw. kiosk.byOrientation.<format>.quickMenuLayout).
quickMenuOrder (ab 0.1.788): Im GET fehlt das Feld oder es ist [], wenn keine eigene Reihenfolge gespeichert ist — v0 nutzt dann die feste Standardreihenfolge der elf Keys. Gespeicherte Arrays enthalten eindeutige erlaubte Keys (max. 11). Sichtbarkeit am Kiosk weiter über die passenden enable*-Schalter (z. B. offers → enableOffers, social → enableSocialFeed, transit → enableTransitMonitor). Ungültige Werte → HTTP 400 mit Feldnamen (kiosk.quickMenuOrder bzw. kiosk.byOrientation.<format>.quickMenuOrder).
| Key | enable*-Schalter |
|---|---|
centerplan | enableCenterplan |
shops | enableShops |
offers | enableOffers |
food | enableFood |
services | enableServices |
nearby | enableNearby |
groupSession | enableGroupSession |
traffic | enableTraffic |
transit | enableTransitMonitor |
social | enableSocialFeed |
jobs | enableJobs |
Social-Feed (v0 — API vs. Legacy-Embed)
Was: Ist enableSocialFeed an, liefert v0 den Social-Bereich entweder als Cockpit-Feed (öffentliche API) oder als Legacy-iframe — abhängig vom Einbettungsfeld, nicht vom Zernio-Inbox-API im Browser.
Warum: Einheitliche Posts wie auf der Center-Website (Outstand-veröffentlichte Beiträge, manuelle Einträge, ggf. Scrape) statt leerer Slide-ups oder paralleler Zernio-Integration in der Stele. Zernio bleibt Backend für Community/Inbox im Dashboard; der Kiosk liest nur GET …/social-feed.
Wer: Redaktion (Modul + optional Embed), v0-Entwicklung, Besucher an der Stele.
Wo: Dashboard → Signage → Stele → Module (enableSocialFeed) und Einbettungen (socialFeedEmbedCode); Discovery data.apiHints.socialFeedGet in GET …/public-visitor-surface oder GET …/signage-surface.
Entscheidungsregel (v0):
| Bedingung | Quelle |
|---|---|
enableSocialFeed === false | Modul aus — kein Social-Screen |
Embed mit extrahierbarem src="…" in socialFeedEmbedCode | Legacy: iframe/Slide-up (Elfsight, Zernio-Widget o. ä.) — wie Monorepo KioskEmbedSlideUp |
enableSocialFeed === true und kein gültiger src (Feld leer oder ohne iframe-src) | GET data.apiHints.socialFeedGet — normalisierte Posts aus Cockpit (Tier managed = veröffentlichte DB-Posts/Outstand-Pipeline, plus manual / scrape / profile_links je Center-Modus) |
API liefert leere posts[] | Hinweis oder Profil-Links aus Response — kein Fallback auf Zernio-API im Frontend |
So testen:
- Modul an,
socialFeedEmbedCodeleer →GET …/signage-surface→apiHints.socialFeedGetaufrufen → Posts oderprofileLinkssichtbar in v0. - Modul an, Embed mit
src="https://…"→ v0 zeigt iframe, ohne Pflicht-Call aufsocial-feed(API optional für Parität). - Modul aus → Quicklink „Social“ fehlt bzw. Screen nicht erreichbar.
Copy-Paste für v0-Instructions: packages/mcp-cockpit-os/V0_SIGNAGE_SOCIAL_FEED.md · Spezifikation: Public Social Feed Spec.
Animation am Gerät (nur v0, nicht im Cockpit konfigurierbar): Das Cockpit speichert nur animation: pulse oder none. Die Stele setzt den Rhythmus in CSS um (v0-Klasse k-touch-hint-cycle).
| Wert | Verhalten auf der Stele |
|---|---|
pulse | 16-Sekunden-Zyklus: 8 s Button sichtbar (mit dezentem Puls), 1 s ausblenden, 6 s Pause ohne Button, 1 s einblenden — wiederholt |
none | Button dauerhaft sichtbar, ohne Rhythmus und ohne Puls |
| (System) | „Bewegung reduzieren“ am Gerät: Button immer sichtbar, kein Ein-/Ausblenden — unabhängig von pulse/none |
backgroundMedia.overlayColor (ab 0.1.780) wird immer geliefert: gespeicherter Wert, sonst bei ?orientation= der Wert aus den allgemeinen Optionen, sonst #000000. v0 mischt die Farbe mit dimPercent (z. B. rgba(overlayColor, dimPercent/100) über dem Medium). Ungültige Hex-Werte werden beim Speichern verworfen; #abc wird zu #aabbcc.
"backgroundMedia": { "url": "https://cdn.example/bg.mp4", "type": "video", "dimPercent": 40, "overlayColor": "#0b1f3a" }
Feinsteuerung der Kiosk-Farben (colorTokens)
Was: Bis zu 24 optionale Farbfelder unter options.kiosk.colorTokens, benannt wie die CSS-Variablen der alten Petersbogen-App. Gelten für Hoch- und Querformat gemeinsam; pro Format überschreibbar über kiosk.byOrientation.portrait|landscape.colorTokens (Deep-Merge pro Feld). Nur für die Templates ai-premium und ai-wayfinding.
Warum: Bisher gab es nur accentColor, colors.* und quickLinkColors. Hot Picks, Hinweisblase, Etagen-Umschalter, Info-Karten und Info-Box ließen sich nicht einzeln färben. Außerdem blieb eine Änderung an accentColor wirkungslos, solange ein Orientierungs-Override gesetzt war — das Dashboard zeigt das jetzt an.
Wer: Redaktion / Center-Betrieb (Dashboard), Agenten (MCP), v0-Stele (liest die Felder und setzt je Feld eine CSS-Variable --k-<feldname>).
Wo: Dashboard → Center → Signage → Stele → Reiter Farben & Verlauf → Karte Farben (erweitert). API: GET/PUT/PATCH …/signage-template-options; MCP: cockpit_update_signage_template_options, cockpit_clone_signage_config.
| Gruppe | Felder |
|---|---|
| Grundfläche, Kopf | background, logoText, logoBackground |
| Info-Karten | contentBackground, contentBorder, contentTextBackground, contentText, contentQrCodeBackground, contentQrCode |
| Hot Picks | hotPickBackground, hotPickText, hotPickBorder, hotPickOfferBackground, hotPickOfferText |
| Hinweisblase | touchHereBackground, touchHereText |
| Etagen-Umschalter / Navigation | navInactiveBackground, navInactiveText, navActiveBackground, navActiveText, navActiveIcon |
| Info-Box unter dem Plan | ctaTextBackground, ctaText, ctaQrCode (gesetzte promoBox.backgroundColor / promoBox.textColor haben Vorrang) |
Regeln
- Alle Felder optional. Leer oder fehlend = die Stele leitet die Farbe wie bisher automatisch ab („Automatik“). Keine Migration nötig.
- Erlaubte Werte:
#rgb,#rrggbb,#rrggbbaa,rgb(r, g, b),rgba(r, g, b, a)— höchstens 32 Zeichen, gespeichert wie eingegeben. Alles andere (auch unbekannte Feldnamen, z. B.red,url(x),#12) wird abgelehnt: HTTP 400 mit den Feldnamen in der Fehlermeldung. - Zum Leeren eines Feldes im PATCH: leerer String oder
null. Der Server entfernt leere Werte (und leerecolorTokens-Objekte) beim Speichern. GETohneorientation:kiosk.colorTokens(flach) pluskiosk.byOrientation.*.colorTokens.GET …?orientation=portrait|landscape: pro Feld gemergtes Ergebnis. Center ohne gesetzte Farben: Feld fehlt in der Antwort (kein Default).- Andere Templates (z. B.
agnes-kiosk,non-touch-kiosk):colorTokensim Patch wird mit 400 abgelehnt. - Logo-Box (v0): Ist
logoBackgroundgesetzt oder ein Center-Logo-Override (logoOverride) aktiv, zeigt v0 das Logo in den Originalfarben (nicht erzwungen weiß im dunklen Farbschema). Ohne beides bleibt das bisherige Verhalten.
Dashboard-Verhalten
- Einklappbare Gruppen in der Reihenfolge der Tabelle oben (Grundfläche und Kopfbereich, Info-Karten, Hot Picks, Hinweisblase, Etagen-Umschalter und Navigation, Info-Box unter dem Plan). Gruppen mit gesetzten Werten starten offen, die übrigen eingeklappt; im Gruppenkopf stehen „n von m gesetzt“ und, im Umfang „Allgemein“, wie viele Felder je Format abweichen. „Alle aufklappen / zuklappen“ steuert alle Gruppen.
- Pro Feld: Farbwähler, Hex-Eingabe und Knopf Automatik (erscheint nur, wenn ein eigener Wert gesetzt ist, und leert das Feld). Umschalter Allgemein / Hochformat / Querformat wie bei den anderen Optionen; im Formatreiter leere Felder übernehmen den allgemeinen Wert (Platzhalter zeigt ihn). Die Zahl am Reiter „Hochformat (3)“ zählt die gespeicherten Abweichungen.
- Reihenfolge im Reiter Farben: Farben (Farbschema, Akzentfarbe, Farbpalette, Verlauf, Quicklink-Farben), Hintergrund (Bild oder Video), Farben (erweitert). Farbschema und Akzentfarbe liegen jetzt hier statt im Reiter Darstellung. Die Textfläche und der QR-Code der Info-Box stehen in „Farben (erweitert)“; Hintergrund- und Textfarbe der Info-Box im Reiter Wayfinding haben Vorrang.
- Kontrastwarnung (gelb, kein Blocker) unter 4,5:1 für die Paare
contentText/contentTextBackground,hotPickText/hotPickBackground,hotPickOfferText/hotPickOfferBackground,touchHereText/touchHereBackground,navInactiveText/navInactiveBackground,navActiveText/navActiveBackground,ctaText/ctaTextBackground— nur wenn beide Felder gesetzt sind. - Override-Hinweis: Im Reiter „Allgemein“ zeigt jedes Farbfeld, das ein Orientierungs-Override überdeckt, einen kurzen Hinweis neben der Beschriftung, z. B. „Hochformat: #296859“ (bzw. Querformat). Gilt auch für
accentColor,colors.*,backgroundGradient.*,quickLinkColors.*undrouteColor.
So testen
- Reiter Farben → Farben (erweitert):
hotPickBackgroundsetzen, speichern. GET /api/centers/{centerId}/signage-template-options?template=ai-premium→options.kiosk.colorTokens.hotPickBackgroundvorhanden.- Reiter „Hochformat“:
hotPickBackgroundanders setzen, speichern;GET …&orientation=portraitliefert den Override,…&orientation=landscapeden allgemeinen Wert. - Zurück auf „Allgemein“: Hinweis „Hochformat: …“ erscheint neben dem Feld, die Gruppe zeigt „abweichend je Format“.
- API-Test:
PATCHmit{"templateId":"ai-premium","kiosk":{"colorTokens":{"ctaText":"red"}}}→ 400, Meldung nenntkiosk.colorTokens.ctaText. - Automatik klicken, speichern → Feld fehlt im GET.
Beispiel (Petersbogen, aus der alten App übernommen):
{
"kiosk": {
"colorTokens": {
"background": "#1c5552", "logoText": "#ffffff",
"contentBackground": "#ffffff", "contentBorder": "#000000",
"contentTextBackground": "#d6d54e", "contentText": "#20574c",
"contentQrCodeBackground": "#ffffff", "contentQrCode": "#000000",
"hotPickBackground": "#d6d54e", "hotPickText": "#20574c", "hotPickBorder": "#1c5552",
"hotPickOfferBackground": "#ffffff", "hotPickOfferText": "#1c5552",
"touchHereBackground": "#d0dcd9", "touchHereText": "#20574c",
"navInactiveBackground": "#7e9d96", "navInactiveText": "#ffffff",
"navActiveBackground": "#d6d54e", "navActiveText": "#20574c", "navActiveIcon": "#7e9d96",
"ctaTextBackground": "#60867e", "ctaText": "#ffffff", "ctaQrCode": "#ffffff"
}
}
}
Betrieb: Keine Env-Variablen, keine Migration. Cache der Stele (5 Min.) wird beim Speichern wie bei den übrigen Kiosk-Optionen invalidiert. Die Stelen-App liest die Felder in einem Folgeschritt; ohne Wert bleibt alles wie bisher.
v0-Handoff (Idle + Farben): dooh/active unverändert, optional source, Implementierungsaufgaben colorTokens / overlayColor · Pilot-Checkliste Petersbogen.
Companion-Optionen
| Feld | Wirkung |
|---|---|
accentColor | Companion-Akzente (Legacy; v0 bevorzugt colors.accent) |
colors.{primary,secondary,background,accent} | Companion-Brand-Farben |
quickLinkColors.* | Optionale Quicklink-Akzente (gleiche Keys wie Kiosk) |
showAISuggestions | Vorschlags-Chips in der Chatbar |
defaultTargetShop | Standard-Ziel nach QR-Scan |
routeStepsEnabled | Schritt-für-Schritt-Wegbeschreibung (aus: nur Route auf der Karte) |
menuSearchEnabled | Suchfeld oben in der Companion-Seitenleiste |
menuHintTitle, menuHintText | Hinweisblase am Menü-Button (leer = v0-Standardtexte) |
Dashboard-Vorschau (Cockpit): previewTouchscreenIdPortrait, previewTouchscreenIdLandscape unter signageTemplateOptions[templateId] — Stele für ?touchscreenId= in Vorschau-URLs (Reiter Vorschau).
Zusätzlich: companionConfig (Reiter Companion App) — plattformweite Feature-Flags (Wayfinding, AI-Chat, …) über GET …/signage-config → companionConfig.
4. Feature-Parität: Kiosk (React-Referenz)
Referenz-Code: AIPremiumKioskShell.tsx, Daten: load-ai-premium-family-kiosk-page.ts.
Pflicht für Ablösung (Phase 1)
| Feature | Dashboard-Toggle | Daten-API |
|---|---|---|
| Start mit Centerplan als Hero | — | wayfinding/floors, Display-Config |
| Etage pro Stele | — | signage-config, signage-display-config?displayId= |
| Shops-Liste + Shop-Detail | — | shops, Services optional |
| Slide-ups: Angebote/News/Events | enableOffers | news, aktuelles-Bundle |
| Gastronomie | enableFood | services / gefilterte Shops |
| Services | enableServices | services |
| Hot Picks | enableHighlights | hotpicks |
| In der Nähe | enableNearby | signage-nearby?displayId= |
| KI-Suche / Concierge | enableAiSearch (+ Companion-KI) | Handoff / POST …/ai/visitor-chatbot |
| Tastatur-Suche | enableKeyboardSearch | Filter über Shops/Services — ohne KI-Assistent |
| Shop-Detail-Modal | enableShopModal (Default: false) | — |
| Kopfzeile mit Logo | enableHeader (Default: true) | — |
| Unteres Quick-Menü | enableBottomQuickMenu | — |
| Handoff-QR (aktive Nutzung) | enableHandoffQr | POST …/handoff-sessions |
| Handoff-QR (Ruhebildschirm/Idle) | enableHandoffQrIdle (Default: true) | POST …/handoff-sessions |
| Barrierefrei-Overlay | enableA11y | Routing-Optionen |
| Gruppen-Session-QR | enableGroupSession | Group-Session-API |
| Wayfinding Ziel auf Startkarte | — | Routing API / SVG |
| Idle-Reset (Datenschutz) | — | ~90 s UX (Teil H) |
| DOOH Idle | enableDoohIdle | dooh/active (Signage) — dooh/public/active nur bei Website-Kanal |
Phase 2 (optional, kann nachziehen)
| Feature | Toggle / Quelle |
|---|---|
| Traffic / Social / ÖPNV | enableTraffic, enableSocialFeed, enableTransitMonitor |
| DOOH dauerhaft unter Header | doohPersistentSlotBelowHeader |
| Grid-Mood (Querformat-Grids) | enableGridMoodMedia + bentoQuickLinkMoods.* (Medien & Mood) — gridMoodMediaPlaylistSlug nur Legacy digital-signage |
| Auto-Refresh | autoRefreshMinutes |
5. Feature-Parität: Companion (Phase 1)
Referenz: AIPremiumCompanionShell.tsx
| Feature | Quelle |
|---|---|
Handoff (sessionKey, shop, screen) | URL-Params + PATCH handoff-sessions |
| Home mit Karte + Hot Picks | floors, hotpicks, template-options |
| Inline-Route auf Home | Wayfinding + Routing |
| Dedizierter Wayfinding-Screen | — |
| Shop-Detail Vollbild | shops/services |
| Angebots-Liste | offers / aktuelles |
| Concierge-Chatbar | visitor-chatbot + showAISuggestions |
Standort-QR /companion/qr/[id] oder v0-eigener Pfad | public QR resolve/scan |
Phase 2
- AR-Navigation / Shopfront-Tracking (MindAR) — siehe Premium AI Template
- Treueprogramm, Feedback-Routen — plattformweit, nicht AI-Premium-exklusiv
6. Startup-Daten (v0 Server / Route Handler)
Discovery: GET …/public-visitor-surface → data.apiHints enthält alle Signage-Pfade (siehe unten).
Parallel laden (wie Monorepo):
GET …/signage-config— Branding, Touchscreens, signagePublicUrl, companionPublicUrlGET …/signage-template-options?template=ai-premium— Dashboard-SteuerungGET …/signage-display-config?displayId={touchscreenId}— Standort, Etage, SVG-StartGET …/public-visitor-surface— Branding, Chatbot-Hinweise, apiHints- Content:
hotpicks,shops,services,news?published=true - Optional:
signage-nearby,dooh/active(Signage, CORS) oderdooh/public/active(nur beiwebsiteEnabled),center-config(Traffic-Kontext)
apiHints (public-visitor-surface)
| Key | Zweck |
|---|---|
signageConfigGet | Stele, Branding, URLs |
signageTemplateOptionsGet | AI-Premium-Optionen (?template=ai-premium) |
signageDisplayConfigGet | Standort/Etage pro Stele |
signageNearbyGet | In der Nähe |
doohSignageActiveGet | DOOH Idle (ohne websiteEnabled) |
hotPicksGet | Hot Picks |
handoffSessionPost | Handoff Kiosk → Companion |
groupSessionPost | Gruppen-QR |
touchscreensGet | Touchscreen-Liste |
socialFeedGet | Öffentlicher Social-Feed (wenn kein Legacy-Embed-src) — siehe § Social-Feed v0 |
Device-Binding: ?touchscreenId= oder NEXT_PUBLIC_KIOSK_TOUCHSCREEN_ID — kein hardcodiertes Floor-Env.
7. v0 — Instruction H + Chat-Prompt K
v0 erlaubt max. 10 Instructions (A–J). AI-Premium-Steuerung gehört in Instruction „Cockpit H“ (Abschnitt „AI PREMIUM — DASHBOARD-STEUERUNG“).
Teil K ist nur Chat-Prompt für Feature-Lücken — siehe center-website-v0-api-ready-to-go (Teil K, kein Slot).
In H enthalten (Kurz):
signage-template-options?template=ai-premium→ alleenable*, Labels, Farben- apiHints-Discovery, Startup-APIs, Phase-1-Feature-Liste
- Handoff-QR vs Gruppen-QR getrennt
Chat bei Lücken (einmalig, nicht als Instruction):
Vergleiche v0-Signage mit Cockpit-Doku „AI Premium v0-Parität“ Phase 1.
Fehlende Kiosk-Features an options.kiosk.enable* koppeln. Companion → Teil I. Keine Dummy-Daten.
7.1 Sprachen (Stele, Companion, Website-Teile der v0-App)
Was: GET …/public-visitor-surface → data.languages: { code, label, href, active? }[]. Quelle: Website Header & Navigation → Sprachumschalter (header.languageOptions) bzw. MEC-Import; Fallback Locales aus Template-Slice, mindestens de.
Warum: v0 zeigt den Umschalter nur bei length > 1; active: true markiert die Center-Standardsprache.
Wo testen: Public API-Vertrag — languages. Redaktionelle Kiosk-/Companion-Labels optional mit *ByLocale.en (Basisfeld = de) — siehe Signage editorial ByLocale. v0 muss Locales konsumieren (Was v0 noch umsetzen muss).
7.2 Classic Kiosk (defaultSignageTemplate = kiosk)
Was: GET …/signage-surface → classicKiosk aus ShoppingCenter.kiosk* (Theme, Farben, activeScreens, screenOrder, Willkommenstexte). AI-Premium-Familie nutzt stattdessen templateOptions.kiosk.
Wo: Dashboard → Signage → Classic-Kiosk-Skin; Vertrag: v0 Signage Config — Classic.
8. Cockpit-Checkliste (Projekt)
-
defaultSignageTemplate = ai-premiumfür das Center - AI-Premium-Optionen im Signage-Reiter gepflegt und getestet (Toggle → v0 neu laden)
- Touchscreens mit Etage + MapLocation zugeordnet
- Frontend-Kanäle: signage + companion → v0-URLs
- Handoff E2E: QR → Companion mit sessionKey
- Paritäts-Checkliste §4/§5 abhaken
- React-Hosting (
*.signage.cockpit-os.de) abschalten, wenn v0 stabil
9. v0-Chat-Prompt (Feature-Lücken schließen)
„Vergleiche unsere v0-Signage-App mit der Cockpit-Doku AI Premium v0-Parität (Feature-Checkliste Phase 1). Implementiere fehlende Kiosk-Features und koppel sie an
signage-template-options?template=ai-premium→options.kiosk. Companion fehlt X → Teil I. URLs bleiben bei unseren Pfaden{KIOSK_PATH}/{COMPANION_PATH}. Keine Dummy-Daten.“
Referenz-Implementierung: Premium AI Template · Hosting: Parallele Frontends
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/digital-signage/ai-premium-v0-paritaet-und-dashboard-steuerung