Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/coyote-31/bcl-v2-batch


https://github.com/coyote-31/bcl-v2-batch

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README 

        
# Big City Library v2 : BATCH



## ✨ Présentation :



Ce projet a pour but la création d’un ensemble d’outils numériques pour les différents acteurs des bibliothèques d'une ville.

1. Un Back-end : RESTFull Serveur ([GitHub](https://github.com/Coyote-31/bcl-v2-rest-server))

2. Un Front-end : RESTFull Client Public ([GitHub](https://github.com/Coyote-31/bcl-v2-rest-client-public))

3. Un envoi automatique de mails : BATCH (Projet développé ici [GitHub](https://github.com/Coyote-31/bcl-v2-batch))



L'objectif de ce projet est de continuer le développement en suivant les différents tickets :

- Ticket #1 : [Ajoutez un système de réservation d’ouvrages](https://github.com/Coyote-31/bcl-v2-rest-server/issues/1)

- Ticket #2 : [Corrigez un bug dans la gestion des prolongations de prêt (par le client)](https://github.com/Coyote-31/bcl-v2-rest-server/issues/2)

- Ticket #3 : [Mettez en place une stratégie de tests](https://github.com/Coyote-31/bcl-v2-rest-server/issues/5)



> **IMPORTANT:**

> Ce projet fait partie du cursus de formation "Développeur J2EE" de [OpenClassroom](https://openclassrooms.com/).

> Les informations qu'il comporte ne doivent pas être utilisées dans le cadre d'une pratique réelle.

> Les informations présentées ici ne servent qu'à illustrer le projet pour le rendre le plus proche possible de la réalité.



## 📱 Application :



L'application est un serveur de type RESTFull développé en **Java EE** sur l'**IDE Visual Studio Code**.

Cette application utilise le framework Spring et les dépendences MapStruct & Lombok.

Elle est packagée via **[Maven](https://maven.apache.org/index.html)** dans un fichier `.war` pour être déployée sur un serveur compatible comme : **[Apache TomEE v9.0](https://tomee.apache.org/)**.



#### Aperçu de l'application :



![Aperçu de l'application](https://i.imgur.com/uodji7N.jpg)



#### Architecture de l'application :



![Architecture de l'application](https://i.imgur.com/C0z5X92.png)



## 🗃 Base de données :



La base de données est développée avec **MySQL v8.0**.

Elle est intégrée à l'application via des **classes JPA** et l'**ORM Hibernate** de Spring.

Et l'application présente ou recoit les données via des DTOs.



#### Diagramme de l'architecture de la base de données :



![Diagramme de l'architecture de la base de données](https://i.imgur.com/Pm7bNz5.png)



## 🛠 Déploiement :



Pour déployer correctement l'application veuillez suivre ces étapes :



#### 1. Packaging Maven :



Pour compiler et packager l'application dans un fichier `.war`, il faut utiliser le goal [`install`](https://maven.apache.org/plugins/maven-install-plugin/) de Maven avec la commande `mvn install`. Le fichier se créé alors dans le dossier *target*.

> On peut aussi utiliser le goal [`deploy`](https://maven.apache.org/plugins/maven-deploy-plugin/) mais cela demande de configurer le fichier POM, ce que je ne développerai pas ici.



#### 2. Serveur d'application :



La dernière étape est de mettre en ligne le serveur **[Apache TomEE v9.0](https://tomee.apache.org/)**.



Lorsque ce dernier est en ligne, dans l'interface du serveur Apache cliquer sur le bouton `Manager App`.

Après s'être identifier trouver la partie `Deployer > Fichier WAR à déployer` et y déployer le fichier `.war` précédemment généré à l'étape 1.



✅ **Bravo !** *L'application web est maintenant 100% fonctionnelle !*