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 comptes OpenBanking 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

actor client as "Client"
actor bank as "Systeme Bancaire"
actor notif as "Notifications"
actor backend as "Backend REWAPP"

rectangle "Application Mobile REWAPP" {
  package "Authentification" {
    usecase "Sinscrire" as UC01
    usecase "Se connecter" as UC02
    usecase "Reset MDP" as UC03
      }

  package "OpenBanking" {
    usecase "Lier compte OpenBanking" as UC05
    usecase "Consulter comptes" as UC06
    usecase "Supprimer compte" as UC07
  }

  package "Tableau de Bord" {
    usecase "Solde points" as UC08
    usecase "Palier fidelite" as UC09
    usecase "Progression" as UC10
  }

  package "Utilisation Points" {
    usecase "Generer QR" as UC11
    usecase "Annuler QR" as UC12
    usecase "Virement" as UC13
    usecase "Suivre virement" as UC14
  }

  package "Partenaires" {
    usecase "Rechercher" as UC15
    usecase "Historique" as UC16
    usecase "Favoris" as UC17
  }

  package "Profil" {
    usecase "Modifier profil" as UC18
    usecase "Notifications" as UC19
    usecase "Supprimer compte" as UC20
  }
}

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

3.2 Synthèse des Cas d'Usage

4.1 UC-M1 : 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-M2 : Se connecter

Description : Permet à un utilisateur inscrit de s'authentifier sur l'application via email/mot de passe ou OAuth (Google/Apple).

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

   Redirection vers le dashboard

6.1 UC-M7 : Consulter solde points

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

6.2 UC-M8 : Voir palier fidélité

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

7.1 UC-M10 : 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 15 minutes (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-M12 : Demander virement

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

Statuts de demande

8.1 UC-M14 : Rechercher partenaires

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

Catégories de partenaires

8.2 UC-M15 : Consulter historique transactions

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

Types de transactions

9.1 UC-M17 : 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-M18 : 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-M19 : 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