SimulationSecretairePatisserie.py

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script SimulationSecretairePatisserie.py

Version 1.0.0

Date de création 11/03/2026

Auteur / Demandeur IA Générée (Gemini)

Objectif principal Simuler l’activité quotidienne d’une secrétaire travaillant pour un fournisseur de matériel de pâtisserie via une interface en ligne de commande interactive.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Le script lance une simulation interactive où l’utilisateur incarne une secrétaire chez « PâtisserieMatériel Pro ». Il propose des tâches aléatoires (gestion de commandes, devis, factures) et permet soit de les valider simplement, soit de générer un document textuel formaté correspondant à l’activité.

📌 Problème résolu

Il offre un outil pédagogique ou de démonstration pour illustrer le flux de travail administratif (édition de documents, archivage, gestion des priorités) dans un secteur spécifique (matériel de cuisine).

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.x

OS cible Tous (Windows, Linux, MacOS)

Mode d’exécution CLI (Ligne de commande) Interactif

📦 Dépendances / Librairies

# Librairies standard (built-in)

random : Pour la sélection aléatoire des tâches et documents.

time : Pour simuler des délais de traitement (pauses).

datetime : Pour l’horodatage des documents et de la journée.

# Librairies externes

Aucune (Standard Python uniquement).

📥 ENTRÉES (INPUTS)

# Nom Type Obligatoire Description Exemple

1 action str ✅ Oui Choix de l’utilisateur dans la boucle « 1 », « 2 », « doc », « q »

📤 SORTIES (OUTPUTS)

# Nom Type Description Exemple

1 doc str Document formaté affiché à l’écran « DOCUMENT: DEVIS CLIENT… »

2 stats print Résumé final des tâches et documents « Tâches complétées: 5 »

🧱 STRUCTURE DU SCRIPT

SimulationSecretairePatisserie.py

│

├── 📌 IMPORTS (random, time, datetime)

├── 📌 CLASSE PRINCIPALE (SimulationSecretairePatisserie)

│ ├── __init__ : Initialisation du nom, des listes de tâches et des templates.

│ ├── generer_document() : Logique de formatage des strings.

│ └── simulation_journee() : Boucle principale de l’interface utilisateur.

└── 📌 MAIN (Point d’entrée if __name__ == « __main__ »:)

🔧 Détail des fonctions principales

Fonction Paramètres Retour Rôle

generer_document(type_doc, **kwargs) type_doc (str), **kwargs bool Formate un template avec les données fournies et l’ajoute à l’historique.

simulation_journee() Aucun None Gère la boucle while, l’affichage du menu et les entrées utilisateur.

🔄 LOGIQUE / ALGORITHME

Initialisation : Chargement de la liste des tâches (emails, stocks, devis) et des modèles de documents.

Boucle de Journée :

Sélection aléatoire d’une tâche dans la liste.

Attente de l’entrée utilisateur.

Traitement :

Option 1 : Incrémente le compteur de tâches.

Option 2 : Analyse les mots-clés de la tâche pour choisir le bon template, génère des données fictives (prix, articles) et affiche le document.

Affichage/Sortie : Historique des documents ou fin de simulation avec statistiques.

🚨 GESTION DES ERREURS

Entrée invalide : Si l’utilisateur tape autre chose que les options proposées, un message « Action non reconnue » s’affiche sans faire planter le script.

Template manquant : La méthode generer_document vérifie si le type demandé existe dans le dictionnaire avant de formater.

✅ RÈGLES MÉTIER

Horodatage : Chaque document généré prend automatiquement la date du jour système.

Signature : Tous les documents sont signés par défaut par « Marie Dupont ».

Calculs : Pour les devis, le script calcule automatiquement la TVA (20%) et le Total TTC à partir du HT.

🧪 TESTS ATTENDUS

# Cas de test Entrée Résultat attendu

1 Cas nominal Action « 2 » sur tâche devis Affichage d’un devis avec calcul TTC correct.

2 Historique Action « doc » Affiche les 5 derniers documents créés.

3 Sortie Action « q » Affiche le résumé final et ferme proprement.

📝 EXEMPLE D’UTILISATION

▶️ Lancement en ligne de commande

Bash

python SimulationSecretairePatisserie.py

📋 Exemple de sortie attendue

Plaintext

🎂 Bienvenue dans la simulation de la secrétaire chez PâtisserieMatériel Pro 🎂

— Journée 1 — 14:30

📋 NOUVELLE TÂCHE: Rédiger un devis pour un lot de 100 plaques de cuisson en silicone.

Que faites-vous ? (1: Compléter la tâche | 2: Générer un document associé | q: Quitter) : 2

============================================================

DOCUMENT: DEVIS CLIENT

Entreprise: PâtisserieMatériel Pro

Date: 2024-03-11

Client: Boulangerie Dupont

Articles:

– Moule à gâteau silicone: 100 unités à 5.5€/unité

Total HT: 825€

TVA 20%: 165€

Total TTC: 990€

============================================================