jugurtao / ikeo

Development of a web application dedicated to optimize warehouse delivery schedules and efficiently manage delivery routes.

Bienvenue au Projet Integrateur 2024

IKEO, une application web dédiée à l'optimisation des plannings de livraison en entrepôt et à la gestion efficace des tournées des livreurs.

Contributeurs:

- OURZIK Jugurta

- OUKKAL Yacine

- BOUQUETY Andy

- MIEL Nils

- FARINA Alessandro

- MONACHON Vivian

Niveau: Licence 3 MIAGE

Technologies & environements :

• Java/Springboot pour le back-end ( RO et server métier).
• PostgreSQL pour la base de données.
• Docker pour la conteneurisation de l'application.
• Angular et angularMaterial pour le front-end.
• Openrouteservice et data.gouv APIs pour la carte et le géocodage.
• Jest et Junit pour les tests.

---

Objectifs du projet:

• Développement d'un produit suivant des spécifications.
• Intégration des connaissances acquises au long de l'année universitaire 2023-2024.
• Maîtrise du Gitflow (features et branches, pull requests et routines de revue de code ).
• Daily meetings et collaboration entre équipes.
• Mise en place de la méthodologie agile.
• Mise en place d'une organisation en pair programming.
• Exploration du DevOps.
• Compréhension de la philosophie de springboot et particulièrement le concept de l'inversion de contrôle à travers l'injection de dépendances.
• Maîtrise de l'architecture hexagonale.
• Maîtrise de la gestion d'erreurs.
• Compréhension plus approfondie de certaines notions vue en cours comme les observables en angular et les promesses.
• Maîtrise de l'architecture MVVM.
• Développement de test unitaires et de tests d'intégration.
• Mise en pratique des algorithmes vue en cours de la RO pour l'optimisations des itinéraires de livraison.

---

Ma constribution:

Développement d'une application web dédiée à l'optimisation des plannings de livraison en entrepôt et à la gestion efficace des tournées des livreurs.

Dans une équipe de 6 collaborateurs, on m'a confié la construction d'une partie du serveur avec le framework spring boot.

Technologies utilisées:

• Java/Spring boot pour le backend.
• PostgreSQL pour la base de données.
• Swagger pour documentation de l'API.
• JUnit pour les tests.

Mes missions sont les suivantes :

• Réalisation de la documentation de l’API.
• Construction du squelette de l'application en suivant l'architecture hexagonale.
• Revue de code.
• Implémentation et développement de tests unitaires et d'intégration. (Plannification et visualisation d'une journée de la part du plannificateur, chargement et mise à jours de l'état d'une tournée de la part du livreur.
• Implémentation des mappeurs.
• Analyse de fichiers CSV et alimentation de la base de données.
• Refactorisation de code et tests de l'API avec Insomnia.
• Aide des coéquipiers à corriger les bugs et à améliorer les fonctionnalités ou les algorithmes.

Mes améliorations :

• Maîtrise de l'architecture hexagonale.
• Maîtrise de la gestion des erreurs techniques et rest.
• Amélioration de la collaboration au sein de l'équipe.
• Exploration du DevOps et mise en place de la méthodologie agile.
• Utilisation de Trello pour la planification des tâches.
• Maîtrise de Gitflow en équipe (fonctionnalités et branches, pull requests et routines de revue de code).
• Communication et réunions quotidiennes.
• Compréhension de la philosophie de Spring.

Comment lancer le server

mettez vous à la racine du projet et sur la ligne de commande tapez la commande suivante:

  docker-compose -f docker/docker-compose-prod.yml up --build &

---

Comment contribuer:

Ce que vous devez faire :

Créer un projet (Fork).
Cloner le repo forké localement.
Ajouter quelques changements localement, pousser vers votre repo forké.
Ensuite, lancez une pull request vers ce repo.

Pour plus de détails, voici les étapes à suivre.

Tout d'abord, forker le projet sur github.

Utilisez git pour cloner et installer votre projet forké localement.


# après le clonage, naviguer vers le projet

# pour synchroniser avec l'origine
git remote add upstream <main_repo_url>
git remote add origin <your_forked_repo_url>


# pour configurer votre branche de développement locale
git branch your_local_branch
git checkout votre_branche_locale

# pour ajouter vos modifications
git add *
git commit -m "+votre_branche_locale : votre commit ici"

# pousser vers votre repo forké
git push origin votre_branche_locale