MartyAIDocumentation

Modèle de données et persistance H2

Comprendre la structure des entités métier, leur mapping vers la base de données, et les contraintes appliquées.

Entités métier et leurs propriétés

L’application manipule cinq entités métier principales, modélisées par des classes Java sérialisables.

Product représente un placement financier. Il expose un code unique, un nom, un profil de risque, une description textuelle et un taux annuel brut (annualRate) stocké sous forme de BigDecimal. Ce taux est utilisé pour les calculs de simulation et affiché en pourcentage via la méthode getRatePercent().

Subscriber encapsule les informations du souscripteur : prénom (firstName), nom (lastName), adresse électronique (email) et date de naissance (birthDate de type LocalDate). La méthode getBirthDateLabel() formate la date au format JJ/MM/AAAA pour l’affichage.

Simulation modélise le résultat d’un calcul de placement. Elle contient le versement initial (initial), le versement mensuel (monthly), la durée en années (years), le total des versements (contributed) et le capital final estimé (finalCapital), tous typés BigDecimal sauf la durée. La méthode getGains() déduit le total des versements du capital final pour obtenir le gain estimé.

Draft est un objet de session qui porte l’état en cours de souscription. Il référence le produit choisi (product), le souscripteur (subscriber), la simulation (simulation) et une clé de confirmation (confirmationKey) régénérée à chaque modification du souscripteur ou de la simulation pour invalider les étapes précédentes.

Subscription représente une souscription confirmée et persistée. Elle agrège une référence unique (reference), le produit, le souscripteur, la simulation, et l’horodatage de création (createdAt de type Instant). La méthode getCreatedAtLabel() formate la date pour l’affichage dans le fuseau horaire Europe/Paris.

Consulter les sources (5)
Marty Harness · source
src/main/java/fr/demo/souscription/model/Product.java · lignes 6–28
Marty Harness · source
src/main/java/fr/demo/souscription/model/Subscriber.java · lignes 6–27
Marty Harness · source
src/main/java/fr/demo/souscription/model/Simulation.java · lignes 6–29
Marty Harness · source
src/main/java/fr/demo/souscription/model/Draft.java · lignes 6–28
Marty Harness · source
src/main/java/fr/demo/souscription/model/Subscription.java · lignes 8–34

Stockage des souscriptions dans H2

La table subscriptions est créée par le script SQL embarqué /db/schema.sql et initialisée au démarrage par SubscriptionRepository.initialize(). Elle stocke l’intégralité des données d’une souscription confirmée sous forme dénormalisée, sans jointure avec d’autres tables.

Chaque ligne correspond à une Subscription et contient :

  • reference (VARCHAR(36)) : clé primaire, identifiant unique de la souscription généré par UUID.
  • confirmation_key (VARCHAR(36)) : clé unique associée au Draft, utilisée pour éviter les doublons et valider la confirmation.
  • product_code, product_name, product_profile (VARCHAR) : code, nom et profil du produit, copiés depuis Product.
  • annual_rate (DECIMAL(8,6)) : taux annuel brut du produit.
  • first_name, last_name (VARCHAR(80)) : prénom et nom du souscripteur.
  • email (VARCHAR(254)) : adresse électronique du souscripteur.
  • birth_date (DATE) : date de naissance du souscripteur.
  • initial_amount, monthly_amount (DECIMAL(14,2)) : montants initiaux et mensuels de la simulation.
  • duration_years (INTEGER) : durée en années.
  • contributed (DECIMAL(14,2)) : total des versements (initial + mensuels sur la durée).
  • final_capital (DECIMAL(14,2)) : capital final estimé.
  • created_at (TIMESTAMP) : horodatage de création.

Le repository SubscriptionRepository insère une nouvelle ligne via une requête paramétrée qui mappe chaque propriété de Subscription, Product, Subscriber et Simulation vers les colonnes correspondantes. La transaction est atomique : en cas de conflit sur confirmation_key (SQLState 23505), une recherche par clé est effectuée pour retourner la souscription existante, garantissant l’idempotence de l’opération.

Consulter les sources (2)
Marty Harness · source
src/main/resources/db/schema.sql · lignes 1–1; src/main/resources/db/schema.sql · lignes 1–21
Marty Harness · source
src/main/java/fr/demo/souscription/repository/SubscriptionRepository.java · lignes 24–115

Contraintes de schéma appliquées

Le schéma H2 définit trois contraintes CHECK sur la table subscriptions, qui reprennent les règles métier validées en amont par les services InputValidator et SimulationService :

  • CHECK (initial_amount BETWEEN 100 AND 100000) : le versement initial doit être compris entre 100,00 € et 100 000,00 €. Cette borne inférieure correspond au minimum autorisé pour ouvrir un placement, et la borne supérieure limite l’exposition maximale par souscription.
  • CHECK (monthly_amount BETWEEN 0 AND 2000) : la mensualité doit être comprise entre 0,00 € et 2 000,00 €. Une mensualité nulle permet de modéliser des placements sans versements réguliers, tandis que le plafond limite le montant mensuel autorisé.
  • CHECK (duration_years BETWEEN 1 AND 30) : la durée doit être un entier entre 1 et 30 ans, reflétant la plage de simulation supportée par l’application.

Ces contraintes sont appliquées au niveau de la base pour garantir l’intégrité des données même en cas de contournement des validations applicatives. Elles sont cohérentes avec les validations côté service : InputValidator vérifie les montants et la durée dans subscriberErrors et simulationErrors, et SimulationService applique les mêmes bornes dans calculate avant tout calcul.

Consulter les sources (3)
Marty Harness · source
src/main/resources/db/schema.sql · lignes 1–1; src/main/resources/db/schema.sql · lignes 1–21
Marty Harness · source
src/main/java/fr/demo/souscription/service/InputValidator.java · lignes 14–91
Marty Harness · source
src/main/java/fr/demo/souscription/service/SimulationService.java · lignes 8–30

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

Empreinte du snapshot
9a6815fc1f0aaae6d1abef9ee7a19d966482e4bb8dc9f23161a788d459d556c1