Skip to content

Documentation

Jump to bottom
PasRP-Theo edited this page Jan 11, 2025 · 24 revisions

Fonctionnalitées Smart

1. Commande load_csv_files

  • Spécifique : Charge tous les fichiers CSV d’un répertoire et les combine en une seule base de données.
  • Mesurable : Vérifie que les fichiers sont valides et les combine en un DataFrame sans erreurs.
  • Atteignable : il fait fournir le chemin vers le répertoire des fichiers CSV.
  • Pertinent : aide a centraliser les données pour une gestion facile.

2. Commande show_menu

  • Spécifique : Affiche un menu qui permet de naviguer entre les fonctionnalités.
  • Mesurable : Tout est documentées et accessibles par l'utilisateur.
  • Atteignable : Interface facile pour les utilisateurs.
  • Pertinent : Simplifie l'utilisation du script.

3. Commande search_product

  • Spécifique : Rechercher un produit dans la ligne nom du produit.
  • Mesurable : Retourne les infos correspondant aux critères donnés.
  • Atteignable : Insensible à la casse.
  • Pertinent : Permet une recherche rapide de produits.

4. Commande filter_by_category

  • Spécifique : Filtre les données par une catégorie spécifique.
  • Mesurable : Retourne les entrées correspondant à la catégorie donnée.
  • Atteignable : Fonctionne sur n'importe quelle colonne contenant la catégorie.
  • Pertinent : Permet de rechercher facilement les produits par catégorie.

5. Commande filter_by_price

  • Spécifique : Filtre les données par plage de prix.
  • Mesurable : Retourne les entrées correspondant à la plage de prix définie.
  • Atteignable : La saisie des limites de prix est réalisée sous forme de valeurs numériques.
  • Pertinent : Permet d'examiner les produits en fonction de leur prix.

6. Commande generate_report

  • Spécifique : Génère un rapport regroupé par catégorie avec les quantités totales et les prix moyens.
  • Mesurable : Crée un rapport exporté en CSV.
  • Atteignable : L'utilisateur spécifie le chemin pour sauvegarder le fichier.
  • Pertinent : Permet l'analyse du stock par catégorie pour une prise de décision éclairée.

7. Commande show_first_rows

  • Spécifique : Affiche les premières lignes du DataFrame consolidé pour validation ou inspection.
  • Mesurable : L'utilisateur peut spécifier combien de lignes à afficher.
  • Atteignable : Fonctionne avec de grands volumes de données.
  • Pertinent : Offre un aperçu rapide pour vérifier la validité des données.

8. Commande exit_program

  • Spécifique : Quitte le programme proprement.
  • Mesurable : Le programme se termine sans erreur.
  • Atteignable : Simplement en saisissant un choix.
  • Pertinent : Permet de sortir de l’application sans perdre les données.

Caractéristiques SMART du Programme

1. Chargement des Données

  • Spécifique : Charger des fichiers CSV d'un répertoire en une base de données unifiée.
  • Mesurable : Tous les fichiers CSV sont combinés sans erreurs en un DataFrame unique.
  • Atteignable : L'utilisateur spécifie le chemin du répertoire contenant les fichiers.
  • Pertinent : Centralisation des données pour une gestion plus facile.

2. Recherche en Inventaire

  • Spécifique : Rechercher un produit ou une catégorie via une condition colonne=valeur.
  • Mesurable : Retourne toutes les entrées correspondantes.
  • Atteignable : Fonctionne sur n'importe quelle colonne existante dans le DataFrame.
  • Pertinent : Permet une recherche rapide et précise d’informations spécifiques.

3. Résumé et Reporting

  • Spécifique : Générer un résumé des quantités totales et des prix moyens par catégorie.
  • Mesurable : Crée un rapport exporté en CSV.
  • Atteignable : L'utilisateur spécifie le chemin pour enregistrer le rapport.
  • Pertinent : Permet l'analyse du stock par catégorie pour une prise de décision éclairée.

4. Affichage des Données

  • Spécifique : Afficher les premières lignes du DataFrame consolidé.
  • Mesurable : L'utilisateur peut spécifier combien de lignes à afficher.
  • Atteignable : Fonctionne même avec de gros volumes de données.
  • Pertinent : Offre un aperçu rapide pour validation ou inspection.

5. Système Interactif (CLI)

  • Spécifique : Interface en ligne de commande interactive pour exécuter diverses fonctionnalités.
  • Mesurable : Toutes les commandes sont documentées et conviviales.
  • Atteignable : Construit avec une structure modulaire permettant l'ajout facile de nouvelles fonctionnalités.
  • Pertinent : Simplifie l'utilisation pour les utilisateurs techniques et non techniques.

Rapport sur l'Utilisation des Outils IA

Outils Utilisés

ChatGPT

  • Utilisé pour générer des idées, structurer le code et résoudre des problèmes spécifiques liés à Python.
  • Texte : mise en structure des textes

Ce qui a bien fonctionné

  • Résolution rapide des problèmes: ChatGPT donne des informations précises a chaque fois qu'il fait quelques choses.
  • Les Smart : chatGPT donne des smarts complete et précise

Ce qui n'a pas bien fonctionné

Personnalisation de ChatGPT : Bien que puissant, il donne parfois des solutions assez générique ou qui ne convient pas a la demande.

Expérience Globale

La combinaison de ces outils a fortement réduit le temps passé sur le script et a amélioré la qualité du script. Par contre, j'ai du vérifier que tout le code fonctionnait manuellement

Linter

Lors de la validation du programme, j'ai utilisé PyLint sans changer sa configuration. Sa configuration ne respecte pas toutes les règles de la PEP8. J'ai également changer des options dans mon IDE (PyCharm) pour avoir plus de 'warnings' si le code ne respecte pas certaines règles et bonnes pratiques. image

Clone this wiki locally