Navegación principal del espacio de trabajo
El panel administrativo de Passinstance ofrece una interfaz unificada para la supervisión operativa, el estudio de diseño de tarjetas, el procesamiento masivo por lotes y la configuración para desarrolladores. La barra lateral izquierda organiza los flujos diarios en áreas funcionales especializadas:

| Área de navegación y ruta | Responsabilidades principales | Capacidades y entidades de respaldo en backend |
|---|---|---|
Dashboard (/dashboard) | KPI en directo del espacio de trabajo, telemetría de eventos en tiempo real y métricas de salud de los pases | Respaldado por Dashboard Analytics API (/api/v1/dashboards/analytics), filas multi-widget y flujos de eventos en tiempo real. |
Templates (/templates) | Estudio visual de pases con 7 pestañas de detalle (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings) | Implementa versionado en una sola tabla (Template), comprobaciones de riesgo previas a la publicación, reglas regex de identificadores personalizados y ajustes de agrupación. |
Passes (/passes) | Directorio de todos los pases emitidos, búsqueda por externalId, agrupación por bundleId, líneas temporales de historial y edición en panel lateral | Directorio de alta concurrencia respaldado por atributos structured JSON, transiciones de ciclo de vida (PassLifecycleStatus) y desactivación o anulación instantánea. |
Distribution (/templates/download-pages, /delivery-center, /pass-flows) | Agrupa Páginas de descarga (DownloadPage), Delivery Center (EmailSendCampaign) y Pass Flows (PassFlow) | Gestiona páginas públicas de descarga (/d/:slug), campañas de envío por correo/SMS y registros multipaso o cobros (/f/:url). |
Automations (/automations, /workflows) | Reglas de automatización basadas en eventos y comercio electrónico | Evalúa reglas UniversalAutomation y disparadores Workflow (workflow trigger type, workflow action type). |
Scanner (/scanner/configs) | Validación en mostrador, control de acceso en puertas, lugares de validación y configuración de lectores físicos | Gestiona ValidationPlace, ScannerConfiguration, emparejamientos de escáner móvil (ScannerKey) y adaptadores NFC/POS. |
Batch (/batch-processing, /batch-notifications) | Asistente asíncrono de emisión masiva mediante CSV y notificaciones programadas para monederos | Controla Batch Jobs API (/api/v1/batch-processing) y Batch Notifications API (/api/v1/batch-notifications). |
Wallet Experiences (/wallet-experiences / /pass-projects) | Centro de proyectos multi-tarjeta (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings) | Gestiona PassProject, PassProjectTemplateRole, paquetes .pkpasses y automatizaciones entre pases. |
Integrations & Analytics (/settings/workspace/integrations, /analytics) | Conectores CRM/POS conectados, webhooks, claves API y paquetes de informes | Administra webhooks (/api/v1/webhooks/*), claves de API con ámbito específico e informes /api/v1/analytics/*. |
Arquitectura del panel y endpoints de telemetría
El motor de métricas del panel se apoya en una arquitectura modular de widgets y caché (Dashboard, Row, Widget y SharedDashboard en Passinstance database). El backend coordina con Cache Manager para ofrecer analíticas ágiles sin sobrecargar con consultas las tablas transaccionales de pases:
Endpoints clave de telemetría
Los desarrolladores y plataformas de datos pueden consultar estos endpoints analíticos utilizando autenticación estándar con token Bearer o cookie de sesión:
-
GET /api/v1/dashboards/analytics: Devuelve métricas agregadas del espacio de trabajo respaldadas porDashboard Analytics Engine.getDashboardAnalyticsyCache Manager. -
GET /api/v1/dashboards/metrics/realtime: Proporciona recuentos de actividad de alta frecuencia y telemetría reciente de instalaciones y escaneos. -
GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD: Devuelve series temporales por cohortes en un periodo personalizado. -
GET /api/v1/dashboards/performance: Supervisa métricas operativas de rendimiento de escaneo y entrega de pases. -
GET /api/v1/dashboards/insights: Muestra recomendaciones operativas automatizadas en todo su espacio de trabajo. -
GET /api/v1/dashboards/export?format=csv|json|pdf: Exporta tablas de métricas sin procesar del panel para BI y conciliación.
Centros funcionales y vistas del espacio de trabajo
1. Estudio de plantillas (/templates/:id/*)
Cree y edite plantillas visuales en 7 pestañas (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Configure ranuras image asset slot, verifique el contraste de color WCAG, gestione reglas de identificadores personalizados e itere en un estado DRAFT aislado antes de publicar.
2. Directorio de pases y línea temporal (/passes)
Busque entre los pases emitidos utilizando búsqueda de texto completo y filtros (status, templateId, externalId, bundleId). Abra cualquier fila en Pass Details panel para inspeccionar su cronología (GET /api/v1/passes/:id/history y /timeline), ver dispositivos emparejados o lanzar actualizaciones push.
3. Centro de operaciones por lotes (/batch-processing)
Siga los pasos del asistente (Plantilla -> Subir CSV -> Mapear campos -> Opciones de envío -> Procesar) para emitir o actualizar pases masivamente desde archivos CSV. Descargue esquemas de ejemplo (GET /api/v1/batch-processing/templates/:templateId/sample-csv), revise recomendaciones de mapeo de campos (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) y descargue /result.csv con cada URL de pase generada y su externalId.
Importante: Toda la telemetría del panel y las consultas de búsqueda están estrictamente aisladas al inquilino activo de su espacio de trabajo (
customerId). Los espacios de trabajo hermanos dentro de la misma organización permanecen completamente aislados.
Explore cada vista de forma interactiva en nuestro Recorrido interactivo por el espacio de trabajo.
