# Les jeux UnikSim — rôle, contenu et navigation de la documentation

## Pourquoi cette page existe

Cette page est une **carte fonctionnelle du produit**. Elle explique ce que chaque jeu simule, ce que l'étudiant y fait et quelles pages de documentation ouvrir en premier. Elle ne remplace pas les pages d'architecture détaillées.

## Les deux grandes familles

```mermaid
flowchart TD
GAME[UnikSim Game] --> YEAR[By Year]
GAME --> MODULE[By Module]
YEAR --> ENT1
YEAR --> HR1
YEAR --> MGT1
YEAR --> MK1
YEAR --> MK2
MODULE --> ACC1
MODULE --> ACC2

```

<table id="bkmrk-famille-logique-prin"><thead><tr><th>Famille</th><th>Logique principale</th><th>Jeux</th></tr></thead><tbody><tr><td>**By Year**</td><td>Les équipes prennent des décisions pendant une année; le moteur génère les résultats; l'état est transporté vers l'année suivante.</td><td>ENT1, HR1, MGT1, MK1, MK2.</td></tr><tr><td>**By Module**</td><td>L'activité est composée de modules configurables avec pages data-driven, Answer Key, Grading et résultats de module.</td><td>ACC1, ACC2.</td></tr></tbody></table>

## ENT1 — entreprise / gestion intégrée

**Contexte :** équipe de direction d'une entreprise qui produit des téléphones intelligents.

**Objectif fonctionnel :** fabriquer et commercialiser des téléphones adaptés aux consommateurs tout en contrôlant les coûts de production.

### Ce que le jeu combine

- marketing et segments;
- développement/lancement de produits;
- usines et capacité de production;
- matières premières;
- ressources humaines;
- financement/cash;
- pays/marchés;
- événements et résultats annuels.

### Où regarder d'abord

- [ENT1 — architecture et logique game-specific](https://wiki.uniksim.com/books/game/page/ent1-architecture-et-logique-game-specific);
- [Décisions et génération des résultats By Year](https://wiki.uniksim.com/books/game/page/decisions-et-generation-des-resultats-by-year);
- [Cycle d'une année](https://wiki.uniksim.com/books/game/page/cycle-dune-annee-calendrier-et-jobs).

**Repère mental :** ENT1 est le jeu By Year le plus transversal : une décision peut traverser marketing → production → RH → finance → ventes.

## MK1 — marketing produit

**Contexte :** entreprise de vêtements.

**Objectif fonctionnel :** faire prospérer l'entreprise en commercialisant des produits adaptés aux consommateurs.

### Concepts importants

- produits;
- lancements;
- segments;
- product score;
- communication score;
- distribution score;
- prix/coûts;
- ventes générées;
- calculator products;
- événements et bots.

### Où regarder d'abord

- [MK1 — architecture et logique game-specific](https://wiki.uniksim.com/books/game/page/mk1-architecture-et-logique-game-specific);
- [Décisions et génération des résultats By Year](https://wiki.uniksim.com/books/game/page/decisions-et-generation-des-resultats-by-year);
- [Bots et simulations asynchrones](https://wiki.uniksim.com/books/game/page/bots-et-simulations-asynchrones-by-year).

**Repère mental :** MK1 est centré sur le mix marketing et la performance comparative des produits/lancements.

## MK2 — marketing avancé / international

**Contexte :** entreprise qui produit des skis.

**Objectif fonctionnel :** commercialiser des produits adaptés aux consommateurs et faire croître l'entreprise.

### Ce qui le distingue de MK1

- pays;
- launch type;
- relaunch;
- stock associé aux lancements;
- redistribution/refund du stock;
- loyalty;
- notoriety;
- rentabilité par lancement/pays.

### Où regarder d'abord

- [MK2 — architecture et logique game-specific](https://wiki.uniksim.com/books/game/page/mk2-architecture-et-logique-game-specific);
- [MK1](https://wiki.uniksim.com/books/game/page/mk1-architecture-et-logique-game-specific) pour comparer les concepts partagés;
- [Décisions et génération des résultats By Year](https://wiki.uniksim.com/books/game/page/decisions-et-generation-des-resultats-by-year).

**Repère mental :** ne pas traiter MK2 comme un simple “MK1 avec d'autres textes”; ses pays, relaunchs, stocks, loyalty et notoriety changent le moteur.

## HR1 — ressources humaines

**Contexte :** département RH d'une entreprise d'organisation et de production de spectacles musicaux.

**Objectif fonctionnel :** contrôler les dépenses RH tout en permettant à l'entreprise de fonctionner et de maximiser ses résultats.

### Concepts importants

- postings;
- embauche;
- dismissals;
- salaires;
- avantages;
- contrats;
- CEO bids;
- retention/belonging;
- segments RH;
- coûts et cash.

### Où regarder d'abord

- [HR1 — architecture et logique game-specific](https://wiki.uniksim.com/books/game/page/hr1-architecture-et-logique-game-specific);
- [Évaluations et rankings By Year](https://wiki.uniksim.com/books/game/page/evaluations-logbook-scenarios-et-rankings-by-year);
- [Commandes serveur / réouverture By Year](https://wiki.uniksim.com/books/game/page/commandes-serveur-reouverture-et-transitions-by-year).

**Repère mental :** beaucoup d'actions HR1 modifient immédiatement le cash avant même la génération annuelle.

## <s>MGT1 — processus de gestion</s> (DEPRECATED)

<s>**Contexte :** équipe de cadres d'une entreprise de création de jeux vidéo.</s>

<s>**Objectif fonctionnel :** appliquer le processus de gestion — planification, organisation, direction et contrôle — afin d'utiliser correctement les ressources financières.</s>

### <s>Concepts importants</s>

- <s>création/lancement de jeux;</s>
- <s>features;</s>
- <s>employés et niveaux;</s>
- <s>allocation du temps de travail;</s>
- <s>social budget;</s>
- <s>remote budget;</s>
- <s>feature ratios;</s>
- <s>énergie;</s>
- <s>discipline;</s>
- <s>bonheur;</s>
- <s>travail requis et complétion.</s>

### <s>Où regarder d'abord</s>

- <s>[MGT1 — architecture et logique game-specific](https://wiki.uniksim.com/books/game/page/mgt1-architecture-et-logique-game-specific);</s>
- <s>[Décisions et génération des résultats By Year](https://wiki.uniksim.com/books/game/page/decisions-et-generation-des-resultats-by-year);</s>
- <s>[UI et prefabs By Year](https://wiki.uniksim.com/books/game/page/ui-et-prefabs-by-year).</s>

<s>**Repère mental :** MGT1 est fortement structuré autour des employés → temps de travail → features → résultat de l'organisation.</s>

## ACC1 — Accounting / entreprise de piscines

**Contexte :** département de comptabilité d'une entreprise spécialisée dans la vente de piscines.

**Objectif fonctionnel :** compléter le cycle comptable à travers des modules pédagogiques.

### Concepts importants

- pièces justificatives / bills;
- journaux auxiliaires et journal général;
- ledger;
- subledgers;
- taxes;
- paie / retenues;
- inventaire;
- immobilisations;
- contrats;
- régularisations;
- états financiers;
- Answer Key et Grading.

### Où regarder d'abord

- [Architecture By Module / Accounting](https://wiki.uniksim.com/books/game/page/architecture-by-module-accounting);
- [Configuration Accounting — guide des JSON](https://wiki.uniksim.com/books/game/page/configuration-accounting-guide-des-json);
- [Contextes Accounting](https://wiki.uniksim.com/books/game/page/contextes-accounting-cycle-heritage-et-donnees-entre-periodes);
- [Pipeline des Bills](https://wiki.uniksim.com/books/game/page/pipeline-des-bills-architecture-et-ajout-dun-nouveau-type).

## ACC2 — Accounting / café et machines à café

**Contexte :** département de comptabilité d'une entreprise spécialisée dans la vente de café et de machines à café.

**Objectif fonctionnel :** comme ACC1, compléter le cycle comptable à travers des modules By Module.

### Différence de haut niveau

ACC2 réutilise le même moteur comptable qu'ACC1, mais son univers de companies/partners/products/services diffère et il contient notamment du contenu **Petite caisse**.

### Où regarder d'abord

- [Accounting 1 vs Accounting 2 — différences réelles](https://wiki.uniksim.com/books/game/page/accounting-1-vs-accounting-2-differences-reelles);
- [Architecture By Module / Accounting](https://wiki.uniksim.com/books/game/page/architecture-by-module-accounting);
- [Contextes Accounting](https://wiki.uniksim.com/books/game/page/contextes-accounting-cycle-heritage-et-donnees-entre-periodes);
- [UI data-driven By Module](https://wiki.uniksim.com/books/game/page/ui-data-driven-pages-tables-et-prefabs-by-module).

## Pages Commun à connaître peu importe le jeu

<table id="bkmrk-si-tu-touches...-lir"><thead><tr><th>Si tu touches...</th><th>Lire...</th></tr></thead><tbody><tr><td>Login / navigation / changement d'état</td><td>[Machine d'état client](https://wiki.uniksim.com/books/game/page/machine-detat-client-login-chargement-et-navigation).</td></tr><tr><td>Nouvelle commande serveur</td><td>[Backend Unity ↔ BrainCloud](https://wiki.uniksim.com/books/game/page/backend-unity-braincloud).</td></tr><tr><td>Custom Entity / persistance</td><td>[Documents et persistance BrainCloud](https://wiki.uniksim.com/books/game/page/commandes-documents-et-persistance-braincloud).</td></tr><tr><td>Synchronisation live</td><td>[RTT, messages et synchronisation](https://wiki.uniksim.com/books/game/page/rtt-messages-et-synchronisation).</td></tr><tr><td>Static data</td><td>[Données statiques et import/export](https://wiki.uniksim.com/books/game/page/donnees-statiques-et-pipeline-importexport).</td></tr><tr><td>Textes</td><td>[Textes, localisation et mise à jour](https://wiki.uniksim.com/books/game/page/textes-localisation-et-mise-a-jour).</td></tr><tr><td>Tutoriel</td><td>[Tutoriels — création de A à Z](https://wiki.uniksim.com/books/game/page/tutoriels-creation-de-a-a-z-et-architecture).</td></tr><tr><td>Scenario</td><td>[Scénarios runtime](https://wiki.uniksim.com/books/game/page/scenarios-runtime-configuration-reponses-et-evaluation).</td></tr><tr><td>Animation Timeline</td><td>[Timelines Unity](https://wiki.uniksim.com/books/game/page/timelines-unity-architecture-et-creation-de-sequences).</td></tr><tr><td>Build / déploiement</td><td>[Build Unity, WebGL et versioning client](https://wiki.uniksim.com/books/game/page/build-unity-webgl-et-versioning-client).</td></tr><tr><td>Test serveur</td><td>[Tests automatisés des Server Scripts](https://wiki.uniksim.com/books/game/page/tests-automatises-des-server-scripts).</td></tr><tr><td>Debug serveur</td><td>[Debug local des Server Scripts BrainCloud](https://wiki.uniksim.com/books/game/page/debug-local-des-server-scripts-braincloud).</td></tr></tbody></table>

## Comment choisir où chercher quand un bug arrive

1. **Le bug existe dans plusieurs jeux ?** Commencer par Commun ou le framework By Year/By Module.
2. **Il existe dans ACC1 et ACC2 ?** Commencer par By Module / `acc_base`, pas les dossiers game-specific.
3. **Il existe seulement dans un GameUid ?** Regarder static data, GameSpecific Unity et utils serveur du jeu.
4. **La donnée est bonne après reload mais pas live ?** Regarder RTT/controller.
5. **La donnée est fausse même après reload ?** Regarder commande/persistance/génération.
6. **Le calcul serveur est bon mais l'écran faux ?** Regarder modèle Unity/UI.

## Structure documentaire recommandée pour naviguer

Pour une feature inconnue, lire dans cet ordre :

1. cette page pour identifier le jeu et le domaine;
2. la page d'architecture de la famille (**By Year** ou **By Module**);
3. la page game-specific si By Year, ou la page domaine Accounting si ACC;
4. la page workflow spécialisée : bills, contextes, Answer Key, grading, RTT, tutoriels, Scenario, Timeline, build, etc.