MartyAIDocumentation

Services métier et règles de calcul

Analyser le rôle de chaque service (CatalogService, InputValidator, SimulationService, SubscriptionService) et leurs interactions.

Interprétation candidate — à confirmer

Rôle des services métier

L’application organise sa logique fonctionnelle autour de quatre services métier distincts. CatalogService gère le référentiel des produits d’épargne. InputValidator centralise les règles de validation des données saisies par l’utilisateur. SimulationService réalise les calculs de projection financière selon des intérêts composés mensuels. SubscriptionService assure la confirmation et la persistance des souscriptions. Ces services sont instanciés et exposés par la classe Application, qui les met à disposition des composants web via des getters dédiés.

Consulter les sources (1)
Marty Harness · source
src/main/java/fr/demo/souscription/web/Application.java · lignes 22–84

Fourniture et recherche des produits

CatalogService maintient une liste immuable de produits d’épargne, définie directement dans son code sous forme de collection non modifiable. Les trois produits disponibles sont : Horizon Prudent (code PRUDENT, taux annuel 0,02), Horizon Équilibre (code EQUILIBRE, taux annuel 0,04) et Horizon Dynamique (code DYNAMIQUE, taux annuel 0,06).

La méthode getProducts() retourne l’intégralité de cette liste. La méthode find(String code) effectue une recherche par code en appliquant un filtre sur la collection et retourne un Optional<Product> correspondant au premier produit dont le code correspond à la valeur fournie. Cette approche permet à la fois de lister tous les produits pour le catalogue et de retrouver un produit spécifique pour démarrer une souscription.

Consulter les sources (1)
Marty Harness · source
src/main/java/fr/demo/souscription/service/CatalogService.java · lignes 9–23

Validation des données souscripteur et simulation

InputValidator applique des règles de validation strictes sur les données du souscripteur et de la simulation, en retournant une map d’erreurs par champ en cas d’échec.

Pour le souscripteur, subscriberErrors vérifie que le prénom et le nom contiennent entre 1 et 80 caractères, sans caractère de contrôle (ISO control), et que l’adresse email respecte un format standard (sans espaces, @ ou <>, avec une longueur maximale de 254 caractères). La date de naissance doit être au format JJ/MM/AAAA, valide, non dans le futur, et correspondre à une personne majeure (18 ans révolus). La méthode birthDate parse la chaîne selon ce format avec une validation stricte.

Pour la simulation, simulationErrors valide que le versement initial est compris entre 100,00 € et 100 000,00 €, que la mensualité est comprise entre 0,00 € et 2 000,00 €, et que la durée est un entier entre 1 et 30 ans. Les montants sont analysés par amount selon une expression régulière autorisant 1 à 6 chiffres, éventuellement suivis d’un séparateur décimal (virgule ou point) et de 1 à 2 décimales, puis convertis en BigDecimal.

Consulter les sources (1)
Marty Harness · source
src/main/java/fr/demo/souscription/service/InputValidator.java · lignes 14–91

Calcul du capital final avec intérêts composés mensuels

SimulationService implémente le calcul du capital final selon une capitalisation mensuelle des intérêts composés. La méthode calculate prend en entrée le versement initial, la mensualité, la durée en années et le taux annuel.

Elle vérifie d’abord la validité des paramètres : les montants doivent avoir au maximum 2 décimales, le versement initial doit être entre 100 et 100 000, la mensualité entre 0 et 2 000, la durée entre 1 et 30 ans, et le taux annuel doit être positif et inférieur ou égal à 1. Le calcul utilise un facteur mensuel 1 + (taux_annuel / 12) avec une précision DECIMAL128. Pour chaque mois de la durée (years × 12), le capital est mis à jour selon la formule : capital = capital × facteur + mensualité. Le total des versements (contributed) est calculé comme la somme du versement initial et de toutes les mensualités (monthly × years × 12). Le résultat est retourné sous forme d’un objet Simulation contenant les valeurs initiales, le total des versements et le capital final, ce dernier étant arrondi à deux décimales selon la règle HALF_UP.

Consulter les sources (1)
Marty Harness · source
src/main/java/fr/demo/souscription/service/SimulationService.java · lignes 8–30

Interactions entre les services

Les services métier interagissent de manière séquentielle dans le processus de souscription. Dans SubscriptionAction, CatalogService est utilisé pour récupérer le produit sélectionné via app.getCatalog().find(request.getParameter("code")). InputValidator est sollicité pour valider les données du souscripteur (app.getValidator().subscriberErrors(form)) et de la simulation (app.getValidator().simulationErrors(form)), ainsi que pour convertir les montants saisis (app.getValidator().amount(form.getInitial())). SimulationService est invoqué pour calculer la projection financière avec app.getSimulations().calculate(initial, monthly, years, annualRate). Enfin, SubscriptionService confirme et persiste la souscription via app.getSubscriptions().confirm(draft). Cette organisation permet une séparation claire des responsabilités entre la gestion des produits, la validation, le calcul et la persistance.

Consulter les sources (2)
Marty Harness · source
src/main/java/fr/demo/souscription/web/Application.java · lignes 22–84
Marty Harness · source
src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151

Snapshot graph:e63f5f99ab8bbd6992fd2ffb · version 1
Workspace struts-example-3

Empreinte du snapshot
9a6815fc1f0aaae6d1abef9ee7a19d966482e4bb8dc9f23161a788d459d556c1