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)
| Was | Im Dashboard unter Center → Signage → Stele → Module gibt es ein Feld Startansicht / Menüform mit drei Optionen. Die Rohfelder bleiben als Expertenfelder erhalten. |
| Warum | Drei Einzelfelder (startViewModule, quickMenuLayout, enableBottomQuickMenu) mussten zusammenpassen. enableBottomQuickMenu allein blendet Kacheln nicht aus, entscheidend ist quickMenuLayout. |
| Betrifft | Redaktion/Center-Betrieb, Agenten (MCP), v0-Signage-Frontend (liest unverändert die Rohfelder) |
| Wo | Dashboard: 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) | startViewModule | quickMenuLayout | enableBottomQuickMenu |
|---|---|---|---|
Centerplan ohne Menü (centerplan-only) | centerplan | bar | false |
Centerplan mit Leiste (centerplan-bar) | centerplan | bar | true |
Kacheln (tiles) | centerplan | grid | true |
startViewModewird nicht gespeichert. Beim Schreiben wird er in die Rohfelder aufgelöst (flach und je Format), beim Lesen aus den Rohfeldern abgeleitet (Antwort-FelderstartViewMode,startViewModeByOrientation).- Bei Konflikt im selben Patch gewinnt
startViewModegegenü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.startViewModebzw..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“
| Was | Beim 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. |
| Warum | Ohne Rückmeldung blieb unsichtbar, dass die Signage-Domain Änderungen wegen eines falschen Secrets nie übernommen hat. |
| Betrifft | Center-Betrieb, IT/Betrieb |
| Wo | Dashboard: 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)
| Was | Der 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. |
| Warum | Der Chat braucht drei Bedingungen. chatbot.enabled in den Signage-Optionen allein reicht nicht. |
| Wo | Dashboard (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)
- Dashboard → Center → Signage → Stele → Module: Centerplan ohne Menü wählen, speichern. Erwartung: Hinweis zum Revalidate (Erfolg oder konkreter Fehler).
- Stele neu laden: keine Kacheln, Centerplan ohne Leiste. Mit Kacheln wechseln: Kacheln sichtbar.
cockpit_signage_health_checkaufrufen:revalidate-signagegrün. Bei rot: Secret prüfen (Betrieb unten).- Signage → Standard → Displays: letzter Kontakt und Version prüfen, Display neu laden klicken.
- KI-Chat am Kiosk einschalten, danach
cockpit_signage_kiosk_ai_chat:enabled: true,missingleer. cockpit_diff_signage_optionszwischen ALEXA und einem Referenz-Center aufrufen: Unterschiede beiquickMenuLayouto. ä. sichtbar.
Betrieb
REVALIDATION_SECRETmuss auf dem Dashboard (Render, Servicemallos-dashboard) und im Vercel-Signage-Projekt identisch sein. Abweichung ergibt401 invalid secret.- Ziele des Webhooks:
signagePublicUrlundcompanionPublicUrldes Centers (POST {origin}/api/revalidate). Globale Website-Ziele optional überCENTER_WEBSITE_URLSbzw.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