Skip to content
Guía del Centro de ayuda · Vista general del panelFase de incorporación 6
3 min de lecturaVerificado 2026-11-16

Comprender tu espacio de trabajo

Interpreta KPIs, salud de pases, registros activos vs. no instalados y el aislamiento por inquilino.

En esta guía

Recorridos visuales interactivos

Abrir en la guía de 6 fases

Inspecciona las pantallas reales del panel y las anotaciones ampliadas de esta guía.

Enfoque de interfaz ampliado
Elementos clave de la interfaz

Salud de los pases y acciones recomendadas (Zoom)

Controla la proporción de pases activos frente a no instalados en Pass health y actúa sobre las recomendaciones automáticas para dar seguimiento a pases pendientes de instalación.

Salud del espacio de trabajo y telemetría en vivo

Cada cuenta de Passinstance opera dentro de un espacio de trabajo por inquilino estrictamente particionado. Todos los activos creados en un espacio de trabajo —incluidas las plantillas visuales, los certificados de firma criptográfica, las propiedades personalizadas, los registros de pases de clientes, los secretos de API y el historial de escaneos en punto de venta— quedan vinculados a su ID de espacio de trabajo (customerId) y completamente aislados de otras organizaciones.

Resumen de salud de pases y tarjeta de acciones
Resumen de salud de pases y tarjeta de acciones

Arquitectura multitenant y jerarquía de espacios de trabajo

Passinstance implementa una jerarquía organizativa en dos niveles que separa el gobierno de la facturación de la cuenta de la gestión diaria de los pases:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
JERARQUÍA MULTITENANT
ETAPA 01 ORGANIZACIÓN (Nivel de cuenta)
Modelo Passinstance database: Organization
Roles (OrganizationMemberRole): OWNER, ADMIN, MEMBER
Cuotas centralizadas de suscripción y facturación consolidada con Stripe
ETAPA 02 1:N Espacios de trabajo
ESPACIO DE TRABAJO DE PRODUCCIÓN
Registro Customer: cust_prod_901
Tipo (kind): production
Certificado Apple .p12 y Auth Google
Monederos y escáneres en producción
Consume cuota de monederos activos
ESPACIO DE TRABAJO SANDBOX
Registro Customer: cust_sbx_902
Tipo (kind): sandbox
Firma de demostración y pruebas
Entorno de pruebas aislado
Impacto cero en límites del plan

Gestión de espacios de trabajo hermanos mediante la API de Organización

Los equipos que administran varias marcas, cuentas de clientes o entornos de prueba pueden interactuar con Organizations API:

Ruta del endpointMétodoAuthFuncionalidad
/api/v1/organizations/currentGETBearerDevuelve la organización activa, los roles de miembro y el listado de espacios de trabajo hermanos accesibles.
/api/v1/organizations/current/billing-summaryGETBearerResumen de límites del plan y recuento acumulado de pases activos en todos los espacios de trabajo.
/api/v1/organizations/current/workspacesPOSTBearerCrea un nuevo espacio de trabajo hermano (`kind: "production" \"sandbox"`).
/api/v1/organizations/current/workspaces/switchPOSTBearerCambia el contexto de inquilino activo y rota las cookies de sesión autenticada.

Taxonomía de métricas centrales de telemetría

Para supervisar su programa de pases con precisión, Passinstance distingue entre la creación del registro en servidor y la instalación física en un monedero:

TEXT
Pase creado (POST /api/v1/passes)  ================>  unclaimedPasses (No instalado)
                                                               |
                                                               | El cliente añade al Wallet
                                                               v
Dispositivo registrado (POST /v1/devices/...) ====>  installedDevices (Instalado)
                                                               |
                                                               | El cliente elimina del Wallet
                                                               v
Dispositivo anulado (DELETE /v1/devices/...) =====>  inactivePasses / inactiveDeviceRegistrations

Definiciones de metric-definitions.ts

  • totalPasses (Total Passes Issued): Recuento acumulado de registros de pases activos generados en su espacio de trabajo que no han sido eliminados en el momento de la captura.
  • activePasses (Active Passes): Instancias de pases activos que cuentan actualmente con al menos un registro de dispositivo alcanzable (excluyendo los pases caducados y anulados).
  • installedDevices (Active Device Registrations): Registros de pases guardados y alcanzables entre Apple APNs y Google Wallet. Si un mismo pase se guarda en dos dispositivos, cuenta como dos registros activos y consume dos unidades de capacidad del plan.
  • unclaimedPasses (Unclaimed Passes): Instancias de pases emitidos en Passinstance que nunca se han guardado en un monedero.
  • inactivePasses (Removed Passes): Instancias de pases que estuvieron guardadas en un monedero anteriormente, pero que ya no conservan ningún registro de dispositivo alcanzable (incluidos callbacks DELETE /v1/devices/... de Apple y del de Google en /api/v1/wallet/callback).
  • voidedPasses (Voided Passes) y expiredPasses (Expired Passes): Instancias de pases revocadas en el servidor o que han superado su fecha expirationDate.

Configuración del espacio de trabajo y ajustes regionales

Cada espacio de trabajo se configura de forma independiente en Configuración -> Espacio de trabajo (/settings/workspace/*):

  • Ajustes generales y regionales (PUT /api/v1/customer/:customerId/regional-settings): Configura la zona horaria predeterminada (resolveCustomerTimeZone), el código de divisa ISO 4217 predeterminado y el idioma principal.
  • Cuotas de uso (GET /api/v1/customer/:customerId/usage-summary): Informa en tiempo real del total de pases, pases activos frente a maxActivePasses y recuento de plantillas.
  • Dominios personalizados de marca blanca (/api/v1/white-labeling/vanity-urls): Conecta dominios propios (domain surface type: PASS_DOWNLOAD, PASS_FLOW, BACKEND_UI, etc.) con aprovisionamiento automático de SSL para todos los enlaces inteligentes y páginas de descarga.

Importante: Los espacios de trabajo sandbox ofrecen un entorno aislado para probar revisiones de plantillas, webhooks de API y configuraciones de escáner sin consumir capacidad de pases activos de su plan de producción.

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.