Skip to main content

Vue d’ensemble du Game

Rôle de cette page

Cette page est la carte d'entrée du projet Game. La documentation suit les frontières réelles du code : Commun, By Module et By Year.

flowchart TD
GAME[Unity Game] --> COM[Commun]
GAME --> BM[By Module]
GAME --> BY[By Year]
COM --> CORE[Bootstrap / Controllers / UI]
COM --> BC[BrainCloud / Documents / RTT]
COM --> PIPE[Static Data / Textes / Build]
BM --> ACC[Accounting: acc_base + acc1 + acc2]
BY --> GAMES[ENT1 / HR1 / MGT1 / MK1 / MK2]

Comment choisir le bon chapitre

Chapitre Responsabilité Exemples Commun Tout ce qui est partagé entre familles ou structure le runtime général. Game.cs, Factory, controllers, state machine, backend, Custom Entities, RTT, textes, build. By Module Framework de modules/pages et domaine Accounting. teamsModules, Module Type Data, bills, inventory, answer key, grading, acc1/acc2. By Year Framework d'années/décisions et implémentations des jeux annuels. cycle annuel, jobs, génération résultats, bots, ENT1/HR1/MGT1/MK1/MK2.

Architecture globale

sequenceDiagram
actor User as Utilisateur
participant Game as Unity Game
participant Factory as Factory
participant Ctrl as Controllers
participant BE as BackEndBrainCloud
participant CS as Cloud Scripts
participant DB as Custom Entities
participant RTT as BrainCloud RTT
User->>Game: lance / interagit
Game->>Factory: crée classes selon GameUid + SimType
Factory-->>Ctrl: modèles/controllers concrets
Ctrl->>BE: opération métier
BE->>CS: RunScript
CS->>DB: read / update / save
CS->>RTT: message si synchronisation nécessaire
CS-->>BE: response
RTT-->>BE: changement distant
BE-->>Ctrl: MessageData / ServerMessage
Ctrl-->>Game: modèle + UI mis à jour

Points d'entrée Unity

  • Assets/Src/Game/Game.cs — bootstrap, environnement, services globaux, GameUid et SimType.
  • Assets/Src/Game/Factory.cs — composition des classes concrètes.
  • Assets/Src/Game/GameStates/ — login, chargement et navigation professeur/étudiant.
  • Assets/Src/Game/Controllers/ — modèles runtime, caches et listeners.
  • Assets/Src/Game/Data/ — données sérialisées communes, By Module et By Year.
  • Assets/Src/Game/BackEnd/ — contrat backend et implémentation BrainCloud.
  • Assets/Src/UI/ — UI commune et spécialisations.
  • Assets/GameSpecific/ — code, Resources et prefabs propres à chaque jeu.

Points d'entrée Node / BrainCloud

  • backend/braincloud/server_scripts/_command/ — Cloud Scripts communs appelables.
  • backend/braincloud/server_scripts/_utils/ — documents, messages, eval, rankings et logique partagée.
  • .../_utils/by_module/ — moteurs By Module.
  • .../acc_base, acc1, acc2 — Accounting.
  • .../ent1, hr1, mgt1, mk1, mk2 — moteurs By Year game-specific.
  • node.js/exports/ — Google Sheets → JSON → BrainCloud et pipeline des textes.
  • backend/braincloud/debugging/ — exécution locale des Server Scripts.
  • backend/braincloud/tests/ — tests automatisés.

Méthode pour tracer une feature

  1. Identifier le contrôle UI et le controller Unity.
  2. Trouver la méthode correspondante dans BackEndBase/BackEndBrainCloud.
  3. Identifier le Cloud Script commun ou game-specific réellement appelé.
  4. Suivre ses bridge.include().
  5. Identifier chaque document lu ou sauvegardé.
  6. Identifier le message RTT envoyé.
  7. Retrouver le listener Unity qui consomme ce message.
  8. Si la donnée est générée/configurée, remonter aussi au JSON/Google Sheet source.

Ordre de lecture conseillé

Pour prendre le projet en main : Bootstrap → Machine d'état → Controllers → Simulations/activités/équipes → Backend Unity ↔ BrainCloud → Documents/RTT, puis entrer dans By Module ou By Year.

Carte fonctionnelle des jeux

Pour comprendre rapidement le rôle de chaque simulation avant d’entrer dans le code, voir Les jeux UnikSim — rôle, contenu et navigation de la documentation. Cette page résume ENT1, HR1, MGT1, MK1, MK2, ACC1 et ACC2 et indique quelles pages techniques ouvrir ensuite.

Back to top