generer_contenu_documentSECRETAIRE.py

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script generer_contenu_documentSECRETAIRE.py

Version 1.0.0

Date de création 09/03/2026

Auteur / Demandeur Gemini (Inspiré par TechForge Solutions)

Objectif principal Simuler un flux de travail de secrétariat technique en générant des demandes de documents et leurs tâches administratives associées.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Ce script est un simulateur de gestion administrative pour une entreprise fictive (TechForge Solutions). Il génère aléatoirement des demandes provenant d’employés (ingénieurs, techniciens), crée des documents techniques ou RH réalistes, et liste automatiquement les tâches que la secrétaire doit accomplir pour chaque type de document, tout en calculant la charge de travail totale.

📌 Problème résolu

Il permet de modéliser et de visualiser la charge de travail d’un poste administratif, d’automatiser la création de jeux de données de test pour des outils de gestion de workflow, ou de servir de base à un outil de formation pour la priorisation des tâches.

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.7+ (utilise les dataclasses et Enum)

OS cible Tous (Windows, Linux, MacOS)

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

📦 Dépendances / Librairies

Librairies standard (built-in)

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

datetime : Manipulation des dates et délais.

time : Simulation de pauses de traitement.

dataclasses : Structuration des objets (Document, Tache, Demande).

typing, enum : Typage statique et énumérations de statuts.

📥 ENTRÉES (INPUTS)

# Nom Type Obligatoire Description Exemple

1 nb_demandes int ❌ Non Nombre de demandes à simuler (via input) 5

📂 Fichiers / Sources de données internes

Listes statiques : EMPLOYES, TYPES_DOCUMENTS, FOURNISSEURS, PROJETS servent de base de données interne pour la génération.

📤 SORTIES (OUTPUTS)

# Nom Type Description

1 Affichage Console str Rendu visuel formaté des demandes, documents et tâches.

2 Bilan de journée str Statistiques agrégées (temps total, priorités, volume).

🧱 STRUCTURE DU SCRIPT

Plaintext

generer_contenu_documentSECRETAIRE.py

│

├── 📌 CONFIGURATION (Enums Priorite, StatutTache)

├── 📌 STRUCTURES DE DONNÉES (Dataclasses: Document, Tache, Demande)

├── 📌 DONNÉES DE BASE (Listes employes, projets, fournisseurs)

├── 📌 GÉNÉRATEURS

│ ├── generer_contenu_document() → Logique textuelle par type de doc

│ ├── generer_taches_secretaire() → Mapping Type Doc <-> Liste Tâches

│ └── generer_demande() → Assemblage complet

├── 📌 AFFICHAGE (Formatage print, tableaux et bilans)

└── 📌 MAIN (Point d’entrée principal avec simulation)

🔄 LOGIQUE / ALGORITHME

[Image d’un logigramme de processus métier]

Initialisation : L’utilisateur saisit le nombre de demandes.

Génération :

Sélection d’un émetteur et d’un projet.

Création de N documents (1 à 3 par demande).

Attribution d’une priorité et calcul de la date_limite.

Extraction de la liste de tâches spécifiques au type de document.

Traitement des données : Calcul du temps de travail cumulé (conversion des chaînes « 30min » en entiers).

Affichage : Impression des fiches détaillées et du bilan statistique.

Simulation : Passage des tâches URGENTES au statut « En cours ».

🚨 GESTION DES ERREURS

Cas d’erreur Type d’exception Comportement attendu

Saisie non-numérique ValueError Utilise la valeur par défaut (4 demandes).

Type doc inconnu KeyError (gérée) Retourne un contenu et des tâches par défaut.

Valeur hors limite Logique Bride l’entrée entre 1 et 15 demandes.

✅ CONTRAINTES & RÈGLES MÉTIER

Priorisation : Les délais sont calculés selon la priorité (Urgent = 1j, Normal = 3j, Bas = 7j).

Calcul du temps : La fonction parse_duree convertit les formats « 1h 30min » pour le bilan final.

Unicité : Les types de documents au sein d’une même demande sont sélectionnés sans doublon (random.sample).

🧪 TESTS ATTENDUS

# Cas de test Entrée Résultat attendu

1 Cas nominal 3 Génère 3 demandes avec bilan cohérent.

2 Entrée vide «  » Exécute la simulation avec 4 demandes (par défaut).

3 Typage incorrect « abc » Gère l’erreur et lance la simulation par défaut.

4 Volumétrie 15 Vérifie que l’affichage reste lisible et le calcul du temps correct.

📝 EXEMPLE D’UTILISATION

▶️ Lancement en ligne de commande

Bash

python generer_contenu_documentSECRETAIRE.py

# Puis saisir « 5 » à l’invite

📋 Exemple de sortie attendue

Plaintext

📬 Demandes reçues : 4

📄 Documents totaux : 7

✅ Tâches à effectuer : 28

🔴 Documents urgents : 2

⏱ Temps de travail est: 4h 15min