Primaire navigatie in de workspace
Het beheerdersdashboard van Passinstance biedt één geïntegreerde interface voor operationele monitoring, de studio voor pasontwerp, bulkverwerking en configuratie voor ontwikkelaars. De navigatiezijbalk links ordent dagelijkse workflows in gespecialiseerde onderdelen:

| Navigatieonderdeel & route | Belangrijkste verantwoordelijkheden | Onderliggende backendmogelijkheden & entiteiten |
|---|---|---|
Dashboard (/dashboard) | Live KPI's van de workspace, realtime gebeurtenistelemetrie en pasgezondheidsstatistieken | Aangedreven door Dashboard Analytics API (/api/v1/dashboards/analytics), rijen met meerdere widgets en realtime gebeurtenisstreams. |
Templates (/templates) | Visuele passtudio met 7 detailtabbladen (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings) | Implementeert versiebeheer in één tabel (Template), risicocontroles vóór publicatie, aangepaste regex-identificatieregels en bundelinstellingen. |
Passes (/passes) | Overzicht van alle uitgegeven passen, opzoeken op externalId, groepering via bundleId, geschiedenistijdlijnen en zijpaneelbewerkingen | Directory voor hoge gelijktijdigheid op basis van structured JSON-eigenschappen, levenscyclustransities (PassLifecycleStatus) en directe deactivering of ongeldigmaking. |
Distribution (/templates/download-pages, /delivery-center, /pass-flows) | Bundelt Download Pages (DownloadPage), Delivery Center (EmailSendCampaign) en Pass Flows (PassFlow) | Beheert openbare claimpagina's (/d/:slug), e-mail-/sms-bezorgcampagnes en meerstaps registratie-/betaalstromen (/f/:url). |
Automations (/automations, /workflows) | Gebeurtenisgestuurde en e-commerce automatiseringsregels | Evalueert UniversalAutomation-regels en Workflow-triggers (workflow trigger type, workflow action type). |
Scanner (/scanner/configs) | Balievalidatie, toegangscontrole bij ingangen, validatielocaties en configuratie van hardwarelezers | Beheert ValidationPlace, ScannerConfiguration, koppelingen met mobiele scanners (ScannerKey) en NFC-/POS-adapters. |
Batch (/batch-processing, /batch-notifications) | Asynchrone wizard voor grootschalige CSV-uitgifte en geplande wallet-meldingen | Stuurt Batch Jobs API (/api/v1/batch-processing) en Batch Notifications API (/api/v1/batch-notifications) aan. |
Wallet Experiences (/wallet-experiences / /pass-projects) | Projecthub voor meerdere kaarten (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings) | Beheert PassProject, PassProjectTemplateRole, .pkpasses-bundels en automatiseringen tussen passen. |
Integrations & Analytics (/settings/workspace/integrations, /analytics) | Gekoppelde CRM-/POS-connectors, webhooks, API-sleutels en rapportagesuites | Beheert webhooks (/api/v1/webhooks/*), afgeschermde API-sleutels en /api/v1/analytics/*-rapporten. |
Dashboardarchitectuur & telemetrie-endpoints
De engine voor dashboardstatistieken wordt aangedreven door een modulaire widget- en cachingarchitectuur (Dashboard, Row, Widget en SharedDashboard-entiteiten in Passinstance database). De backend werkt samen met Cache Manager om snelle analyses te leveren zonder querybelasting op transactionele pastabellen te veroorzaken:
Belangrijkste telemetrie-endpoints
Ontwikkelaars en dataplatformen kunnen deze analyse-endpoints bevragen met standaard Bearer-authenticatie of sessiecookies:
-
GET /api/v1/dashboards/analytics: Retourneert geaggregeerde workspace-statistieken op basis vanDashboard Analytics Engine.getDashboardAnalyticsenCache Manager. -
GET /api/v1/dashboards/metrics/realtime: Biedt hoogfrequente activiteitstellingen in de workspace en recente installatie-/scantelemetrie. -
GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD: Retourneert tijdreekscohorten over een zelfgekozen periode. -
GET /api/v1/dashboards/performance: Monitort operationele prestatiestatistieken voor scans en pasbezorging. -
GET /api/v1/dashboards/insights: Toont geautomatiseerde operationele aanbevelingen in uw workspace. -
GET /api/v1/dashboards/export?format=csv|json|pdf: Exporteert ruwe dashboardtabellen voor BI en reconciliatie.
Functionele hubs & workspace-weergaven
1. Templates Studio (/templates/:id/*)
Maak en bewerk visuele sjablonen verdeeld over 7 tabbladen (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Configureer image asset slot-posities, controleer WCAG-kleurcontrast, beheer aangepaste identificatieregels en werk iteratief in een geïsoleerde DRAFT-status voordat u publiceert.
2. Passendirectory & tijdlijn (/passes)
Zoek door uitgegeven passen met full-text zoekopdrachten en filters (status, templateId, externalId, bundleId). Open een pasrij in Pass Details panel om de chronologische tijdlijn te bekijken (GET /api/v1/passes/:id/history en /timeline), gekoppelde apparaten in te zien of pushupdates te verzenden.
3. Batch Operations Center (/batch-processing)
Volg de wizardstappen (Sjabloon -> CSV uploaden -> Velden koppelen -> Verzendopties -> Verwerken) om passen in bulk uit te geven of bij te werken vanuit CSV-bestanden. Download voorbeeldschema's (GET /api/v1/batch-processing/templates/:templateId/sample-csv), bekijk aanbevelingen voor veldtoewijzing (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) en download /result.csv met elke gegenereerde pas-URL en externalId.
Belangrijk: Alle dashboardtelemetrie en zoekquery's zijn strikt begrensd tot uw actieve workspace-tenant (
customerId). Zuster-workspaces binnen dezelfde organisatie blijven volledig geïsoleerd.
Verken elke weergave interactief in onze Interactieve werkruimterondleiding.
