Le parcours de souscription guide l’utilisateur depuis la découverte des produits d’épargne jusqu’à l’accusé d’enregistrement final. Il s’agit d’un processus séquentiel en six étapes, où chaque transition est conditionnée par des validations ou des actions explicites de l’utilisateur. Un brouillon de souscription est maintenu en session entre les étapes, permettant de revenir en arrière pour modification avant la confirmation définitive.
Consulter les sources (6)
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/fragments/header.jspf · lignes 1–41
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/simulation.jsp · lignes 1–23
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/CatalogAction.java · lignes 13–31
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/catalogue.jsp · lignes 1–38
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/confirmation.jsp · lignes 1–16
Les six étapes du parcours
Le parcours se décompose en six étapes fonctionnelles enchaînées.
Catalogue : l’utilisateur consulte la liste des produits d’épargne disponibles (Horizon Prudent, Équilibre, Dynamique) et leurs caractéristiques principales. Depuis cette page, il peut accéder à la fiche détaillée d’un produit pour lancer une souscription.
Produit : l’utilisateur vérifie les détails du produit sélectionné (profil de risque, taux annuel illustratif, conditions de versement et durée). Un bouton « Souscrire à ce produit » permet de démarrer la demande et d’initialiser un brouillon de souscription.
Souscripteur : l’utilisateur saisit ses informations personnelles obligatoires : prénom, nom, adresse électronique et date de naissance. Ces données sont validées avant de pouvoir passer à l’étape suivante.
Simulation : l’utilisateur définit les paramètres de son placement : versement initial, versement mensuel et durée. Une estimation du capital final est calculée et affichée. L’utilisateur peut recalculer la simulation autant de fois que nécessaire avant de continuer.
Récapitulatif : toutes les informations saisies (produit, souscripteur, paramètres de placement et résultat de la simulation) sont présentées pour vérification. L’utilisateur doit accepter explicitement les informations et les hypothèses de simulation pour pouvoir finaliser sa demande.
Confirmation : l’application affiche un accusé d’enregistrement contenant la référence unique de la souscription, la date et l’heure d’enregistrement, ainsi que le récapitulatif complet de la demande. Cette étape est terminale et marque la fin du parcours.
Consulter les sources (7)
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/catalogue.jsp · lignes 1–38
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/produit.jsp · lignes 1–25
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/souscripteur.jsp · lignes 1–29
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/simulation.jsp · lignes 1–23
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/recapitulatif.jsp · lignes 1–26
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/confirmation.jsp · lignes 1–16
- Marty Harness · source
- src/main/java/fr/demo/souscription/service/CatalogService.java · lignes 9–23
Conditions de progression entre les étapes
Le passage d’une étape à la suivante est conditionné par des validations ou des actions explicites.
De Catalogue à Produit, la sélection d’un produit dans le catalogue permet d’accéder à sa fiche détaillée. Aucune validation n’est requise à ce stade.
De Produit à Souscripteur, l’utilisateur clique sur le bouton de souscription. L’application vérifie alors que le produit sélectionné existe dans le catalogue. Si le produit est introuvable, la demande est rejetée avec un code 404. Si le produit est valide, un brouillon de souscription est initialisé en session et l’utilisateur est redirigé vers l’étape Souscripteur.
De Souscripteur à Simulation, les informations personnelles saisies sont validées : prénom et nom doivent comporter entre 1 et 80 caractères (sans caractère de contrôle) ; l’adresse électronique doit être au format valide (sans espace ni caractères interdits) et ne pas dépasser 254 caractères ; la date de naissance doit être au format JJ/MM/AAAA et le souscripteur doit être majeur. Si une erreur est détectée, les messages correspondants sont affichés et l’utilisateur reste sur cette étape. Si la validation réussit, le brouillon est mis à jour avec le souscripteur et l’utilisateur passe à l’étape Simulation.
De Simulation à Récapitulatif, les paramètres financiers sont validés : le versement initial doit être compris entre 100,00 € et 100 000,00 €, le versement mensuel entre 0,00 € et 2 000,00 €, et la durée doit être un nombre entier de 1 à 30 ans. L’utilisateur peut recalculer la simulation (en restant sur l’étape) ou choisir de continuer. Si les paramètres sont valides, le brouillon est mis à jour avec le résultat de la simulation et l’utilisateur passe à l’étape Récapitulatif.
De Récapitulatif à Confirmation, deux conditions doivent être remplies : l’utilisateur doit cocher la case d’acceptation des informations et des hypothèses de simulation, et la clé de confirmation associée au brouillon doit correspondre à celle transmise avec la requête. Si l’une de ces conditions n’est pas remplie, une erreur 409 est retournée avec le message : « Ce récapitulatif n’est plus à jour. Revenez à la simulation pour vérifier votre demande. » Si tout est valide, la souscription est enregistrée et l’utilisateur est redirigé vers l’étape Confirmation.
Consulter les sources (7)
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/CatalogAction.java · lignes 13–31
- Marty Harness · source
- src/main/java/fr/demo/souscription/service/InputValidator.java · lignes 14–91
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/souscripteur.jsp · lignes 1–29
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/simulation.jsp · lignes 1–23
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/recapitulatif.jsp · lignes 1–26
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/erreur.jsp · lignes 1–12
Points de sortie et gestion des erreurs
Plusieurs situations peuvent interrompre ou bloquer temporairement la progression dans le parcours.
Échec de validation : Si les données saisies ne respectent pas les règles de validation (informations du souscripteur ou paramètres de simulation), l’application affiche les messages d’erreur correspondants et bloque la progression. L’utilisateur doit corriger ses saisies pour pouvoir continuer.
Produit introuvable : Si l’utilisateur tente d’accéder à un produit qui n’existe pas dans le catalogue, l’application affiche un code 404 avec le message : « La page ou le produit demandé est introuvable. » Un retour au catalogue est proposé.
Récapitulatif obsolète : Si la clé de confirmation du récapitulatif ne correspond pas à celle attendue (par exemple, après une modification non enregistrée ou une session expirée), l’application retourne une erreur 409 avec le message : « Ce récapitulatif n’est plus à jour. Revenez à la simulation pour vérifier votre demande. » L’utilisateur doit alors revenir à l’étape Simulation pour recalculer et obtenir une nouvelle clé valide.
Erreur technique lors de l’enregistrement : Si une erreur survient lors de la persistance de la souscription (par exemple, problème de base de données), l’application affiche un code 503 avec le message : « L'enregistrement est momentanément indisponible. Aucune confirmation n’a été émise. Votre saisie est conservée ; vous pouvez réessayer. » L’utilisateur reste sur l’étape Récapitulatif et peut tenter à nouveau la confirmation sans perdre ses données.
Session incomplète ou expirée : Si le brouillon de souscription est absent ou incomplet (par exemple, après une inactivité prolongée ou un retour direct à une étape sans avoir suivi le parcours), l’application redirige l’utilisateur vers le catalogue avec un message indiquant que le parcours est incomplet ou que la session a expiré.
Consulter les sources (5)
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
- Marty Harness · source
- src/main/java/fr/demo/souscription/service/InputValidator.java · lignes 14–91
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/erreur.jsp · lignes 1–12
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/catalogue.jsp · lignes 1–38
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/CatalogAction.java · lignes 13–31