<a href="/_slides/java/editique.html" class="doc-only slide" target="_blank">🎬 Passer en mode présentation</a> # Editique Objectif : Comprendre comment cela fonctionne pour facilité les US / DE sur l'éditique et pouvoir faire évoluer si besoin. Shu-Ha-Ri : - Comprendre - S'approprier et critiquer - Faire évoluer --- ## Historique - Première version d'éditique - Front envoie toutes les données nécessaires - Back construit un objet unique avec tous les champs de fusions (présent ou non dans le document à éditer) - Quelques documents sont implémentés avec cette version --- ## Conception socle - La seconde version d'éditique : - le socle fournit un service pour récupérer la liste des editions - le socle founit un service pour récupérer une map de champs de fusion pour une liste de modèles - le socle ne veut uniquement que les champs de fusion nécessaire à l'édition du document ## Conception DH Patient Indépendant du document à éditer. Le découpage favorise la modification en limitant les impactes afin d'itérer sur le remaniement de code avec la montée en complexité d'un module comme l'éditique. ### Pré-requis - 3 modèles maximum : le premier esr le principal et les 2 autres sont des modèles secondaires contenus dans le principal - Un modèle d'édition === liste de champs de fusion - Soit on édite un objet, soit une liste d'objets - Limite : le principal est obligatoirement un objet, seul les modèles secondaires peuvent être des listes d'objets. Besoin d'une évolution si le besoin existe. --- ### Moteur de fusion - recherche les modèles par uuid - recherche les champs de fusion par uuid - récupération des métadonnées de champs de fusion - récupération des valeurs des champs de fusion - Création de l'objet de retour ```plantuml @startuml skinparam linetype ortho skinparam classAttributeIconSize 0 skinparam shadowing false skinparam classFontColor #ffffff skinparam interfaceFontColor #ffffff skinparam classAttributeFontColor #ffffff skinparam fontColor #ffffff skinparam stereotypeFontColor #d8dee9 skinparam classBackgroundColor #21252d skinparam classBorderColor #4f5f72 skinparam interfaceBackgroundColor #21252d skinparam interfaceBorderColor #4f5f72 skinparam ArrowColor #4c566a class DonneesEditionGetter class EditiquePourModeDegrade class EditiquePourRegistreNaissance class EditiqueProxy class EditiqueService class GestionEditionAS interface IGestionEditionAS << interface >> class DemandeEditionUnitaireDTOAS class ReponseEditionDTOASFactory GestionEditionAS -up-^ IGestionEditionAS GestionEditionAS --> EditiqueService : use EditiqueService --> EditiqueProxy : use EditiqueService --> ReponseEditionDTOASFactory : use DonneesEditionGetter -- EditiqueService DonneesEditionGetter -- ReponseEditionDTOASFactory DemandeEditionUnitaireDTOAS -- ReponseEditionDTOASFactory GestionEditionAS --> EditiquePourRegistreNaissance : use EditiquePourRegistreNaissance --> EditiqueProxy : use GestionEditionAS --> EditiquePourModeDegrade : use EditiquePourModeDegrade --> EditiqueProxy : use note right of DonneesEditionGetter #3b4252 gestion des données dans un cache end note note right of EditiqueService #3b4252 mise en relation de la demande avec le cache pour construire la réponse end note note right of ReponseEditionDTOASFactory #3b4252 c'est le moteur de génération du modèle de donnée attendue pour éditer le document end note @enduml ``` --- ### La factory ```plantuml @startuml skinparam linetype ortho skinparam classAttributeIconSize 0 skinparam shadowing false skinparam classFontColor #ffffff skinparam interfaceFontColor #ffffff skinparam classAttributeFontColor #ffffff skinparam fontColor #ffffff skinparam stereotypeFontColor #d8dee9 skinparam classBackgroundColor #21252d skinparam classBorderColor #4f5f72 skinparam interfaceBackgroundColor #21252d skinparam interfaceBorderColor #4f5f72 skinparam ArrowColor #4c566a class ReponseEditionDTOASFactory { + ReponseEditionDTOASFactory(EditiqueProxy): + creerReponseEditionEnMasseDTOAS(List<String>, List<DonneesEditionGetter>, DemandeEditionCommun): ReponseEditionDTOAS + creerReponseEditionDTOAS(List<String>, DonneesEditionGetter, DemandeEditionUnitaireDTOAS): ReponseEditionDTOAS --- Moteur --- - getMergeFieldNames(String[]): Map<String, Set<String>> - extraireChampsFusion(List<String>, Map<String, Set<String>>, List<String>, Set<ChampFusionEdition>, Map<String, Set<ChampFusionEdition>>, Boolean): void - getValues(DonneesEditionGetter, Set<ChampFusionEdition>, Map<String, Set<ChampFusionEdition>>, Boolean): Map<String, Object> --- champs de fusion --- - recupererChampsFusionEditique(Set<String>, List<String>, Boolean): Set<ChampFusionEdition> - chargerChampFusion(String, boolean): ChampFusionEdition? - recupererModeleParUuid(String): ModeleDTO - removeExtension(String): String --- Extraction des données --- - extraireCritereTri(String, ParametrageEditionPreadmission, EditionDTOAS): List<ChampFusionEdition> - extractValeursPourModele(Set<ChampFusionEdition>, DonneesEditionGetter): Map<String, Object> - extractValeursPourSousModele(ChampFusionEdition, Set<ChampFusionEdition>, DonneesEditionGetter): List<Object> - constructionListeJsonObject(List<DonneesEditionGetter>, Map<String, Set<ChampFusionEdition>>, Set<ChampFusionEdition>, boolean): List<JsonObject> --- Construction Reponse --- - creerReponseEditionDTOAS(DemandeEditionCommun, String[], Map<String, Object>): ReponseEditionDTOAS - creerReponseEditionPartieCommune(DemandeEditionCommun, String[]): ReponseEditionDTOAS - creerReponseEditionEnMasse(DemandeEditionCommun, String[], MJsonArray): ReponseEditionDTOAS --- utilitaire --- - getNbCopiePourEdition(DemandeEditionCommun): Integer } @enduml ``` --- ### Métadonnée de champs de fusion un champs de fusion === [ un nom,un objet contenant la valeur, un accesseur vers la valeur,un formateur ] ```plantuml @startuml skinparam linetype ortho skinparam classAttributeIconSize 0 skinparam shadowing false skinparam classFontColor #ffffff skinparam interfaceFontColor #ffffff skinparam classAttributeFontColor #ffffff skinparam fontColor #ffffff skinparam stereotypeFontColor #d8dee9 skinparam classBackgroundColor #21252d skinparam classBorderColor #4f5f72 skinparam interfaceBackgroundColor #21252d skinparam interfaceBorderColor #4f5f72 skinparam ArrowColor #4c566a enum ChampFusionCouverture << enumeration >> interface ChampFusionEdition << interface >> enum ChampFusionEncaissement << enumeration >> enum ChampFusionList << enumeration >> enum ChampFusionNouveauNe << enumeration >> enum ChampFusionPatient << enumeration >> enum ChampFusionVenue << enumeration >> ChampFusionCouverture -[dashed]up-^ ChampFusionEdition ChampFusionEncaissement -[dashed]up-^ ChampFusionEdition ChampFusionList -[dashed]up-^ ChampFusionEdition ChampFusionNouveauNe -[dashed]up-^ ChampFusionEdition ChampFusionPatient -[dashed]up-^ ChampFusionEdition ChampFusionVenue -[dashed]up-^ ChampFusionEdition @enduml ``` --- ### Récupérateur de valeurs - récupération directe d'une valeur dans un objet métier - récupération d'une valeur conditionné par une valeur - récupération d'une valeur calculé par plusieurs champs - formatage de la valeur pour affichage dans le document ```java public interface ChampFusionEdition { default String getValue(DonneesEditionGetter donneesEditique) throws EditiqueException { try { Object donnee = donneesEditique.getDonnee(this); // récupération de l'instance if (donnee == null || getMethod() == null) { return ""; } Object value = getMethod().invoke(donnee); // Invocation de la méthode return getFormatter().apply(value); // Application du formatage de la valeur } catch (Exception e) { // Dans ce cas là, on envoie vide et on log en debug l'info, on bloque pas la génération. getLogger().debug(String.format("Les données %s nécessaires à la génération du document n'ont pas été transmises", getEntite().getSourceClass() .getSimpleName().concat(".").concat(getMethod().getName()))); return ""; } } boolean isListe(); String getNomChamp(); EntiteEdition getEntite(); Method getMethod(); Function<Object, String> getFormatter(); Logger getLogger(); } ``` --- ### cache de donnée ```plantuml @startuml skinparam linetype ortho skinparam classAttributeIconSize 0 skinparam shadowing false skinparam classFontColor #ffffff skinparam interfaceFontColor #ffffff skinparam classAttributeFontColor #ffffff skinparam fontColor #ffffff skinparam stereotypeFontColor #d8dee9 skinparam classBackgroundColor #21252d skinparam classBorderColor #4f5f72 skinparam interfaceBackgroundColor #21252d skinparam interfaceBorderColor #4f5f72 skinparam ArrowColor #4c566a Package structure { interface Cache<T> << interface >> interface CacheList<T> << interface >> class DefaultCache<U> class DefaultCacheList<U> class DefaultResettableCache<U> class DefaultResettableCacheList<U> interface Resettable << interface >> class NouveauNeCacheList<U> } class DonneeEditionFacade class DonneesEdition class DonneesEditionExtends class DonneesEditionGetter interface ThrowingSupplier<T, E> << interface >> CacheList -up-^ Cache DefaultCache -up-^ Cache DefaultCacheList -up-^ CacheList DefaultResettableCache -up-^ DefaultCache DefaultResettableCache -up-^ Resettable DefaultResettableCacheList -up-^ DefaultCacheList DefaultResettableCacheList -up-^ Resettable NouveauNeCacheList -up-^ DefaultCacheList DonneesEdition --> DonneesEditionExtends : use DonneesEdition --> DonneesEditionGetter : use DonneesEdition --> DefaultCache : use DonneesEdition --> DefaultCacheList : use DonneesEdition --> ThrowingSupplier : use DonneesEditionExtends --^ EditiqueProxy DonneeEditionFacade --> DonneesEdition : use @enduml ``` --- ## Implémentation d'une edition !!!danger Il ne faut surtout pas impacter le comportement actuel du getter sauf si c'est l'objectif de la modification suite à un DE ### modification du cache !!!info Aujourd'hui les données sont transférées via le front et peu de données sont géré en lazy. Définition d'un cache sur une donnée Donnée simple ```java public class DonneesEdition { DonneesEdition(DonneesEditiqueBuilder donneesEditiqueBuilder, DonneesEditionExtends donneesEditionExtends) throws EditiqueException { editiqueCache.put(EntiteEdition.PATIENT, new DefaultResettableCache<>(() -> donneesEditiqueBuilder.patient)); editiqueCache.put(EntiteEdition.DOSSIER_DECES, new DefaultCacheList<>(() -> dossiersDeces)); registerDependent(EntiteEdition.DOSSIER_DECES, Arrays.asList(EntiteEdition.PATIENT_GHT, EntiteEdition.TRAIT_COMPLEMENTAIRE, EntiteEdition.ADRESSE_PRINCIPALE, EntiteEdition.CONTACT, EntiteEdition.CONJOINT, EntiteEdition.PERE, EntiteEdition.MERE, EntiteEdition.VENUE)); } } ``` --- ### Modification des champs de fusion ```java public enum ChampFusionPatient implements ChampFusionEdition { IPP("IPP", PATIENT_GHT, "getIppGht", ChampsFusionUtils::defaultFormatter), MT_FDV_HT("MT_FDV_HT", CALCULE, "getMontantHorsTaxeFraisDivers", ChampsFusionUtils::formaterMontant), ... } ``` ### Modification des getters ```java // DonneeEditionGetter public BigDecimal getMontantHorsTaxeFraisDivers() throws EditiqueException { FraisDiversDTO fraisDiversDTO = donneeEditionFacade.getFraisDivers(); BigDecimal montantTva = fraisDiversDTO.getMontantTva(); BigDecimal totalFacture = fraisDiversDTO.getTotalFacture(); BigDecimal montantHorsTaxe = totalFacture.subtract(montantTva); return montantHorsTaxe; } public String getNom() throws EditiqueException { return donneeEditionFacade.isNouveauNe() ? donneeEditionFacade.getNouveauNe() .getNom() : donneeEditionFacade.getPatient().getNomNaissance(); } ``` --- ## Evolutions - Le nombre de champs de fusion est important ==> remplacer les enums par une table en BDD si nécessaire - Le front envoie une uniquement les id et le cache se charge de récupérer les données en mode lazy. - Problème historique : un champs de fusion != une donnée déterminée (un attribut unique de BDD sans condition) --- # <a href="javascript:window.close();" class="slide-only">Terminé </a>