# Les cours

Ce site regroupe des **cours courts**. Chacun explique une notion générale, puis la montre à l'œuvre dans le code d'un vrai projet.

## Le projet fil rouge

Les exemples viennent de **BestGameOfTheYear**, un jeu de stratégie au tour par tour sur grille hexagonale, écrit en Python avec Pygame. Quand un cours parle du « jeu » ou du « projet », c'est de lui qu'il s'agit.

Ce jeu a sa propre documentation, dans le dossier `docs/` de son dépôt : concept, audit du code, architecture actuelle et cible, flows, algorithmes. Les cours y renvoient par la mention « documentation du jeu ».

## Le principe

Un cours n'est pas une page de documentation du jeu. C'est une notion qu'on pourra réutiliser dans n'importe quel projet. Le jeu sert d'exemple, parce qu'on retient mieux une règle quand on a vu le problème qu'elle évite.

Chaque cours suit le même plan :

1. **Le problème**, tel qu'il apparaît dans le jeu.
2. **La notion**, expliquée simplement, une page par idée.
3. **L'application**, sur un extrait du code.
4. **À retenir**, en quelques lignes.
5. **Exercices**, à faire sur le projet.

Un cours tient en quelques pages courtes : une vue d'ensemble qui pose le problème, une page par notion, puis une page « À retenir et exercices ». Chaque thème a aussi sa **présentation**, un jeu de diapositives pour le découvrir ou le réviser en vingt minutes : elles sont réunies sur la page [Les présentations](/presentations).

## Les cours disponibles

Chaque titre de thème mène à sa page d'accueil, avec sa présentation.

### [Python : bonnes pratiques](/python/bonnes-pratiques)

| Cours | Ce qu'on y apprend | Problème du jeu associé |
| --- | --- | --- |
| [Nommer les choses](/python/bonnes-pratiques/nommage) | Choisir des noms qui disent ce que fait le code | `tile_with_prio`, `coo`, `page == 5` |
| [Fonctions et effets de bord](/python/bonnes-pratiques/fonctions) | Écrire des fonctions dont on peut prévoir le résultat | Fonctions qui modifient des variables partout |
| [Classes et responsabilités](/python/bonnes-pratiques/classes) | Découper une classe trop grosse | `Map`, `ButtonHandler` |
| [Modules et imports](/python/bonnes-pratiques/modules) | Organiser les fichiers et leurs dépendances | `from units import *`, `self.game` |

### [Python : données et tests](/python)

| Cours | Ce qu'on y apprend | Problème du jeu associé |
| --- | --- | --- |
| [Choisir sa structure de données](/python/structures-de-donnees) | Liste, tuple, dictionnaire, ensemble | Voisins introuvables après un chargement |
| [Premiers tests avec pytest](/python/tests) | Vérifier son code automatiquement | Aucun test dans le projet |

### [Algorithmes](/algorithmes)

| Cours | Ce qu'on y apprend | Problème du jeu associé |
| --- | --- | --- |
| [La complexité](/algorithmes/complexite) | Estimer le coût d'un code avant de l'optimiser | Le jeu ralentit sur les grandes cartes |
| [Parcours de graphe](/algorithmes/parcours-de-graphe) | Largeur, Dijkstra, A* | Déplacement sur plusieurs cases |

### [Documentation](/documentation)

| Cours | Ce qu'on y apprend | Problème du jeu associé |
| --- | --- | --- |
| [Les schémas Mermaid](/documentation/mermaid) | Choisir et écrire le bon type de schéma | Avoir une vue d'ensemble |
| [Écrire une documentation](/documentation/ecrire-une-doc) | Docstrings, README, pages de ce site | Oublier comment marche son propre code |

### [Terminal et outils](/terminal)

| Cours | Ce qu'on y apprend | Problème du jeu associé |
| --- | --- | --- |
| [La ligne de commande](/terminal/cli) | Se déplacer, lancer un programme, enchaîner des commandes | Le jeu ne se lance que depuis la racine du projet |
| [brew, apt, npm](/terminal/gestionnaires-de-paquets) | Installer des outils et figer les versions d'un projet | Un README de deux lignes, dont une fausse |
| [Git](/terminal/git) | Commits utiles, branches, revenir en arrière | Trois commits pour tout le projet, du code commenté par prudence |
| [SSH](/terminal/ssh) | Ouvrir un terminal sur une autre machine, avec des clés | Administrer un serveur pour le jeu |

### [Serveur et API](/reseau)

| Cours | Ce qu'on y apprend | Problème du jeu associé |
| --- | --- | --- |
| [Le serveur](/reseau/serveur) | Client, serveur, adresse IP, port, localhost | Le jeu est entièrement local |
| [Les API](/reseau/api) | Requêtes HTTP, JSON, codes de statut, FastAPI | Un classement en ligne |

### [Virtualisation](/virtualisation)

| Cours | Ce qu'on y apprend | Problème du jeu associé |
| --- | --- | --- |
| [VirtualBox](/virtualisation/virtualbox) | Créer un serveur Linux jetable sur son poste | S'entraîner sans rien louer ni rien casser |
| [Docker](/virtualisation/docker) | Image, conteneur, Dockerfile | « Chez moi, ça marche » |
| [Docker Compose](/virtualisation/docker-compose) | Plusieurs conteneurs reliés, données dans un volume | Les scores disparaissent au redémarrage |

### [Web](/web)

| Cours | Ce qu'on y apprend | Problème du jeu associé |
| --- | --- | --- |
| [HTML](/web/html) | Décrire le contenu d'une page avec des balises qui ont un sens | Le classement n'est lisible que par un programme |
| [CSS](/web/css) | Sélecteurs, cascade, modèle de boîte, flexbox et grid | Mettre en forme sans toucher au contenu |
| [React](/web/react) | Composants, props, état, effets | Afficher les scores de l'API, garder l'écran fidèle aux données |

Les cours Serveur et API, Virtualisation et Web partagent un fil rouge : un **classement en ligne** pour le jeu. On écrit son API, on la met dans un conteneur, on lui ajoute une base de données, puis on lui construit une page web en HTML, CSS et React.

## Un parcours conseillé

Les cours sont indépendants, mais cet ordre suit les prochaines étapes du projet, listées dans la documentation du jeu.

```mermaid
flowchart LR
    a[Choisir sa structure<br/>de données] --> b[La complexité]
    b --> c[Premiers tests]
    c --> d[Fonctions et<br/>effets de bord]
    d --> e[Classes et<br/>responsabilités]
    e --> f[Modules et imports]
    f --> g[Parcours de graphe]
    n[Nommer les choses] -.-> d
    m[Schémas Mermaid] -.-> e
```

### Du terminal au conteneur et au web

Ces cours se suivent : chacun réutilise le précédent.

```mermaid
flowchart LR
    cli[Ligne de commande] --> pkg[brew, apt, npm]
    pkg --> srv[Le serveur]
    srv --> api[Les API]
    srv --> vbox[VirtualBox]
    vbox --> ssh[SSH]
    api --> docker[Docker]
    docker --> compose[Docker Compose]
    cli --> git[Git]
    api --> html[HTML]
    html --> css[CSS]
    css --> react[React]
```

## Les thèmes à venir

La section est faite pour grandir. Des thèmes sont prévus et seront ajoutés au fil du cours :

| Thème | Exemples de sujets |
| --- | --- |
| Python avancé | `dataclass`, `Enum`, annotations de type |
| Mise en ligne | Louer un serveur, nom de domaine, HTTPS |
| JavaScript | Les bases du langage, avant React |
| Bases de données | Tables, requêtes SQL, SQLite |

Pour ajouter un cours ou un thème, voir [Ajouter un cours](/ajouter-un-cours).
