Tableaux de Bord (Dashboards)
La solution de cashback nouvelle génération
INTRODUCTION
1.1 Objectifs du Document
Ce document définit les spécifications détaillées des tableaux de bord (dashboards) de l'écosystème REWAPP. Il décrit les indicateurs affichés, les visualisations utilisées et les fonctionnalités disponibles pour chaque audience cible.
Les tableaux de bord constituent l'interface principale de pilotage de la plateforme, permettant :
- Suivi en temps réel des KPIs business et techniques
- Détection proactive des anomalies et incidents
- Aide à la décision pour les équipes métier et technique
- Mesure de la performance et de l'atteinte des objectifs
1.2 Portée et Audience
Tableaux de Bord par Audience
| Dashboard | Audience | Plateforme | Actualisation |
|---|---|---|---|
| Business | Direction, Produit, Commercial | Dashboard Admin (Angular) | 5 minutes |
| Technique | Équipe Dev, QA | Grafana | 1 minute |
| Opérationnel | Équipe Ops, Ingénieurs de garde | Grafana | 30 secondes |
| Sécurité | Équipe Sécurité, DPO, Compliance | Grafana | 1 minute |
| Partenaire | Commerçants partenaires | Dashboard Partenaire (Angular + Ionic PWA) | 5 minutes |
1.3 Documents Connexes
- 13.1 Définition des KPIs Business
- 13.2 Définition des KPIs Techniques
- 13.3 Plan de Tracking Analytics
- 10.3 Procédures de Monitoring et Alerting
- 2.3 Spécifications Dashboard Admin
- 2.4 Spécifications Dashboard Partenaire
ARCHITECTURE DES TABLEAUX DE BORD
2.1 Vue d'Ensemble
L'architecture de visualisation REWAPP repose sur une approche multi-couches adaptée à chaque type d'utilisateur.
Architecture Multi-Couches
| Couche | Composant | Description |
|---|---|---|
| Collecte | CloudWatch, Prometheus |
Agrégation des métriques infrastructure et application |
| Stockage | TimescaleDB, CloudWatch Logs |
Historisation des données avec rétention configurable |
| Traitement | AWS Lambda, Scheduled Jobs |
Calcul des agrégations et KPIs dérivés |
| Visualisation | Grafana, Angular (Angular Material) |
Dashboards temps réel et rapports |
2.2 Stack Technique de Visualisation
Outils de Visualisation
| Outil | Usage | Audience |
|---|---|---|
Grafana 10.x |
Dashboards techniques et ops | Dev, Ops, Sécurité |
Angular + Angular Material |
Dashboard Admin | Direction, Admin |
Angular + ng2-charts |
Dashboard Partenaire | Commerçants |
AWS QuickSight |
Rapports BI avancés | Direction (optionnel) |
2.3 Principes de Conception
DASHBOARD BUSINESS (DIRECTION)
3.1 Vue d'Ensemble
Configuration Dashboard Business
Audience : Direction générale, équipe produit, équipe commerciale
Plateforme : Dashboard Admin (Angular)
URL : https://admin.rewapp.fr/dashboard
Rafraîchissement : 5 minutes (temps réel pour compteurs principaux)
Accès : Rôles Admin et Super Admin
Objectif : Fournir une vision consolidée de la performance business de REWAPP avec les indicateurs clés d'acquisition, d'engagement, de rétention et de monétisation.
3.2 KPIs Acquisition
3.2.1 Panneau Inscriptions
Métriques Inscriptions
| Métrique | Type Affichage | Calcul | Comparaison |
|---|---|---|---|
| Inscriptions Jour | Stat + Tendance | COUNT(users WHERE created_at = TODAY) |
vs J-1, J-7 |
| Inscriptions Semaine | Stat | COUNT(users WHERE created_at >= 7 jours) |
vs S-1 |
| Inscriptions Mois | Stat | COUNT(users WHERE created_at >= 30 jours) |
vs M-1 |
| Taux de Croissance | Pourcentage | (Inscriptions M / Inscriptions M-1) - 1 |
vs M-1, M-2 |
3.2.2 Coût d'Acquisition Client (CAC)
Métriques CAC
| Métrique | Formule | Objectif | Seuil Alerte |
|---|---|---|---|
| CAC Global | Dépenses marketing / Nouvelles inscriptions | < 5€ | > 8€ |
| CAC par Canal | Dépenses canal / Inscriptions canal | Variable | > 2× moyenne |
| ROI Acquisition | LTV / CAC | > 3 | < 2 |
3.3 KPIs Engagement
3.3.1 Panneau Utilisateurs Actifs
Utilisateurs Actifs
| Métrique | Type Affichage | Calcul | Objectif |
|---|---|---|---|
| DAU (Daily Active Users) | Stat temps réel | COUNT(users WHERE last_activity = TODAY) |
Croissance +5%/mois |
| WAU (Weekly Active Users) | Stat | COUNT(users WHERE last_activity >= 7 jours) |
- |
| MAU (Monthly Active Users) | Stat | COUNT(users WHERE last_activity >= 30 jours) |
30 000 (An 1) |
| DAU/MAU Ratio | Gauge | DAU / MAU × 100 |
> 20% |
RÈGLE MÉTIER
Le ratio favorise l'utilisation chez les partenaires (+5% bonus QR vs -5% bancaire)
3.3.2 Graphique Taux de Liaison Carte
Type : Funnel
-
1
Inscriptions totales
Nombre total d'inscriptions
-
2
Vérification email complétée
Utilisateurs ayant validé leur email
-
3
Carte bancaire liée
Connexion bancaire établie via OpenBanking
-
4
Première transaction effectuée
Objectif : Taux de conversion global > 60%
3.4 KPIs Rétention
Métriques Rétention
| Métrique | Type Affichage | Calcul | Objectif |
|---|---|---|---|
| Rétention J7 | Gauge | Users actifs J7 / Inscriptions J0 × 100 |
> 50% |
| Rétention J30 | Gauge | Users actifs J30 / Inscriptions J0 × 100 |
> 40% |
| Rétention J90 | Gauge | Users actifs J90 / Inscriptions J0 × 100 |
> 30% |
| Taux de Churn Mensuel | Stat | Users perdus / Users début mois × 100 |
< 5% |
3.5 KPIs Monétisation
Métriques Revenus
| Métrique | Type Affichage | Calcul | Objectif An 1 |
|---|---|---|---|
| Revenus Jour | Counter | Commission 2% × Volume transactions jour | - |
| Revenus Mois | Stat + Tendance | Commission 2% × Volume transactions mois | 59 045€/mois |
| MRR | Stat | COUNT(premium_subscriptions) × 49€ |
> 7 840€ |
| ARR | Stat | MRR × 12 |
> 94 080€ |
| Revenue Total Mois | Stat | Revenus Commission + MRR | 708 540€ (An 1) |
RÈGLE MÉTIER
1 point = 0,10€ | Validité 12 mois | Méthode FIFO
3.6 KPIs Partenaires
Métriques Partenaires
| Métrique | Type Affichage | Calcul | Objectif An 1 |
|---|---|---|---|
| Partenaires Actifs | Stat | COUNT(partners WHERE status = 'active') |
600 |
| Partenaires en Attente | Badge rouge | COUNT(partners WHERE status = 'pending') |
< 20 |
| Taux de Validation | Pourcentage | Validés / (Validés + Refusés) × 100 |
> 80% |
| Partenaires Premium | Badge or | COUNT(partners WHERE subscription = 'premium') |
120 (20%) |
DASHBOARD TECHNIQUE (DEV/OPS)
4.1 Vue d'Ensemble
Configuration Dashboard Technique
Audience : Équipe développement, QA
Plateforme : Grafana
URL : https://grafana.rewapp.internal/d/dev-overview
Rafraîchissement : 1 minute
Accès : Rôle Editor Grafana
4.2 Métriques Performance API
Latence API
| Métrique | Type Affichage | Seuil Normal | Warning | Critical |
|---|---|---|---|---|
| Latence P50 | Gauge | < 100ms | 100-200ms | > 200ms |
| Latence P95 | Gauge | < 200ms | 200-300ms | > 300ms |
| Latence P99 | Gauge | < 500ms | 500-800ms | > 800ms |
Endpoints critiques à surveiller :
POST /api/auth/loginPOST /api/qr-codes/generatePOST /api/qr-codes/validatePOST /api/transactionsPOST /api/withdrawals
4.3 Métriques Infrastructure ECS Fargate
Services ECS
| Service | CPU | RAM | Tasks | Statut |
|---|---|---|---|---|
| API Gateway | Gauge 0-100% | Gauge 0-100% | Running/Desired | Health |
| Auth Service | Gauge 0-100% | Gauge 0-100% | Running/Desired | Health |
| Transaction Service | Gauge 0-100% | Gauge 0-100% | Running/Desired | Health |
| Points Service | Gauge 0-100% | Gauge 0-100% | Running/Desired | Health |
| Notification Service | Gauge 0-100% | Gauge 0-100% | Running/Desired | Health |
Seuils : CPU Warning > 70%, Critical > 85% | RAM Warning > 75%, Critical > 90%
4.4 Métriques Base de Données RDS PostgreSQL
RDS PostgreSQL
| Métrique | Seuil Normal | Warning | Critical |
|---|---|---|---|
| Connexions Actives | < 100 | 100-150 | > 150 (max 200) |
| CPU Utilization | < 50% | 50-70% | > 70% |
| Free Storage | > 50% | 20-50% | < 20% |
| Read Latency | < 5ms | 5-10ms | > 10ms |
| Write Latency | < 10ms | 10-20ms | > 20ms |
| Replica Lag | < 1s | 1-5s | > 5s |
4.5 Métriques Cache Redis et Bull Queue
Redis Cache
| Métrique | Seuil Optimal | Warning |
|---|---|---|
| Cache Hit Ratio | > 95% | < 90% |
| Memory Used | < 70% | > 85% |
| Evictions/min | 0 | > 100 |
| Connected Clients | < 500 | > 800 |
Bull Queues
| Queue | Waiting | Active | Completed/h | Failed/h |
|---|---|---|---|---|
email-queue |
Counter | Counter | Counter | alerte si > 0 |
push-queue |
Counter | Counter | Counter | Counter |
transaction-queue |
Counter | Counter | Counter | Counter |
points-calculation |
Counter | Counter | Counter | Counter |
DASHBOARD OPÉRATIONNEL (OPS)
5.1 Vue d'Ensemble
Configuration Dashboard Opérationnel
Audience : Équipe opérations, ingénieurs de garde
Plateforme : Grafana
URL : https://grafana.rewapp.internal/d/ops-overview
Rafraîchissement : 30 secondes
Accès : Rôle Admin Grafana
5.2 Health Status Global
Status Overview
| Composant | Indicateur | UP | DEGRADED | DOWN |
|---|---|---|---|---|
| API Gateway | Health Check | 200 OK | Latence > 500ms | Timeout/5xx |
| Auth Service | Health Check | 200 OK | Latence > 300ms | Timeout/5xx |
| Transaction Service | Health Check | 200 OK | Latence > 500ms | Timeout/5xx |
| RDS PostgreSQL | Connection | Connected | Lag > 5s | Unreachable |
| Redis | PING | PONG | Latence > 50ms | Timeout |
| Load Balancer | Healthy Hosts | 100% | < 75% | < 50% |
5.3 Uptime SLA
Objectifs Uptime
| Période | Uptime Actuel | Objectif SLA | Downtime Autorisé |
|---|---|---|---|
| Jour | XX.XX% | 99.9% | 1.44 min |
| Semaine | XX.XX% | 99.9% | 10.08 min |
| Mois | XX.XX% | 99.9% | 43.8 min |
| Année | XX.XX% | 99.9% | 8.76 heures |
5.4 Feed Transactions Live
Type : Table scrollante (WebSocket)
Colonnes : Timestamp | User | Merchant | Amount | Points | Type
Affichage : 50 dernières transactions
Indicateurs couleur :
- 🟢 Normal (< 100€)
- 🟡 Moyen (100-300€)
- 🔴 Élevé (> 300€)
- ⚠️ Suspect (alerte fraude)
5.5 Runbook Links
- API Latency Élevée → Runbook
- Error Rate Élevé → Runbook
- Database Connection Exhaustion → Runbook
- QR Code System Failure → Runbook
- Security Incident → Runbook
DASHBOARD SÉCURITÉ (SECURITY)
6.1 Vue d'Ensemble
Configuration Dashboard Sécurité
Audience : Équipe sécurité, DPO, compliance
Plateforme : Grafana
URL : https://grafana.rewapp.internal/d/security
Rafraîchissement : 1 minute
Accès : Rôle Admin Grafana + Whitelist IP
6.2 Métriques Authentification
Login Activity
| Métrique | Seuil Normal | Warning | Critical |
|---|---|---|---|
| Logins Réussis/h | Variable | - | - |
| Logins Échoués/h | < 50 | 50-100 | > 100 |
| Ratio Échec | < 5% | 5-10% | > 10% |
| 2FA Failures/h | < 10 | 10-30 | > 30 |
6.3 Détection des Menaces
Security Score
Type : Gauge (0-100)
Calcul : Score composite basé sur :
- Taux d'échec authentification (30%)
- Tentatives d'injection (25%)
- Rate limit violations (20%)
- Activités suspectes (25%)
Couleurs : Vert (>80) | Jaune (60-80) | Rouge (<60)
QR Code Fraud Detection
RÈGLE MÉTIER CRITIQUE
QR Code valide 60 secondes, usage UNIQUE
Détection Fraude QR
| Métrique | Valeur | Seuil Alerte | Action |
|---|---|---|---|
| QR Replay Attempts | Counter | > 0 | Alerte immédiate + blocage user |
| QR Expired Usage | Counter | Monitoring | Investigation si pattern |
| Multiple QR Same User | Counter | > 5/h | Investigation |
| QR Geographic Mismatch | Counter | > 0 | Alerte fraude potentielle |
6.4 Audit et Conformité
RGPD Compliance
| Indicateur | Statut | Dernière Vérification |
|---|---|---|
| Consentements Valides | XX% | Date |
| Demandes d'Accès (30j) | Counter | - |
| Demandes de Suppression (30j) | Counter | - |
| Durée Rétention Respectée | Vert/Rouge | Date audit |
| Logs Anonymisation | Vert/Rouge | Date |
Certificates Status
| Certificat | Expiration | Jours Restants | Statut |
|---|---|---|---|
| SSL/TLS Production | Date | XX jours | OK |
| SSL/TLS Staging | Date | XX jours | OK |
| API JWT Signing Key | Date | XX jours | OK |
| HMAC QR Code Key | Date | XX jours | OK |
Seuils : Vert (>30j) | Jaune (7-30j) | Rouge (<7j)
DASHBOARD PARTENAIRE (COMMERÇANT)
7.1 Vue d'Ensemble
Configuration Dashboard Partenaire
Audience : Commerçants partenaires REWAPP
Plateforme : Dashboard Partenaire (Angular + Ionic PWA)
URL : https://partenaire.rewapp.fr/dashboard
Rafraîchissement : 5 minutes
Accès : Authentification partenaire (email + mot de passe + 2FA optionnel)
7.2 Performance Commerciale
KPIs Principaux
| Métrique | Type Affichage | Calcul | Comparaison |
|---|---|---|---|
| Transactions Jour | Stat temps réel | COUNT(transactions WHERE partner_id AND date = TODAY) |
vs J-1 |
| Chiffre d'Affaires Jour | Stat temps réel | SUM(transactions.amount) |
vs J-1 |
| Transactions Mois | Stat | COUNT(transactions WHERE month = CURRENT) |
vs M-1 |
| Chiffre d'Affaires Mois | Stat | SUM(transactions.amount WHERE month = CURRENT) |
vs M-1 |
| Panier Moyen | Stat | AVG(transactions.amount) |
vs M-1 |
7.3 Fidélité Client
Clients REWAPP
| Métrique | Type Affichage | Calcul | Évolution |
|---|---|---|---|
| Clients Uniques (mois) | Stat | COUNT(DISTINCT user_id) |
vs M-1 |
| Nouveaux Clients | Stat | Clients avec 1ère transaction ce mois | vs M-1 |
| Clients Récurrents | Stat | Clients avec 2+ transactions | vs M-1 |
| Taux de Récurrence | Gauge | Clients récurrents / Clients totaux × 100 |
Objectif >30% |
RÈGLE MÉTIER
Les paliers sont calculés sur les 12 derniers mois glissants, par commerçant
Configuration Paliers
Paliers de Fidélité
| Palier | Seuil Par Défaut | Bonus | Modifiable |
|---|---|---|---|
| ● Bronze | Par défaut | +0% | - |
| ● Silver | 200€ ou 10 transactions | +5% | Oui (Premium) |
| ● Gold | 500€ ou 25 transactions | +10% | Oui (Premium) |
| ● Platine | 1000€ ou 50 transactions | +15% | Oui (Premium) |
| ● Diamant | 2500€ ou 100 transactions | +20% | Oui (Premium) |
7.4 ROI et Analyses
Coût Cashback et ROI
| Métrique | Calcul | Valeur | Benchmark |
|---|---|---|---|
| Commission Totale Mois | Volume × 6% | XX€ | - |
| Dont Cashback Client | Volume × 4% | XX€ | - |
| Dont Commission REWAPP | Volume × 2% | XX€ | - |
| Coût par Transaction | Commission / Nb transactions | X,XX€ | < 2€ |
ROI Estimé
| Indicateur | Calcul | Valeur |
|---|---|---|
| CA Généré via REWAPP | SUM(transactions.amount) |
XX XXX€ |
| Nouveaux Clients Acquis | Clients avec 1ère visite via REWAPP | XXX |
| Valeur Client Moyen | CA / Clients uniques | XX€ |
| ROI Cashback | (CA Généré - Coût Commission) / Coût Commission | X,XX |
PERSONNALISATION ET CONFIGURATION
8.1 Filtres et Périodes
Filtres Temporels Standards
| Filtre | Options | Disponibilité |
|---|---|---|
| Période Prédéfinie | Aujourd'hui, 7 jours, 30 jours, 90 jours, 12 mois, Année | Tous dashboards |
| Période Personnalisée | Date début - Date fin (date picker) | Tous dashboards |
| Granularité | Heure, Jour, Semaine, Mois | Graphiques uniquement |
| Comparaison | Période précédente, Année précédente, Aucune | Tous dashboards |
8.2 Vues Personnalisables
Favoris et Widgets
- Épingler des KPIs en favoris (affichage prioritaire)
- Réorganiser les panneaux par drag & drop (Admin uniquement)
- Masquer des panneaux non pertinents
- Créer des vues personnalisées sauvegardées
Alertes Personnalisées
Configuration par utilisateur :
- Définir des seuils personnalisés pour alertes
- Choisir les canaux de notification (email, Slack, push)
- Définir la fréquence des digest
Exemple : "M'alerter si le panier moyen baisse de plus de 20%"
8.3 Export des Données
Formats d'Export
| Format | Usage | Contenu | Disponibilité |
|---|---|---|---|
CSV |
Analyse Excel/BI | Données brutes tabulaires | Tous dashboards |
Excel (.xlsx) |
Reporting formel | Données + mise en forme | Admin, Partenaire Premium |
PDF |
Communication | Rapport mis en page avec graphiques | Admin, Partenaire Premium |
PNG/SVG |
Présentation | Export graphique individuel | Tous dashboards |
Rapports Planifiés
- Rapport Journalier (7h00) : KPIs J-1
- Rapport Hebdomadaire (Lundi 8h00) : Synthèse semaine
- Rapport Mensuel (1er du mois) : Bilan complet
8.4 Alertes Configurables
Types d'Alertes Business
| Alerte | Seuil Par Défaut | Configurable | Canal |
|---|---|---|---|
| Chute des inscriptions | -30% vs J-1 | Oui | Email, Slack |
| Chute du volume transactions | -50% vs moyenne | Oui | Email, Slack |
| Pic de churn | +100% vs moyenne | Oui | |
| Objectif MRR atteint | 100% de l'objectif | Oui | Email, Slack |
| Points expirant (utilisateur) | J-30, J-7 | Non | Push, Email |
SPÉCIFICATIONS TECHNIQUES
9.1 Architecture de Données
Sources de Données
Sources de Données
| Source | Type | Latence | Usage |
|---|---|---|---|
PostgreSQL (RDS) |
Transactionnel | Temps réel | Données métier, transactions |
Redis |
Cache | < 1ms | Compteurs temps réel, sessions |
Prometheus |
Time Series | 15s | Métriques application |
CloudWatch |
Time Series | 1 min | Métriques infrastructure |
ElasticSearch |
Logs | < 5s | Recherche logs, debugging |
Agrégations et Pré-calculs
Fréquence des Agrégations
| Agrégation | Fréquence | Stockage | Rétention |
|---|---|---|---|
| KPIs horaires | Chaque heure | TimescaleDB | 90 jours |
| KPIs journaliers | Quotidien (2h00) | TimescaleDB | 3 ans |
| KPIs mensuels | Mensuel (1er) | TimescaleDB | 10 ans |
| Paliers fidélité | Quotidien (2h00) | PostgreSQL | Temps réel |
9.2 Performance et Actualisation
Stratégies d'Optimisation
- Lazy Loading : Chargement différé des panneaux non visibles
- Caching : Cache Redis pour les requêtes fréquentes (TTL 1-5 min)
- Pagination : Limitation des données affichées avec scroll infini
- Agrégation Server-Side : Calculs complexes côté serveur, pas côté client
- WebSocket : Données temps réel sans polling
9.3 Accessibilité et Responsive
Breakpoints Responsive
| Device | Breakpoint | Adaptation |
|---|---|---|
| Desktop Large | > 1440px | Affichage complet, multi-colonnes |
| Desktop | 1280-1440px | Affichage standard |
| Tablette | 768-1279px | Réorganisation 2 colonnes, panneaux empilés |
| Mobile | < 768px | Dashboard Partenaire uniquement, vue simplifiée |
Accessibilité (A11Y)
- Contraste : WCAG 2.1 AA minimum
- Navigation clavier : Tab navigation complète
- Screen readers : ARIA labels sur tous les graphiques
- Alternatives textuelles : Données tableaux pour chaque graphique
CONCLUSION
10.1 Récapitulatif
Les tableaux de bord REWAPP ont été conçus pour répondre aux besoins spécifiques de chaque audience :
- Dashboard Business : Vision consolidée des KPIs d'acquisition, engagement, rétention et monétisation pour piloter la croissance de REWAPP.
- Dashboard Technique : Visibilité complète sur les performances applicatives et l'infrastructure pour garantir la qualité de service.
- Dashboard Opérationnel : Monitoring temps réel et gestion des incidents pour assurer la disponibilité 99.9%.
- Dashboard Sécurité : Surveillance des menaces et conformité réglementaire pour protéger les utilisateurs et les données.
- Dashboard Partenaire : Suivi de performance et ROI pour fidéliser les commerçants partenaires.
10.2 Points Clés
CARACTÉRISTIQUES PRINCIPALES
- Architecture multi-couches adaptée à chaque audience
- Actualisation temps réel pour les métriques critiques
- Personnalisation avancée (filtres, exports, alertes)
- Respect des règles métier REWAPP (1 point = 0,10€, QR 60s, etc.)
- Performance optimisée (chargement < 2s)
- Conformité RGPD et accessibilité
10.3 Documents Connexes
- 13.1 Définition des KPIs Business
- 13.2 Définition des KPIs Techniques
- 13.3 Plan de Tracking Analytics
- 10.3 Procédures de Monitoring et Alerting
- 2.3 Spécifications Dashboard Admin
- 2.4 Spécifications Dashboard Partenaire