Navigation principale de l'espace de travail
Le tableau de bord d'administration Passinstance offre une interface unifiée regroupant le suivi opérationnel, le studio de conception des cartes, les traitements par lot à grand volume et la configuration développeur. La barre latérale gauche organise les workflows quotidiens par pôles fonctionnels :

| Pôle de navigation & route | Responsabilités principales | Capacités & entités backend associées |
|---|---|---|
Tableau de bord (/dashboard) | KPI en direct de l'espace de travail, télémétrie événementielle temps réel et santé des passes | Appuyé sur Dashboard Analytics API (/api/v1/dashboards/analytics), lignes multi-widgets et flux d'événements temps réel. |
Modèles (/templates) | Studio visuel de cartes avec 7 onglets détaillés (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings) | Met en œuvre le versionnage en table unique (Template), l'analyse de risque avant publication, les règles regex d'identifiants personnalisés et le regroupement en lots. |
Passes (/passes) | Répertoire de tous les passes émis, recherche par externalId, regroupement par bundleId, chronologie et panneau d'édition | Répertoire haute concurrence appuyé sur des attributs structured JSON, les transitions de cycle de vie (PassLifecycleStatus) et l'annulation/désactivation instantanée. |
Distribution (/templates/download-pages, /delivery-center, /pass-flows) | Regroupe Pages de téléchargement (DownloadPage), Centre d'envoi (EmailSendCampaign) et Pass Flows (PassFlow) | Gère les pages publiques de retrait (/d/:slug), les campagnes e-mail/SMS et les formulaires multi-étapes d'inscription et de paiement (/f/:url). |
Automatisations (/automations, /workflows) | Règles d'automatisation événementielles et e-commerce | Évalue les règles UniversalAutomation et déclencheurs Workflow (workflow trigger type, workflow action type). |
Scanner (/scanner/configs) | Validation au comptoir, contrôle d'entrée, lieux de validation et configuration des lecteurs matériels | Gère ValidationPlace, ScannerConfiguration, les appairages mobiles (ScannerKey) et les adaptateurs NFC/POS. |
Traitements en lot (/batch-processing, /batch-notifications) | Assistant d'émission CSV asynchrone à fort volume et notifications Wallet planifiées | Pilote Batch Jobs API (/api/v1/batch-processing) et Batch Notifications API (/api/v1/batch-notifications). |
Wallet Experiences (/wallet-experiences / /pass-projects) | Hub de projets multi-cartes (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings) | Gère PassProject, PassProjectTemplateRole, les lots .pkpasses et les automatisations inter-passes. |
Intégrations & Analytique (/settings/workspace/integrations, /analytics) | Connecteurs CRM/POS, webhooks, clés API et suites de rapports | Gère les webhooks (/api/v1/webhooks/*), clés API cloisonnées et rapports /api/v1/analytics/*. |
Architecture du tableau de bord & endpoints de télémétrie
Le moteur de métriques du tableau de bord repose sur une architecture modulaire de widgets et de cache (entités Passinstance database Dashboard, Row, Widget et SharedDashboard). Le backend s'appuie sur Cache Manager pour fournir des analyses réactives sans surcharger les tables transactionnelles des passes :
Principaux endpoints de télémétrie
Les développeurs et plateformes data peuvent interroger ces endpoints analytiques avec une authentification Bearer ou par cookie de session :
-
GET /api/v1/dashboards/analytics: retourne les métriques agrégées de l'espace de travail viaDashboard Analytics Engine.getDashboardAnalyticsetCache Manager. -
GET /api/v1/dashboards/metrics/realtime: fournit les compteurs d'activité haute fréquence de l'espace de travail ainsi que la télémétrie récente d'installation et de scan. -
GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD: retourne les séries chronologiques par cohorte sur une période personnalisée. -
GET /api/v1/dashboards/performance: suit les indicateurs opérationnels de performance des scans et de livraison des passes. -
GET /api/v1/dashboards/insights: fait ressortir des recommandations opérationnelles automatisées pour votre espace de travail. -
GET /api/v1/dashboards/export?format=csv|json|pdf: exporte les tableaux de métriques brutes du tableau de bord pour vos outils BI ou rapprochements.
Pôles fonctionnels & vues de l'espace de travail
1. Studio de modèles (/templates/:id/*)
Créez et éditez vos modèles visuels à travers 7 onglets (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Configurez les emplacements image asset slot, vérifiez le contraste WCAG, gérez les règles d'identifiants personnalisés et itérez dans un état DRAFT isolé avant publication.
2. Répertoire des passes & chronologie (/passes)
Recherchez parmi les passes émis via la recherche plein texte et les filtres (status, templateId, externalId, bundleId). Ouvrez n'importe quelle ligne dans Pass Details panel pour inspecter sa chronologie (GET /api/v1/passes/:id/history et /timeline), consulter les appareils appairés ou déclencher des mises à jour push.
3. Centre des opérations en lot (/batch-processing)
Suivez les étapes de l'assistant (Modèle -> Importer CSV -> Mapper les champs -> Options d'envoi -> Traiter) pour émettre ou actualiser des passes en masse depuis des fichiers CSV. Téléchargez des schémas d'exemple (GET /api/v1/batch-processing/templates/:templateId/sample-csv), consultez les suggestions de correspondance (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) et récupérez /result.csv contenant chaque URL de passe générée et son externalId.
Important : Toutes les requêtes de télémétrie et de recherche du tableau de bord sont strictement cloisonnées à votre locataire d'espace de travail actif (
customerId). Les espaces frères au sein d'une même organisation restent totalement isolés.
Explorez chaque vue de manière interactive dans notre Visite interactive de l'espace de travail.
