Zum Hauptinhalt springen

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​

WerWas
Cockpit DashboardInhalte, Touchscreens, Centerplan, DOOH, AI-Premium-Optionen (Feature-Toggles, Farben, Labels)
Dashboard-APIÖffentliche GETs — v0 lädt beim Start / bei Refresh
v0-AppUI, 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)​

  1. Website-Management → Frontend-Kanäle (v0) — Kanäle signage und companion auf die v0-Produktions-URLs setzen (Teil J)
  2. Optional: signagePublicUrl / companionPublicUrl manuell pflegen — erscheinen in GET …/signage-config
  3. 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:

FeldTypBedeutung
type'image' | 'video' | 'slideshow'Medientyp
urlstring?Einzelnes Bild oder Video
urlsstring[]?Slideshow: mehrere Bild-URLs
slideDurationnumber?Sekunden pro Bild (Slideshow, Default 8)
transitionType'fade' | 'slide' | 'none'?Übergang (optional)
fallbackImageUrlstring?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-FeldWirkung in der App
accentColorButtons, Links, Akzente
kioskColorSchemelight / dark — Theme-Tokens
locationLabelHeader-Standort (Fallback wenn kein Display-Config)
hotPicksLimitMax. Hot Picks auf Start
showFeaturedNewsNews/Highlights-Bereich
wayfindingSourceauto / svg / dashboard — Routing-Quelle
force2DMap, routeColor, routeSmoothing, preferSteleFloorForRouteCenterplan-Darstellung; Etage der Stele für Route bevorzugen
enableOfferPins, enableIdleTour, idleTourDelaySeconds, enableOfferFloorFollowAngebots-Marker und optionaler Rundgang im Ruhemodus — pro Orientierung (byOrientation)
promoBoxInfo-Box unter dem Plan (Hochformat): Text, Bild, QR, Zeitraum — Reiter Wayfinding
backgroundMediaVollflächiger Hintergrund (Bild/Video) mit Abdunklung: dimPercent (0–80, Stärke) und overlayColor (#rrggbb, Farbe, Default #000000) — Reiter Farben, pro Orientierung
colorTokensFeinsteuerung der Farben einzelner Bereiche (24 optionale Felder) — Reiter Farben, Abschnitt Farben (erweitert); nur ai-premium / ai-wayfinding
a11yDefaultStart mit Aufzug-Routing
idleTimeoutSecondsDOOH / Idle (30–120 s)
autoRefreshMinutesReload bei Inaktivität
startViewModuleAnsicht beim Kiosk-Start (centerplan, idle, … jobs, Default centerplan). idle = DOOH-Playlist beim Boot. Nach Idle-Timeout → Centerplan (nicht startViewModule). Fallback wenn Voraussetzung fehlt
enableOffers … enableBottomQuickMenuFeature-Toggles (siehe Checkliste §4)
*Label, youAreHereLabelTitel der Quick-Icons; Karten-Marker (leer → „Sie sind hier“)
enableTraffic + trafficMapEmbedUrlVerkehrs-Slide-up
enableAiSearchKI-Suche / Concierge — nur wirksam, wenn data.bots.companion.companionChatEnabled (Companion aktiv + KI-Assistent)
enableKeyboardSearchKlassische Suche mit Bildschirmtastatur (Default true); greift, wenn KI-Suche nicht angeboten wird; beide aus = keine Suche an der Stele. Pro Orientierung (byOrientation)
enableShopModalShop-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
enableHeaderKopfzeile mit Logo (Default true); false blendet sie aus. Flaches Feld kiosk.enableHeader (Stele) — nicht kiosk.nonTouch.enableHeader (Non-Touch-Display). Dashboard: Stele → Darstellung & Startseite
enableSocialFeedSocial-Modul (siehe Social-Feed v0 unten)
enableTransitMonitor + transitMonitorEmbedUrlÖPNV-Embed
enableDoohIdle, doohPersistentSlotBelowHeader, enableDoohIdleFullscreenOverlayDOOH aus GET …/dooh/active (Signage) — alternativ dooh/public/active nur bei websiteEnabled
idleTouchHintButton „Berühren zum Starten“ im DOOH-Vollbild-Ruhemodus: enabled, text (max. 40), backgroundColor, textColor, animation (pulse | none) — Reiter Idle & DOOH, pro Orientierung
quickMenuLayoutDarstellung 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)
quickMenuOrderReihenfolge 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
enableGridMoodMediaQuerformat-Grid-Split (Shops/Food/Services/Angebote/Nearby): links Mood-Medien aus bentoQuickLinkMoods.* (Reiter Medien & Mood), rechts Grid — kein DOOH für Grid in v0
gridMoodMediaPlaylistSlugLegacy (apps/digital-signage only) — v0 ignorieren; DOOH-Playlists nur für Idle (GET …/dooh/active)
(global) maintenanceModeEnabledWartungsmodus für alle Signage-Templates — Reiter Wartungsmodus oder GET …/signage-global-options
(global) maintenanceMessageHinweistext unter dem Logo (Logo: centerLogoUrl / signage-config.logoUrl)
(global) kioskLanguagesSprachumschalter 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).

Keyenable*-Schalter
centerplanenableCenterplan
shopsenableShops
offersenableOffers
foodenableFood
servicesenableServices
nearbyenableNearby
groupSessionenableGroupSession
trafficenableTraffic
transitenableTransitMonitor
socialenableSocialFeed
jobsenableJobs

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):

BedingungQuelle
enableSocialFeed === falseModul aus — kein Social-Screen
Embed mit extrahierbarem src="…" in socialFeedEmbedCodeLegacy: 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:

  1. Modul an, socialFeedEmbedCode leer → GET …/signage-surface → apiHints.socialFeedGet aufrufen → Posts oder profileLinks sichtbar in v0.
  2. Modul an, Embed mit src="https://…" → v0 zeigt iframe, ohne Pflicht-Call auf social-feed (API optional für Parität).
  3. 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).

WertVerhalten auf der Stele
pulse16-Sekunden-Zyklus: 8 s Button sichtbar (mit dezentem Puls), 1 s ausblenden, 6 s Pause ohne Button, 1 s einblenden — wiederholt
noneButton 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.

GruppeFelder
Grundfläche, Kopfbackground, logoText, logoBackground
Info-KartencontentBackground, contentBorder, contentTextBackground, contentText, contentQrCodeBackground, contentQrCode
Hot PickshotPickBackground, hotPickText, hotPickBorder, hotPickOfferBackground, hotPickOfferText
HinweisblasetouchHereBackground, touchHereText
Etagen-Umschalter / NavigationnavInactiveBackground, navInactiveText, navActiveBackground, navActiveText, navActiveIcon
Info-Box unter dem PlanctaTextBackground, 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 leere colorTokens-Objekte) beim Speichern.
  • GET ohne orientation: kiosk.colorTokens (flach) plus kiosk.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): colorTokens im Patch wird mit 400 abgelehnt.
  • Logo-Box (v0): Ist logoBackground gesetzt 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.* und routeColor.

So testen

  1. Reiter Farben → Farben (erweitert): hotPickBackground setzen, speichern.
  2. GET /api/centers/{centerId}/signage-template-options?template=ai-premium → options.kiosk.colorTokens.hotPickBackground vorhanden.
  3. Reiter „Hochformat“: hotPickBackground anders setzen, speichern; GET …&orientation=portrait liefert den Override, …&orientation=landscape den allgemeinen Wert.
  4. Zurück auf „Allgemein“: Hinweis „Hochformat: …“ erscheint neben dem Feld, die Gruppe zeigt „abweichend je Format“.
  5. API-Test: PATCH mit {"templateId":"ai-premium","kiosk":{"colorTokens":{"ctaText":"red"}}} → 400, Meldung nennt kiosk.colorTokens.ctaText.
  6. 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​

FeldWirkung
accentColorCompanion-Akzente (Legacy; v0 bevorzugt colors.accent)
colors.{primary,secondary,background,accent}Companion-Brand-Farben
quickLinkColors.*Optionale Quicklink-Akzente (gleiche Keys wie Kiosk)
showAISuggestionsVorschlags-Chips in der Chatbar
defaultTargetShopStandard-Ziel nach QR-Scan
routeStepsEnabledSchritt-für-Schritt-Wegbeschreibung (aus: nur Route auf der Karte)
menuSearchEnabledSuchfeld oben in der Companion-Seitenleiste
menuHintTitle, menuHintTextHinweisblase 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)​

FeatureDashboard-ToggleDaten-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/EventsenableOffersnews, aktuelles-Bundle
GastronomieenableFoodservices / gefilterte Shops
ServicesenableServicesservices
Hot PicksenableHighlightshotpicks
In der NäheenableNearbysignage-nearby?displayId=
KI-Suche / ConciergeenableAiSearch (+ Companion-KI)Handoff / POST …/ai/visitor-chatbot
Tastatur-SucheenableKeyboardSearchFilter über Shops/Services — ohne KI-Assistent
Shop-Detail-ModalenableShopModal (Default: false)—
Kopfzeile mit LogoenableHeader (Default: true)—
Unteres Quick-MenüenableBottomQuickMenu—
Handoff-QR (aktive Nutzung)enableHandoffQrPOST …/handoff-sessions
Handoff-QR (Ruhebildschirm/Idle)enableHandoffQrIdle (Default: true)POST …/handoff-sessions
Barrierefrei-OverlayenableA11yRouting-Optionen
Gruppen-Session-QRenableGroupSessionGroup-Session-API
Wayfinding Ziel auf Startkarte—Routing API / SVG
Idle-Reset (Datenschutz)—~90 s UX (Teil H)
DOOH IdleenableDoohIdledooh/active (Signage) — dooh/public/active nur bei Website-Kanal

Phase 2 (optional, kann nachziehen)​

FeatureToggle / Quelle
Traffic / Social / ÖPNVenableTraffic, enableSocialFeed, enableTransitMonitor
DOOH dauerhaft unter HeaderdoohPersistentSlotBelowHeader
Grid-Mood (Querformat-Grids)enableGridMoodMedia + bentoQuickLinkMoods.* (Medien & Mood) — gridMoodMediaPlaylistSlug nur Legacy digital-signage
Auto-RefreshautoRefreshMinutes

5. Feature-Parität: Companion (Phase 1)​

Referenz: AIPremiumCompanionShell.tsx

FeatureQuelle
Handoff (sessionKey, shop, screen)URL-Params + PATCH handoff-sessions
Home mit Karte + Hot Picksfloors, hotpicks, template-options
Inline-Route auf HomeWayfinding + Routing
Dedizierter Wayfinding-Screen—
Shop-Detail Vollbildshops/services
Angebots-Listeoffers / aktuelles
Concierge-Chatbarvisitor-chatbot + showAISuggestions
Standort-QR /companion/qr/[id] oder v0-eigener Pfadpublic 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):

  1. GET …/signage-config — Branding, Touchscreens, signagePublicUrl, companionPublicUrl
  2. GET …/signage-template-options?template=ai-premium — Dashboard-Steuerung
  3. GET …/signage-display-config?displayId={touchscreenId} — Standort, Etage, SVG-Start
  4. GET …/public-visitor-surface — Branding, Chatbot-Hinweise, apiHints
  5. Content: hotpicks, shops, services, news?published=true
  6. Optional: signage-nearby, dooh/active (Signage, CORS) oder dooh/public/active (nur bei websiteEnabled), center-config (Traffic-Kontext)

apiHints (public-visitor-surface)​

KeyZweck
signageConfigGetStele, Branding, URLs
signageTemplateOptionsGetAI-Premium-Optionen (?template=ai-premium)
signageDisplayConfigGetStandort/Etage pro Stele
signageNearbyGetIn der Nähe
doohSignageActiveGetDOOH Idle (ohne websiteEnabled)
hotPicksGetHot Picks
handoffSessionPostHandoff Kiosk → Companion
groupSessionPostGruppen-QR
touchscreensGetTouchscreen-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 → alle enable*, 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-premium fü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: /digital-signage/ai-premium-v0-paritaet-und-dashboard-steuerung