Préparation

Pour simplifier l’identification des participants, utilisez toujours le compte GitLab lié à votre numéro d’étudiant.

1. Avant de commencer

  1. Les seuls identifiants valides sont votre adresse e-mail et votre compte GitLab de l’Université de Nantes.

  2. Les commits du gestionnaire de versions témoignent de l’investissement de chaque participant.

  3. Les participants qui n’auront effectué aucun commit seront notés "Absent".

  4. Les commits arrivés après le 19 décembre 2025 à 23h59 ne seront pas prises en compte.

Ne faites jamais de commit d’un code dont la production automatique (build) ne marche pas.

2. Configuration de vos identifiants Git

  1. Pour être sûr que les validations réalisées sur votre machine vous seront correctement attribuées, configurez Git avec votre nom et votre e-mail[1]:

    git config --global user.name "Jean Pierre"
git config --global user.email "jean.pierre@etu.univ-nantes.fr"

  2. Vous devez configurer toutes les machines sur lesquelles vous travaillez.

3. Configuration du JDK

Si vous utilisez les machines des salles de TPs dans le cadre de ce projet, vous devez utiliser le Java JDK 17. Vous pouvez changer le JDK utilisé dans un projet dans IntelliJ, dans le menu File  Project structure  Project  Project SDK.

4. Organisation

Ce projet sera réalisé par groupe d'au plus 4 étudiants. Vous allez suivre le processus de maintenance vu en cours.

Commencez par préparer l’environnement de votre projet :

  1. Avant toute chose, un seul membre du groupe doit créer une "Bifurcation" du projet sur le GitLab. Pour ce faire, cliquez sur l’icône "Fork" (ou "Créer une bifurcation" en français) de la page du projet pour accéder au lien suivant.

  2. Assurez-vous que les informations sur le projet/Description du projet (facultative) de votre bifurcation contient bien le libellé #Projet-CEL-2025. C’est ce libellé qui nous permettra de retrouver vos projets.

  3. Ajoutez tous les autres membres du groupe à votre bifurcation.

  4. Ajoutez également comme nouveau membre l’utilisateur virtuel appelé sunye-g-clone, avec le statut "Reporter". Cet utilisateur virtuel que nous contrôlons nous donne le droit d’accéder à votre travail et nous permettra de récupérer vos projets.

  5. Ouvrez le fichier CONTRIBUTORS.adoc et ajoutez-y le prénom, le nom, le numéro d’étudiant et l’adresse email de tous les participants.

  6. Créez des étiquettes (labels) pour organiser les tickets du projet : bug, improvement, smell, performance, etc. Vous pouvez ajouter des nouvelles étiquettes ou modifier les existantes plus tard.

  7. Chaque membre du groupe doit cloner la bifurcation du projet (et non pas celui d’origine). Toutes vos modifications devront être poussées sur votre fork et toutes les issues (ou "tickets" en français) ouvertes le seront sur votre version du projet.

  8. Il ne doit y avoir qu’une seule "bifurcation" par groupe d’étudiants. Elle sera utilisée comme espace de rendu des fichiers liés au projet.

Si vous avez deux bifurcations du projet sur votre compte GitLab, faites en sorte qu’une seule soit visible par l’utilisateur virtuel.

5. Dépendances Maven

Le projet de démarrage est configuré comme un projet Maven standard. Vous êtes libres d’ajouter de nouvelles extensions lors du développement du projet. Par défaut, les dépendances suivantes sont configurées :

  • JUnit Jupiter pour exécuter les tests unitaires.

  • Mockito pour créer des simulations de test.

  • Atlanmod Commons qui fournit une extension de la librairie Java standard.

  • AssertJ, qui permet l’écriture d’assertions "fluides" en Java.

1. Seulement si vous ne vous appelez pas Jean Pierre