onizuka_a3lund8nhnlyp078_333.py

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script onizuka_a3lund8nhnlyp078_333.py

Version 1.0.0

Date 25/03/2026

Auteur / Demandeur refoïa jeremy

Objectif principal Simuler l’activité quotidienne d’une entreprise de maintenance d’ascenseurs (gestion clients, parc, documents et tâches).

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Ce script est un simulateur métier qui génère de manière procédurale un écosystème d’ascensoriste. Il crée des clients, des parcs d’ascenseurs associés, et simule le flux de travail quotidien en générant des documents techniques (factures, certificats) et des tâches de maintenance ou administratives avec différents niveaux d’urgence.

📌 Problème résolu

Il permet de modéliser et de tester la logique de gestion d’un carnet de commandes et d’interventions sans nécessiter de base de données réelle, idéal pour du prototypage de logiciel de gestion (ERP/GMAO).

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.7+ (utilise dataclasses et typing)

OS cible Tous (Windows / Linux / MacOS)

Mode d’exécution CLI / Module

📦 Dépendances / Librairies

Librairies standard (built-in)

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

datetime : Gestion des dates d’installation et d’échéance.

json : (Importé mais non utilisé intensivement dans cette version).

enum : Définition des types de documents, tâches, urgences et statuts.

dataclasses : Structure des objets métier.

typing : Type hinting pour la clarté du code.

time : Simulation du délai de traitement des tâches.

📥 ENTRÉES (INPUTS)

📂 Paramètres d’initialisation

# Nom Type Obligatoire Description

1 seed int ❌ Non Graine de randomisation pour la reproductibilité.

2 nb_documents int ❌ Non Nombre de documents à générer par jour (défaut: 3).

3 nb_taches int ❌ Non Nombre de tâches à générer par jour (défaut: 5).

📤 SORTIES (OUTPUTS)

📂 Données en sortie

Console (CLI) : Affichage structuré du journal de simulation (Émojis d’urgence, détails des clients et ascenseurs).

Objets Python : Retourne un dictionnaire structuré contenant les listes d’objets Document et Tache.

🧱 STRUCTURE DU SCRIPT

Plaintext

onizuka_a3lund8nhnlyp078_333.py

│

├── 📌 ENUMÉRATIONS (Types, Urgences, Statuts)

├── 📌 CLASSES DE DONNÉES (Client, Ascenseur, Document, Tache)

├── 📌 CLASSE PRINCIPALE (SimulateurAscensoriste)

│ ├── _initialiser_donnees_base() → Setup du parc initial

│ ├── generer_demande_document() → Logique de création de docs

│ ├── generer_tache() → Logique de création de tâches

│ └── generer_demandes_quotidiennes() → Orchestrateur journalier

└── 📌 FONCTION EXTERNE

└── simuler_traitement_tache() → Simulation de résolution

🔄 LOGIQUE / ALGORITHME

Initialisation : Création d’un pool de 5 clients et génération de 1 à 3 ascenseurs par client (marques, capacités et étages aléatoires).

Génération Quotidienne :

Sélection aléatoire d’un client et/ou d’un ascenseur.

Attribution d’un type (Document ou Tache).

Calcul de la date d’échéance en fonction de l’urgence (ex: Critique = 1 jour).

Traitement : Simulation d’un temps de travail via time.sleep(). Une probabilité de 20% d’échec est intégrée pour simuler les aléas du métier.

✅ CONTRAINTES & RÈGLES MÉTIER

Règle 1 : Un document peut être lié à un client sans être lié à un ascenseur spécifique (ex: une facture globale).

Règle 2 : L’échéance d’une tâche est strictement corrélée à son niveau d’urgence.

Règle 3 : Le temps de traitement simulé augmente avec la criticité de la tâche.

📝 EXEMPLE D’UTILISATION

💻 Appel via script

Python

sim = SimulateurAscensoriste()

# Générer la journée

resultats = sim.generer_demandes_quotidiennes(nb_documents=2, nb_taches=3)

# Traiter la première tâche générée

if resultats[« taches »]:

simuler_traitement_tache(resultats[« taches »][0])

📋 Exemple de sortie console

Plaintext

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

📅 SIMULATION DU 25/03/2026

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

📄 DOCUMENTS DEMANDÉS (1):

1. Rapport d’inspection – Client: Hôpital Saint-Joseph

Ascenseur: ASC-3-001

📋 TÂCHES À ACCOMPLIR (1):

1. 🔴 Planifier une intervention

Description: Planifier intervention curative

Échéance: 26/03/2026

Responsable: Sophie