Skip to content
Helpcentrum-gids · DashboardoverzichtOnboardingfase 6
3 min leestijdGecontroleerd 2026-11-16

Uw werkruimte begrijpen

Lees werkruimte-KPI's, Pass Health-grafieken, geïnstalleerde vs. openstaande kaarten en tenantisolatie.

In deze gids

Interactieve UI-weergaven

Openen in onboardinggids (6 fasen)

Bekijk de exacte dashboardpanelen, knoppen en ingezoomde toelichtingen bij deze gids.

Ingezoomde UI-focus
Belangrijke UI-onderdelen

Pasgezondheid & aanbevolen acties (Ingesneden)

Volg de verhouding tussen actieve en niet-geïnstalleerde passen onder Pass health en onderneem actie op automatische aanbevelingen voor passen die wachten op installatie.

Workspace-gezondheid & live telemetrie

Elk Passinstance-account werkt binnen een strikt gescheiden tenant-workspace. Alle assets die binnen een workspace worden aangemaakt — waaronder visuele sjablonen, cryptografische ondertekeningscertificaten, aangepaste eigenschappen, pasrecords van klanten, API-geheimen en scangeschiedenis van de kassa — zijn gekoppeld aan uw workspace-ID (customerId) en volledig geïsoleerd van andere organisaties.

Overzicht van pasgezondheid en actiekaart
Overzicht van pasgezondheid en actiekaart

Multi-tenant architectuur & workspace-hiërarchie

Passinstance hanteert een tweetrapshiërarchie voor organisaties, waarmee accountfacturatie wordt gescheiden van dagelijks pasbeheer:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
MULTI-TENANT HIËRARCHIE
FASE 01 ORGANIZATION (Accountniveau)
Passinstance database-model: Organization
Rollen (OrganizationMemberRole): OWNER, ADMIN, MEMBER
Gecentraliseerde abonnementsquota & geconsolideerde Stripe-facturatie
FASE 02 1:N Workspaces
PRODUCTION WORKSPACE
Customer-record: cust_prod_901
Soort (kind): production
Productie Apple .p12 & Google Auth
Live klant-wallets & scanners
Telt mee voor Actieve Wallet-quotum
SANDBOX WORKSPACE
Customer-record: cust_sbx_902
Soort (kind): sandbox
Demo-ondertekening & testpassen
Geïsoleerde testomgeving
Geen impact op abonnementslimieten

Zuster-workspaces beheren via de Organization API

Teams die meerdere merken, klantaccounts of sandbox-omgevingen beheren, kunnen de Organizations API gebruiken:

EndpointpadMethodeAuthFunctionaliteit
/api/v1/organizations/currentGETBearerRetourneert de actieve organisatie, ledenrollen en een lijst van toegankelijke zuster-workspaces.
/api/v1/organizations/current/billing-summaryGETBearerOverzicht van abonnementslimieten en cumulatieve aantallen actieve passen over alle workspaces.
/api/v1/organizations/current/workspacesPOSTBearerMaakt een nieuwe zuster-workspace aan (`kind: "production" \"sandbox"`).
/api/v1/organizations/current/workspaces/switchPOSTBearerSchakelt naar een andere actieve tenantcontext en roteert authenticatiesessiecookies.

Taxonomie van kerntelemetriestatistieken

Om uw pasprogramma nauwkeurig te volgen, maakt Passinstance onderscheid tussen serverzijdige recordaanmaak en fysieke wallet-installatie:

TEXT
Pas aangemaakt (POST /api/v1/passes) ===============> unclaimedPasses (Niet geïnstalleerd)
                                                               |
                                                               | Klant voegt toe aan Wallet
                                                               v
Apparaat geregistreerd (POST /v1/devices/...) ======> installedDevices (Geïnstalleerd)
                                                               |
                                                               | Klant verwijdert uit Wallet
                                                               v
Apparaat afgemeld (DELETE /v1/devices/...) =========> inactivePasses / inactiveDeviceRegistrations

Definities uit metric-definitions.ts

  • totalPasses (Totaal uitgegeven passen): Cumulatief aantal live pasrecords dat in uw workspace is gegenereerd en op het moment van de meting niet is verwijderd.
  • activePasses (Actieve passen): Live pasinstanties die momenteel ten minste één bereikbare apparaatregistratie hebben (exclusief verlopen en ongeldig verklaarde passen).
  • installedDevices (Actieve apparaatregistraties): Bereikbare opgeslagen pasregistraties via Apple APNs en Google Wallet. Als één pas op twee apparaten is opgeslagen, telt dit als twee actieve registraties en telt het mee in de abonnementcapaciteit.
  • unclaimedPasses (Niet-geclaimde passen): Live pasinstanties die in Passinstance zijn uitgegeven maar nog nooit in een wallet zijn opgeslagen.
  • inactivePasses (Verwijderde passen): Live pasinstanties die eerder in een wallet waren opgeslagen, maar geen bereikbare apparaatregistraties meer hebben (inclusief Apple DELETE /v1/devices/... en Google del-callbacks naar /api/v1/wallet/callback).
  • voidedPasses (Ongeldig verklaarde passen) & expiredPasses (Verlopen passen): Pasinstanties die aan de serverzijde zijn ingetrokken of waarvan expirationDate is verstreken.

Workspace-instellingen & regionale configuratie

Elke workspace wordt afzonderlijk geconfigureerd onder Instellingen -> Workspace (/settings/workspace/*):

  • Algemene & regionale instellingen (PUT /api/v1/customer/:customerId/regional-settings): Configureert de standaardtijdzone (resolveCustomerTimeZone), de standaard ISO 4217-valutacode en de taallocale.
  • Gebruiksquota (GET /api/v1/customer/:customerId/usage-summary): Rapporteert realtime totaal aantallen passen, actieve passen afgezet tegen maxActivePasses en aantallen sjablonen.
  • Whitelabel eigen domeinen (/api/v1/white-labeling/vanity-urls): Koppelt aangepaste domeinen (domain surface type: PASS_DOWNLOAD, PASS_FLOW, BACKEND_UI, enz.) met geautomatiseerde SSL-provisioning voor alle slimme links en downloadpagina's.

Belangrijk: Sandbox-workspaces bieden een geïsoleerde omgeving om sjabloonrevisies, API-webhooks en scannerconfiguraties te testen zonder actieve pascapaciteit van uw productieabonnement te verbruiken.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.