Skip to main content

Signage: Startansicht, Display-Sync und KI-Chat am Kiosk

Auslöser war der Vorfall ALEXA Berlin (Feb 2026): Die Stele zeigte trotz „Centerplan ohne Menü“ noch Kacheln, Änderungen kamen am Display nicht an (Revalidate 401 invalid secret), und der KI-Chat blieb aus, obwohl „Chatbot“ aktiv war.

1. Startansicht / Menüform (ein Feld)​

WasIm Dashboard unter Center → Signage → Stele → Module gibt es ein Feld Startansicht / Menüform mit drei Optionen. Die Rohfelder bleiben als Expertenfelder erhalten.
WarumDrei Einzelfelder (startViewModule, quickMenuLayout, enableBottomQuickMenu) mussten zusammenpassen. enableBottomQuickMenu allein blendet Kacheln nicht aus, entscheidend ist quickMenuLayout.
BetrifftRedaktion/Center-Betrieb, Agenten (MCP), v0-Signage-Frontend (liest unverändert die Rohfelder)
WoDashboard: Stele → Module. MCP: cockpit_update_signage_template_options mit startViewMode. API: PUT/PATCH …/signage-template-options mit kiosk.startViewMode.

Zuordnung (steht auch als Hilfetext im Dashboard):

Option (startViewMode)startViewModulequickMenuLayoutenableBottomQuickMenu
Centerplan ohne Menü (centerplan-only)centerplanbarfalse
Centerplan mit Leiste (centerplan-bar)centerplanbartrue
Kacheln (tiles)centerplangridtrue
  • startViewMode wird nicht gespeichert. Beim Schreiben wird er in die Rohfelder aufgelöst (flach und je Format), beim Lesen aus den Rohfeldern abgeleitet (Antwort-Felder startViewMode, startViewModeByOrientation).
  • Bei Konflikt im selben Patch gewinnt startViewMode gegenüber den Rohfeldern.
  • Andere Startansichten (z. B. Shops, Idle) zeigt das Dashboard als „Benutzerdefiniert“ an. Dann bleiben die Expertenfelder maßgeblich.
  • Pro Format: kiosk.byOrientation.portrait.startViewMode bzw. .landscape.startViewMode.

2. Hochformat/Querformat transparent​

Die Karte Wirksame Werte je Format (Stele → Module) zeigt für wichtige Felder den wirksamen Wert in Hoch- und Querformat und die Quelle: Standard, Allgemein (flach) oder Format-Override. Unterschiede sind hervorgehoben. Reihenfolge zur Laufzeit: Standard, dann Allgemein, dann Format-Override.

3. Revalidate, Display-Stand und „Display neu laden“​

WasBeim Speichern der Signage-Optionen wartet das Dashboard (max. 8 s) auf den Revalidate-Webhook der Signage-Domain und zeigt Erfolg, Teilerfolg oder Fehler als Hinweis. Im Tab Standard zeigt der Abschnitt Displays je Stele: Status, letzter Kontakt, letzter Konfig-Abruf, App-Version und ob der Konfig-Stand aktuell ist. Der Button Display neu laden stößt Revalidate an und liefert Cache-Bust-URLs (?cb=…) für den nächsten Abruf.
WarumOhne Rückmeldung blieb unsichtbar, dass die Signage-Domain Änderungen wegen eines falschen Secrets nie übernommen hat.
BetrifftCenter-Betrieb, IT/Betrieb
WoDashboard: Signage → Standard (Displays), Speichern-Hinweis in den Stele-Reitern. API: GET/POST /api/centers/{centerId}/signage-display-sync.

Telemetrie: Die Anzeige nutzt TouchscreenLocation.deviceInfo.kioskHealth aus dem Heartbeat (kiosk_heartbeat über /api/analytics/usage-events). Felder: appVersion, lastConfigFetchAt und configRevision (Kurz-Hash der gespeicherten Optionen; Dashboard liefert den aktuellen Wert in GET signage-template-options als configRevision). Was das Display nicht meldet, steht als „nicht gemeldet“ da. Für v0: diese drei Felder im Heartbeat-Body (oben, neben appVersion) mitsenden.

4. Revalidate-Secret im Health-Check​

cockpit_signage_health_check enthält den Eintrag revalidate-signage. Er ruft den Webhook der Signage-Domain leicht auf (kein Datenschreibzugriff): grün = Secret und Route ok, rot = z. B. 401 (Secret stimmt nicht) oder 404 (Route fehlt), gelb = keine Signage-URL gepflegt. Rot hebt das Gesamtergebnis auf rot. Mit probeRevalidate=false wird der Aufruf übersprungen.

5. Center-Diff (MCP/API)​

cockpit_diff_signage_options(centerA, centerB, templateId?, orientation?) vergleicht die wirksamen Signage-Optionen zweier Center und listet changed, only-a, only-b. Center-spezifische Vorschau-IDs werden ignoriert. API: GET /api/agencyos/v1/centers/{centerId}/signage-options-diff?compareCenterId=…. Eine Dashboard-Ansicht dazu ist ein Folge-Ticket.

6. KI-Chat am Kiosk (ein Schalter)​

WasDer Schalter KI-Chat am Kiosk (Stele → Module, Karte Suche) setzt alle Voraussetzungen gemeinsam: kiosk.enableAiSearch, Website-Chatbot aktiv, Companion aktiv mit KI-Assistent. Aus nimmt nur die Stele zurück (enableAiSearch=false). Website-Chatbot und Companion bleiben unverändert.
WarumDer Chat braucht drei Bedingungen. chatbot.enabled in den Signage-Optionen allein reicht nicht.
WoDashboard (nur bei gespeicherten Änderungen im Tab bedienbar). MCP: cockpit_signage_kiosk_ai_chat (lesen) und cockpit_update_signage_kiosk_ai_chat (schreiben). API: GET/PUT …/signage-kiosk-ai-chat (Dashboard-Session und AgencyOS).

Bots-Profil 500: Die Chatbot-Konfiguration (aiConfigurations) wird jetzt separat geladen. Scheitert das Laden am Feld enabled, wird ohne dieses Feld erneut gelesen (Standard true) und gewarnt, statt mit 500 abzubrechen. Das ist eine Absicherung, die Ursache auf der Live-Datenbank ist nicht bestätigt.

So testen (ALEXA-ähnliches Center)​

  1. Dashboard → Center → Signage → Stele → Module: Centerplan ohne Menü wählen, speichern. Erwartung: Hinweis zum Revalidate (Erfolg oder konkreter Fehler).
  2. Stele neu laden: keine Kacheln, Centerplan ohne Leiste. Mit Kacheln wechseln: Kacheln sichtbar.
  3. cockpit_signage_health_check aufrufen: revalidate-signage grün. Bei rot: Secret prüfen (Betrieb unten).
  4. Signage → Standard → Displays: letzter Kontakt und Version prüfen, Display neu laden klicken.
  5. KI-Chat am Kiosk einschalten, danach cockpit_signage_kiosk_ai_chat: enabled: true, missing leer.
  6. cockpit_diff_signage_options zwischen ALEXA und einem Referenz-Center aufrufen: Unterschiede bei quickMenuLayout o. ä. sichtbar.

Betrieb​

  • REVALIDATION_SECRET muss auf dem Dashboard (Render, Service mallos-dashboard) und im Vercel-Signage-Projekt identisch sein. Abweichung ergibt 401 invalid secret.
  • Ziele des Webhooks: signagePublicUrl und companionPublicUrl des Centers (POST {origin}/api/revalidate). Globale Website-Ziele optional über CENTER_WEBSITE_URLS bzw. CENTER_WEBSITE_URL.
  • Keine neuen Datenbank-Felder, keine Migration.

Siehe auch: AI-Premium v0-Parität · MCP-Tool-Referenz · AgencyOS-API

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/digital-signage/signage-startansicht-sync-und-ki-chat