Lab 1.2 : Archéologue du Code

Module : 1.2 - Exploration de Base de Code | ← SlidesDurée : 1 heure Projet d'Exemple : node-express-mongoose-demo

Objectifs d'Apprentissage

À la fin de ce lab, vous serez capable de :

• Naviguer dans une base de code inconnue avec Claude Code
• Poser des questions progressivement plus profondes (large → précis)
• Tracer les flux d'exécution à travers plusieurs fichiers
• Identifier les modèles de données clés et leurs relations

Prérequis

• Claude Code installé et fonctionnel
• Projets d'exemple clonés (exécuter sample-projects/setup.sh)
• MongoDB en cours d'exécution (via Docker ou localement)

Configuration

# Naviguez vers le projet d'exemple
cd sample-projects/node-express-mongoose-demo

# Installez les dépendances
npm install

# Démarrez Claude Code
claude

---

Tâche 1 : Trouver les Points d'Entrée

Temps : 10-12 minutes

Demandez à Claude d'identifier comment l'application démarre.

Prompts à essayer :

Quels sont les principaux points d'entrée de cette application ?

Montre-moi le code du point d'entrée principal.

Résultat Attendu

Vous devriez savoir quel(s) fichier(s) démarre(nt) l'application et pourquoi.

Critères de réussite :

• [ ] Identifié le fichier serveur principal
• [ ] Compris ce qui se passe au démarrage de l'application

---

Tâche 2 : Tracer un Flux d'Exécution

Temps : 15-20 minutes

Choisissez une fonctionnalité principale et tracez-la de bout en bout.

Prompts à essayer :

Guide-moi à travers le processus de connexion utilisateur, étape par étape.

Trace le flux d'exécution quand un utilisateur crée un nouvel article.

Que se passe-t-il quand un utilisateur soumet le formulaire d'inscription ?

Résultat Attendu

Comprendre le flux complet de l'action utilisateur jusqu'à la base de données.

Critères de réussite :

• [ ] Tracé un flux complet (route → contrôleur → modèle → base de données)
• [ ] Peut expliquer le flux à quelqu'un d'autre

---

Tâche 3 : Clarifier des Modules Spécifiques

Temps : 10-15 minutes

Trouvez du code confus et demandez à Claude de l'expliquer.

Prompts à essayer :

Que fait le middleware dans `config/express.js` ?

Pourquoi cette application utilise-t-elle Mongoose ?

Quel est le but du répertoire `lib/` ?

Résultat Attendu

Comprendre l'intention derrière le code, pas seulement ce qu'il fait.

Critères de réussite :

• [ ] Identifié au moins 3 modules/fichiers et leurs objectifs
• [ ] Compris pourquoi certaines décisions architecturales ont été prises

---

Tâche 4 : Identifier les Modèles de Données

Temps : 10-15 minutes

Cartographiez les entités principales de l'application.

Prompts à essayer :

Quels sont les modèles de données clés de cette application ?

Comment est structuré le modèle Article ?

Où le modèle User est-il créé, lu, mis à jour et supprimé ?

Résultat Attendu

Connaître les entités principales et comment elles circulent dans le système.

Critères de réussite :

• [ ] Listé tous les modèles de données majeurs
• [ ] Compris les relations entre les modèles
• [ ] Sait où les opérations CRUD se produisent pour au moins un modèle

---

Conseils pour Réussir

À Faire	À Éviter
Commencer large, puis préciser	Sauter directement dans les détails
Être spécifique sur le périmètre	Poser des questions vagues comme "explique le code"
Demander pourquoi, pas juste quoi	Accepter des réponses superficielles
Demander des exemples	Supposer comprendre sans vérification

Exemple de progression :

"Que fait cette application ?"
  → "Comment fonctionne l'auth ?"
    → "Explique la fonction hashPassword"

---

Dépannage

Claude donne des réponses vagues

• Essayez de reformuler avec un périmètre plus spécifique
• Référencez un fichier ou numéro de ligne spécifique

Claude semble confus

• Découpez votre question en parties plus petites
• Donnez du contexte : "Je regarde le flux d'authentification..."

Claude fait une erreur

• Vérifiez en lisant le code réel
• Demandez à Claude de vous montrer le code spécifique qu'il référence

---

Objectifs Avancés

Si vous finissez en avance :

1. Créez un fichier NOTES_EXPLORATION.md documentant vos découvertes
2. Dessinez un diagramme des principaux flux d'exécution
3. Identifiez les code smells potentiels ou les zones à améliorer

---

Livrables

À la fin de ce lab, vous devriez avoir :

1. Un modèle mental de la structure de l'application
2. Des notes sur les points d'entrée clés, les flux et les modèles de données
3. Des questions à partager pendant le débriefing

---

Prochaines Étapes

Après avoir complété ce lab, passez au Lab 1.3 : Construire le Cerveau du Projet.