v1.0 Novembre 2025
5.1.4

Diagrammes de Cas d'Usage
Site Vitrine

La solution de cashback nouvelle génération

24 novembre 2025
Version 1.0
14 Cas d'Usage
1

VUE D'ENSEMBLE

1.1 Objectif du Document

Ce document présente les diagrammes de cas d'usage UML du Site Vitrine REWAPP. Il décrit les interactions possibles entre les acteurs externes et le système, couvrant les cas nominaux, alternatifs et les scénarios d'erreur.

Le Site Vitrine constitue la porte d'entrée digitale de l'écosystème REWAPP. Ses missions principales sont :

  • Présenter la proposition de valeur unique REWAPP
  • Convertir les visiteurs en utilisateurs de l'application mobile
  • Recruter de nouveaux commerçants partenaires
  • Afficher l'annuaire des partenaires
  • Assurer la conformité légale (CGU, CGV, RGPD)

1.2 Acteurs du Système

Acteurs Identifiés

Acteur Type Description
Visiteur Primaire Tout utilisateur anonyme naviguant sur le site vitrine. Peut être un prospect client ou un prospect partenaire.
Prospect Client Primaire Visiteur intéressé par le téléchargement de l'application REWAPP pour bénéficier du cashback.
Prospect Partenaire Primaire Commerçant ou représentant d'entreprise souhaitant devenir partenaire REWAPP.
Système Email Secondaire Service tiers (SendGrid) pour l'envoi d'emails de confirmation et notifications.
API REWAPP Secondaire Backend REWAPP fournissant les données partenaires et traitant les soumissions de formulaires.
Service Géolocalisation Secondaire API de cartographie (Mapbox/Google Maps) pour la carte interactive.
App Store / Play Store Secondaire Plateformes de téléchargement d'applications mobiles.

1.3 Périmètre Fonctionnel

Le Site Vitrine couvre les fonctionnalités suivantes :

  • Navigation et consultation de contenu informatif
  • Annuaire interactif des partenaires avec carte et filtres
  • Formulaires de conversion (newsletter, inscription partenaire, contact)
  • Simulateur de gains pour les prospects
  • Pages légales (CGU, CGV, RGPD, mentions légales)
  • Téléchargement de l'application mobile
HORS PÉRIMÈTRE

L'authentification utilisateur et la gestion de compte client sont exclusivement réalisées via l'Application Mobile.

2

DIAGRAMME DE CAS D'USAGE GLOBAL

Diagramme de Cas d'Usage - Site Vitrine REWAPP
4

CAS D'USAGE - PARTENAIRES

4.1 UC-SV-004 : Consulter la Liste des Partenaires

Fiche Cas d'Usage

IdentifiantUC-SV-004
NomConsulter la Liste des Partenaires
Acteur principalVisiteur
Acteurs secondairesAPI REWAPP, Service Géolocalisation
Pré-conditionsAucune
Post-conditionsLa liste des partenaires est affichée avec carte interactive
PrioritéHaute

Description : Le visiteur consulte l'annuaire complet des partenaires REWAPP avec une carte interactive et une liste filtrable.

Scénario Nominal

  1. 1

    Le visiteur accède à /partenaires

  2. 2

    Le système récupère la liste des partenaires depuis l'API

  3. 3

    Le système demande la géolocalisation du visiteur

  4. 4

    Le visiteur autorise la géolocalisation

  5. 5

    Le système centre la carte sur la position du visiteur

  6. 6

    Le système affiche les pins des partenaires sur la carte

  7. 7

    Le système affiche la liste des partenaires triés par distance

  8. 8

    Le visiteur peut interagir avec la carte et la liste

Scénarios Alternatifs

A1 - Géolocalisation refusée

A1.1 Le visiteur refuse la géolocalisation
A1.2 Le système centre la carte sur la France métropolitaine (zoom 6)
A1.3 Le système affiche un message : "Activez la géolocalisation pour voir les partenaires près de vous"
A1.4 Le système propose une recherche par ville/code postal
A1.5 Le scénario reprend à l'étape 6

A2 - Nombreux partenaires (clustering)

A2.1 Plus de 10 pins sont proches sur la carte
A2.2 Le système regroupe les pins en clusters
A2.3 Le visiteur peut zoomer pour détailler les clusters

Scénarios d'Erreur

E1 - API indisponible

E1.1 L'API ne répond pas dans les 5 secondes
E1.2 Le système affiche un message d'erreur
E1.3 Un bouton "Réessayer" est affiché

Diagramme de Séquence - UC-SV-004
@startuml
title UC-SV-004 : Consulter la Liste des Partenaires

actor Visiteur as V
participant "Site Vitrine" as SV
participant "API REWAPP" as API
participant "Mapbox" as GEO
participant "Navigateur" as NAV

V -> SV : Accès /partenaires
activate SV

SV -> API : GET /partners?limit=100
API --> SV : Liste partenaires

SV -> NAV : Demande géolocalisation
alt Autorisée
  NAV --> SV : Position (lat, lng)
  SV -> GEO : Centrer carte sur position
else Refusée
  NAV --> SV : Permission refusée
  SV -> SV : Centrer carte sur France
  SV --> V : Message "Activez géolocalisation"
end

SV -> GEO : Afficher pins partenaires
GEO --> SV : Carte avec pins

SV --> V : Page partenaires complète

V -> SV : Clic sur pin
SV -> SV : Afficher info-bulle partenaire

V -> SV : Clic "Voir détails"
SV --> V : Fiche partenaire (sidebar/modal)

@enduml

4.2 UC-SV-005 : Rechercher un Partenaire

Fiche Cas d'Usage

IdentifiantUC-SV-005
NomRechercher un Partenaire
Acteur principalVisiteur
Acteurs secondairesAPI REWAPP
Pré-conditionsLe visiteur est sur la page /partenaires
Post-conditionsLes résultats de recherche sont affichés
PrioritéHaute

Description : Le visiteur utilise la barre de recherche pour trouver un partenaire spécifique par nom, catégorie ou ville.

Scénario Nominal

  1. 1

    Le visiteur saisit un terme dans la barre de recherche

  2. 2

    Le système attend 300ms (debounce)

  3. 3

    Le système envoie la requête de recherche à l'API

  4. 4

    Le système affiche les suggestions autocomplete

  5. 5

    Le visiteur sélectionne une suggestion ou valide sa recherche

  6. 6

    Le système filtre la liste et la carte selon les résultats

  7. 7

    Le système affiche le nombre de résultats trouvés

Règles de Recherche

  • Recherche sur : nom du partenaire, catégorie, ville
  • Insensible à la casse
  • Tolérante aux accents
  • Debounce de 300ms pour optimisation
A1 - Aucun résultat

A1.1 La recherche ne retourne aucun partenaire
A1.2 Le système affiche "Aucun partenaire trouvé pour [terme]"
A1.3 Le système propose des suggestions de recherche alternatives

4.3 UC-SV-006 : Filtrer les Partenaires

Fiche Cas d'Usage

IdentifiantUC-SV-006
NomFiltrer les Partenaires
Acteur principalVisiteur
Acteurs secondairesAPI REWAPP
Pré-conditionsLe visiteur est sur la page /partenaires
Post-conditionsLa liste est filtrée selon les critères sélectionnés
PrioritéMoyenne

Description : Le visiteur applique des filtres pour affiner la liste des partenaires affichés.

Filtres Disponibles

Options de Filtrage

Filtre Type Options
Catégorie Multi-select Restauration, Commerce alimentaire, Mode & beauté, Services, Loisirs & culture, Santé & bien-être
Taux de cashback Range slider 1% - 10%
Type partenaire Toggle Tous / Premium uniquement
Tri Select Distance, Taux cashback (décroissant), Nom (A-Z), Nouveautés

4.4 UC-SV-007 : Géolocaliser les Partenaires

Fiche Cas d'Usage

IdentifiantUC-SV-007
NomGéolocaliser les Partenaires
Acteur principalVisiteur
Acteurs secondairesService Géolocalisation, API REWAPP
Pré-conditionsLe visiteur est sur la page /partenaires
Post-conditionsLa carte est centrée sur une position avec partenaires à proximité
PrioritéMoyenne

Description : Le visiteur utilise la géolocalisation ou recherche une adresse pour trouver les partenaires proches d'un lieu spécifique.

Scénario Nominal

  1. 1

    Le visiteur clique sur le bouton "Me localiser"

  2. 2

    Le navigateur demande l'autorisation de géolocalisation

  3. 3

    Le visiteur autorise

  4. 4

    Le système récupère les coordonnées GPS

  5. 5

    Le système centre la carte sur la position (zoom 12)

  6. 6

    Le système affiche les partenaires dans un rayon de 10km

  7. 7

    Le système trie la liste par distance croissante

A1 - Recherche par adresse

A1.1 Le visiteur saisit une adresse dans le champ localisation
A1.2 Le système propose des suggestions via autocomplete (Google Places)
A1.3 Le visiteur sélectionne une adresse
A1.4 Le système centre la carte sur cette adresse
A1.5 Le scénario reprend à l'étape 6

5

CAS D'USAGE - CONVERSION UTILISATEURS

5.1 UC-SV-008 : S'Inscrire à la Newsletter

Fiche Cas d'Usage

IdentifiantUC-SV-008
NomS'Inscrire à la Newsletter
Acteur principalProspect Client
Acteurs secondairesAPI REWAPP, Système Email
Pré-conditionsLe visiteur n'est pas encore inscrit
Post-conditionsL'email est enregistré et un email de confirmation est envoyé
PrioritéHaute

Description : Le prospect client s'inscrit à la newsletter pour recevoir les liens de téléchargement et les actualités REWAPP.

Scénario Nominal

  1. 1

    Le prospect localise le formulaire newsletter (footer ou section dédiée)

  2. 2

    Le prospect saisit son adresse email

  3. 3

    Le système valide le format de l'email (côté client)

  4. 4

    Le prospect soumet le formulaire

  5. 5

    Le système vérifie le captcha invisible (reCAPTCHA v3)

  6. 6

    Le système envoie l'email à l'API

  7. 7

    L'API enregistre l'email en base de données

  8. 8

    L'API déclenche l'envoi d'un email de confirmation

  9. 9

    Le système affiche le message : "Merci ! Vous recevrez un email avec les liens de téléchargement."

Scénarios d'Erreur

E1 - Email invalide

E1.1 Le format de l'email est invalide
E1.2 Le système affiche : "Veuillez saisir une adresse email valide"
E1.3 Le champ est mis en évidence (bordure rouge)

E2 - Captcha échoué

E2.1 Le score reCAPTCHA est trop bas (suspicion de bot)
E2.2 Le système bloque la soumission
E2.3 Le système propose un captcha visible en fallback

Diagramme de Séquence - UC-SV-008
@startuml
title UC-SV-008 : S'Inscrire à la Newsletter

actor "Prospect Client" as PC
participant "Site Vitrine" as SV
participant "reCAPTCHA" as RC
participant "API REWAPP" as API
participant "SendGrid" as EMAIL

PC -> SV : Saisie email + submit
activate SV

SV -> SV : Validation format email
alt Email invalide
  SV --> PC : Erreur "Email invalide"
else Email valide
  SV -> RC : Vérification captcha
  RC --> SV : Score (0.0 - 1.0)
  
  alt Score < 0.5
    SV --> PC : Captcha visible requis
  else Score >= 0.5
    SV -> API : POST /newsletter/subscribe
    API -> API : Vérifier si email existe
    
    alt Nouvel email
      API -> API : Enregistrer email
      API -> EMAIL : Envoyer email bienvenue
    else Email existant
      API -> EMAIL : Envoyer email rappel
    end
    
    API --> SV : 200 OK
    SV --> PC : "Merci ! Email de confirmation envoyé"
  end
end

@enduml

5.2 UC-SV-009 : Télécharger l'Application

Fiche Cas d'Usage

IdentifiantUC-SV-009
NomTélécharger l'Application
Acteur principalProspect Client
Acteurs secondairesApp Store, Play Store
Pré-conditionsLe visiteur souhaite télécharger l'application
Post-conditionsLe visiteur est redirigé vers le store approprié
PrioritéCritique

Description : Le prospect client clique sur un bouton de téléchargement pour être redirigé vers l'App Store (iOS) ou le Play Store (Android).

Scénario Nominal

  1. 1

    Le prospect clique sur le bouton "App Store" ou "Play Store"

  2. 2

    Le système détecte le type de store cliqué

  3. 3

    Le système enregistre l'événement analytics (download_click)

  4. 4

    Le système redirige vers l'URL du store correspondant

  5. 5

    Le store s'ouvre avec la fiche de l'application REWAPP

Scénarios Alternatifs

A1 - Scan du QR Code

A1.1 Le prospect scanne le QR code avec son smartphone
A1.2 Le système détecte l'OS du device (iOS/Android)
A1.3 Le système redirige automatiquement vers le store approprié

A2 - Détection automatique de l'OS

A2.1 Un bouton unique "Télécharger" est cliqué
A2.2 Le système détecte l'OS via User-Agent
A2.3 Le système redirige vers le store correspondant
A2.4 Si OS non détecté, afficher les deux options

Événement Analytics

Nomdownload_click
Paramètresstore_type (ios/android), source_page, source_button

5.3 UC-SV-010 : Utiliser le Simulateur de Gains

Fiche Cas d'Usage

IdentifiantUC-SV-010
NomUtiliser le Simulateur de Gains
Acteur principalProspect Client
Acteurs secondairesAucun
Pré-conditionsLe visiteur est sur la page /clients
Post-conditionsLes gains estimés sont affichés
PrioritéMoyenne

Description : Le prospect utilise le simulateur interactif pour estimer ses gains potentiels avec REWAPP.

Scénario Nominal

  1. 1

    Le prospect accède au simulateur sur la page /clients

  2. 2

    Le prospect ajuste les paramètres :
    - Dépenses mensuelles (slider : 100€ - 2000€)
    - Taux de cashback moyen (défaut : 4%)
    - Mode d'utilisation (bancaire / commerçant)

  3. 3

    Le système calcule en temps réel :
    - Points mensuels gagnés
    - Valeur en euros (selon mode choisi)
    - Projection annuelle

  4. 4

    Le système affiche les résultats de manière visuelle

Formules de Calcul

FORMULES
Points gagnés = (Dépenses × Taux cashback) / 0,10€

Si mode bancaire : Valeur = Points × 0,095€
Si mode commerçant : Valeur = Points × 0,105€
Exemple de Calcul

Dépenses : 500€/mois | Taux : 4%
Points = (500 × 0,04) / 0,10 = 200 points/mois
Bancaire : 200 × 0,095 = 19€/mois = 228€/an
Commerçant : 200 × 0,105 = 21€/mois = 252€/an

6

CAS D'USAGE - CONVERSION PARTENAIRES

6.1 UC-SV-011 : Soumettre une Demande Partenaire

RÈGLE MÉTIER IMPORTANTE

Toute demande partenaire nécessite une VALIDATION MANUELLE par l'équipe admin REWAPP avant activation.

Fiche Cas d'Usage

IdentifiantUC-SV-011
NomSoumettre une Demande Partenaire
Acteur principalProspect Partenaire
Acteurs secondairesAPI REWAPP, Système Email
Pré-conditionsLe commerçant souhaite devenir partenaire
Post-conditionsLa demande est enregistrée avec statut "En attente de validation"
PrioritéCritique

Description : Le prospect partenaire remplit le formulaire d'inscription pour devenir partenaire REWAPP.

Scénario Nominal

  1. 1

    Le prospect accède à /commercants

  2. 2

    Le prospect scrolle jusqu'au formulaire d'inscription

  3. 3

    Le prospect remplit les champs obligatoires

  4. 4

    Le système valide chaque champ en temps réel

  5. 5

    Le prospect soumet le formulaire

  6. 6

    Le système vérifie le SIRET (format + checksum Luhn)

  7. 7

    Le système envoie les données à l'API

  8. 8

    L'API crée une entrée partenaire avec statut "En attente de validation"

  9. 9

    L'API déclenche email de confirmation au commerçant + notification à l'équipe admin

  10. 10

    Le système affiche : "Merci pour votre demande ! Notre équipe vous contactera sous 48h ouvrées pour finaliser votre inscription."

Validation des Champs

Règles de Validation

Champ Type Validation
Raison socialeTexteMin 2 caractères, max 100
Numéro SIRETTexteFormat 14 chiffres + checksum Luhn
Nom du contactTexteMin 2 caractères
Email professionnelEmailFormat email valide (regex)
TéléphoneTéléphoneFormat français (+33 ou 0X XX XX XX XX)
Type de commerceSelectValeur dans liste autorisée
AdresseTexteValidée via Google Places
Consentement RGPDCheckboxDoit être coché

Scénarios d'Erreur

Messages d'Erreur

Erreur Message Action
SIRET invalide"Le numéro SIRET saisi est invalide. Veuillez vérifier."Focus sur le champ SIRET
Email invalide"L'adresse email n'est pas valide."Focus sur le champ email
Téléphone invalide"Le numéro de téléphone n'est pas valide (format français attendu)."Focus sur le champ téléphone
Champ obligatoire vide"Ce champ est obligatoire"Indication sur le champ concerné
Consentement non coché"Vous devez accepter les conditions pour continuer"Focus sur la checkbox
Erreur serveur"Une erreur est survenue. Veuillez réessayer."Bouton réessayer
Diagramme de Séquence - UC-SV-011
@startuml
title UC-SV-011 : Soumettre une Demande Partenaire

actor "Prospect Partenaire" as PP
participant "Site Vitrine" as SV
participant "Google Places" as GP
participant "API REWAPP" as API
participant "SendGrid" as EMAIL
participant "Dashboard Admin" as ADMIN

PP -> SV : Remplissage formulaire
activate SV

PP -> SV : Saisie adresse
SV -> GP : Autocomplete adresse
GP --> SV : Suggestions
SV --> PP : Afficher suggestions

PP -> SV : Soumission formulaire
SV -> SV : Validation côté client

alt Validation échouée
  SV --> PP : Erreurs de validation
else Validation OK
  SV -> API : POST /partners/register
  
  API -> API : Validation SIRET (Luhn)
  alt SIRET invalide
    API --> SV : 400 "SIRET invalide"
    SV --> PP : Erreur SIRET
  else SIRET valide
    API -> API : Créer partenaire (statut: pending)
    
    par Notifications
      API -> EMAIL : Email confirmation partenaire
      API -> ADMIN : Notification nouvelle demande
    end
    
    API --> SV : 201 Created
    SV --> PP : Message succès
  end
end

@enduml

6.2 UC-SV-012 : Demander une Démonstration

Fiche Cas d'Usage

IdentifiantUC-SV-012
NomDemander une Démonstration
Acteur principalProspect Partenaire
Acteurs secondairesAPI REWAPP, Système Email
Pré-conditionsLe commerçant souhaite plus d'informations
Post-conditionsUne demande de démonstration est enregistrée
PrioritéMoyenne

Description : Le prospect partenaire demande à être contacté pour une démonstration du service REWAPP.

Scénario Nominal

  1. 1

    Le prospect clique sur "Demander une démonstration"

  2. 2

    Le système scrolle vers le formulaire partenaire

  3. 3

    Le prospect remplit le formulaire (voir UC-SV-011)

  4. 4

    Le prospect indique dans le message qu'il souhaite une démonstration

  5. 5

    Le système traite la demande comme une inscription partenaire avec flag "demo_requested"

7

CAS D'USAGE - SUPPORT

7.1 UC-SV-013 : Consulter la FAQ

Fiche Cas d'Usage

IdentifiantUC-SV-013
NomConsulter la FAQ
Acteur principalVisiteur
Pré-conditionsAucune
Post-conditionsLe visiteur a consulté les réponses à ses questions
PrioritéMoyenne

Description : Le visiteur consulte la Foire Aux Questions pour trouver des réponses à ses interrogations.

Questions FAQ Clients (minimum 8)

  • Comment lier ma carte bancaire ?
  • Comment fonctionne le cashback bancaire ?
  • Comment utiliser mes points chez un partenaire ?
  • Quelle est la durée de validité des points ? (12 mois)
  • Y a-t-il un plafond de points ? (Non, illimité)
  • Combien de temps pour recevoir mon virement ? (2-3 semaines)
  • Comment fonctionne le QR code ? (60 secondes, usage unique)
  • Mes données bancaires sont-elles sécurisées ?

7.2 UC-SV-014 : Contacter le Support

Fiche Cas d'Usage

IdentifiantUC-SV-014
NomContacter le Support
Acteur principalVisiteur
Acteurs secondairesAPI REWAPP, Système Email
Pré-conditionsAucune
Post-conditionsLe message est envoyé à l'équipe support
PrioritéMoyenne

Description : Le visiteur utilise le formulaire de contact pour envoyer un message à l'équipe REWAPP.

Scénario Nominal

  1. 1

    Le visiteur accède à /contact

  2. 2

    Le visiteur remplit le formulaire :
    - Nom complet (obligatoire)
    - Email (obligatoire)
    - Sujet (select : Question générale, Problème technique, Partenariat, Presse, Autre)
    - Message (obligatoire, min 10 caractères)

  3. 3

    Le système valide les champs

  4. 4

    Le visiteur soumet le formulaire

  5. 5

    Le système envoie le message à l'API

  6. 6

    L'API transmet le message au support

  7. 7

    Le système affiche : "Votre message a bien été envoyé. Nous vous répondrons sous 48h."

Scénarios d'Erreur

  • E1 - Champ vide : "Ce champ est obligatoire"
  • E2 - Email invalide : "Veuillez saisir une adresse email valide"
  • E3 - Message trop court : "Votre message doit contenir au moins 10 caractères"
8

RELATIONS ET EXTENSIONS

Tableau des Relations

Cas d'Usage Source Relation Cas d'Usage Cible Condition
UC-SV-004 Liste Partenaires <<extend>> UC-SV-004b Fiche Partenaire Clic sur un partenaire
UC-SV-004 Liste Partenaires <<extend>> UC-SV-005 Recherche Utilisation barre de recherche
UC-SV-004 Liste Partenaires <<extend>> UC-SV-006 Filtrage Application de filtres
UC-SV-004 Liste Partenaires <<extend>> UC-SV-007 Géolocalisation Activation localisation
UC-SV-012 Demande Démo <<include>> UC-SV-011 Inscription Partenaire Toujours
UC-SV-008 Newsletter <<extend>> UC-SV-009 Téléchargement Via email de confirmation
Diagramme des Relations entre Cas d'Usage
@startuml
title Relations entre Cas d'Usage - Site Vitrine

left to right direction

usecase "Consulter liste partenaires" as UC004
usecase "Afficher fiche partenaire" as UC004b
usecase "Rechercher partenaire" as UC005
usecase "Filtrer partenaires" as UC006
usecase "Géolocaliser partenaires" as UC007

usecase "S'inscrire newsletter" as UC008
usecase "Télécharger application" as UC009

usecase "Soumettre demande partenaire" as UC011
usecase "Demander démonstration" as UC012

' Extensions de la liste partenaires
UC004 <.. UC004b : <>
UC004 <.. UC005 : <>
UC004 <.. UC006 : <>
UC004 <.. UC007 : <>

' Relation include
UC012 ..> UC011 : <>

' Relation entre newsletter et téléchargement
UC008 ..> UC009 : <>
[email contient liens stores]

@enduml
9

RÉCAPITULATIF DES CAS D'USAGE

Synthèse des 14 Cas d'Usage

ID Nom Acteur Principal Priorité Complexité
UC-SV-001 Consulter la Page d'Accueil Visiteur Haute Faible
UC-SV-002 Découvrir les Fonctionnalités Visiteur Haute Faible
UC-SV-003 Consulter Informations Légales Visiteur Moyenne Faible
UC-SV-004 Consulter Liste Partenaires Visiteur Haute Moyenne
UC-SV-005 Rechercher un Partenaire Visiteur Haute Moyenne
UC-SV-006 Filtrer les Partenaires Visiteur Moyenne Moyenne
UC-SV-007 Géolocaliser les Partenaires Visiteur Moyenne Moyenne
UC-SV-008 S'Inscrire à la Newsletter Prospect Client Haute Faible
UC-SV-009 Télécharger l'Application Prospect Client Critique Faible
UC-SV-010 Utiliser Simulateur de Gains Prospect Client Moyenne Moyenne
UC-SV-011 Soumettre Demande Partenaire Prospect Partenaire Critique Haute
UC-SV-012 Demander une Démonstration Prospect Partenaire Moyenne Faible
UC-SV-013 Consulter la FAQ Visiteur Moyenne Faible
UC-SV-014 Contacter le Support Visiteur Moyenne Faible
14 Cas d'Usage Total
2 Critiques
5 Haute Priorité
7 Moyenne Priorité