Zentrale Workspace-Navigation
Das administrative Dashboard von Passinstance bietet eine einheitliche Oberfläche für Betriebsmonitoring, Karten-Design-Studio, Massenverarbeitung und Entwicklerkonfiguration. Die linke Navigationsleiste strukturiert Ihre täglichen Arbeitsabläufe in spezialisierte Funktionsbereiche:

| Navigationsbereich & Route | Hauptaufgaben | Zugrunde liegende Backend-Funktionen & Entitäten |
|---|---|---|
Dashboard (/dashboard) | Live-Workspace-KPIs, Echtzeit-Ereignis-Telemetrie und Pass-Health-Kennzahlen | Unterstützt durch Dashboard Analytics API (/api/v1/dashboards/analytics), mehrzeilige Widgets und Echtzeit-Event-Streams. |
Vorlagen (Templates) (/templates) | Visuelles Pass-Studio mit 7 Detail-Tabs (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings) | Bietet Single-Table-Versionierung (Template), Vorab-Risikoprüfungen, benutzerdefinierte ID-Regex-Regeln und Bundle-Einstellungen. |
Pässe (Passes) (/passes) | Verzeichnis aller ausgegebenen Pässe, externalId-Suche, bundleId-Gruppierung, Verlaufs-Timelines und Drawer-Bearbeitung | Leistungsstarkes Verzeichnis auf Basis von structured JSON-Attributen, Lebenszyklusübergängen (PassLifecycleStatus) und sofortiger Deaktivierung/Entwertung. |
Verteilung (Distribution) (/templates/download-pages, /delivery-center, /pass-flows) | Bündelt Download-Seiten (DownloadPage), Delivery Center (EmailSendCampaign) und PassFlows (PassFlow) | Verwaltet öffentliche Abrufseiten (/d/:slug), E-Mail-/SMS-Versandkampagnen und mehrstufige Registrierungs-/Zahlungsstrecken (/f/:url). |
Automationen (/automations, /workflows) | Ereignisgesteuerte und E-Commerce-Automatisierungsregeln | Wertet UniversalAutomation-Regeln und Workflow-Trigger (workflow trigger type, workflow action type) aus. |
Scanner (/scanner/configs) | Kassenvalidierung, Einlass-Check-in, Validation Places und Einrichtung von Hardware-Lesegeräten | Verwaltet ValidationPlace, ScannerConfiguration, mobile Scanner-Kopplungen (ScannerKey) sowie NFC-/POS-Adapter. |
Stapelverarbeitung (Batch) (/batch-processing, /batch-notifications) | Asynchroner CSV-Massenausgabe-Assistent und geplante Wallet-Benachrichtigungen | Steuert Batch Jobs API (/api/v1/batch-processing) und Batch Notifications API (/api/v1/batch-notifications). |
Wallet Experiences (/wallet-experiences / /pass-projects) | Multi-Karten-Projektzentrale (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings) | Verwaltet PassProject, PassProjectTemplateRole, .pkpasses-Bundles und vorlagenübergreifende Automationen. |
Integrationen & Analysen (/settings/workspace/integrations, /analytics) | Verbundene CRM-/POS-Konnektoren, Webhooks, API-Schlüssel und Reporting-Suiten | Verwaltet Webhooks (/api/v1/webhooks/*), berechtigungsbegrenzte API-Schlüssel und /api/v1/analytics/*-Berichte. |
Dashboard-Architektur & Telemetrie-Endpunkte
Die Metrik-Engine des Dashboards basiert auf einer modularen Widget- und Caching-Architektur (Dashboard, Row, Widget und SharedDashboard in Passinstance database). Das Backend arbeitet mit Cache Manager zusammen, um reaktionsschnelle Analysen ohne Abfragelast auf transaktionalen Pass-Tabellen bereitzustellen:
Wichtige Telemetrie-Endpunkte
Entwickler und Datenplattformen können diese Analyse-Endpunkte per Bearer-Token oder Session-Cookie abfragen:
-
GET /api/v1/dashboards/analytics: Liefert aggregierte Workspace-Metriken überDashboard Analytics Engine.getDashboardAnalyticsundCache Manager. -
GET /api/v1/dashboards/metrics/realtime: Liefert hochfrequente Aktivitätszahlen sowie aktuelle Installations- und Scan-Telemetrie. -
GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD: Liefert Zeitreihen-Kohorten über einen frei wählbaren Zeitraum. -
GET /api/v1/dashboards/performance: Überwacht die operative Performance von Scans und Pass-Auslieferungen. -
GET /api/v1/dashboards/insights: Zeigt automatisierte operative Empfehlungen für Ihren Workspace an. -
GET /api/v1/dashboards/export?format=csv|json|pdf: Exportiert Dashboard-Kennzahlentabellen für BI-Systeme und Abstimmungen.
Funktionsbereiche & Workspace-Ansichten
1. Vorlagen-Studio (/templates/:id/*)
Erstellen und bearbeiten Sie visuelle Vorlagen in 7 Tabs (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Konfigurieren Sie image asset slot-Slots, prüfen Sie WCAG-Farbkontraste, definieren Sie benutzerdefinierte ID-Regeln und testen Sie Änderungen isoliert im Zustand DRAFT, bevor Sie veröffentlichen.
2. Pass-Verzeichnis & Timeline (/passes)
Durchsuchen Sie ausgegebene Pässe per Volltextsuche und Filterkriterien (status, templateId, externalId, bundleId). Öffnen Sie jeden Pass im Pass Details panel, um die chronologische Timeline (GET /api/v1/passes/:id/history und /timeline) und gekoppelte Geräte einzusehen oder Push-Updates auszulösen.
3. Stapelverarbeitungs-Zentrale (/batch-processing)
Folgen Sie den Assistenten-Schritten (Vorlage -> CSV hochladen -> Felder zuordnen -> Versandoptionen -> Verarbeiten), um Pässe per CSV-Datei massenhaft auszugeben oder zu aktualisieren. Laden Sie Beispielschemata herunter (GET /api/v1/batch-processing/templates/:templateId/sample-csv), nutzen Sie Empfehlungen zur Feldzuordnung (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) und laden Sie /result.csv mit allen erzeugten Pass-URLs und externalId-Werten herunter.
Wichtig: Alle Dashboard-Telemetrie- und Suchabfragen sind strikt auf Ihren aktiven Workspace-Mandanten (
customerId) beschränkt. Schwester-Workspaces innerhalb derselben Organisation bleiben vollständig getrennt.
Erkunden Sie jede Ansicht interaktiv in unserer interaktiven Workspace-Tour.
