/amt-project

AMT project

Primary LanguageJava

PIANORGUE

Pianorgue est un site e-commerce de vente d'instruments de musique.

Prérequis

Installation de Maven

Installation de l'application

Récupération du code source

Le code source est disponible sur Github, la branche de l'application est la branche main.

On peut cloner le repos :

git clone git@github.com:g-roch/amt-project.git

Mise en place

Pour fonctionner en local, l'application nécessite une base de donnée en local. L'outil de gestion de base de données MySQL MySQLWorkbench est utilisé dans ce projet, d'autres alternatives existent mais nous conseillons d'utiliser cet outil. Nous utilisons la version 5.7.36-0ubuntu0.18.04.1 de MySQL

Il est nécessaire de créer un utilisateur mysql avec les droits suivants :

CREATE USER 'userAmt'@'localhost' IDENTIFIED BY 'RooT@@123';
GRANT USAGE ON *.* TO 'userAmt'@'localhost';
GRANT UPDATE, INSERT, SELECT, EXECUTE, CREATE, DELETE  ON `amt\_pianorgue`.* TO 'userAmt'@'localhost';
FLUSH PRIVILEGES;

Une fois le serveur SQL démarré, il est nécessaire d'exécuter les scripts suivants :

  • amt_pianorgue.sql qui permet la création des tables de la DB.
  • insert_articles.sql qui permet de peupler les tables en insérant des articles.

Il est à noter qu'il faut s'assurer ensuite de la bonne configuration de la DB dans le code source de l'application, cela se trouve dans le fichier application/src/main/resources/application.properties.

Les lignes à vérifier sont :

  • spring.datasource.url=jdbc:mysql://localhost:3306/amt_pianorgue

    Adresse locale (localhost), port (3306) ainsi que nom de la DB (amt_pianorgue)

  • spring.datasource.username=userAmt

    Nom utilisateur de la DB

  • spring.datasource.password=RooT@@123

    Mot de passe de la DB

Lancement de l'application

  • Pour construire le binaire :

    cd application/
mvn clean package

​ L'application se trouve à l'emplacement application/target/AMT-Test-.....jar

  • Pour lancer l'application depuis un IDE :

    Exécuter le fichier application/src/main/java/com/amt/app/PianorgueApp.java

Accès au service d'authentification (pour le développement)

Afin d'accéder au service d'authentification, le port localhost:8081 doit être redirigé vers le service d'authentification (10.0.1.92:8080).

Développement avec l'IDE Intellij ultimate

Ouverture du projet

Afin d'ouvrir le projet en tant que projet maven, il faut suivre les étapes suivantes :

Soit directement depuis l'IDE:

  • Cliquer sur File > Open....
  • Sélectionner le fichierapplication/pom.xml.
  • Dans la fenêtre qui s'ouvre cliquer sur Open as project.

Soit depuis la fenêtre de bienvenue de l'IDE

  • Cliquer sur Open.
  • Sélectionner le fichierapplication/pom.xml.
  • Dans la fenêtre qui s'ouvre cliquer sur Open as project.

Aide au développement

Bien que pas utilisé par lors du développement, le plugin JPA Budy peut être installé afin de faciliter la gestion des données JPA.

Contribution

Si vous avez des suggestions pour améliorer le projet, veuillez tout d'abord lire toutes les informations qui se trouvent dans le Wiki. Les pull-requests sont les bien venues. Pour les changements majeurs, veuillez ouvrir une issue. Veuillez vous assurer de mettre à jour les tests le cas échéant.

  1. Fork le projet
  2. Créer sa branche selon les conventions (voir wiki)
  3. Commit vos changements
  4. Push sur sa branch
  5. Ouvrir une pull request

Si vous voulez rejoindre l'équipe, les informations de contacts se trouve juste en dessous. Si vous devez rejoindre notre équipe vous pouvez aller regarder nos methodologies de travail et rejoindre notre outil collaboratif. Au plaisir de travailler avec vous.

Contacts

License

Tout droit reservé, aucune license n'est choisie pour l'instant