🔷 INFORMATIONS GÉNÉRALES
Champ Détail
Nom du script onizuka_3bvcg8xjbsb1cetq_333.py
Version 1.0.0
Date de création 11/03/2026
Auteur / Demandeur Gemini (Analyse de script existant)
Objectif principal Gérer les interventions, le stock et la facturation d’un atelier de réparation de cycles.
🎯 DESCRIPTION FONCTIONNELLE
📌 Que fait ce script ?
Ce script est un outil de gestion complet pour un vélociste. Il permet d’enregistrer des interventions mécaniques, de suivre l’état des stocks de pièces détachées, de calculer des statistiques de performance (CA, temps moyen, taux de réalisation) et de générer des rapports et factures au format CSV.
📌 Problème résolu
Il automatise le suivi administratif d’un atelier qui, autrement, utiliserait des carnets papier ou des tableurs désorganisés. Il offre une visibilité immédiate sur la rentabilité et les besoins de réapprovisionnement.
⚙️ SPÉCIFICATIONS TECHNIQUES
🐍 Environnement
Élément Valeur
Version Python 3.7+ (utilise les dataclasses et le typage)
OS cible Tous (Windows / Linux / MacOS)
Mode d’exécution CLI (Ligne de commande)
📦 Dépendances / Librairies
# Librairies standard (built-in)
csv : Génération des rapports et factures.
datetime : Horodatage des documents.
os : Gestion du système de fichiers.
dataclasses : Structure de données propre pour les interventions.
typing : Hinting pour la clarté du code.
statistics : (Importée mais non utilisée explicitement dans le code actuel).
📥 ENTRÉES (INPUTS)
📂 Fichiers / Sources de données en entrée
Données programmatiques : Les interventions sont actuellement créées via la fonction creer_exemple_donnees().
Stock : Dictionnaire codé en dur dans le constructeur de la classe AtelierVelos.
📤 SORTIES (OUTPUTS)
📂 Fichiers / Données en sortie
Type Chemin / Format Description
CSV rapport_atelier_velo.csv Rapport complet : stats, détail interventions et état des stocks.
CSV facture_[NOM_CLIENT].csv Facture détaillée pour un client spécifique avec calcul TTC.
Console Sortie Standard Analyse de performance textuelle et alertes de stock.
🧱 STRUCTURE DU SCRIPT
onizuka_3bvcg8xjbsb1cetq_333.py
📌 IMPORTS (csv, datetime, dataclasses, etc.)
📌 CLASSES
Intervention (DataClass) : Modèle de données.
AtelierVelos : Moteur de logique métier.
📌 FONCTIONS DE GESTION
creer_exemple_donnees() : Générateur de sandbox.
analyser_performance_atelier() : Affichage console.
📌 MAIN (Point d’entrée principal)
🔧 Détail des fonctions principales
Fonction Paramètres Retour Rôle
ajouter_intervention intervention: Intervention None Archive une nouvelle prestation.
calculer_stats Aucun Dict Calcule les indicateurs clés (KPI).
generer_rapport_csv nom_fichier: str None Exporte l’état global de l’atelier.
generer_facture_client nom_client: str None Filtre et facture un client précis.
🔄 LOGIQUE / ALGORITHME
Initialisation : Création de l’objet AtelierVelos avec son stock par défaut.
Saisie : Injection des objets Intervention dans la liste interne.
Traitement :
Calcul des sommes (temps, coûts).
Vérification des seuils de stock (Alerte si < 3 unités). Sortie : Formatage des chaînes de caractères et écriture physique des fichiers CSV. 🚨 GESTION DES ERREURS Absence de données : calculer_stats retourne un dictionnaire vide si aucune intervention n'est présente. Client inconnu : La fonction de facturation affiche un message prévenant que le client n'existe pas dans la base. Statut de stock : Marquage visuel (⚠️) si la quantité est critique. ✅ CONTRAINTES & RÈGLES MÉTIER Règle 1 : Le tarif horaire de la main d'œuvre est fixé à 45€/h. Règle 2 : Les descriptions d'interventions trop longues sont tronquées à 30 caractères dans le rapport global. Règle 3 : Le taux de réalisation est calculé uniquement sur les interventions au statut "Terminé". 🧪 TESTS ATTENDUS Cas nominal : Vérifier que le fichier rapport_atelier_velo.csv contient bien les 7 interventions d'exemple. Calcul financier : Vérifier que Total TTC = Pièces + (Heures * 45). Alerte Stock : Vérifier que la "Roue" (2 unités) déclenche bien l'alerte réapprovisionnement. 📝 EXEMPLE D'UTILISATION ▶️ Lancement en ligne de commande Bash python onizuka_3bvcg8xjbsb1cetq_333.py 📋 Exemple de sortie attendue (Console) Plaintext 📊 Statistiques générales: • Interventions totales: 7 • Taux de réalisation: 71.43% • CA pièces: 360.95€ 🔧 Alertes stock (quantité < 3): ⚠️ Roue: 2 unités ⚠️ Pédalier: 1 unités
Avis
Il n’y a pas encore d’avis.