Architecture Technique Globale

1.1 Introduction

L'architecture technique de REWAPP est conçue selon les principes de scalabilité, haute disponibilité et sécurité. Elle repose sur une architecture microservices déployée sur infrastructure CapRover + Docker, permettant une évolutivité horizontale et une maintenance facilitée.

L'écosystème REWAPP comprend quatre composantes principales :

• Application Mobile : iOS/Android pour les clients finaux
• Site Vitrine : présentation de l'offre et inscription
• Dashboard Admin : gestion globale par l'équipe REWAPP
• Dashboard Partenaire : interface de gestion pour les commerçants

1.2 Principes Architecturaux

1.3 Composants de l'Écosystème

1.3.1 Applications Clientes

1.3.2 Services Backend

2.1 Couche Présentation (Frontend)

2.1.1 Application Mobile (Angular + Ionic)

Architecture :

• NgRx / Services Angular pour gestion d'état global
• Ionic Router pour la navigation native
• HttpClient Angular pour les appels API avec intercepteurs
• Ionic Storage pour persistance locale
• @capacitor/camera pour scan QR code
• @capacitor/push-notifications pour push notifications

Sécurité Mobile :

• Certificate Pinning pour éviter attaques MITM
• Biométrie native (FaceID / TouchID / Fingerprint)
• Stockage sécurisé des tokens (Keychain iOS / Keystore Android)
• Obfuscation du code en production

2.1.2 Site Vitrine (Angular 17)

Architecture :

• Static Site Generation (SSG) pour performance SEO optimale
• Tailwind CSS pour styling responsive
• Optimisation images avec next/image
• Integration Google Tag Manager pour analytics

Pages principales :

• Accueil : présentation REWAPP, proposition de valeur
• Comment ça marche : tutoriel utilisateur
• Partenaires : liste et carte des commerçants
• Inscription : formulaire utilisateur et commerçant
• FAQ : questions fréquentes

2.1.3 Dashboards Admin et Partenaire (Angular)

Architecture commune :

• Angular Material / Ionic Components pour composants professionnels
• Services Angular / NgRx pour cache et synchronisation
• Chart.js / Recharts pour visualisations données
• WebSocket pour temps réel (scan QR, notifications)
• PWA avec Service Worker pour mode offline (Dashboard Partenaire)

2.2 Couche API Gateway

2.2.1 Kong API Gateway / Traefik

2.2.2 Structure des Endpoints API

/api/v1/auth/*         → Auth Service (inscription, connexion, 2FA, tokens)
/api/v1/users/*        → User Service (profil, préférences, RGPD)
/api/v1/merchants/*    → Merchant Service (inscription, configuration)
/api/v1/transactions/* → Transaction Service (détection, historique)
/api/v1/points/*       → Points Service (solde, QR code, paliers)
/api/v1/banking/*      → Banking Service (card linking, virements)
/api/v1/notifications/*→ Notification Service (push, email, SMS)

2.3 Couche Services Métier (Backend)

2.3.1 Microservices NestJS

2.3.2 Communication Inter-Services

Communication Synchrone (REST) :

• Requêtes client-facing via API Gateway
• Timeout : 5 secondes par défaut
• Retry policy : 3 tentatives avec exponential backoff (1s, 2s, 4s)

Communication Asynchrone (Bull Queue / Redis) :

• Events : transaction.created, points.credited, user.registered, merchant.validated
• Queues durables avec acknowledgment
• Dead Letter Queue pour messages en échec
• Priorité configurable par type d'event

2.4 Couche Données

2.4.1 PostgreSQL 15+ (Base Principale)

Configuration :

• Extensions activées : UUID-OSSP, pg_trgm (recherche texte)
• Master-Replica replication pour haute disponibilité
• Backup automatique quotidien avec rétention 30 jours
• Connection pooling avec PgBouncer

Tables Principales :

• users : profils utilisateurs
• merchants : informations commerçants
• transactions : historique achats détectés
• points_ledger : journal des mouvements de points
• cards : cartes bancaires liées (tokens uniquement)
• withdrawals : demandes de virement bancaire
• loyalty_tiers : configuration paliers par commerçant
• qr_codes : QR codes générés (TTL 60 secondes)
• notifications : historique notifications

2.4.2 Redis 7+ (Cache et Sessions)

3.1 Services Infrastructure CapRover

3.2 Architecture Réseau (VPC)

3.2.1 Configuration VPC

VPC CIDR           : 10.0.0.0/16
Subnets publics    : 10.0.1.0/24, 10.0.2.0/24 (Multi-AZ a et b)
Subnets privés App : 10.0.10.0/24, 10.0.11.0/24 (Multi-AZ)
Subnets privés Data: 10.0.20.0/24, 10.0.21.0/24 (Multi-AZ)
NAT Gateway        : Accès internet sortant pour subnets privés
Docker Network     : Réseau interne containers CapRover

3.2.2 Security Groups

3.3 Configuration par Environnement

4.1 Chiffrement des Données

4.1.1 Chiffrement au Repos

• PostgreSQL : Encryption via volumes Docker (AES-256)
• MinIO/Stockage : Encryption des volumes (AES-256)
• Docker Volumes : Encrypted by default
• Redis Container : Encryption at-rest activé

4.1.2 Chiffrement en Transit

• TLS 1.3 minimum pour toutes les communications
• Certificate Pinning sur application mobile
• VPN Site-to-Site pour connexions avec partenaire bancaire
• HTTPS obligatoire (HTTP redirection 301)

4.2 Authentification et Autorisation

4.2.1 Stratégie JWT (RS256)

Claims JWT :

• sub : userId unique
• role : user, merchant, admin, superadmin
• permissions : tableau de permissions granulaires
• deviceId : identifiant device pour détection fraude
• exp : timestamp expiration

4.2.2 RBAC (Role-Based Access Control)

4.2.3 2FA (Authentification à Deux Facteurs)

4.3 Protection contre les Attaques

4.3.1 Protection OWASP Top 10

4.3.2 Protection DDoS et Rate Limiting

• Cloudflare/Traefik : Protection DDoS layer 3/4
• Traefik Middleware : Filtrage requêtes malveillantes layer 7
• Rate Limiting API Gateway :

100 requêtes/minute par utilisateur authentifié
1000 requêtes/minute par IP
5 tentatives de login/heure par compte

4.3.3 Sécurité QR Code

• Signature HMAC-SHA256 avec clé secrète
• Points BLOQUÉS dès génération du QR code
• Validation côté serveur obligatoire avant débit
• Détection tentatives de replay (code déjà utilisé)

5.1 Stratégies de Cache

5.1.1 Cache Multi-Niveaux

5.1.2 Stratégies d'Invalidation

• TTL adaptatif : court pour données volatiles, long pour données stables
• Event-driven invalidation : invalidation cache lors de mise à jour données
• Cache warming : pré-chargement données fréquentes au démarrage

5.2 Auto-Scaling

5.2.1 Scaling Horizontal (Docker CapRover)

5.2.2 Scaling Database

• Read Replicas : Répartition charge lectures sur replicas
• Connection Pooling : PgBouncer pour optimiser connexions
• Partitioning : Tables volumineuses partitionnées par date (transactions)

5.3 Optimisations

5.3.1 Optimisations Backend

• Pagination curseur pour grandes listes (évite OFFSET)
• DataLoader pattern pour éviter N+1 queries
• Batch processing pour opérations lourdes (Bull Queue)
• Lazy loading des relations Prisma

5.3.2 Optimisations Frontend

• Code splitting et lazy loading des routes
• Optimisation images : WebP, compression, responsive
• Service Worker pour cache offline (Dashboard Partenaire PWA)
• Bundle size cible : < 200KB gzipped

5.3.3 Objectifs de Performance

6.1 Stack de Monitoring

6.1.1 Métriques (Prometheus + Grafana)

• Métriques système : CPU, RAM, Disk, Network
• Métriques application : Requêtes/s, Latence, Taux d'erreur
• Métriques business : Transactions/jour, Points crédités, Conversions QR
• Dashboards personnalisés par équipe (Dev, Ops, Business)

6.1.2 Logs Centralisés (Loki / CapRover Logs)

Structure des logs (JSON) :

{
  "timestamp": "2025-11-24T10:30:00.000Z",    // Horodatage ISO 8601
  "level": "INFO",                             // INFO, WARN, ERROR, DEBUG
  "service": "auth-service",                   // Nom du microservice
  "requestId": "req_abc123xyz",                // Identifiant unique de requête
  "userId": "usr_456def",                      // Utilisateur concerné (si applicable)
  "message": "User authenticated successfully",// Description de l'événement
  "metadata": {                                // Données contextuelles
    "ip": "192.168.1.1",
    "userAgent": "REWAPP-Mobile/1.0"
  }
}

6.1.3 APM (Application Performance Monitoring)

• Tracing distribué : Suivi requêtes à travers microservices
• Real User Monitoring (RUM) : Performance côté client
• Profiling : Identification goulots d'étranglement
• Error tracking : Sentry pour capture et analyse erreurs

6.2 Alerting

7.1 Pipeline de Déploiement

7.1.1 Outils

7.1.2 Workflow CI/CD

7.2 Environnements

8.1 Solution Bancaire (Card Linking)

8.1.1 Fournisseur Recommandé : Budget Insight

8.1.2 Webhooks Bancaires

• card.linked : Nouvelle carte liée
• card.removed : Carte retirée
• transaction.created : Nouvel achat détecté
• transaction.updated : Mise à jour transaction (confirmation)

8.1.3 Virements SEPA

• API REST pour initiation virements
• Batch processing nocturne (2h00)
• Réconciliation automatique avec webhooks
• Délai : 2-3 semaines maximum (règle métier REWAPP)

8.2 Services de Communication

8.2.1 Notifications Push (Firebase Cloud Messaging)

8.2.2 Email (SendGrid)

• Templates transactionnels : Confirmation inscription, réinitialisation mot de passe
• Templates marketing : Newsletter, promotions (opt-in)
• Bounce handling et suppression automatique
• Suivi delivery et open rates

8.2.3 SMS (Twilio)

• Usage restreint : 2FA et alertes critiques uniquement
• Opt-out management RGPD compliant
• Fallback si échec push notification

8.3 Analytics et Tracking

8.3.1 Google Analytics 4

Événements trackés :

• signup_started, signup_completed
• card_linked
• transaction_detected
• qr_generated, qr_scanned
• withdrawal_requested, withdrawal_completed

8.3.2 Mixpanel

• Funnel analysis : Inscription → Liaison carte → 1ère transaction
• Cohort retention analysis : Rétention J7, J30, J90
• A/B testing framework pour optimisation UX

8.3.3 Sentry (Error Tracking)

• Capture automatique des erreurs frontend et backend
• Stack traces avec contexte utilisateur
• Alertes temps réel sur nouvelles erreurs
• Release tracking pour corrélation erreurs/déploiements

9.1 Récapitulatif de l'Architecture

L'architecture technique de REWAPP a été conçue pour répondre aux exigences de scalabilité, performance et sécurité d'une plateforme de cashback moderne.

9.2 Points Clés

• Architecture cloud-native sur CapRover + Docker
• Microservices découplés avec NestJS
• Base PostgreSQL avec Prisma ORM
• Cache Redis pour performance et sessions
• Bull Queue pour traitement asynchrone
• Sécurité intégrée (Security by Design)
• CI/CD automatisé avec GitHub Actions
• Monitoring complet avec alerting

9.3 Évolutions Futures Prévues

L'architecture est conçue pour supporter les évolutions suivantes :

• Migration Kubernetes : Orchestration avancée pour phase de scale
• GraphQL API : Flexibilité accrue pour les clients
• Machine Learning : Détection fraude et recommandations personnalisées
• Multi-région : Expansion européenne (Belgique, Suisse)