🎮 Audit Master

Un simulateur d'audit pédagogique développé par Fork Games

---

📋 Table des matières

• Présentation du projet
• Équipe
• Captures d'écran
• Fonctionnalités
• Comment jouer
• Installation et exécution
• Architecture technique
• Licence
• Remerciements

---

🎯 Présentation du projet

Audit Master est un jeu vidéo éducatif qui plonge le joueur dans la peau d'un auditeur débutant au sein d'une université. L'objectif ? Réaliser un audit complet de l'établissement en parcourant ses différents pôles, tout en développant ses compétences professionnelles et en maintenant sa crédibilité.

Objectifs pédagogiques

Ce simulateur a été conçu pour enseigner :

• 📊 La planification d'un audit : Organiser méthodiquement l'ordre de passage dans les différents services
• 🤝 L'importance de l'image professionnelle : Comprendre comment la confiance et la compétence perçues influencent la qualité des échanges
• 🎯 La gestion des priorités : Identifier les zones critiques et adapter sa stratégie
• 📝 La prise de décision : Faire les bons choix face à des situations d'audit variées

📚 Référence pédagogique : Ce projet s'appuie sur l'expertise de Romain Boully, responsable du service audit interne de l'Université de Strasbourg (Unistra).

---

👥 Équipe

Fork Games - Projet T3

Membre	Rôle	Github
Arthur ALEXANDRE	Développeur	@ArthurALEXANDRE-29
Andy PHAN	Développeur	@cestlelheure
Ilian AKGUL	Développeur	@Chrisnac11
Omar Farouk LASFAR	Développeur	@oflasfar

---

📸 Captures d'écran

Écran d'accueil
Menu principal & Navigation

Choix de l'université	Choix du Personnage
Choix d'une université	Choix d'un personnage

Écran principal	Système de QCM
Exploration de la carte	Prise de décision durant l'audit

---

✨ Fonctionnalités

🎮 Gameplay

• 8 pôles à auditer : CROUS, Bibliothèque (BU), Informatique, Restaurant Universitaire (RU), Orientation, Infirmerie, Services Administratifs, SUAPS.
• Système de QCM : Prenez des décisions stratégiques durant chaque audit.
• Exploration stratégique : Découvrez l'état des pôles adjacents en progressant.
• Difficulté dynamique : Plus un pôle est en mauvaise santé, plus la récompense est élevée.

📊 Système de progression

Statistique	Description
💪 Compétence	Votre expertise technique d'auditeur
⭐ Crédibilité	La confiance que l'organisation vous accorde
❤️ Points de vie	Votre endurance - épuisement = défaite
🏆 Route du succès	Progression globale vers la victoire (100%)

👤 Profils de personnage

Choisissez votre style de jeu parmi 4 profils uniques :

Profil	Avantage
🗣️ Sociable et aimable	Bonus initial en crédibilité
🔧 Expert technique	Bonus initial en compétences
🔍 Analyste de génie	Visualise la santé des pôles voisins + bonus initial en compétences
🛡️ Résistant	Plus de points de vie + petits bonus initiaux en compétence et crédibilité

🎚️ Niveaux de difficulté

• Facile : Idéal pour découvrir le jeu
• Moyen : Équilibre entre défi et apprentissage
• Difficile : Pour les auditeurs aguerris

---

🕹️ Comment jouer

Démarrage rapide

1. Lancez le jeu et sélectionnez "Nouvelle partie"
2. Choisissez votre université (niveau de difficulté)
3. Sélectionnez votre profil d'auditeur
4. Explorez la carte et cliquez sur un pôle pour lancer un audit

Déroulement d'un audit

1️⃣ Sélection du pôle → Vérification des prérequis de compétence
                              ↓
2️⃣ Ordre de mission → Lecture du contexte et des indices
                              ↓
3️⃣ QCM de décisions → Répondez aux questions stratégiques
                              ↓
4️⃣ Résultat → ✅ Réussite = Récompenses + Progression
              ❌ Échec = Perte de vie + Impact statistiques

Conditions de victoire et défaite

🏆 Victoire	💀 Défaite
Atteindre 100% sur la Route du Succès	Points de vie épuisés

💡 Conseil : La santé des pôles n'est pas visible directement. Analysez les indices pour identifier les zones à risque !

---

📥 Installation & Téléchargement

Ce projet est Open Source. Vous avez deux façons d'y accéder selon votre profil :

🎮 Pour les Joueurs (Juste envie de jouer ?)

Pas besoin d'installer Godot ou de compiler quoi que ce soit. Nous avons généré des exécutables "prêts à jouer" (portables).

1. Téléchargez la version correspondant à votre système :
   • Releases
2. Lancez simplement le fichier téléchargé (ou l'installeur).
3. Amusez-vous !

---

👨‍💻 Pour les Développeurs (Code Source)

Vous souhaitez voir comment le jeu est codé, modifier les scripts ou contribuer au projet ? Le code source est entièrement disponible.

Pré-requis :

• Godot Engine 4.x (Version standard).

Installation :

1. Cloner le dépôt :

   git clone git@git.unistra.fr:met25b-d/t3.git

2. Importer dans Godot :
   • Lancez Godot Engine.
   • Cliquez sur "Importer".
   • Naviguez vers le dossier cloné et sélectionnez le fichier project.godot.
3. Lancer l'éditeur :
   • Faites F5 pour lancer le jeu en mode débug.

N'hésitez pas à explorer les scripts dans le dossier Scripts/, ils sont documentés pour faciliter la compréhension de l'architecture (MVC, Pattern Observer, Singleton).

---

🏗️ Architecture technique

AuditMaster/
├── 📄 README.md
├── 📄 LICENSE.txt
├── 📄 project.godot            # Configuration principale du projet
│
├── 📁 Assets/                  # Ressources artistiques
│   ├── 📁 Images/              # Fonds, Logos, Pôles, UI...
│   ├── 📁 Polices/             # Polices (Exo, Ubuntu)
│   ├── 📁 Sons/                # Musiques et bruitages
│   └── 📁 Styles/              # Thèmes et shaders
│ 
├── 📁 Builds/                  # Executables (.exe)
│   ├── 📁 Windows/
│   │   └── 🎮 AuditMaster.exe
│   │   └── 🎮 AuditMaster.msi
│   └── 📁 Linux/
│       └── 🎮 AuditMaster.x86_64
├── 📁 Documentation/           # Documentation générée (Doxygen)
│
├── 📁 Scenes/                  # Scènes (.tscn)
│   ├── 📁 Global/              # Scènes persistantes (ex: SonAmbiant)
│   ├── 📁 Jeu/                 # Scènes de gameplay (Principal, Victoire, Défaite)
│   ├── 📁 Menus/               # Menus (Accueil, Choix persos, Universités...)
│   └── ...
│
└── 📁 Scripts/                 # Code source (.gd)
    ├── 📁 Donnees/             # Données et logique des villes
    │   ├── 📜 VillesDonnees.gd # Classe mère pour les données
    │   ├── 📜 DonneesParis.gd
    │   ├── 📜 DonneesBordeaux.gd
    │   └── ...
    │
    ├── 📁 Global/              # Singletons et gestionnaires
    │   ├── 📜 GestionnaireJeu.gd       # Logique globale (GameManager)
    │   ├── 📜 GestionnaireQuestions.gd # Gestion des QCM
    │   └── 📜 ControleAudio.gd         # Gestion du son
    │
    ├── 📁 Interfaces/          # Scripts UI (Popups, Boutons)
    │   └── ...
    │
    ├── 📁 Jeu/                 # Logique de la boucle de jeu
    │   ├── 📜 ScenePrincipale.gd
    │   ├── 📜 Victoire.gd
    │   └── 📜 Defaite.gd
    │
    ├── 📁 Joueur/              # Données du joueur
    │   └── 📜 StatsJoueur.gd   # Statistiques (Compétence, Vie, etc.)
    │
    └── 📁 Menus/               # Logique des menus
        ├── 📜 EcranAccueil.gd
        ├── 📜 SelectionPersonnage.gd
        └── ...

Technologies utilisées

Technologie	Usage
Godot Engine 4.x	Moteur de jeu
GDScript	Langage de programmation (100%)
Signaux Godot	Communication entre composants

Patterns de conception

• Singleton : PlayerStats pour la gestion globale des données joueur
• L'Observateur (Observer) : Communication événementielle (stats_updated, audit_reussi)
• La Stratégie (Strategy) / Héritage : classes enfants (stratégies concrètes) : DonneesParis.gd, DonneesBordeaux.gd, DonneesMarseille.gd, ...
• Composite : un nœud qui contient des enfants (UI, Carte, Joueur), qui eux-mêmes contiennent des enfants (Sprites, Labels, Boutons)...

---

📜 Licence

Ce projet est distribué sous licence MIT.

MIT License - Copyright (c) 2025 Fork Games

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software. 

Voir le fichier LICENSE.txt pour plus de détails.

---

🙏 Remerciements

• L'équipe Godot - Pour ce moteur de jeu open source extraordinaire
• Nos enseignants - Pour leur accompagnement tout au long du projet
• Les Youtubeurs Godot - Pour leur apprentissage clair et précis sur les bases du moteur

---

Développé avec ❤️ par Fork Games

🐛 Signaler un bug · 💡 Proposer une fonctionnalité