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

Comprendere l'area di lavoro

Leggi KPI dell'area, stato Pass Health, conteggi Attivi vs Non installati e isolamento tra tenant.

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

Salute dei pass e azioni consigliate (Zoom)

Monitora il rapporto tra pass attivi e non installati in Pass health e intervieni sulle raccomandazioni automatiche per sollecitare i pass in attesa di installazione.

Stato del workspace e telemetria live

Ogni account Passinstance opera all'interno di un workspace tenant rigorosamente partizionato. Tutte le risorse create in un workspace — inclusi modelli visuali, certificati crittografici di firma, proprietà personalizzate, record dei pass dei clienti, segreti API e storico delle scansioni al punto vendita — sono limitate al proprio ID workspace (customerId) e risultano completamente isolate dalle altre organizzazioni.

Riepilogo stato pass e scheda azioni
Riepilogo stato pass e scheda azioni

Architettura multi-tenant e gerarchia dei workspace

Passinstance implementa una gerarchia organizzativa su due livelli che separa la governance della fatturazione dell'account dalla gestione quotidiana dei pass:

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
GERARCHIA MULTI-TENANT
FASE 01 ORGANIZZAZIONE (Livello Account)
Modello Passinstance database: Organization
Ruoli (OrganizationMemberRole): OWNER, ADMIN, MEMBER
Quote centralizzate del piano e fatturazione Stripe consolidata
FASE 02 1:N Workspace
WORKSPACE DI PRODUZIONE
Record Customer: cust_prod_901
Tipo (Kind): production
Apple .p12 e Auth Google produzione
Wallet clienti e scanner live
Consuma quota Wallet attiva
WORKSPACE SANDBOX
Record Customer: cust_sbx_902
Tipo (Kind): sandbox
Firma demo e pass di test
Ambiente di test isolato
Zero impatto sui limiti del piano

Gestire workspace fratelli tramite l'API Organization

I team che gestiscono più brand, account clienti o ambienti sandbox possono interagire con Organizations API:

Percorso endpointMetodoAuthFunzionalità
/api/v1/organizations/currentGETBearerRestituisce l'organizzazione attiva, i ruoli dei membri e l'elenco dei workspace fratelli accessibili.
/api/v1/organizations/current/billing-summaryGETBearerRiepilogo dei limiti del piano e dei conteggi cumulativi di pass attivi su tutti i workspace.
/api/v1/organizations/current/workspacesPOSTBearerCrea un nuovo workspace fratello (`kind: "production" \"sandbox"`).
/api/v1/organizations/current/workspaces/switchPOSTBearerCambia il contesto tenant attivo e ruota i cookie di sessione autenticati.

Tassonomia delle metriche principali di telemetria

Per monitorare con precisione il programma pass, Passinstance distingue tra la creazione del record lato server e l'installazione fisica nel Wallet:

TEXT
Pass creato (POST /api/v1/passes)  =================>  unclaimedPasses (Non installati)
                                                               |
                                                               | Il cliente aggiunge al Wallet
                                                               v
Dispositivo registrato (POST /v1/devices/...) =====>  installedDevices (Installati)
                                                               |
                                                               | Il cliente rimuove dal Wallet
                                                               v
Dispositivo annullato (DELETE /v1/devices/...) ====>  inactivePasses / inactiveDeviceRegistrations

Definizioni da metric-definitions.ts

  • totalPasses (Total Passes Issued): Conteggio cumulativo dei record pass attivi generati nel workspace che non risultano eliminati al momento dello snapshot.
  • activePasses (Active Passes): Istanze di pass attive che dispongono attualmente di almeno una registrazione dispositivo raggiungibile (esclusi pass scaduti e annullati).
  • installedDevices (Active Device Registrations): Registrazioni di pass salvati e raggiungibili su Apple APNs e Google Wallet. Se un pass è salvato su due dispositivi, conta come due registrazioni attive e consuma capacità del piano di conseguenza.
  • unclaimedPasses (Unclaimed Passes): Istanze di pass attive emesse in Passinstance che non sono mai state salvate in un Wallet.
  • inactivePasses (Removed Passes): Istanze di pass attive salvate in precedenza in un Wallet, ma che non hanno più alcuna registrazione dispositivo raggiungibile (inclusi DELETE /v1/devices/... Apple e callback del Google verso /api/v1/wallet/callback).
  • voidedPasses (Voided Passes) ed expiredPasses (Expired Passes): Istanze di pass revocate lato server oppure oltre expirationDate.

Impostazioni workspace e configurazione regionale

Ogni workspace viene configurato in modo indipendente sotto Impostazioni -> Workspace (/settings/workspace/*):

  • Impostazioni generali e regionali (PUT /api/v1/customer/:customerId/regional-settings): Configura il fuso orario predefinito (resolveCustomerTimeZone), il codice valuta ISO 4217 predefinito e la lingua locale.
  • Quote di utilizzo (GET /api/v1/customer/:customerId/usage-summary): Riporta in tempo reale i pass totali, i pass attivi rispetto a maxActivePasses e il conteggio dei modelli.
  • Vanity domain Whitelabel (/api/v1/white-labeling/vanity-urls): Collega domini personalizzati (domain surface type: PASS_DOWNLOAD, PASS_FLOW, BACKEND_UI, ecc.) con provisioning SSL automatico per tutti gli smart link e le pagine di download.

Importante: I workspace sandbox forniscono un ambiente isolato per testare revisioni dei modelli, webhook API e configurazioni scanner senza consumare capacità di pass attivi dal piano di produzione.

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.