onizuka_school_sim.py

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script onizuka_school_sim.py

Version 1.0.0

Date de création 11/03/2026

Auteur IA Généré (Inspiré par le code fourni)

Objectif principal Simuler la gestion quotidienne d’un établissement scolaire en intégrant des variables physiques et économiques.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Ce script est un simulateur éducatif et de gestion. Il permet de créer une structure scolaire (salles, enseignants, élèves), d’en gérer le budget et de simuler l’impact de facteurs externes (température, usure des locaux, probabilités statistiques) sur la réussite académique et la santé financière de l’établissement sur une période donnée.

📌 Problème résolu

Il offre un modèle simplifié pour comprendre les interactions complexes entre :

Les infrastructures (consommation énergétique, usure).

Le capital humain (satisfaction, assiduité, recrutement).

Les finances (subventions vs dépenses opérationnelles).

Les résultats pédagogiques (notes influencées par l’environnement).

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.x

OS cible Windows / Linux / MacOS

Mode d’exécution CLI (Ligne de commande) avec visualisation graphique optionnelle

📦 Dépendances / Librairies

Standard : random, collections (defaultdict)

Externes : matplotlib (visualisation), numpy (calculs statistiques/notes)

📥 ENTRÉES (INPUTS)

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

Le script actuel fonctionne de manière autonome via la fonction main(), mais il peut être paramétré par :

Objets de classe : Instanciation de la classe Ecole avec un nom et un budget de départ.

Méthodes d’ajout : ajouter_salle, ajouter_enseignant, ajouter_eleve.

📤 SORTIES (OUTPUTS)

📂 Fichiers / Données en sortie

Type Chemin / Format Description

Rapport Texte rapport_ecole.txt Synthèse finale des performances de l’école.

Graphiques Matplotlib Pop-up 4 graphiques d’évolution (Budget, Population, Réussite, Énergie).

Logs CLI Console Journalisation en temps réel des événements quotidiens.

🧱 STRUCTURE DU SCRIPT

Plaintext

onizuka_school_sim.py

│

├── 📌 IMPORTS (random, matplotlib, numpy, etc.)

├── 📌 CLASSE Ecole

│ ├── 🔹 Sous-classe Salle

│ ├── 🔹 Sous-classe Enseignant

│ ├── 🔹 Sous-classe Eleve

│ ├── 🔸 Méthodes de Gestion (ajouter_*, calculer_*)

│ └── 🔸 Méthodes de Simulation (simuler_cours, gerer_budget)

├── 📌 FONCTIONS GLOBALES

│ └── sauvegarder_rapport()

└── 📌 MAIN (Point d’entrée de la simulation)

🔧 Détail des fonctions principales

Fonction Paramètres Retour Rôle

simuler_cours() Aucun None Gère une journée de cours (météo, usure, notes).

gerer_budget() Aucun None Calcule revenus/dépenses et gère les aléas (pannes, dons).

visualiser_donnees() Aucun None Génère les graphiques d’historique via Matplotlib.

calculer_moyenne_generale() Aucun float Calcule la performance globale basée sur les notes élèves.

🔄 LOGIQUE / ALGORITHME

Initialisation : Création de l’école, des salles, recrutement du personnel et inscription des élèves.

Boucle Temporelle (30 jours) :

Application de la physique thermique (Température ➔ Assiduité).

Vérification de l’état des infrastructures (Usure ➔ Impact apprentissage).

Calcul probabiliste des notes (Distribution normale via NumPy).

Mise à jour de l’historique de données.

Gestion Économique : Tous les 5 jours, calcul du solde (Revenus par élève – Salaires – Énergie).

Finalisation : Exportation du rapport et affichage des graphiques.

🚨 GESTION DES ERREURS

Manque d’effectif : Le script bloque la simulation (simuler_cours) si aucun élève ou enseignant n’est présent.

Limites de valeurs : Les notes sont bridées entre 0 et 20 ; l’état des salles est bloqué à 0 minimum.

✅ RÈGLES MÉTIER

Règle 1 : L’assiduité des élèves chute si la température est hors de la zone de confort (20°C – 25°C).

Règle 2 : Une salle avec un état < 50% pénalise l'assiduité des élèves qui y étudient. Règle 3 : Les pannes électriques (10% de chance) doublent temporairement les coûts énergétiques. 📝 EXEMPLE D'UTILISATION ▶️ Lancement en ligne de commande Bash python onizuka_school_sim.py 📋 Exemple de sortie attendue (Console) Plaintext ✅ Salle ajoutée : Laboratoire (Capacité: 20, Type: science) 👨‍🏫 Enseignant recruté : M. Dupont (Matière: Physique) 📚 Simulation du jour 1 📊 Moyenne générale du jour : 12.45/20 💰 Budget restant : 200000.00 € ⚠️ Panne électrique ! Coûts doublés. 📄 Rapport sauvegardé dans rapport_ecole.txt