Comprendre l'architecture d'un projet logiciel collectif : modules, tests et documentation
Décomposer un projet logiciel collectif en modules aux responsabilités claires, expliquer comment les tests et la documentation s'appuient sur cette architecture et justifier un découpage proposé.

Les points essentiels
- L'architecture d'un logiciel décrit sa décomposition en modules (fichiers, classes, fonctions regroupées) et les relations entre eux : qui appelle qui, qui échange quelles données. Elle est pensée avant d'écrire le gros du code.
- Un bon découpage applique la séparation des responsabilités : chaque module a un rôle unique et identifiable (par exemple données, logique de jeu, affichage, entrées-sorties).
Les mots à connaître
- Architecture logicielle
- Organisation d'un programme en modules distincts et description de leurs relations et de leurs interfaces, qui détermine comment le travail est réparti, testé et maintenu.
- Interface (ou contrat) d'un module
- Ensemble des fonctions ou méthodes qu'un module met à disposition des autres, avec leurs paramètres, leur résultat et leurs préconditions, indépendamment de la façon dont elles sont codées.
Un exemple pour comprendre
Une équipe développe un jeu de morpion en Python. Tout le code (grille, tour de jeu, victoire, affichage, saisie clavier) est écrit dans un seul fichier de 300 lignes. Proposer un découpage en modules et justifier l'intérêt pour les tests.
On sépare par responsabilité. Module grille : crée la grille, place un symbole, indique si une case est libre. Module regles : détecte la victoire ou l'égalité à partir d'une grille. Module affichage : montre la grille dans la console. Module main : boucle de jeu qui enchaîne saisie, mise à jour et affichage. Les dépendances vont de main vers les trois autres, et regles dépend seulement de la structure de la grille ; affichage ne contient aucune règle du jeu. Avantage pour les tests : regles.victoire(grille) se teste sans écran ni clavier, en construisant à la main des grilles gagnantes, perdantes ou pleines et en vérifiant le résultat attendu. Dans le fichier unique, tester la victoire obligeait à jouer une partie entière au clavier.

