onizuka_sim_cuisinier.py

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script onizuka_sim_cuisinier.py

Version 1.0.0

Date de création 25/03/2026

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

Objectif principal Simuler la gestion opérationnelle et administrative d’un cuisinier en restauration collective face aux demandes d’un secrétariat.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Le script génère de manière aléatoire un scénario de travail pour un cuisinier (contexte saisonnier, type de menu, normes d’hygiène). Il crée une liste de documents administratifs à fournir et de tâches techniques à accomplir, puis simule leur exécution en calculant les temps de traitement et les succès/échecs de chaque action.

📌 Problème résolu

Il permet de modéliser la charge de travail et la complexité organisationnelle d’un chef de cuisine, facilitant la compréhension des flux de documents et des priorités opérationnelles en restauration.

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.7+ (utilisation de dataclasses)

OS cible Tous (Windows / Linux / MacOS)

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

📦 Dépendances / Librairies

Librairies standard (built-in)

random : Génération de données aléatoires.

datetime : Gestion des dates et échéances.

dataclasses : Structure de données propre.

typing : Hinting de type pour la robustesse.

json : Export du rapport final.

📥 ENTRÉES (INPUTS)

📂 Fichiers / Sources de données en entrée

Type Chemin / Format Description

Configuration interne Classe Configuration Paramètres initiaux (menus, normes, volumes de repas).

📤 SORTIES (OUTPUTS)

📂 Fichiers / Données en sortie

Type Chemin / Format Description

JSON ./rapport_simulation.json État complet de la simulation (demandes + résultats).

Console Flux Standard Résumé visuel et log de l’exécution avec emojis.

🧱 STRUCTURE DU SCRIPT

onizuka_sim_cuisinier.py

📌 IMPORTS : random, datetime, dataclasses, json.

📌 CONFIGURATION : Classe Configuration (logique saisonnière).

📌 MODÈLES DE DONNÉES : Classes Document, Tache, DemandeSecrétaire.

📌 LOGIQUE DE GÉNÉRATION : Classe GenerateurDemandes.

📌 MOTEUR DE SIMULATION : Classe SimulateurCuisinier.

📌 MAIN : Point d’entrée orchestrant la création et l’exécution.

🔧 Détail des fonctions principales

Fonction Paramètres Retour Rôle

generer_demande() avec_message: bool DemandeSecrétaire Compile contexte, documents et tâches.

traiter_document() document: Document Dict Simule le temps et le statut de validation.

executer_tache() tache: Tache Dict Calcule le temps réel vs estimé d’une tâche.

generer_rapport() fichier: str None Sérialise les résultats en JSON.

🔄 LOGIQUE / ALGORITHME

Initialisation : Chargement de la configuration de base.

Génération de Contexte : Choix aléatoire d’une saison et d’une norme d’hygiène.

Instanciation des Demandes :

Création de documents avec formats (PDF, Excel) et urgences variables.

Création de tâches avec ressources spécifiques et calcul d’échéances.

Simulation du Traitement :

Application de coefficients aléatoires sur les durées.

Détermination du succès (90% de réussite pour les tâches).

Reporting : Affichage console et sauvegarde fichier.

🚨 GESTION DES ERREURS

Fichiers : Gestion de l’encodage utf-8 lors de l’écriture du JSON.

Robustesse : Utilisation de min() et max() pour éviter des durées négatives ou des échantillonnages dépassant la taille des listes de base.

✅ CONTRAINTES & RÈGLES MÉTIER

Saisonnalité : En été, le contrôle thermique est renforcé ; en hiver, les menus incluent des plats chauds.

Priorisation : Les tâches sont triées par priorité (1 à 5) avant affichage.

Échéances : Les tâches urgentes (priorité ≤2) voient leur échéance limitée à 24h.

🧪 TESTS ATTENDUS

# Cas de test Entrée Résultat attendu Statut

1 Cas nominal Exécution standard Affichage complet et fichier JSON créé. ⬜ À tester

2 Saison Été Contexte = « Été » Présence de la norme « Température renforcée ». ⬜ À tester

3 Export JSON Données complexes Dates converties en ISO strings (pas d’erreur de sérialisation). ⬜ À tester

📊 PERFORMANCES ATTENDUES

Temps d’exécution : < 1 seconde (simulation purement mathématique). Consommation mémoire : Très faible (< 50 Mo). 📝 EXEMPLE D'UTILISATION ▶️ Lancement en ligne de commande Bash python onizuka_5ipxvym4u7uzwal8_333.py 📋 Exemple de sortie attendue Plaintext 🍽️ Contexte : Été - Menu Végétarien 📊 142 repas/jour 🧼 Norme : HACCP 📄 DOCUMENTS À FOURNIR : 1. 🔴 Liste des allergènes 📅 Date limite : 26/03/2026 | 📁 Format : PDF ... 🔄 TRAITEMENT DES DEMANDES EN COURS... ✅ Fiche technique de production : VALIDÉ