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.

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:
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 endpoint | Método | Auth | Funcionalidad | |
|---|---|---|---|---|
/api/v1/organizations/current | GET | Bearer | Devuelve la organización activa, los roles de miembro y el listado de espacios de trabajo hermanos accesibles. | |
/api/v1/organizations/current/billing-summary | GET | Bearer | Resumen de límites del plan y recuento acumulado de pases activos en todos los espacios de trabajo. | |
/api/v1/organizations/current/workspaces | POST | Bearer | Crea un nuevo espacio de trabajo hermano (`kind: "production" \ | "sandbox"`). |
/api/v1/organizations/current/workspaces/switch | POST | Bearer | Cambia 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:
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 callbacksDELETE /v1/devices/...de Apple ydelde Google en/api/v1/wallet/callback). -
voidedPasses(Voided Passes) yexpiredPasses(Expired Passes): Instancias de pases revocadas en el servidor o que han superado su fechaexpirationDate.
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 amaxActivePassesy 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.
