Résoudre un problème

┌─────────────────┬──────────────────────────────────┐
│ ACTIONS         │ Ce que le programme fait          │
├─────────────────┼──────────────────────────────────┤
│ • Lire          │ un fichier CSV de produits        │
│ • Filtrer       │ par catégorie et prix max         │
│ • Afficher      │ les résultats formatés            │
│ • Exporter      │ vers un nouveau CSV               │
├─────────────────┼──────────────────────────────────┤
│ DONNÉES         │ Entités & structures              │
├─────────────────┼──────────────────────────────────┤
│ • Produit       │ nom, catégorie, prix, stock       │
│ • Catalogue     │ liste de Produit                  │
├─────────────────┼──────────────────────────────────┤
│ CONTRAINTES     │ Limites & règles                  │
├─────────────────┼──────────────────────────────────┤
│ • POO           │ Obligatoire (classe Produit)      │
│ • Pas de pandas │ Seulement csv et builtins         │
│ • Prix négatif  │ → lever une ValueError            │
├─────────────────┼──────────────────────────────────┤
│ LIVRABLES       │ Ce qu'on rend                     │
├─────────────────┼──────────────────────────────────┤
│ • main.py       │ + produit.py, catalogue.py        │
│ • tests/        │ 5 tests minimum                   │
├─────────────────┼──────────────────────────────────┤
│ AMBIGUÏTÉS      │ À clarifier avant de commencer   │
├─────────────────┼──────────────────────────────────┤
│ • "filtrer"     │ → ET ou OU entre les critères ?   │
│ • "formatés"    │ → tableau ASCII ? JSON ? autre ?  │
└─────────────────┴──────────────────────────────────┘

════════════════════════════════════════
 MA COMPRÉHENSION DU PROBLÈME
════════════════════════════════════════

Problème central :
  Créer un gestionnaire de bibliothèque POO
  qui garantit l'unicité des ISBN.

Ce que le programme fait :
  • Maintenir une collection de livres en mémoire
  • Ajouter un livre (avec vérification ISBN)
  • Rechercher par titre OU auteur
  • Supprimer par ISBN
  • Lever des exceptions sur les erreurs

Ce que le programme ne fait PAS :
  • Pas de sauvegarde sur disque
  • Pas d'interface graphique
  • Pas de tri (non mentionné)

Structures de données envisagées :
  class Livre : titre, auteur, annee, isbn
  class Bibliotheque : dict {isbn → Livre}
     → dict = recherche ISBN en O(1)

Cas limites à traiter :
  • ISBN en double → ValueError
  • Recherche sans résultat → liste vide
  • Suppression ISBN inexistant → ?  ← à clarifier

Questions ouvertes :
  1. Recherche "ou" : les deux champs en même temps ?
  2. Suppression inexistant : exception ou pass ?
  3. La persistance peut-elle être faite en bonus ?
════════════════════════════════════════

INCONNUES — Projet bibliothèque
Mis à jour : 2025-01-15
════════════════════════════════════

🔴 BLOQUANT (à résoudre avant de commencer)
───────────────────────────────────────────
□ Recherche "par titre OU auteur" :
    → méthode unique avec un paramètre ?
    → deux méthodes séparées ?
    → Statut : À demander au prof

□ Suppression d'un ISBN inexistant :
    → lever KeyError ? retourner False ?
    → Statut : À demander au prof

🟡 IMPORTANT (à résoudre dans les 24h)
───────────────────────────────────────────
□ Format d'affichage des résultats :
    → __str__ sur Livre ? tableau ? dict ?
    → Statut : Choix personnel documenté → __repr__ + __str__

🟢 OPTIONNEL (si on a le temps)
───────────────────────────────────────────
□ La persistance peut-elle être ajoutée ?
    → Statut : Demanderait des points bonus ?
    
RÉSOLUES
───────────────────────────────────────────
✓ Bibliothèques externes → interdites (confirmé)
✓ 8 tests minimum → pas "exactement 8"

PLAN D'ATTAQUE — Bibliothèque Python
═══════════════════════════════════════

Estimation : ~4h

1. [30min] Structures de données
   → Classe Livre(titre, auteur, annee, isbn)
   → Classe Bibliotheque(dict isbn→Livre)
   → Validation : créer 2-3 livres, afficher

2. [45min] Ajout avec validation ISBN
   → Bibliotheque.ajouter(livre)
   → Lever ValueError si ISBN existe déjà
   → Test : ajouter doublon → exception

3. [45min] Recherche
   → Bibliotheque.rechercher(terme)
   → Cherche dans titre ET auteur
   → Retourne liste (vide si pas trouvé)

4. [30min] Suppression
   → Bibliotheque.supprimer(isbn)
   → Comportement si inexistant → Exception
      (confirmé avec prof)

5. [60min] Tests unitaires (8 minimum)
   → test_ajout_normal
   → test_ajout_doublon_isbn
   → test_recherche_par_titre
   → test_recherche_par_auteur
   → test_recherche_inexistante → []
   → test_suppression
   → test_suppression_inexistante
   → test_bibliotheque_vide

6. [30min] main.py de démonstration
   → Scénario réaliste complet

7. [20min] Relecture de l'énoncé
   → Cocher chaque exigence une par une

ACTIONS  : déposer, retirer, consulter historique,
            rejeter les opérations invalides

DONNÉES  : Compte(titulaire, solde), 
            Opération(type, montant, date)
            Historique = liste d'Opération

CONTRAINTES :
  ✓ POO obligatoire
  ✓ Solde jamais négatif → exception
  ✓ Montants négatifs → exception
  ✓ Tests : cas nominaux + cas d'erreur

LIVRABLES : compte.py, test_compte.py

AMBIGUÏTÉS À CLARIFIER :
  ⚠ "montants négatifs rejetés" → s'applique
    au dépôt seulement ? au retrait aussi ?
    (un retrait est-il déjà négatif par nature ?)
  
  ⚠ "leur date" → date système automatique ?
    ou passée en paramètre ? Quel format ?

  ⚠ "exception appropriée" → ValueError ?
    une classe custom InsufficientFunds ?

EXEMPLES CONCRETS :
  compte = Compte("Alice", 1000)
  compte.deposer(500)   → solde : 1500
  compte.retirer(200)   → solde : 1300
  compte.retirer(2000)  → exception !
  compte.deposer(-50)   → exception !
  compte.historique()   → [Dépôt 500, Retrait 200]

PLAN (estimé 3h) :
  1. Classe Compte + Opération (30min)
  2. deposer() + retirer() (45min)
  3. historique() (20min)
  4. Exceptions et validation (30min)
  5. Tests (45min)

AVANT DE COMMENCER — 10 questions prioritaires

1. Qu'est-ce qu'"archiver" signifie exactement ?
   → L'annonce est encore visible par le directeur ?
   → On peut la "désarchiver" ?

2. L'application doit-elle fonctionner sur mobile ?
   → Les agents ont des smartphones/tablettes ?

3. Avez-vous un exemple d'application qui ressemble
   à ce que vous imaginez ?

4. Faut-il migrer les données de l'Excel actuel ?
   → Combien d'annonces ? Sur quelle période ?

5. Qui gère l'hébergement après livraison ?
   → Budget prévu pour le serveur / maintenance ?

6. La recherche des clients : sur votre site actuel
   ou une nouvelle page publique ?

7. Les photos : stockage illimité ou quota ?
   → Taille max par photo ?

8. Que doit-il se passer si deux agents modifient
   la même annonce en même temps ?

9. Avez-vous besoin de statistiques ?
   → Nombre de vues par annonce, etc ?

10. Quel est le périmètre strict pour les 2 mois ?
    → Qu'est-ce qui peut attendre une V2 ?

MVP (2 mois, 5 000€) — périmètre suggéré :

✓ Authentification agents (login simple)
✓ CRUD annonces (ajouter/modifier/archiver)
✓ Rôle directeur (suppression définitive)
✓ Upload de photos (3 max par annonce)
✓ Page publique de recherche (ville, type, prix)
✓ Fiche annonce publique

✗ Hors MVP — Phase 2 :
  - Statistiques et tableaux de bord
  - Application mobile native
  - Messagerie entre agents
  - Intégration portails (SeLoger, LeBonCoin)
  - Signature électronique

Questions qui conditionnent l'architecture :
  - Mobile web ou app native ? → impact coût x3
  - Hébergement inclus ? → +500€/an
  - Migration données Excel ? → +2 jours

→ Valider ce périmètre avant tout devis

□ J'ai lu l'énoncé/CDC deux fois en entier
□ J'ai identifié toutes les actions demandées
□ J'ai listé toutes les contraintes (même celles en milieu de phrase)
□ Je sais exactement ce qu'il faut rendre
□ J'ai listé toutes les ambiguïtés
□ J'ai clarifié les ambiguïtés bloquantes
□ J'ai reformulé le problème avec mes propres mots
□ J'ai tracé un exemple concret à la main
□ J'ai réfléchi aux cas limites
□ J'ai un plan d'attaque avec des étapes ordonnées

□ J'ai relu l'énoncé/CDC ligne par ligne
□ Chaque action demandée est implémentée
□ Chaque contrainte est respectée
□ Tous les livrables sont présents
□ Les cas limites sont gérés
□ Les tests couvrent le nominal ET l'erreur
□ Le code tourne sans erreur sur un exemple neuf
□ J'ai testé avec des données différentes de l'exemple
□ Le README / la doc demandée est présente
□ J'ai vérifié les conventions de nommage