Notifications Push

1.1 Objectifs

Les notifications push sont un composant essentiel de l'expérience utilisateur REWAPP. Elles permettent :

• Informer en temps réel des événements importants (transactions, points crédités)
• Engager l'utilisateur avec des offres personnalisées et des rappels
• Améliorer la rétention en maintenant une communication proactive
• Faciliter la navigation via le deep linking vers les écrans pertinents

1.2 Fournisseurs de Services

1.3 Principes Directeurs

2.1 Schéma d'Architecture

L'architecture des notifications push REWAPP est conçue pour être scalable et fiable :

[Backend REWAPP] → [Service Notification] → [Firebase Cloud Messaging] → [Application Mobile]
                                         → [Apple Push Notification Service] → [Application Mobile]

2.2 Composants du Système

2.3 Flux de Notification

3.1 Prérequis

• Compte Firebase avec projet créé
• Application Android et iOS enregistrées dans Firebase
• Fichier de clé de service (service account JSON)
• SDK Firebase configuré dans l'application mobile

3.2 Variables d'Environnement

3.3 Initialisation du SDK

// notification.service.ts
import * as admin from 'firebase-admin';

const firebaseConfig = {
  projectId: process.env.FIREBASE_PROJECT_ID,
  privateKey: process.env.FIREBASE_PRIVATE_KEY.replace(/\n/g, '
'),
  clientEmail: process.env.FIREBASE_CLIENT_EMAIL,
};

admin.initializeApp({
  credential: admin.credential.cert(firebaseConfig),
});

3.4 Configuration Mobile (Angular + Ionic / Capacitor)

Installation des Dépendances

# Installation Capacitor Push Notifications
npm install @capacitor/push-notifications
npx cap sync

# Configuration Firebase pour Angular
npm install @angular/fire firebase

Configuration app.json

{
  "appId": "fr.rewapp.app",
  "appName": "REWAPP",
  "webDir": "www",
  "plugins": {
    "PushNotifications": {
      "presentationOptions": ["badge", "sound", "alert"]
    }
  },
  "android": {
    "googleServicesFile": "./google-services.json"
  },
  "ios": {
    "googleServicesFile": "./GoogleService-Info.plist"
  }
}

4.1 Prérequis Apple Developer

• Compte Apple Developer actif
• Certificat APNs ou clé d'authentification (p8)
• Bundle ID de l'application enregistré
• Provisioning profile avec capability Push Notifications

4.2 Types de Clés APNs

4.3 Configuration via Firebase

Firebase gère automatiquement la communication avec APNs. Configuration requise :

1. 1

   Télécharger la clé APNs

   Télécharger la clé APNs (.p8) depuis Apple Developer Portal

2. 2

   Uploader dans Firebase

   Firebase Console > Project Settings > Cloud Messaging

3. 3

   Renseigner les identifiants

   Key ID et Team ID

4.4 Variables d'Environnement APNs (Direct)

5.1 Cycle de Vie des Tokens

5.2 Modèle de Données

5.3 API Enregistrement de Token

{
  "token": "fcm_token_string",
  "platform": "android",
  "device_id": "unique_device_identifier"
}

{
  "success": true,
  "message": "Token enregistré avec succès",
  "data": {
    "token_id": "uuid-token-id",
    "platform": "android"
  }
}

5.4 Nettoyage des Tokens Invalides

Un job planifié (CRON) nettoie les tokens invalides quotidiennement :

• Tokens avec erreurs FCM/APNs répétées (NotRegistered, InvalidToken)
• Tokens non utilisés depuis plus de 90 jours
• Tokens d'appareils désinstallés

6.1 Catégories de Notifications

6.2 Notifications Transactionnelles

6.2.1 Transaction Détectée

{
  "notification": {
    "title": "Achat détecté chez Boulangerie Martin 🛒",
    "body": "25,00€ • Vous allez recevoir 25 points"
  },
  "data": {
    "type": "TRANSACTION_DETECTED",
    "transaction_id": "txn_123456",
    "merchant_name": "Boulangerie Martin",
    "deep_link": "rewapp://transaction/txn_123456"
  }
}

6.2.2 Points Crédités

{
  "notification": {
    "title": "Points crédités ! 🎉",
    "body": "+25 points ajoutés • Total : 450 points"
  },
  "data": {
    "type": "POINTS_CREDITED",
    "points_added": "25",
    "total_balance": "450",
    "deep_link": "rewapp://wallet"
  }
}

6.2.3 QR Code Scanné

{
  "notification": {
    "title": "Paiement réussi chez Café du Centre ✅",
    "body": "-50 points utilisés (5,25€)"
  },
  "data": {
    "type": "QR_SCANNED",
    "points_used": "50",
    "deep_link": "rewapp://history"
  }
}

6.3 Notifications Compte & Rappels

7.1 Endpoints Backend

{
  "categories": {
    "TRANSACTION": true,
    "ACCOUNT": true,
    "PROMO": false,
    "REMINDER": true,
    "SYSTEM": true
  },
  "quiet_hours": {
    "enabled": true,
    "start": "22:00",
    "end": "08:00"
  }
}

7.2 Service d'Envoi Interne

interface NotificationPayload {
  userId: string;
  title: string;
  body: string;
  data?: Record<string, string>;
  category: NotificationCategory;
  priority?: 'high' | 'normal';
}

interface BatchNotificationPayload {
  userIds: string[];
  title: string;
  body: string;
  category: NotificationCategory;
}

8.1 Configuration des Deep Links

8.2 Configuration Mobile

{
  "appId": "fr.rewapp.app",
  "appName": "REWAPP",
  "webDir": "www",
  "server": {
    "hostname": "rewapp.fr"
  },
  "plugins": {
    "PushNotifications": {
      "presentationOptions": ["badge", "sound", "alert"]
    }
  }
}

9.1 Codes d'Erreur FCM

9.2 Codes d'Erreur APNs

9.3 Stratégie de Retry

{
  "maxRetries": 3,
  "initialDelayMs": 1000,
  "maxDelayMs": 60000,
  "backoffMultiplier": 2
}

10.1 Métriques à Suivre

10.2 Alertes Configurées

11.1 Contenu des Notifications

11.2 Timing des Envois

11.3 Segmentation

Segments recommandés pour les notifications promotionnelles :

• Utilisateurs actifs : transaction < 30 jours
• Utilisateurs dormants : pas de transaction > 30 jours
• Utilisateurs premium : palier Gold+
• Nouveaux utilisateurs : inscription < 7 jours
• Utilisateurs géolocalisés : proche d'un partenaire

11.4 Tests A/B

Variables à tester :

Métrique principale : taux d'ouverture et taux de conversion

12.1 Checklist d'Implémentation

• Créer projet Firebase et configurer FCM
• Générer clé APNs et uploader dans Firebase
• Configurer variables d'environnement backend
• Implémenter service de notification NestJS
• Configurer Bull Queue pour traitement asynchrone
• Créer table device_tokens en base
• Implémenter endpoints API (register, preferences)
• Configurer SDK mobile (Capacitor Push Notifications)
• Implémenter deep linking
• Configurer channels Android
• Tester sur appareils physiques iOS et Android
• Configurer monitoring CloudWatch

12.2 Ressources

• Documentation Firebase Cloud Messaging
• Documentation APNs
• Ionic Push Notifications
• Capacitor Push Notifications

12.3 Contacts