OpenClassrooms-Student-Center / G-rez-le-cycle-de-vie-de-d-veloppement-logiciel

Mission du P5 du parcours Expert DevOps

MicroCRM (P5 - Expert DevOps - Gérez le cycle de vie de développement logiciel)

MicroCRM est une application de démonstration basique ayant pour être objectif de servir de socle pour le module "P5 - Expert DevOps".

L'application MicroCRM est une implémentation simplifiée d'un "CRM" (Customer Relationship Management). Les fonctionnalités sont limitées à la création, édition et la visualisations des individus liés à des organisations.

Code source

Organisation

Ce monorepo contient les 2 composantes du projet "MicroCRM":

• La partie serveur (ou "backend"), en Java SpringBoot 3;
• La partie cliente (ou "frontend"), en Angular 17.

Une intégration basique avec Gitlab CI est définie via le fichier .gitlab-ci.yml.

Démarrer avec les sources

Serveur

Dépendances

• OpenJDK >= 17

Procédure

1. Se positionner dans le répertoire back avec une invite de commande:

   cd back

2. Construire le JAR:

   # Sur Linux
   ./gradlew build
   
   # Sur Windows
   gradlew.bat build

3. Démarrer le service:

   java -jar build/libs/microcrm-0.0.1-SNAPSHOT.jar

Puis ouvrir l'URL http://localhost:8080 dans votre navigateur.

Client

Dépendances

• NPM >= 10.2.4

Procédure

1. Se positionner dans le répertoire front avec une invite de commande:

   cd front

2. (La première fois seulement) Installer les dépendances NodeJS:

   npm install

3. Démarrer le service de développement:

   npx @angular/cli serve

Puis ouvrir l'URL http://localhost:4200 dans votre navigateur.

Exécution des tests

Client

Dépendances

• Google Chrome ou Chromium

Dans votre terminal:

cd front
CHROME_BIN=</path/to/google/chrome> npm test

Serveur

Dans votre terminal:

cd back
./gradlew test

Images Docker

Client

Construire l'image

docker build --target front -t orion-microcrm-front:latest .

Exécuter l'image

docker run -it --rm -p 80:80 -p 443:443 orion-microcrm-front:latest

L'application sera disponible sur https://localhost.

Serveur

Construire l'image

docker build --target back -t orion-microcrm-back:latest .

Exécuter l'image

docker run -it --rm -p 8080:8080 orion-microcrm-back:latest

L'API sera disponible sur http://localhost:8080.

Tout en un

docker build --target standalone -t orion-microcrm-standalone:latest .

Exécuter l'image

docker run -it --rm -p 8080:8080 -p 80:80 -p 443:443 orion-microcrm-standalone:latest

L'application sera disponible sur https://localhost et l'API sur http://localhost:8080.