# Les trois zones

Un fichier passe par trois zones avant d'entrer dans l'histoire du projet. Les commandes de Git déplacent les modifications de l'une à l'autre.

## Du dossier de travail au dépôt

```mermaid
flowchart LR
    wd[Dossier de travail<br/>les fichiers qu'on modifie] -- git add --> idx[Zone de préparation<br/>ce qui partira au prochain commit]
    idx -- git commit --> repo[Dépôt local<br/>l'histoire, dans .git]
    repo -- git push --> remote[(Dépôt distant<br/>GitHub)]
    remote -- git pull --> wd
```

| Mot | Sens |
| --- | --- |
| Dépôt | Le projet et toute son histoire, rangée dans le dossier caché `.git` |
| Commit | Une photo de l'état du projet, avec un auteur, une date et un message |
| Zone de préparation | La liste de ce qui entrera dans le prochain commit |
| Branche | Une ligne d'histoire parallèle |
| Dépôt distant | Une copie du dépôt sur un serveur, nommée `origin` par convention |

L'étape `git add` surprend au début. Elle sert à choisir : on peut avoir modifié cinq fichiers et n'en valider que deux, parce qu'ils forment un changement cohérent.

## Le cycle de base

```bash
git status                  # où en suis-je ?
git diff                    # qu'ai-je modifié, ligne par ligne ?
git add src/map.py          # je prépare ce fichier
git commit -m "Corrige les coordonnées en liste après chargement"
```

| Commande | Effet |
| --- | --- |
| `git status` | Fichiers modifiés, préparés, non suivis. À lancer sans modération |
| `git diff` | Les modifications pas encore préparées |
| `git diff --staged` | Ce qui partira au prochain commit |
| `git add fichier` | Prépare un fichier |
| `git add -p` | Prépare morceau par morceau, en demandant à chaque fois |
| `git commit -m "message"` | Valide ce qui est préparé |
| `git log --oneline` | L'histoire, une ligne par commit |
| `git show 6efd04a` | Le contenu d'un commit |

:::tip{title="Le réflexe"}

`git status` avant chaque commande. Il dit où l'on en est et, le plus souvent, quelle commande taper ensuite.

:::
