# Vékanban

## <span style="color: rgb(0, 0, 0);">I. INTRODUCTION</span>

### <span style="color: rgb(0, 0, 0);">1. RAPPEL DU SUJET</span>

<span style="color: rgb(0, 0, 0);">Pour notre projet annuel, il nous a été demandé de concevoir une application Java. Cette application doit être un client lourd , possédant une interface graphique de type JavaFX. Elle devra avoir pour but de gérer l'équipe de développement du projet (gestion et définition des tâches, planification, affectation de ressources humaines aux tâches, gestion de tickets...). Un système d'extension de type Plug-in devra être présent. Il faudra vérifier que le plug-in pouvant être construit par 1 tier possède bien la liste des fonctions attendues et que celui-ci s'intègre à l'application sans recompilation. Une gestion des différents plugins devra être intégrées dans l'interface.</span>

### <span style="color: rgb(0, 0, 0);">2. APPLICATION CHOISI</span>

<span style="color: rgb(0, 0, 0);">Nous avons choisi de réaliser une application de gestion de projet agile à l'aide de la méthode Kanban. Elle permettra à l'équipe de développement , ainsi qu’aux consultants de suivre l'avancement du projet. Cette application se comportera exactement comme un Trello. Elle permettra de gérer différents projets, la gestion des tâches à faire, en cours et terminé ainsi que les personnes assignés à ces dernières. Il faudra pouvoir gérer également les dates d'échéance. Pour l'implémentation du plug-in, nous avons pensé un plug-in permettant d'importer les tâches d'un projet Github au sein même de notre application.</span>

## <span style="color: rgb(0, 0, 0);"><a name="_Toc78133323" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;"><span style="font: 7.0pt 'Times New Roman';"> </span>II.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Focus sur l’application</span>

### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133324" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">1.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Connexion &amp; Inscription</span>

<table border="1" id="bkmrk-connexion-pour-pouvo" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 51.9013%;"></col><col style="width: 48.1976%;"></col></colgroup><tbody><tr><td style="vertical-align: top;">#### <span style="color: rgb(0, 0, 0);">Connexion</span>

<span style="color: rgb(0, 0, 0);">Pour pouvoir utiliser l'application, il faut posséder un compte sur celle-ci.</span>

<span style="color: rgb(0, 0, 0);">Il suffit ensuite de se connecter en indiquant son pseudo et son mot de passe.<span style="mso-no-proof: yes;"> </span></span>

</td><td><span style="color: rgb(0, 0, 0);">[![Image1.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/Shaimage1.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/Shaimage1.png)</span></td></tr><tr><td style="vertical-align: top;">#### <span style="color: rgb(0, 0, 0);">Inscription</span>  


<span style="color: rgb(0, 0, 0);">Il est possible de s'inscrire directement depuis l'application. Pour ce faire il suffit de cliquer sur le bouton inscription qui se situe sur la page de connexion.</span>  
<span style="color: rgb(0, 0, 0);">Il faut ensuite renseigner son adresse mail qui doit être unique son pseudo qui doit être unique également ainsi que son mot de passe.</span>

</td><td><span style="color: rgb(0, 0, 0);">[![Image2.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/VSHimage2.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/VSHimage2.png)</span></td></tr></tbody></table>

#### <span style="color: rgb(0, 0, 0);">Déconnexion</span>  


<span style="color: rgb(0, 0, 0);">Il est possible de se déconnecter de l'application grâce au bouton log out présent en bas à gauche du menu.</span>

### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133328" style="color: rgb(0, 0, 0);"></a>2<span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Mes projets</span>

<span style="color: rgb(0, 0, 0);">Sur cette page, il est possible de voir les différents projets que nous avons créés ainsi que ceux auxquels nous avons été invités par d'autres.</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133329" style="color: rgb(0, 0, 0);"></a>Liste de mes projets</span>

<span style="color: rgb(0, 0, 0);">La première ligne affiche les projets que nous avons créés. Il est possible depuis ici de supprimer le projet.</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133330" style="color: rgb(0, 0, 0);"></a>Partagé avec moi</span>

<span style="color: rgb(0, 0, 0);">La 2e ligne affiche les projets auxquels nous avons été invités et pour ceux-ci il n'est pas possible de les supprimer, car seule le propriétaire a le droit de le faire.</span>

<span style="color: rgb(0, 0, 0);">[![Image3.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/YGpimage3.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/YGpimage3.png)</span>

### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133331" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">3.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Nouveau projet</span>

<span style="color: rgb(0, 0, 0);">Lorsque nous arrivons sur l'interface de création d'un projet, plusieurs champs sont à remplir dont certains obligatoires.</span>

<span style="color: rgb(0, 0, 0);">Il faut y renseigner le nom du projet, le préfixe des cartes si l'on souhaite inviter des membres à partir de leur adresse mail (il faut que le membre ait un compte existant sur l'application) ainsi qu'une description. La description prend en charge le markdown.</span>

<span style="color: rgb(0, 0, 0);">[![Image4.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/B8Oimage4.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/B8Oimage4.png)</span>

### <span style="color: rgb(0, 0, 0);">4<span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Consultation d’un projet</span>

<span style="color: rgb(0, 0, 0);">On peut consulter un projet en cliquant dessus depuis, la liste des projets.</span>

<span style="color: rgb(0, 0, 0);">Les champs d'administration du projet en lui-même sont réservés aux propriétaires (Nom du projet, description, préfixe et labels.).</span>

<span style="color: rgb(0, 0, 0);">Il est possible pour le propriétaire de créer des labels avec des codes couleurs qui pourront ensuite être assignés à des cartes pour une meilleure visibilité.</span>

<span style="color: rgb(0, 0, 0);">[![Image5.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/OEGimage5.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/OEGimage5.png)</span>

<span style="color: rgb(0, 0, 0);">Seul le propriétaire peut inviter où retirer des membres au projet.</span>

<span style="color: rgb(0, 0, 0);">On peut consulter sur l'interface le nom du projet, sa date de création, création, sa description, les membres du projet. Ainsi que la liste des tâches.</span>

<span style="color: rgb(0, 0, 0);">La liste des tâches est séparée en 3 colonnes. À faire, En cours, Terminé.</span>

<span style="color: rgb(0, 0, 0);">[![Image6.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/jxximage6.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/jxximage6.png)</span>

<span style="color: rgb(0, 0, 0);">Pour éditer une tache, il faut cliquer dessus. S'ouvre alors une fenêtre depuis laquelle nous pouvons modifier le nom de la tâche, la date d'échéance de celle-ci, son statut, ses différents labels, l'utilisateur assigné ainsi que sa description.</span>

<span style="color: rgb(0, 0, 0);">Comme pour la description du projet, la description d'une tâche supporte le markdown.</span>

<span style="color: rgb(0, 0, 0);">[![Image7.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/gM1image7.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/gM1image7.png)</span>

### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133333" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">5.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Mon profil</span>

<span style="color: rgb(0, 0, 0);">L'application permet de modifier ses informations personnelles comme son mot de passe, son adresse mail, ou encore son pseudo.</span>

<span style="color: rgb(0, 0, 0);">On peut supprimer son compte. Attention, cela supprimera tous les projets dont on est propriétaire et nous désassignera de toutes les cartes des autres projets.</span>

<span style="color: rgb(0, 0, 0);">[![Image8.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/RFximage8.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/RFximage8.png)</span>

### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133334" style="color: rgb(0, 0, 0);"></a>6<span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Plugins</span>

<span style="color: rgb(0, 0, 0);">Un menu est disponible pour consulter les plugins chargés dans l'application et permet de voir le nom du plug-in ainsi que sa description.</span>

<span style="color: rgb(0, 0, 0);">[![Image9.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/pFLimage9.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/pFLimage9.png)</span>

<span style="color: rgb(0, 0, 0);">Il suffit ensuite de cliquer sur celui-ci, renseignez les champs nécessaires et le lancer.</span>

<span style="color: rgb(0, 0, 0);">Dans le cadre de notre plug-in d'import Github, il faut renseigner le nom du dépôt ainsi que le nom du projet local sur lequel importer les tâches. La fenêtre se ferme automatiquement une fois que la tâche a été effectuée.</span>

<span style="color: rgb(0, 0, 0);">[![Image10.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/846image10.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/846image10.png)</span>

## <span style="color: rgb(0, 0, 0);"><a name="_Toc78133335" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;"><span style="font: 7.0pt 'Times New Roman';"> </span>III.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Choix d’implémentations</span>

### <span style="color: rgb(0, 0, 0);"><a name="_XML_Parser" style="color: rgb(0, 0, 0);"></a><a name="_Toc78133336" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">11.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Technologies et librairies principales utilisées</span>

<table border="1" id="bkmrk-java-fx-c%E2%80%99est-la-lib" style="border-collapse: collapse; width: 100%; height: 641.734px;"><colgroup><col style="width: 67.1014%;"></col><col style="width: 32.8739%;"></col></colgroup><tbody><tr style="height: 252.467px;"><td style="text-align: justify; vertical-align: middle; height: 252.467px;">#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133337" style="color: rgb(0, 0, 0);"></a>Java FX</span>

<span style="color: rgb(0, 0, 0);">C’est la librairie principale imposée dans le sujet. Java FX permet d’avoir une interface graphique à l’aide de contrôleurs Java et est donc indispensable à notre application.</span>  
<span style="color: rgb(0, 0, 0);">Nos fichiers d’interface sont sous la forme de fichier XML balisant les différents widgets présent sur les fenêtres de notre application.</span>  
<span style="color: rgb(0, 0, 0);">Une sous librairie intitulée controlsfx a également été utilisé dans le projet et permet d'utiliser des widgets qui ne sont pas disponibles de base dans la librairie Java FX. Notamment le widget permettant de sélectionner plusieurs labels lors de la création d'une tâche.</span>

</td><td class="align-center" style="text-align: justify; height: 252.467px; vertical-align: middle;"><span style="color: rgb(0, 0, 0);">[![Image11.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/image11.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/image11.png)</span></td></tr><tr style="height: 241.267px;"><td style="vertical-align: top; text-align: justify; height: 241.267px;">#### <span style="color: rgb(0, 0, 0);">Spring Boot</span>

<span style="color: rgb(0, 0, 0);">C'était le grand défi de ce projet. Spring boot est habituellement un framework orienté back end. Cependant, son système d'injection de dépendance ainsi que son ORM est très intéressant.</span>  
<span style="color: rgb(0, 0, 0);">L'idée était de l'utiliser pour faciliter l'utilisation de Java FX qui de base n'est pas très simple côté code. Cela nous a permis de garder un contexte des contrôleurs actifs de notre application graphique et a énormément enrichi l'application finale. Son ORM nous permettait aussi de manipuler des objets comme de vraies entités de base de données a permis une meilleure intégration de ceux-ci au sein de l'interface graphique.</span>  
<span style="color: rgb(0, 0, 0);">L'implémentation de base était complexe, mais le résultat final est très satisfaisant !</span>  
</td><td class="align-center" style="text-align: justify; height: 241.267px; vertical-align: middle;"><span style="color: rgb(0, 0, 0);">[![Image12.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/image12.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/image12.png)</span></td></tr><tr style="height: 29.6px;"><td style="vertical-align: top; text-align: justify; height: 29.6px;">#### <span style="color: rgb(0, 0, 0);">Flexmark</span>

<span style="color: rgb(0, 0, 0);">Flexmark et une librairie Java permettant de parser du texte et retrouver l'architecture markdown de celui-ci. Il nous a permis d'implémenter la prise en charge du markdown dans l'interface graphique à l'aide de balises CSS personnalisées ajoutées sur nos textes rendus à l'utilisateur. </span>  
</td><td class="align-center" style="height: 29.6px; vertical-align: middle;"><span style="color: rgb(0, 0, 0);">[![Image13.jpg](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/l9gimage13.jpg)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/l9gimage13.jpg)</span></td></tr><tr style="height: 29.6px;"><td style="vertical-align: top; text-align: justify; height: 29.6px;">#### <span style="color: rgb(0, 0, 0);">SL4J</span>

<span style="color: rgb(0, 0, 0);">SL4J (Simple Logging Facade for Java) permet une implémentation de log plus facile au sein de l'application. Elle permet également de séparer les logs d'erreur des lots standard et de sauvegarder tout ça dans des fichiers. </span>  
</td><td class="align-center" style="height: 29.6px; vertical-align: middle;"><span style="color: rgb(0, 0, 0);">[![Image14.jpg](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/image14.jpg)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/image14.jpg)</span></td></tr><tr style="height: 29.6px;"><td style="vertical-align: top; text-align: justify; height: 29.6px;">#### <span style="color: rgb(0, 0, 0);">PF4J</span>

<span style="color: rgb(0, 0, 0);">PF4J (Plugin Framework For Java) est un framework d'injection d'extension.</span>  
<span style="color: rgb(0, 0, 0);">Il permet de charger au démarrage de l'application différents plugins compilés en .jar et de les exécuter au besoin. La version spécifique pour Spring nous permet d'injecter le contexte de notre application au sein du plug-in, ce qui permet à ce dernier d'utiliser le système d'injection de dépendance et les services mis à disposition par notre client lourd.</span>  
</td><td class="align-center" style="height: 29.6px; vertical-align: middle;"><span style="color: rgb(0, 0, 0);">[![Image15.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/image15.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/image15.png)</span></td></tr><tr style="height: 29.6px;"><td style="vertical-align: top; text-align: justify; height: 29.6px;">#### <span style="color: rgb(0, 0, 0);">Mariadb JDBC</span>

<span style="color: rgb(0, 0, 0);">Mariadb JDBC est un driver permettant à l'ORM de Spring de se connecter à la base de données distante qui est sous Maria DB</span>  
</td><td class="align-center" style="height: 29.6px; vertical-align: middle;"><span style="color: rgb(0, 0, 0);">[![Image16.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/aEJimage16.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/aEJimage16.png)</span></td></tr><tr style="height: 29.6px;"><td style="vertical-align: top; text-align: justify; height: 29.6px;">#### <span style="color: rgb(0, 0, 0);">Github API (pour le plugin)</span>

<span style="color: rgb(0, 0, 0);">Github API et une librairie Java permettant d'interagir avec l'API de Github avec des classes et des objets. Elle a été utilisée au sein du plug-in que nous avons développé pour faciliter la récupération des tâches sur un dépôt Github. </span>  
</td><td class="align-center" style="height: 29.6px; vertical-align: middle;"><span style="color: rgb(0, 0, 0);">[![Image17.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/a5Aimage17.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/a5Aimage17.png)</span></td></tr></tbody></table>

### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133344" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">2.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Architecture du code</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133345" style="color: rgb(0, 0, 0);"></a>Chargement du contexte Java FX dans Spring</span>

<span style="color: rgb(0, 0, 0);">Le point d'entrée de l'application est celui de Spring. Il faut donc lui indiquer dès le départ qu'il doit charger une application Java FX.</span>

<span style="color: rgb(0, 0, 0);">Java FX a une classe principale se nommant **Application**, c'est le point d'entrée.</span>

<span style="color: rgb(0, 0, 0);">Nous enregistrons ainsi dans le contexte Spring une seule instance de cette application afin de pouvoir derrière utiliser l'injection de dépendance dessus.</span>

<span style="font-size: 12pt; line-height: 150%; font-family: 'Times New Roman', serif; color: rgb(0, 0, 0);">Nous enregistrons également d'autres Bean propre à Java FX afin que tout fonctionne correctement.<span style="mso-no-proof: yes;"> </span></span>

<span style="font-size: 12pt; line-height: 150%; font-family: 'Times New Roman', serif; color: rgb(0, 0, 0);">[![Image18.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/h3dimage18.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/h3dimage18.png)</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133346" style="color: rgb(0, 0, 0);"></a>Chargement des Plugins</span>

<span style="color: rgb(0, 0, 0);">Les plugins utilisent l'injection de dépendances, ils sont alors eux-mêmes considérés comme une dépendance injectable par l'application principale.</span>

<span style="font-size: 12pt; line-height: 150%; font-family: 'Times New Roman', serif; color: rgb(0, 0, 0);">Une fois le contexte Spring chargé au démarrage, ce sont aux plug-ins d'être détectés.</span>

<span style="font-size: 12pt; line-height: 150%; font-family: 'Times New Roman', serif; color: rgb(0, 0, 0);">[![Image19.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/xCIimage19.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/xCIimage19.png)</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133347" style="color: rgb(0, 0, 0);"></a>Architecture MVC</span>

<span style="color: rgb(0, 0, 0);">L'architecture du projet respecte le modèle MVC (Model, Vue, Controller).</span>

<span style="color: rgb(0, 0, 0);">Bien entendu, une adaptation a été nécessaire pour respecter le fonctionnement de Java FX et celui de Spring.</span>

<span style="color: rgb(0, 0, 0);">• Nos modèles correspondent aux classes de nos entités (utilisateur, projet, tâche, etc.).</span>  
<span style="color: rgb(0, 0, 0);">• Nos vues sont les contrôleurs de Java FX qui font l'interface utilisateur.</span>  
<span style="color: rgb(0, 0, 0);">• Enfin, nos contrôleurs correspondent aux services associés au modèle qui vont effectuer les traitements de données.</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133348" style="color: rgb(0, 0, 0);"></a>Intégration de l’ORM</span>

<span style="color: rgb(0, 0, 0);">Pour intégrer correctement Hibernate, nous avons besoin de 3 types de classes différentes.</span>

<span style="color: rgb(0, 0, 0);">• Tout d'abord les entités (ou modèles) qui vont représenter nos tables en base de données et qui correspondent à des objets Java.</span>

<span style="color: rgb(0, 0, 0);">[![Image20.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/gfFimage20.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/gfFimage20.png)</span>

<span style="color: rgb(0, 0, 0);">• Ensuite, les repository JPA qui vont être nos interfaces entre nos objets et la base de données, c'est eux qui nous permettront d'effectuer des requêtes.</span>

<span style="color: rgb(0, 0, 0);">[![Image21.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/C7zimage21.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/C7zimage21.png)</span>  
<span style="color: rgb(0, 0, 0);"> </span>  
<span style="color: rgb(0, 0, 0);">• Enfin, les services qui vont se charger de traiter la donnée avant de l'envoyer en base ou de la récupérer, ce sont les services qui seront utilisés par les contrôleurs Java FX.</span>

<span style="color: rgb(0, 0, 0);">[![Image22.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/3sbimage22.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/3sbimage22.png)</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133349" style="color: rgb(0, 0, 0);"></a>API pour les plugins</span>

<span style="color: rgb(0, 0, 0);">Pour permettre le développement des plugins, un package séparé de l'application principale est mis à disposition pour être importé dans un projet Maven.</span>

<span style="color: rgb(0, 0, 0);">Ce package contient uniquement la définition des services par des interfaces, l'interface du plug-in devant être rempli, ainsi que les modèles de classes et les exceptions existant dans notre application.</span>

<span style="color: rgb(0, 0, 0);">[![Image23.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/S9Himage23.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/S9Himage23.png)</span>

### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133350" style="color: rgb(0, 0, 0);"></a>3<span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Architecture base de données</span>

<span style="color: rgb(0, 0, 0);">Pour sauvegarder nos données, nous utilisons une base de données MariaDB hébergé en ligne.</span>

<span style="color: rgb(0, 0, 0);">Il est possible via le fichier **application.properties** de changer le driver et de passer sur une base de données PostgreSQL ou même H2 (local).</span>

<span style="color: rgb(0, 0, 0);">Voici le schéma de la base de données Vekanban :</span>

<span style="color: rgb(0, 0, 0);">[![Image24.png](https://wiki.nospy.fr/uploads/images/gallery/2022-09/scaled-1680-/Cqmimage24.png)](https://wiki.nospy.fr/uploads/images/gallery/2022-09/Cqmimage24.png)</span>

## <span style="color: rgb(0, 0, 0);"><a name="_Toc78133351" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;"><span style="font: 7.0pt 'Times New Roman';"> </span>IIV.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Bilan du projet</span>

### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133352" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">1.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Problèmes rencontrés</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133353" style="color: rgb(0, 0, 0);"></a>Fusion de Spring Boot et JavaFX</span>

<span style="color: rgb(0, 0, 0);">Spring Boot et Java FX n'ont jamais été conçus pour être utilisés ensemble. Le projet a mis donc énormément de temps à démarrer car il a fallu faire cohabiter ces deux Framework ensembles.</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133354" style="color: rgb(0, 0, 0);"></a>Thème sombre de l’application</span>

<span style="color: rgb(0, 0, 0);">Les éléments graphiques de Java est fixe son de base claire. Or nous voulions un thème sombre. Il est possible de personnaliser ses composants à l'aide de balises CSS et nous avons dû passer beaucoup de temps à réécrire le thème CSS composants par composants pour avoir un thème sombre qui nous plaisait (500 lignes de CSS au total).</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133355" style="color: rgb(0, 0, 0);"></a>Gestion des différents contrôleurs JavaFX</span>

<span style="color: rgb(0, 0, 0);">Puisque nous avions décidé d'intégrer Spring boot, il fallait que les contrôleurs Java et fixes puisse être auto injectés. Cela a posé plusieurs problèmes au début notamment sur les contrôleurs qui devaient être présents en plusieurs instances (les cartes des taches par exemple) carte de base Spring fonctionne avec des singletons. Nous avons pu cependant résoudre cela en utilisant une annotation supplémentaire sur nos contrôleurs **(@Scope("prototype")**) et tout est rentré dans l'ordre.</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133356" style="color: rgb(0, 0, 0);"></a>Intégration du markdown</span>

<span style="color: rgb(0, 0, 0);">Pour intégrer le markdown il fallait déjà pouvoir le parser et reconnaître les différentes balises utilisées. Pour cela nous avons utilisé flexe marque mais même grâce à cela ça restait très difficile d'identifier certaines balises (notamment les bullets, les liens et checkbox qui sont assez similaires). Une fois cela fait, il a fallu rajouter une surcouche CSS sur notre thème sombre déjà présent. Enfin, nous avons rendu l'édition et le rendu du markdown visible en temps réel ce qui a demandé beaucoup de travail supplémentaire pour l'afficher dynamiquement.</span>

#### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133357" style="color: rgb(0, 0, 0);"></a>Plugins</span>

<span style="color: rgb(0, 0, 0);">Nous voulions dès le départ que le plug-in puisse utiliser les différents services permettant de manipuler notre base de données. Pour cela il, fallait que le plug-in, au moment du chargement, puisse récupérer le contexte de Spring afin que l'injection de dépendance puisse se faire. Le projet a subi des changements majeurs à ce moment-là car il a fallu repenser son architecture pour que cela puisse être possible. Le fait également d'intégrer un plugin en soi sans recompiler le code a été tout un défi.</span>

### <span style="color: rgb(0, 0, 0);"><a name="_Toc78133358" style="color: rgb(0, 0, 0);"></a><span style="mso-fareast-font-family: 'Times New Roman'; mso-bidi-font-family: 'Times New Roman';"><span style="mso-list: Ignore;">2.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Conclusion</span>

<span style="color: rgb(0, 0, 0);">Pour conclure, nous sommes très fiers de cette application. Nous avons fait un pari risqué en voulant combiner différentes technologies ensemble et nous sommes parvenus à en faire ce que nous souhaitions. L'injection de dépendance Spring a été d'une énorme aide et a permis beaucoup de simplification dans l'architecture du code. Même si l'intégration plug-in aurait pu être poussé encore plus, nous sommes épatées d'avoir pu injecter à l'intérieur de celui-ci le contexte de Spring afin de pouvoir réutiliser l'injection de dépendance dans ce dernier. Il faut le voir pour le croire mais Spring et Java FX fonctionne plutôt bien ensemble.</span>