Navegação principal do espaço de trabalho
O painel administrativo da Passinstance fornece uma interface unificada para monitorização operacional, estúdio de design de cartões, processamento em lote e configuração para programadores. A barra lateral esquerda organiza os fluxos diários em áreas funcionais especializadas:

| Área de navegação e rota | Responsabilidades principais | Capacidades e entidades de suporte no backend |
|---|---|---|
Painel (Dashboard) (/dashboard) | KPIs ao vivo do espaço de trabalho, telemetria de eventos em tempo real e métricas de saúde dos passes | Suportado por Dashboard Analytics API (/api/v1/dashboards/analytics), linhas multi-widget e fluxos de eventos em tempo real. |
Modelos (Templates) (/templates) | Estúdio visual de passes com 7 separadores de detalhe (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings) | Implementa versionamento em tabela única (Template), verificações de risco pré-publicação, regras regex de identificador personalizado e definições de pacotes. |
Passes (/passes) | Diretório de todos os passes emitidos, pesquisa por externalId, agrupamento por bundleId, cronologias de histórico e edições em painel lateral | Diretório de elevada concorrência suportado por atributos structured JSON, transições de ciclo de vida (PassLifecycleStatus) e desativação/anulação instantânea. |
Distribuição (/templates/download-pages, /delivery-center, /pass-flows) | Agrupa Páginas de Download (DownloadPage), Centro de Entrega (EmailSendCampaign) e Pass Flows (PassFlow) | Gere páginas públicas de obtenção (/d/:slug), campanhas de entrega por E-mail/SMS e registo/pagamento em múltiplas etapas (/f/:url). |
Automações (/automations, /workflows) | Regras de automação orientadas a eventos e e-commerce | Avalia regras UniversalAutomation e gatilhos Workflow (workflow trigger type, workflow action type). |
Scanner (/scanner/configs) | Validação ao balcão, check-in à entrada, locais de validação e configuração de leitores físicos | Gere ValidationPlace, ScannerConfiguration, emparelhamentos de scanner móvel (ScannerKey) e adaptadores NFC/POS. |
Lote (Batch) (/batch-processing, /batch-notifications) | Assistente assíncrono de emissão em massa por CSV e notificações agendadas para carteiras | Conduz Batch Jobs API (/api/v1/batch-processing) e Batch Notifications API (/api/v1/batch-notifications). |
Wallet Experiences (/wallet-experiences / /pass-projects) | Centro de projetos multi-cartão (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings) | Gere PassProject, PassProjectTemplateRole, pacotes .pkpasses e automações entre passes. |
Integrações e Analítica (/settings/workspace/integrations, /analytics) | Conectores CRM/POS ligados, webhooks, chaves API e relatórios | Gere webhooks (/api/v1/webhooks/*), chaves API com escopo e relatórios /api/v1/analytics/*. |
Arquitetura do painel e endpoints de telemetria
O motor de métricas do painel baseia-se numa arquitetura modular de widgets e cache (Dashboard, Row, Widget e SharedDashboard no Passinstance database). O backend coordena com o Cache Manager para entregar analítica responsiva sem impor carga de consultas às tabelas transacionais de passes:
Principais endpoints de telemetria
Programadores e plataformas de dados podem consultar estes endpoints de analítica com autenticação padrão Bearer ou cookie de sessão:
-
GET /api/v1/dashboards/analytics: Devolve métricas agregadas do espaço de trabalho suportadas porDashboard Analytics Engine.getDashboardAnalyticseCache Manager. -
GET /api/v1/dashboards/metrics/realtime: Fornece contagens de atividade de alta frequência do espaço de trabalho e telemetria recente de instalações/leituras. -
GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD: Devolve coortes em séries temporais ao longo de um período personalizado. -
GET /api/v1/dashboards/performance: Monitoriza métricas operacionais de desempenho de leitura e entrega de passes. -
GET /api/v1/dashboards/insights: Apresenta recomendações operacionais automatizadas no espaço de trabalho. -
GET /api/v1/dashboards/export?format=csv|json|pdf: Exporta tabelas brutas de métricas do painel para BI e reconciliação.
Áreas funcionais e vistas do espaço de trabalho
1. Estúdio de Modelos (/templates/:id/*)
Crie e edite modelos visuais através de 7 separadores (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Configure slots image asset slot, verifique o contraste de cores WCAG, gira regras de identificadores personalizados e itere num estado isolado DRAFT antes de publicar.
2. Diretório e cronologia de Passes (/passes)
Pesquise nos passes emitidos utilizando pesquisa em texto completo e filtros (status, templateId, externalId, bundleId). Abra qualquer linha de passe no Pass Details panel para inspecionar a respetiva cronologia (GET /api/v1/passes/:id/history e /timeline), ver dispositivos emparelhados ou acionar atualizações push.
3. Centro de Operações em Lote (/batch-processing)
Siga as etapas do assistente (Modelo -> Carregar CSV -> Mapear Campos -> Opções de envio -> Processar) para emitir ou atualizar passes em massa a partir de ficheiros CSV. Descarregue esquemas de exemplo (GET /api/v1/batch-processing/templates/:templateId/sample-csv), consulte recomendações de mapeamento de campos (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) e descarregue /result.csv contendo cada URL de passe gerado e externalId.
Importante: Toda a telemetria e todas as pesquisas do painel são estritamente delimitadas ao seu tenant ativo de espaço de trabalho (
customerId). Espaços de trabalho irmãos na mesma organização permanecem totalmente isolados.
Explore cada vista de forma interativa na nossa Visita interativa ao espaço de trabalho.
