LOOP im Dashboard (Pilot)
Was
Unter Marketing Cockpit → Bonus & Loyalität (/dashboard/loyalty) steuern Center-Betrieb und Marketing das LOOP-Programm. Die frühere Demo-Seite mit Platzhalter-Kennzahlen ist ersetzt: alle Zahlen und Einstellungen kommen aus dem echten LOOP-Backend.
| Seite | Pfad | Inhalt |
|---|---|---|
| Übersicht | /dashboard/loyalty | Prüfliste „Bereit für Besucher“ mit direkten Aktionen (siehe unten), Kennzahlen (7/30/90 Tage), Stempel je Shop |
| Auswertung | /dashboard/loyalty/analytics | Trend zur Vorperiode (Stempel, Einlösungen, Punkte, händische Stempel), Verlauf pro Tag, Nutzung (aktive Karten, Stempel je aktiver Karte, Anteil händisch), Anteile je Shop, CSV-Export |
| Programm | /dashboard/loyalty/program | Programm an/aus, Punkte pro Stempel, Sperrfrist (Standard 8 Minuten), Limits für verschenkte Stempel, Punkte-Prämie (Prämie, Punkte je Einlösung, Einlöse-Shop, z. B. „1 Stunde gratis parken“ am Parkhaus), Adresse der LOOP-Anwendung (Basis der QR-/NFC-Adresse, Hinweis auf /loop/stempel) |
| Stempelkarten | /dashboard/loyalty/stamp-cards | Eine Karte pro Shop: Titel, Prämie, Anzahl Stempel, aktiv/inaktiv, Laden-PIN zum Verschenken (Status: gesetzt, fehlt, gesperrt), Schalter PIN beim Einlösen verlangen (Modus C), Links zu den nächsten Schritten |
| Stempelpunkte | /dashboard/loyalty/stamp-points | Adresse der LOOP-Anwendung (gleiches Feld wie unter Programm), Codes für NFC-Tag bzw. QR-Code an der Kasse (je Shop, optional Bezeichnung), QR-Code anzeigen/drucken, Punkt deaktivieren/aktivieren |
| Wallet | /dashboard/loyalty/wallet-config | Wallet an/aus, Passcreator-Template-ID, Pass-Aktualisierung, optionale Mitteilung |
Warum
Das Backend (Public-API, Dashboard-/AgencyOS-API, Wallet) ist live. Ohne Oberfläche konnten nur Entwickler und Agenten das Programm pflegen. Der Pilot gibt dem Center-Betrieb dieselben Funktionen im Cockpit.
Wer ist betroffen
Center-Betrieb und Marketing mit LOOP-Admin-Rolle (Super-Admin, Developer, Platform-Admin, Center-Admin, Org-Marketing-Manager, Center-Manager). Die Kennzahlen in der Übersicht sind zusätzlich für Redaktion und Assistenz lesbar; die Unterseiten zum Bearbeiten nur für die Admin-Rollen.
Wo
- Dashboard: Marketing Cockpit → Bonus & Loyalität. Das Center wird über den Center-Switcher gewählt (bei mehreren Centern ist eine explizite Auswahl nötig).
- API (Session-Auth):
/api/centers/{centerId}/loyalty/{program,stamp-cards,stamp-points,wallet-config,stats,shops}— Vertrag siehe LOOP Loyalty — API-Vertrag.
So testen
- Center wählen,
/dashboard/loyaltyöffnen: Die Prüfliste zeigt die offenen Schritte, jeweils mit Aktion. - Programm aktivieren direkt in der Prüfliste klicken (speichert sofort, Schritt springt auf Erledigt). Alternativ unter Programm.
- Stempelkarte anlegen bzw. Stempelpunkt anlegen öffnet die jeweilige Unterseite: Shop wählen, anlegen (bei Punkten Code kopieren).
- Adresse der LOOP-Anwendung eintragen (Programm oder Stempelpunkte), z. B.
https://<v0-Domain>/loop/stempel, speichern. Das Feld zeigt ein Beispiel für den QR-Inhalt und weist auf/loop/stempelhin, wenn der Pfad abweicht. - Übersicht neu laden: Pflichtschritte sind erledigt, die Anzeige springt auf „Bereit für Besucher“; nach den ersten Stempeln erscheinen Zahlen je Shop.
- Optional: An einer Stempelkarte PIN beim Einlösen verlangen einschalten (Modus C, braucht eine gesetzte Laden-PIN). Die Besucher-Anwendung zeigt dann das PIN-Feld vor dem Wischen.
- Punkte-Prämie unter Programm: Prämie („1 Stunde gratis parken“), Punkte je Einlösung (z. B. 100) und den Einlöse-Shop (z. B. das Parkhaus) wählen, speichern. Für diesen Shop unter Stempelpunkte einen Stempelpunkt anlegen; eine Stempelkarte braucht er nicht. Besucher sehen die Prämie mit Fortschritt auf ihrer Karte und lösen sie am Stempelpunkt mit grünem Bildschirm und Wischen ein.
- Auswertung öffnen: Zeitraum wählen, Trend, Verlauf pro Tag und Anteile je Shop prüfen, bei Bedarf CSV exportieren. Dieselben Kennzahlen (Stempel, Einlösungen, Karten, Punkte, Top-Shops) stehen bei aktivem Programm auch im Kunden-Reporting für den gewählten Berichtszeitraum.
- Stempelpunkte: Nach dem Anlegen öffnet sich der QR-Code; später über QR-Code in der Zeile. Der Dialog nutzt die gespeicherte Adresse (ohne Adresse enthält der QR nur den Code und zeigt einen Hinweis mit Link zu Programm). Drucken oder PNG für die Kasse. Deaktivieren sperrt den Code sofort, Aktivieren schaltet ihn wieder frei.
Prüfliste „Bereit für Besucher“
Die Übersicht zeigt, was vor dem Start fehlt. Pflichtschritte (sonst „Noch nicht vollständig“):
| Schritt | Warum |
|---|---|
| Programm aktiv | Solange es aus ist, sind Karten, Stempel und Einlösungen gesperrt |
| Mindestens eine aktive Stempelkarte | Ohne Karte gibt es nichts zu sammeln |
| Mindestens ein aktiver Stempelpunkt | Der NFC-/QR-Code an der Kasse |
| Jeder aktive Stempelpunkt hat eine aktive Stempelkarte im selben Shop | Sonst sehen Besucher beim Stempeln einen Fehler |
| Adresse der LOOP-Anwendung gespeichert | Ohne sie enthält der QR nur den Code |
Empfehlungen (Badge „Empfohlen“, blockieren nicht): Laden-PIN an allen aktiven Stempelkarten (ohne PIN kann das Personal nichts verschenken) und Wallet eingerichtet (Template-ID, aktiviert, Server-Schlüssel vorhanden).
Welche Zustände die Besucher-Oberfläche behandeln muss (Offline, Wallet auf iPhone und Android, Signage, Fehlercodes), steht in der Screen-Map.
Betrieb
Vor dem Deploy zwei additive Migrationen ausführen: 20261009210000_loop_visitor_app_base_url_SAFE.sql (Adresse der LOOP-Anwendung) und 20261009220000_loop_redeem_pin_SAFE.sql (PIN beim Einlösen). Beide legen nur neue Spalten an, bestehende Daten bleiben unverändert.
Wallet braucht PASSCREATOR_API_KEY auf dem Server (Render). Fehlt der Schlüssel, zeigt die Wallet-Seite einen Hinweis; Einstellungen sind trotzdem speicherbar.
Grenzen im Pilot
- Stempelpunkte lassen sich deaktivieren und wieder aktivieren, aber nicht löschen (die Stempel-Historie verweist auf den Punkt). Ein deaktivierter Code liefert am Public-Endpunkt
404. - Die Übersicht und die Auswertung zeigen nur Summen und einen Verlauf pro Tag, keine einzelnen Karten. Altersgruppen, Top-Prämien und eine Einlöse-Oberfläche gibt es noch nicht (Folgearbeit). Der Vorperioden-Vergleich wird aus den Stats für N und 2 N Tage gerechnet (bis 90 Tage Zeitraum).
- Die Prüfliste kann das Programm nur aktivieren; Deaktivieren und Regeln bleiben unter Programm.
- Das URL-Format hinter dem NFC-/QR-Code legt die LOOP-Anwendung (v0-Frontend) fest (Vertrag:
/loop/stempel); das Dashboard hängt nur den Code an die gespeicherte Adresse. - Schon gedruckte QR-Codes und beschriebene NFC-Tags behalten die alte Adresse. Nach einer Änderung der Adresse neu erzeugen.
- Nicht im Cockpit: v0-Oberflächen, NFC-Hardware, Wallet-Pass-Design, vollständiger Betrugsschutz (siehe Screen-Map).
- Wallet-Branding: Pass-Design (Logo, Farben, Layout) wird nicht im Cockpit gestaltet — nur Template-ID und Sync-Optionen unter Wallet (
/dashboard/loyalty/wallet-config). Die Template-Anlage bleibt in Passcreator. - Ein Master-Template genügt: Dieselbe Template-ID darf bei mehreren Centern eingetragen werden. Der Centername auf dem Pass kommt automatisch aus den Cockpit-Center-Daten. Im Passcreator-Editor des Templates diese dynamischen Felder anlegen:
centerName,cardNumber,pointsBalance,storedValue(optional zusätzlichcenterSlug). OhnecenterNameim Template erscheint der Centername nicht auf dem Pass. Details: API-Vertrag, Wallet.
Später möglich, heute nicht da: LOOP-Pässe vollständig aus dem Cockpit branden (Passcreator Template-API + Dashboard-UI) oder langfristig eigener Apple/Google-Issuer ohne Passcreator.
Epic und Priorisierung: project_specs.md → LOOP Wallet — Branding aus Cockpit / eigener Issuer.
Pilot: CARRÉ Bad Cannstatt
| Center | CARRÉ Bad Cannstatt |
| Slug | carre-bad-cannstatt |
| centerId | e6deaa57-8a5f-4ff6-8790-c538cf068d16 |
Die UUID stammt aus der Shadow-Datenbank (ShoppingCenter); das Produktivsystem nutzt dieselbe Zeile, sofern der Datenstand synchron ist. Vor dem ersten Einsatz in Produktion mit GET /api/public/loyalty/wallet/capabilities?centerId=… oder dem Center-Switcher gegenprüfen.
Einrichtung in der Reihenfolge
-
Programm aktivieren (Dashboard: Programm → Aktiv, oder
PUT /api/centers/{centerId}/loyalty/programmit{ "isActive": true }). Vorher liefern alle Public-Routen409 PROGRAM_INACTIVE. -
Stempelkarte je Pilot-Shop (
POST …/loyalty/stamp-cards):{ "shopId": "<Shop-UUID>", "title": "Stempelkarte", "rewardTitle": "Gratis-Cappuccino", "stampsRequired": 10, "isActive": true, "staffPin": "4711" }staffPin(optional, 4–6 Ziffern) ist die Laden-PIN: Damit verschenkt das Personal am Kundenhandy Stempel. Es gibt keine Händler-App; das Personal braucht kein eigenes Gerät.Shop-Auswahl:
GET …/loyalty/shops(Dashboard-Session). -
Stempelpunkt je Kasse (
POST …/loyalty/stamp-points):{ "shopId": "<Shop-UUID>", "label": "Kasse 1" }. Antwort enthältcodefür die NFC-/QR-URL. -
Wallet (optional, erst wenn Passcreator-Template steht):
PATCH /api/agencyos/v1/centers/{centerId}/loyalty/wallet-configmit{ "isEnabled": true, "passcreatorTemplateId": "<Template-ID>", "autoSyncOnStamp": true }. Voraussetzung:PASSCREATOR_API_KEYauf Render.
QR-Code und Stempel-URL (Vorschlag für v0)
Das Dashboard hängt nur ?code=<Stempelpunkt-Code> an eine Basis-URL; den Pfad legt das v0-Frontend fest. Vorschlag für die Besucher-App (v0):
https://<v0-Domain>/loop/stempel?code=<Stempelpunkt-Code>
Die Seite liest code, hält den Karten-Token des Besuchers und ruft serverseitig POST /api/public/loyalty/stamps mit { "code": "…", "source": "qr" } auf. Das Team trägt die Basis-URL einmal je Center ein (https://<v0-Domain>/loop/stempel, Programm oder Stempelpunkte); sie liegt im Programm (visitorAppBaseUrl) und gilt für alle Teammitglieder und Geräte. Eine früher nur im Browser gemerkte Adresse wird einmalig als Vorbelegung angeboten und beim Speichern übernommen. Solange keine Adresse (https) gespeichert ist, enthält der QR-Code nur den Code und zeigt einen Hinweis. Codes bleiben vertraulich: nur im Tag bzw. QR an der Kasse des jeweiligen Shops verwenden.
Für v0 (Companion-Frontend)
- Public-API-Basis:
https://dashboard.cockpit-os.de/api/public/loyalty/*(Vertrag: LOOP Loyalty — API-Vertrag). - Signage und Companion/NOW! sind v0-Konsumenten, keine Dashboard-Mocks. Das Dashboard liefert nur Regeln, Daten und Stempelpunkt-Codes.
- v0 braucht
centerId(oben) bzw. Slugcarre-bad-cannstatt; Karten-Token (cardToken) pro Besucher speichern. - Public-Loyalty-Routen mit
Authorization-Header aus v0 serverseitig (BFF-Route) aufrufen, nicht direkt aus dem Browser fremder Domains (CORS-Allowlist nur*.cockpit-os.de). - Schreibende Konfiguration bleibt im Cockpit (Dashboard-Session oder MCP/AgencyOS) — nie aus dem v0-Frontend.
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/dashboard/loop-loyalty-dashboard