Skip to content
Guida del Centro assistenza · Panoramica della dashboardFase di onboarding 1
4 min di letturaVerificato 2026-11-16

Navigare nella dashboard

Trova subito Modelli, Pass, Wallet Experiences, Centro consegne, Scanner, Azioni in blocco e Impostazioni.

In questa guida

Guide visive interattive UI

Apri nella guida in 6 fasi

Esplora schermate reali della dashboard e dettagli ingranditi collegati a questa guida.

Focus UI ingrandito
Elementi chiave dell'interfaccia

Dashboard Workspace — KPI e Trend live (Ingrandito)

A sistema avviato, monitora Active in Wallets, Removed, Not Installed insieme alle curve di creazione e registrazione.

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:

Navigazione barra laterale del workspace
Navigazione barra laterale del workspace
Hub di navigazione e percorsoResponsabilità principaliFunzionalità ed entità backend sottostanti
Dashboard (/dashboard)KPI live del workspace, telemetria eventi in tempo reale e metriche sullo stato dei passSupportato 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 lateraleDirectory 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-commerceValuta 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 hardwareGestisce 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 pianificateControlla 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 reportisticaGestisce 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:

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
PIPELINE TELEMETRIA DASHBOARD
FASE 01 Dashboard Client
(React / Vite)
FASE 02 Dashboard Analytics API
(/api/v1/dashboards/analytics
/metrics/realtime)
FASE 03 | Cache Manager
(Cache con scope RBAC e invalidazione eventi)
FASE 02 Aggregati database
Conteggi Pass/Device

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 da Dashboard Analytics Engine.getDashboardAnalytics e Cache 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.

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.