Stack Technique Détaillé

1.1 Objectif du Document

Ce document présente en détail l'ensemble des technologies, frameworks, outils et services utilisés pour développer et exploiter la plateforme REWAPP. Il constitue la référence technique pour l'équipe de développement et les parties prenantes techniques du projet.

1.2 Principes de Sélection

Les choix technologiques de REWAPP ont été guidés par les principes suivants :

• Performance : Temps de réponse API < 200ms, fluidité des applications
• Scalabilité : Architecture capable de supporter 300 000 utilisateurs à 3 ans
• Sécurité : Protection des données bancaires et personnelles (PCI DSS, RGPD)
• Maintenabilité : Technologies matures avec écosystème riche
• Coût : Optimisation des coûts d'infrastructure et de développement

1.3 Vue d'Ensemble de l'Écosystème

2.1 Application Mobile

2.1.1 Technologies Principales

2.1.2 Bibliothèques et Plugins Clés

• HttpClient Angular : Client HTTP natif avec intercepteurs pour authentification
• RxJS (7.x) : Programmation réactive, gestion des flux de données
• @capacitor/camera : Scan QR code et capture photo native
• @capacitor/push-notifications : Notifications FCM/APNs
• Ionic Storage : Persistance locale des données (SQLite/IndexedDB)
• @capacitor/secure-storage : Stockage sécurisé des tokens (Keychain/Keystore)
• @capacitor/geolocation : Géolocalisation native

2.1.3 Outils de Développement

• Angular CLI : Outil de développement et build Angular
• Ionic CLI : Gestion des projets Ionic et builds
• Angular DevTools : Debugging et inspection des composants
• Capacitor : Build natif iOS (Xcode) et Android (Android Studio)

2.1.4 Compatibilité

2.2 Site Vitrine

2.2.1 Technologies Principales

2.2.2 Bibliothèques Clés

• @angular/ssr : Server-side rendering pour SEO
• @angular/forms : Formulaires reactifs
• Zod : Validation des donnees cote client
• Zod : Validation des données côté client

2.2.3 Optimisations SEO

• SSR pour toutes les pages publiques
• Sitemap XML automatique
• Structured Data (JSON-LD)

2.3 Dashboard Admin

2.3.1 Technologies Principales

2.3.2 Bibliothèques Clés

• @angular/common/http : Data fetching avec intercepteurs
• RxJS : Programmation reactive
• @swimlane/ngx-charts : Visualisations de donnees
• Socket.io-client : WebSocket pour temps reel
• date-fns : Manipulation des dates

2.3.3 Fonctionnalités Spécifiques

• Authentification 2FA obligatoire
• Gestion des rôles (Super Admin, Admin, Support)
• Export des données (CSV, Excel, PDF)
• Tableaux de bord personnalisables

2.4 Dashboard Partenaire

2.4.1 Technologies Principales

2.4.2 Fonctionnalités PWA

• Service Worker pour mode offline
• Installation sur écran d'accueil
• Notifications push via Web Push API
• Cache des données critiques
• Responsive design mobile/desktop

2.4.3 Bibliothèques Clés

• @angular/service-worker : Service Worker et caching
• html5-qrcode : Scan QR code via caméra web
• RxJS Services : Synchronisation donnees
• @swimlane/ngx-charts : Statistiques et graphiques

3.1 API et Framework

3.1.1 Technologies Principales

3.1.2 Justification de NestJS

• Architecture modulaire inspirée d'Angular
• Injection de dépendances native
• Support natif TypeScript
• Intégration OpenAPI/Swagger automatique
• Middleware, Guards, Interceptors, Pipes
• Support microservices et WebSockets

3.1.3 Bibliothèques Backend

3.1.4 API Gateway

3.2 Bases de Données

3.2.1 PostgreSQL (Base Principale)

Utilisation :

• Données utilisateurs et authentification
• Transactions et historique
• Recoines de fidélité et mouvements
• Partenaires et campagnes
• QR codes et validations
• Logs d'audit et événements système

3.3 Cache et Sessions

3.3.1 Redis

Utilisation :

• Sessions utilisateurs (TTL 24h)
• Cache API responses (TTL variable)
• QR codes temporaires (TTL 15 min)
• Rate limiting counters
• Pub/Sub pour WebSocket
• Queues BullMQ pour jobs asynchrones

3.4 Message Queue

3.4.1 BullMQ + Redis

Utilisation :

• Communication asynchrone (transactions, notifications)
• Traitement des transactions en arrière-plan
• Envoi d'emails et notifications push
• Calcul des recoines et paliers
• Génération des QR codes

Événements Principaux

user.registered      → Nouvel utilisateur inscrit
transaction.detected → Transaction détectée (Plaid webhooks)
recoins.credited     → Recoines crédités sur un compte
qr_code.scanned      → QR code scanné et validé
campaign.created     → Nouvelle campagne partenaire
payout.requested     → Demande de virement initiée

4.1 Services Infrastructure CapRover

4.1.1 Compute

4.1.2 Stockage

4.1.3 Réseau et Distribution

4.1.4 Sécurité et Monitoring

4.2 Réseau et Sécurité

4.2.1 Architecture réseau interne serveur

réseau interne serveur CIDR          : 10.0.0.0/16
Réseaux publics   : 10.0.1.0/24, 10.0.2.0/24 (redondant)
Réseaux privés    : 10.0.10.0/24, 10.0.11.0/24 (redondant)
Réseaux database  : 10.0.20.0/24, 10.0.21.0/24 (redondant)
NAT Gateway       : Accès internet sortant
Docker Network    : Réseau interne containers

4.2.2 Security Groups

5.1 Solution Bancaire

5.1.1 Connexion Bancaire (OpenBanking)

5.1.2 Virements SEPA

5.2 Notifications

5.2.1 Push Notifications

• Topics pour segmentation (merchants, users, premium)
• Analytics de delivery et engagement
• Notifications riches (images, actions)
• Fallback vers notification in-app

5.3 Emails

5.3.1 Emails Transactionnels

Types d'emails :

• Confirmation d'inscription
• Réinitialisation de mot de passe
• Notification de transaction
• Points sur le point d'expirer
• Newsletter et promotions

5.4 Analytics

5.4.1 Analytics Utilisateur

5.4.2 Monitoring Technique

6.1 Versioning et CI/CD

6.1.1 Gestion du Code Source

6.1.2 Pipeline CI/CD

6.1.3 Infrastructure as Code

6.2 Monitoring et Observabilité

6.2.1 Stack de Monitoring

6.2.2 Alertes

6.3 Tests et Qualité

6.3.1 Outils de Test

6.3.2 Qualité du Code

7.1 Angular/Ionic vs React Native

7.2 NestJS vs Express

7.3 PostgreSQL vs MySQL

7.4 CapRover vs Cloud Providers

8.1 Environnements

8.2 Configuration Infrastructure

8.3 Configuration Applicative

8.4 Gestion des Secrets

DATABASE_URL       → URL de connexion PostgreSQL
REDIS_URL          → URL de connexion Redis
JWT_SECRET         → Clé de signature JWT (RS256)
BANKING_API_KEY    → Clé API solution bancaire
SENDGRID_API_KEY   → Clé API SendGrid
FCM_SERVER_KEY     → Clé serveur Firebase

9.1 Récapitulatif du Stack

9.2 Points Clés

Le stack technique de REWAPP a été conçu pour répondre aux exigences suivantes :

• Scalabilité

  Architecture microservices avec scaling Docker containers horizontal permettant de supporter 30 000 à 300 000 utilisateurs

• Performance

  Temps de réponse API < 200ms grâce au cache multi-niveaux (Redis, CDN)

• Sécurité

  Protection des données bancaires avec chiffrement AES-256, JWT RS256, conformité RGPD et PCI DSS

• Maintenabilité

  Code TypeScript, architecture modulaire NestJS, tests automatisés et documentation OpenAPI

• Disponibilité

  Déploiement CapRover avec SLA 99.9%, circuit breakers et health checks

9.3 Évolutions Prévues

9.3.1 Court Terme (6 mois)

• GraphQL : API GraphQL pour les clients mobiles (flexibilité des requêtes)
• gRPC : Communication inter-services plus performante
• WebSocket : Amélioration du temps réel pour les notifications

9.3.2 Moyen Terme (12 mois)

• Kubernetes : Migration vers K8s pour orchestration avancée
• Service Mesh : Istio pour observabilité et sécurité
• Machine Learning : Détection de fraude et recommandations personnalisées

9.3.3 Long Terme (24 mois)

• Event Sourcing : Traçabilité complète des événements métier
• CQRS : Séparation lecture/écriture pour scalabilité maximale
• Multi-région : Déploiement européen pour latence réduite

9.4 Références

Documents complémentaires :

• 4.1 Architecture Technique Globale
• 4.2 Modèle de Données (MCD/MLD)
• 4.3 Architecture Backend API
• 4.4 Architecture Frontend (Mobile + Web)
• 6.1 Document de Sécurité
• 10.5 CI/CD Pipeline