Diagrammes de Cas d'Usage
Application Mobile Client

1.1 Objet du Document

Ce document détaille l'ensemble des cas d'usage UML de l'application mobile REWAPP destinée aux clients finaux. Chaque cas d'usage est décrit avec ses acteurs, pré-conditions, flux principal, flux alternatifs, exceptions et post-conditions.

L'application mobile est le point de contact principal entre REWAPP et ses utilisateurs. Elle permet :

• L'inscription et l'authentification des clients
• La liaison des cartes bancaires pour la détection automatique des transactions
• La consultation du solde de points et du palier de fidélité
• La génération de QR codes pour l'utilisation des points chez les partenaires
• La demande de virements bancaires (cashback bancaire)
• La recherche et localisation des partenaires
• La consultation de l'historique des transactions

1.2 Périmètre Fonctionnel

1.3 Documents de Référence

1.4 Conventions UML

Notation adoptée : PlantUML

Symboles utilisés :

• Actor : Représenté par un bonhomme stylisé (:NomActeur:)
• Use Case : Représenté par une ellipse (usecase "Nom du cas")
• System Boundary : Représenté par un rectangle (rectangle "Nom")
• Association : Ligne simple reliant acteur et cas d'usage
• Include : Flèche pointillée avec stéréotype <<include>>
• Extend : Flèche pointillée avec stéréotype <<extend>>
• Generalization : Flèche avec pointe triangulaire vide

Niveaux de priorité :

• Critique : Fonctionnalité indispensable au lancement (MVP)
• Haute : Fonctionnalité importante pour l'expérience utilisateur
• Moyenne : Fonctionnalité secondaire, amélioration du service

2.1 Acteur Principal : Client

2.2 Acteurs Secondaires

2.3 Règles Métier Applicables

Note : Le palier est calculé sur les 12 derniers mois glissants, par commerçant. Recalcul quotidien automatique à 2h00.

3.1 Vue d'Ensemble - Application Mobile Client

@startuml
skinparam backgroundColor #FFFFFF
left to right direction
skinparam packageStyle rectangle
skinparam actorStyle awesome
skinparam roundcorner 10

actor "Client" as client #LightBlue
actor "Systeme Bancaire" as bank #Pink
actor "Notifications" as notif #Coral
actor "Backend REWAPP" as backend #LightGray

rectangle "Application Mobile REWAPP" #LightCyan {
  package "Authentification" #LightGreen {
    usecase "Sinscrire" as UC01 #Aqua
    usecase "Se connecter" as UC02 #Aqua
    usecase "Reset MDP" as UC03 #Aqua
    usecase "Biometrie" as UC04 #Aqua
  }
  
  package "Carte Bancaire" #Orange {
    usecase "Lier carte" as UC05 #Gold
    usecase "Consulter cartes" as UC06 #Gold
    usecase "Supprimer carte" as UC07 #Gold
  }
  
  package "Tableau de Bord" #Yellow {
    usecase "Solde points" as UC08 #LightYellow
    usecase "Palier fidelite" as UC09 #LightYellow
    usecase "Progression" as UC10 #LightYellow
  }
  
  package "Utilisation Points" #Pink {
    usecase "Generer QR" as UC11 #Plum
    usecase "Annuler QR" as UC12 #Plum
    usecase "Virement" as UC13 #Plum
    usecase "Suivre virement" as UC14 #Plum
  }
  
  package "Partenaires" #Lavender {
    usecase "Rechercher" as UC15 #Thistle
    usecase "Historique" as UC16 #Thistle
    usecase "Favoris" as UC17 #Thistle
  }
  
  package "Profil" #Wheat {
    usecase "Modifier profil" as UC18 #Bisque
    usecase "Notifications" as UC19 #Bisque
    usecase "Supprimer compte" as UC20 #Bisque
  }
}

client --> UC01
client --> UC02
client --> UC05
client --> UC08
client --> UC11
client --> UC13
client --> UC15
client --> UC16
client --> UC18

UC02 <.. UC03 : extend
UC02 <.. UC04 : extend
UC11 <.. UC12 : extend

UC11 ..> backend : validation
UC13 ..> backend : validation IBAN

UC05 ..> bank
UC11 ..> notif
UC13 ..> notif
@enduml

3.2 Synthèse des Cas d'Usage

4.1 UC-M01 : S'inscrire

Description : Permet à un nouveau visiteur de créer un compte REWAPP via email/mot de passe ou via authentification sociale (Google, Apple).

Pré-conditions

• L'utilisateur n'a pas de compte REWAPP existant
• L'utilisateur dispose d'une adresse email valide
• L'application est installée sur le smartphone

Post-conditions (succès)

• Un compte utilisateur est créé (statut : non vérifié si email, vérifié si OAuth)
• Un email de validation est envoyé (inscription email uniquement)
• L'utilisateur est redirigé vers l'onboarding de liaison carte

Flux Principal (Inscription Email)

1. 1

   L'utilisateur accède à l'écran d'inscription

2. 2

   L'utilisateur saisit ses informations :

   Prénom (2-50 caractères), Nom (2-50 caractères), Email (format RFC 5322), Mot de passe (8+ caractères, majuscule, minuscule, chiffre), Confirmation mot de passe

3. 3

   L'utilisateur coche la case d'acceptation des CGU

4. 4

   L'utilisateur clique sur "Créer mon compte"

5. 5

   Le système valide les champs côté client

6. 6

   Le système envoie les données au backend (POST /api/auth/register)

7. 7

   Le backend vérifie l'unicité de l'email

8. 8

   Le backend crée le compte (statut : non vérifié)

9. 9

   Le backend envoie un email de validation (lien valable 24h)

10. 10

    L'application affiche l'écran "Vérifiez votre email"

11. 11

    L'utilisateur clique sur le lien dans l'email

12. 12

    Le compte passe au statut "vérifié"

13. 13

    L'application redirige vers l'onboarding liaison carte

Flux Alternatif A (Inscription Google)

1. 1

   L'utilisateur clique sur "Continuer avec Google"

2. 2

   Le système ouvre le popup OAuth2 Google

3. 3

   L'utilisateur s'authentifie sur Google

4. 4

   Google retourne les données (email, prénom, nom, photo)

5. 5

   Si compte existe → Connexion automatique. Sinon → Création du compte

6. 6

   Le système affiche un popup d'acceptation des CGU

7. 7

   Le compte est créé (statut : vérifié) et redirection vers l'onboarding

Exceptions

4.2 UC-M02 : Se connecter

Description : Permet à un utilisateur inscrit de s'authentifier sur l'application via email/mot de passe, biométrie ou OAuth.

Flux Principal (Email/Mot de passe)

1. 1

   L'utilisateur saisit son email et mot de passe

2. 2

   Le système valide et envoie au backend (POST /api/auth/login)

3. 3

   Le backend génère Access token JWT (15 min) + Refresh token (30 jours)

4. 4

   L'application stocke les tokens (Keychain iOS / Keystore Android)

5. 5

   Si biométrie disponible → Proposition d'activation

6. 6

   Redirection vers le dashboard

Flux Alternatif A (Connexion Biométrique)

1. 1

   L'application affiche le prompt biométrique natif au lancement

2. 2

   L'utilisateur s'authentifie via Face ID / Touch ID / Empreinte

3. 3

   Le système échange le refresh token contre un access token

4. 4

   Redirection vers le dashboard

4.3 UC-M03 : Réinitialiser mot de passe

Description : Permet à un utilisateur ayant oublié son mot de passe de le réinitialiser via un lien envoyé par email.

Flux Principal

1. 1

   L'utilisateur clique sur "Mot de passe oublié ?"

2. 2

   L'utilisateur saisit son adresse email

3. 3

   Le backend envoie un email avec lien de réinitialisation (validité 1h, usage unique)

4. 4

   Message neutre : "Si un compte existe, vous recevrez un lien"

5. 5

   L'utilisateur clique sur le lien et saisit le nouveau mot de passe

6. 6

   Le backend invalide toutes les sessions actives

7. 7

   Redirection vers l'écran de connexion

4.4 UC-M04 : Activer biométrie

Description : Permet à l'utilisateur d'activer la connexion biométrique (Face ID, Touch ID, Empreinte digitale).

Flux Principal

1. 1

   L'utilisateur accède à Profil > Paramètres > Sécurité

2. 2

   L'utilisateur active le toggle "Connexion biométrique"

3. 3

   Le système affiche le prompt biométrique natif

4. 4

   Le refresh token est stocké avec protection biométrique

5. 5

   Message : "Connexion biométrique activée"

5.1 UC-M05 : Lier carte bancaire

Description : Permet à l'utilisateur de lier une carte bancaire via le SDK OpenBanking pour activer la détection automatique des transactions.

Flux Principal

1. 1

   L'utilisateur accède à l'écran de liaison carte

2. 2

   Avantages affichés :

   ✅ Détection automatique • 🔒 Sécurité bancaire (ACPR) • ❌ Aucun paiement depuis l'app • 💳 Toutes banques françaises

3. 3

   L'utilisateur clique sur "Lier ma carte"

4. 4

   L'application lance le SDK Budget Insight

5. 5

   L'utilisateur sélectionne sa banque et s'authentifie

6. 6

   L'utilisateur valide le 2FA bancaire si requis

7. 7

   L'utilisateur accepte le consentement (90 jours renouvelable)

8. 8

   Message : "Carte liée avec succès !" → Redirection dashboard

5.2 UC-M06 : Consulter cartes liées

Description : Permet à l'utilisateur de visualiser la liste de ses cartes bancaires liées et leur statut.

Informations affichées par carte

• Logo de la banque
• Nom de la banque
• 4 derniers chiffres (•••• 1234)
• Badge "Principale" si applicable
• Date de liaison
• Statut : 🟢 Active / 🟠 Reconnexion requise

5.3 UC-M07 : Supprimer carte

Description : Permet à l'utilisateur de délier une carte bancaire de son compte.

6.1 UC-M08 : Consulter solde points

Description : Permet à l'utilisateur de consulter son solde de points disponibles et son équivalent en euros.

6.2 UC-M09 : Voir palier fidélité

Description : Permet à l'utilisateur de visualiser son palier de fidélité global et les bonus associés.

7.1 UC-M11 : Générer QR Code

Description : Permet à l'utilisateur de générer un QR code pour utiliser ses points chez un partenaire.

Flux Principal

1. 1

   L'utilisateur accède à l'écran de génération QR

2. 2

   Saisie du montant (suggestions : 50, 100, 200, 500, Max)

3. 3

   Clic sur "Générer le QR Code"

4. 4

   Le backend bloque immédiatement les points

5. 5

   Affichage plein écran :

   QR centré (70% largeur), luminosité max, fond blanc, compteur 60s (vert→orange→rouge)

Sécurité du QR Code

{
  "userId": "hash_utilisateur",
  "amount": 100,
  "timestamp": "2025-11-24T14:30:00Z",
  "nonce": "unique_nonce_xyz",
  "signature": "hmac_sha256_signature"
}

7.3 UC-M13 : Demander virement

Description : Permet à l'utilisateur de convertir ses points en euros via virement bancaire.

Statuts de demande

8.1 UC-M15 : Rechercher partenaires

Description : Permet à l'utilisateur de rechercher et localiser les partenaires REWAPP.

Catégories de partenaires

8.2 UC-M16 : Consulter historique transactions

Description : Permet à l'utilisateur de consulter l'ensemble de ses transactions.

Types de transactions

9.1 UC-M18 : Modifier profil

Description : Permet à l'utilisateur de modifier ses informations personnelles.

Champs modifiables

• Photo de profil (caméra ou galerie)
• Prénom
• Nom
• Téléphone (optionnel)
• Date de naissance (optionnel)
• Email (non modifiable directement - processus sécurisé)

9.2 UC-M19 : Gérer notifications

Description : Permet à l'utilisateur de configurer ses préférences de notifications push.

• Points et transactions (recommandé : ON)
• Virements (recommandé : ON)
• Promotions et offres (défaut : ON)
• Nouveaux partenaires (défaut : ON)
• Alertes sécurité (toujours ON, non modifiable)

9.3 UC-M20 : Supprimer compte

Avertissements affichés

• "Cette action est définitive"
• "Toutes vos données seront supprimées"
• "Vos XXX points seront perdus"
• "Les demandes de virement en cours seront annulées"

10.1 Répartition par Priorité

10.2 Matrice de Traçabilité

10.3 Rappel des Règles Métier Critiques