onizuka_0ooghalfyhhwh6kl_333.py

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script onizuka_0ooghalfyhhwh6kl_333.py

Version 1.0.0

Date de création 25/03/2026

Auteur / Demandeur IA Généré (Simulation de gestion de site)

Objectif principal Simuler la gestion administrative et opérationnelle d’un responsable de site de nettoyage via la génération aléatoire de documents et de tâches.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Ce script définit une structure de données et une logique de simulation pour un Responsable de Nettoyage. Il permet de générer dynamiquement des documents administratifs (bons de commande, rapports qualité, plannings) et des tâches techniques localisées sur un site, avec des niveaux de priorité et des dates limites calculées.

📌 Problème résolu

Il automatise la création de scénarios de travail pour la gestion de services de propreté, facilitant le prototypage d’outils de gestion de planning ou de tableaux de bord pour les chefs de site.

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.7+ (nécessite dataclasses)

OS cible Tous (Windows / Linux / MacOS)

Mode d’exécution Module / Bibliothèque de classes

📦 Dépendances / Librairies

Librairies standard (built-in)

random: Pour la sélection aléatoire des zones et priorités.

datetime: Pour la gestion des dates limites.

json: (Importé mais non utilisé dans l’extrait fourni).

dataclasses: Pour la structure des objets Document et Tache.

typing: Pour le typage statique (List, Dict, Optional).

enum: Pour la définition des types de documents et niveaux de priorité.

📥 ENTRÉES (INPUTS)

# Nom Type Obligatoire Description Exemple

1 nom str ✅ Oui Nom du responsable « Jean Dupont »

2 site str ✅ Oui Nom du site géré « Siège Social Alpha »

3 nombre int ❌ Non Nombre d’éléments à générer 3

📤 SORTIES (OUTPUTS)

# Nom Type Description Exemple

1 documents List[Document] Liste d’objets Document générés [Document(type=…, titre=…)]

2 taches List[Tache] Liste d’objets Tache générés [Tache(description=…, zone=…)]

🧱 STRUCTURE DU SCRIPT

onizuka_0ooghalfyhhwh6kl_333.py

📌 ENUMS: TypeDocument, Priorite (définition des constantes métier).

📌 DATACLASSES: Document, Tache (modèles de données).

📌 CLASSE PRINCIPALE: ResponsableNettoyage.

__init__ → Initialisation du profil et des listes de suivi.

generer_documents_administratifs() → Logique de création de documents.

generer_taches_nettoyage() → Logique de planification de tâches.

🔧 Détail des fonctions principales

Fonction Paramètres Retour Rôle

generer_documents_administratifs nombre: int List[Document] Crée un échantillon aléatoire de documents administratifs.

generer_taches_nettoyage nombre: int List[Tache] Génère une liste de tâches techniques (Signature incomplète dans l’extrait).

🔄 LOGIQUE / ALGORITHME

Initialisation : Création de l’instance du responsable avec son nom et site.

Sélection : Le script pioche dans une liste prédéfinie de documents possibles (Fiches, Bons, Rapports).

Calcul temporel : Utilisation de timedelta pour définir une date_limite aléatoire (J+1 à J+5).

Échantillonnage : Utilisation de random.sample pour garantir l’unicité des documents retournés selon le nombre demandé.

🚨 GESTION DES ERREURS

Validation du nombre : Le script utilise min(nombre, len(documents_possibles)) pour éviter les erreurs d’index si l’utilisateur demande plus de documents qu’il n’en existe en base.

Typage : L’utilisation de Enum empêche l’utilisation de priorités ou de types de documents non conformes.

✅ CONTRAINTES & RÈGLES MÉTIER

Règle 1 : Les documents de type « Bon de commande » ont par défaut une priorité ÉLEVÉE.

Règle 2 : Les rapports qualité sont systématiquement marqués en priorité URGENT.

Règle 3 : Le statut est_complete (ou effectuee) est initialisé à False par défaut.

📝 EXEMPLE D’UTILISATION

💻 Appel en tant que module

Python

from onizuka_script import ResponsableNettoyage, Priorite

# Création du responsable

chef = ResponsableNettoyage(« Marc », « Usine Centre »)

# Génération de 2 documents prioritaires

docs = chef.generer_documents_administratifs(2)

for d in docs:

print(f »{d.priorite.value} – {d.titre} (Limite: {d.date_limite}) »)

📋 Exemple de sortie attendue

Plaintext

🔴 Urgent – Rapport qualité hebdomadaire (Limite: 2026-03-26)

🟠 Élevée – Bon de commande – Produits d’entretien (Limite: 2026-03-27)