Arc 1 Quête 02

Les Trois Salles du Savoir

Le 3-tree model de Git

Le Maître Archiviste te regarde d'un air solennel.

« Tu as rejoint la Guilde, apprenti. Mais avant de toucher au moindre parchemin, tu dois comprendre comment fonctionne notre Archive. Suis-moi… je vais te montrer les Trois Salles. »

Il ouvre une lourde porte de chêne et te guide dans un long corridor éclairé par des torches. Trois immenses salles s'ouvrent devant toi.

Comprendre le 3-tree model de Git : les trois zones par lesquelles passent tes fichiers avant d'être archivés.

Les Trois Salles de l'Archive

Tout dépôt Git repose sur trois zones distinctes. Le Maître Archiviste les appelle les Trois Salles :

🏠 Salle de Travail Working Directory Tu écris, modifies et crées tes fichiers ici. C'est le dossier sur ton disque.

→ git add

📋 Salle de Préparation Staging Area / Index Tu y déposes les parchemins que tu veux archiver. C'est le « panier » avant l'envoi.

→ git commit

📚 Grande Archive Repository / .git Les parchemins scellés définitivement. L'historique complet et permanent.

Chaque fichier passe par trois zones : Working Directory → Staging Area → Repository. Comprendre ce flux est la clé pour maîtriser Git.

Pourquoi trois étapes ?

« Pourquoi ne pas archiver directement ? » demandes-tu.

Le Maître Archiviste sourit. « Imagine que tu aies écrit dix lettres. Voudrais-tu toutes les poster d'un coup, sans relire, sans trier ? »

Analogie : La lettre

Étape	Action	Équivalent Git
Écrire la lettre	Tu rédiges sur ton bureau	Modifier dans le Working Directory
Mettre dans l'enveloppe	Tu choisis quoi envoyer	`git add` → Staging Area
Poster la lettre	C'est envoyé, c'est archivé	`git commit` → Repository

Le vrai pouvoir du staging

Le staging te permet de choisir QUOI archiver - pas tout d'un coup !

Tu modifies 10 fichiers
Mais seuls 3 sont prêts
Tu fais git add uniquement sur ces 3 fichiers
Tu fais git commit : seuls ces 3 sont archivés
Les 7 autres restent tranquillement dans la Salle de Travail

Les commandes clés

Commande	Rôle	Transition
`git status`	Voir dans quelle salle sont tes fichiers	-
`git add <fichier>`	Salle de Travail → Salle de Préparation	Working Directory → Staging Area
`git commit`	Salle de Préparation → Grande Archive	Staging Area → Repository

Les couleurs de `git status`

Rouge = le fichier est dans la Salle de Travail (modifié ou non suivi)
Vert = le fichier est dans la Salle de Préparation (prêt à être archivé)

Utilise git status souvent ! C'est ta boussole dans l'Archive.

Exercice pratique

Il est temps de mettre les mains dans le parchemin ! Suis ces étapes une par une.

1 Créer ton atelier

Ouvre un terminal et crée un nouveau dossier, puis initialise un dépôt Git :

mkdir atelier-archiviste
cd atelier-archiviste
git init -b main

2 Créer un parchemin

Crée un fichier parchemin.txt avec du contenu :

echo "Ceci est mon premier parchemin dans l'Archive." > parchemin.txt

3 Observer la Salle de Travail

Lance la commande :

git status

Tu devrais voir parchemin.txt en rouge sous la mention Untracked files. Le fichier est dans la Salle de Travail - Git le voit, mais ne le suit pas encore.

4 Préparer le parchemin

Déplace le fichier dans la Salle de Préparation :

git add parchemin.txt

5 Observer la Salle de Préparation

Lance à nouveau :

git status

Cette fois, parchemin.txt apparaît en vert sous Changes to be committed. Le parchemin est dans la Salle de Préparation, prêt à être scellé.

6 Ne PAS commiter !

Pour cet exercice, ne fais PAS git commit. L'objectif est de comprendre le flux entre les deux premières salles. Le commit viendra dans la quête suivante !

7 Vérifier ta progression

Lance le script de vérification depuis le dossier atelier-archiviste :

Linux / macOS :

bash chemin/vers/quetes/02-les-trois-salles-du-savoir/verifier.sh

Windows (PowerShell) :

& chemin\vers\quetes\02-les-trois-salles-du-savoir\verifier.ps1

Résumé

🏠 Salle de Travail tu modifies rouge dans git status