09 — Carnet de contacts

Niveau requis : 5 pour la v1, 6 pour la v2 / Difficulté : 4/5 / Durée estimée : 3 h (v1) + 3 h (v2)

Objectif

Un carnet d'adresses en ligne de commande : ajouter un contact (nom, téléphone, email), lister, rechercher par nom, modifier, supprimer. Les contacts sont sauvegardés en JSON et survivent aux relances.

Deux versions :

• v1 (niveau 5) — dicts + JSON, style procédural avec fonctions. C'est le grand frère du gestionnaire de tâches (projet 06), en plus complet.
• v2 (niveau 6) — refonte POO : une classe Contact et une classe ContactBook. MÊME comportement extérieur. Le but est de sentir ce que la POO change — et ce qu'elle ne change pas.

C'est le projet le plus exigeant avant les niveaux 9-10 : prends les deux sessions au sérieux.

Notions utilisées

• Fonctions, découpage en responsabilités — niveau 4
• JSON : load/dump, FileNotFoundError — niveau 5
• Recherche insensible à la casse dans des chaînes (in, lower()) — niveau 3
• v2 : classes, __init__, attributs, méthodes — niveau 6
• v2 : __str__ pour l'affichage d'un objet — niveau 6
• v2 : conversion objet ↔ dict pour le JSON (to_dict() / from_dict()) — niveau 6 (c'est LE pont difficile de la v2)

Cahier des charges

Commun :

• Fichiers : contacts.py (v1), contacts_v2.py (v2), données dans contacts.json.
• Un contact = nom (obligatoire, non vide), téléphone, email.
• Menu : ajouter / lister / rechercher / modifier / supprimer / quitter.
• La recherche matche une sous-chaîne du nom, insensible à la casse (« mar » trouve « Marie » et « Omar »).
• Pas de doublon : refuser un ajout dont le nom (insensible à la casse) existe déjà.
• Modifier : proposer champ par champ, Entrée vide = garder la valeur actuelle.
• Sauvegarde après chaque modification ; premier lancement sans fichier OK.

Spécifique v2 :

• Classe Contact : attributs name, phone, email ; méthodes __str__(), to_dict(), et méthode de classe ou fonction from_dict(d).
• Classe ContactBook : détient la liste de Contact ; méthodes add(), find(query), remove(name), save(path), load(path).
• Le menu (interface) ne manipule JAMAIS de dicts directement : uniquement des objets et les méthodes du carnet.
• Comportement extérieur identique à la v1, y compris le format de contacts.json (tes données v1 doivent se charger telles quelles en v2 — c'est un vrai test de migration).

Étapes de construction

v1 — niveau 5

1. Structure de données + listing : liste de dicts en dur, fonction show_contacts(contacts). Lance, vérifie l'affichage.
2. Menu en boucle + add_contact(contacts) avec validation du nom non vide et refus des doublons. Teste le doublon avec des casses différentes.
3. find_contacts(contacts, query) : retourne une LISTE de résultats (pas le premier trouvé), affichage à part. Teste « mar », « MAR », requête sans résultat.
4. Persistance : save_contacts(contacts) / load_contacts() sur le modèle du projet 06 (JSON, with, FileNotFoundError → []). Sauvegarde après chaque changement. Teste le cycle quitter/relancer.
5. edit_contact (champ par champ, Entrée = conserver) et delete_contact (par nom exact, avec confirmation o/n). Teste tout le menu. Commit v1.

v2 — niveau 6

1. Dans contacts_v2.py, écris la classe Contact seule : __init__, __str__, to_dict, from_dict. Teste-la dans le REPL ou sous if __name__ == "__main__": — créer, afficher, convertir aller-retour (Contact.from_dict(c.to_dict())).
2. Écris ContactBook avec add, find, remove en mémoire (sans JSON). Teste ses méthodes directement, sans menu.
3. Ajoute save(path) / load(path) au carnet : save convertit chaque contact avec to_dict, load reconstruit avec from_dict. Charge ton contacts.json de la v1 : il doit passer tel quel.
4. Rebranche le menu de la v1 sur le carnet (l'interface appelle les méthodes, ne touche plus aux dicts). Déroule le même scénario complet que la v1 et compare. Commit v2.

Extensions possibles

1. Trier le listing par nom (sorted avec key=).
2. Valider grossièrement l'email (contient @ et un point après) — la vraie validation est un puits sans fond, reste simple.
3. Export CSV (csv.writer) pour ouvrir le carnet dans un tableur.
4. v2 : une méthode merge(other_book) qui fusionne deux fichiers de contacts en gérant les doublons — bon exercice de conception.

Erreurs fréquentes sur ce projet

• v2 : TypeError: Object of type Contact is not JSON serializable — json.dump ne sait pas sérialiser tes objets. C'est exactement le rôle de to_dict() : JSON ne transporte que des types de base.
• v2 : oublier self dans une méthode : TypeError: add() takes 1 positional argument but 2 were given. Ce message obscur signifie presque toujours « il manque self ».
• Modifier une copie au lieu de l'objet : contact = contacts[i] puis réaffecter contact = {...} ne change PAS la liste. Modifier les champs (contact["phone"] = ...) si. La différence entre lier un nouveau nom et muter l'objet — révision niveau 3.
• Recherche qui retourne le premier résultat au lieu de tous : « mar » doit lister Marie ET Omar. Retourne une liste, toujours.
• Comparaison de doublons sensible à la casse : « marie » et « Marie » passent tous les deux. Normalise (lower()) au moment du TEST, sans altérer le nom stocké.
• v2 : mettre des print()/input() dans Contact ou ContactBook : les classes portent les données et la logique, l'interface parle. Même règle qu'au niveau 4 pour les fonctions.

Critères de réussite

• v1 : les 6 commandes du menu fonctionnent, données persistées à chaque changement.
• v1 : doublons refusés quelle que soit la casse ; recherche partielle correcte.
• v2 : le contacts.json créé par la v1 se charge sans modification.
• v2 : même scénario de test → même comportement que la v1.
• v2 : aucune manipulation de dict dans le code du menu.
• Je peux expliquer à voix haute ce que la POO a simplifié ici (et ce qu'elle a alourdi — réponse honnête attendue).

Commit conseillé

git add projects/mini-projects/09-carnet-de-contacts/
git commit -m "project: add contact book"
# ... puis, apres la v2 :
git commit -m "project: add contact book OOP version"

Puis entrée de journal + git push. Comme au projet 06 : contacts.json dans .gitignore si tu y mets de vrais contacts.