Création d’un projet sur GitLab

Dans cette partie, vous allez créer et configurer un projet sur GitLab. Ce projet va contenir les deux parties du code source, le frontend et le backend, ainsi que la documentation du projet.

1. Création du projet

Commencez par créer un projet appelé "QuizMaker" sur GitLab. Un seul membre du projet doit créer le projet qui sera rendu.

  1. Ouvrez votre navigateur et allez sur la page https://gitlab.univ-nantes.fr/

  2. Connectez-vous, si ce n’est pas déjà le cas

  3. Cliquez sur ➕ et ensuite "Create new projet…​"

  4. Choisissez "Create blank project"

  5. Nommez votre projet "QuizMaker"

  • Le projet sera à rendre sur GitLab.

  1. Ajoutez à la description du projet l’étiquette #PTRANS2026 (vous pouvez retirer cette étiquette si vous ne souhaitez pas que le projet soit évalué)

  2. Changez la visibilité du projet en Privé.

  3. Votre projet doit un contenir un fichier README contenant un compte rendu associé à ce TP.

  4. Ajoutez aux membres du projet le compte Gitlab de votre intervenant de TP également comme membre, de type Reporter.

  5. Référez-vous au tableau ci-dessous pour savoir quel compte Gitlab ajouter.

Si votre groupe de TP est…

Vous ajoutez ce compte Gitlab enseignant comme Membre de type Reporter

2D

bousse e clone

2C

sunye g clone
Votre rendu CCP consistera donc en un projet Gitlab auxquels votre intervenant de TP pourra accéder avec un compte dédié.

2. Créez une copie locale du projet

  1. Sur la page de votre projet GitLab, cliquez sur Clone ⌄ et copiez le lien url (HTTP ou SSH) du dépôt git

  2. Sur le terminal, créez une copie de travail de votre projet et entrez dans son répertoire :

git clone  <url-de-votre-projet>
cd quizmaker

3. Créez la structure de dossiers

mkdir quizmaker-backend
mkdir quizmaker-frontend
mkdir quizmaker-doc

Après la création des dossiers, votre projet doit ressembler à :

📂 QuizMaker
├── 📄 README.adoc
├── 📂 quizmaker-backend
├── 📂 quizmaker-frontend
└── 📂 quizmaker-doc

Le fichier README.adoc doit contenir des informations qui permettront aux autres développeurs de comprendre comment utiliser votre projet. En d’autres termes :

  • Un résumé des objectifs du projet

  • Des instructions pour le compiler et l’exécuter

  • Des liens vers la documentation

Description des dossiers

  • quizmaker-backend contient le code de l’application serveur, en Java/Spring

  • quizmaker-frontend contient le code de l’application client, en TypeScript/Angular

  • quizmaker-doc contient la documentation du projet, en Asciidoc/Antora

4. Ignorer certains fichiers

  1. Ajoutez à la racine de votre projet GitLab, un fichier nommé .gitignore.

  2. Le contenu de ce fichier doit être le suivant :

# Build files
**/build/
.gitlab-ci-local/
public/

# System files
.DS_Store
Thumbs.db

# IDE
.vscode/
.idea/
*.iws
*.iml
*.ipr
.project
.classpath
.c9/
*.launch
.settings/
*.sublime-workspace

# Node
**/node_modules/
**/package-lock.json
npm-debug.log
yarn-error.log

# Angular / Frontend
.angular/
.angular/cache/
dist/
**/dist/
.history/

# Maven / Backend
HELP.md
target/
.mvn/wrapper/maven-wrapper.jar
!**/src/main/**/target/
!**/src/test/**/target/

# STS
.apt_generated
.factorypath
.springBeans
.sts4-cache

# NetBeans
/nbproject/private/
/nbbuild/
/nbdist/
/.nb-gradle/

# Compiled output
/tmp
/out-tsc
/bazel-out

# Coverage / misc
/connect.lock
/coverage
/libpeerconnection.log
testem.log
/typings
.sass-cache/

5. Initial commit

Après cette configuration initiale, validez et publiez vos changements.

  1. Sur le terminal et à la racine de votre projet, exécutez les commandes suivantes :

git stage .
git commit -m "Initial commit"
git push