Navigazione principale del workspace
La dashboard amministrativa di Passinstance fornisce un'interfaccia unificata per il monitoraggio operativo, l'editor visuale delle tessere, l'elaborazione batch di massa e la configurazione per sviluppatori. La barra di navigazione laterale sinistra organizza i flussi quotidiani in hub funzionali specializzati:

| Hub di navigazione e percorso | Responsabilità principali | Funzionalità ed entità backend sottostanti |
|---|---|---|
Dashboard (/dashboard) | KPI live del workspace, telemetria eventi in tempo reale e metriche sullo stato dei pass | Supportato da Dashboard Analytics API (/api/v1/dashboards/analytics), righe multi-widget e flussi di eventi in tempo reale. |
Modelli (/templates) | Studio visuale dei pass con 7 schede di dettaglio (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings) | Implementa versioning a tabella singola (Template), verifiche del rischio pre-pubblicazione, regole regex per identificativi personalizzati e impostazioni bundler. |
Pass (/passes) | Directory di tutti i pass emessi, ricerca per externalId, raggruppamento bundleId, timeline storica e modifiche da pannello laterale | Directory ad alta concorrenza basata su attributi structured JSON, transizioni di ciclo di vita (PassLifecycleStatus) e disattivazione/annullamento istantaneo. |
Distribuzione (/templates/download-pages, /delivery-center, /pass-flows) | Raggruppa Pagine di download (DownloadPage), Centro consegne (EmailSendCampaign) e Pass Flow (PassFlow) | Gestisce pagine pubbliche di richiesta (/d/:slug), campagne di consegna e-mail/SMS e acquisizione multi-step con modulo/pagamento (/f/:url). |
Automazioni (/automations, /workflows) | Regole di automazione basate su eventi e su e-commerce | Valuta le regole UniversalAutomation e i trigger Workflow (workflow trigger type, workflow action type). |
Scanner (/scanner/configs) | Validazione in cassa, check-in ai varchi, luoghi di validazione e configurazione lettori hardware | Gestisce ValidationPlace, ScannerConfiguration, abbinamenti di scanner mobili (ScannerKey) e adattatori NFC/POS. |
Operazioni batch (/batch-processing, /batch-notifications) | Procedura guidata asincrona per emissione CSV ad alto volume e notifiche Wallet pianificate | Controlla Batch Jobs API (/api/v1/batch-processing) e Batch Notifications API (/api/v1/batch-notifications). |
Wallet Experiences (/wallet-experiences / /pass-projects) | Hub progetti multi-carta (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings) | Gestisce PassProject, PassProjectTemplateRole, bundle .pkpasses e automazioni cross-pass. |
Integrazioni e Analytics (/settings/workspace/integrations, /analytics) | Connettori CRM/POS collegati, webhook, chiavi API e suite di reportistica | Gestisce webhook (/api/v1/webhooks/*), chiavi API con scope e report /api/v1/analytics/*. |
Architettura della dashboard ed endpoint di telemetria
Il motore metrico della dashboard si basa su un'architettura modulare di widget e caching (entità Passinstance database Dashboard, Row, Widget e SharedDashboard). Il backend collabora con Cache Manager per fornire analytics reattive senza appesantire le tabelle transazionali dei pass:
Principali endpoint di telemetria
Sviluppatori e piattaforme dati possono interrogare questi endpoint analitici tramite autenticazione standard Bearer o cookie di sessione:
-
GET /api/v1/dashboards/analytics: Restituisce le metriche aggregate del workspace fornite daDashboard Analytics Engine.getDashboardAnalyticseCache Manager. -
GET /api/v1/dashboards/metrics/realtime: Fornisce conteggi ad alta frequenza sull'attività del workspace e telemetria recente di installazioni/scansioni. -
GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD: Restituisce coorti in serie temporali su un intervallo personalizzato. -
GET /api/v1/dashboards/performance: Monitora le metriche operative di prestazioni su scansioni e consegne pass. -
GET /api/v1/dashboards/insights: Evidenzia raccomandazioni operative automatizzate per l'intero workspace. -
GET /api/v1/dashboards/export?format=csv|json|pdf: Esporta le tabelle grezze delle metriche dashboard per BI e riconciliazione.
Hub funzionali e viste del workspace
1. Studio Modelli (/templates/:id/*)
Crea e modifica modelli visuali attraverso 7 schede (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Consente di configurare gli slot image asset slot, verificare il contrasto colori WCAG, gestire regole regex per identificativi personalizzati e iterare in uno stato DRAFT isolato prima della pubblicazione.
2. Directory Pass e Timeline (/passes)
Effettua ricerche su tutti i pass emessi utilizzando ricerca full-text e filtri (status, templateId, externalId, bundleId). Aprendo qualsiasi riga in Pass Details panel è possibile ispezionarne la timeline cronologica (GET /api/v1/passes/:id/history e /timeline), visualizzare i dispositivi abbinati o inviare aggiornamenti push.
3. Centro operazioni batch (/batch-processing)
Segue i passaggi della procedura guidata (Modello -> Carica CSV -> Mappa campi -> Opzioni di invio -> Elabora) per emettere o aggiornare pass in blocco da file CSV. Permette di scaricare schemi di esempio (GET /api/v1/batch-processing/templates/:templateId/sample-csv), esaminare i suggerimenti di mapping dei campi (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) e scaricare /result.csv con ogni URL di pass generato e relativo externalId.
Importante: Tutta la telemetria e tutte le ricerche della dashboard sono rigorosamente limitate al tenant del workspace attivo (
customerId). I workspace fratelli all'interno della stessa organizzazione rimangono completamente isolati.
Esplori ogni vista in modo interattivo nel nostro Tour interattivo del workspace.
