# m-khallouf/stage-level-game architecture

> Architecture diagram of the GitHub repository m-khallouf/stage-level-game, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/m-khallouf/stage-level-game
- Repository: https://github.com/m-khallouf/stage-level-game

## Overview

##### Project type and purpose
- This is a stand-alone 2D platformer game built in C# on top of the MonoGame framework.
- The player moves, jumps, collects a key, opens a door, and advances through levels.

##### File structure
- Top-level solution: Project1.sln, azure-pipelines.yml, README.md
- Two projects underneath Project1.sln:
- Project1 (the game):
– .config (dotnet tools)
– Content (mgcb file + sprite fonts)
– Entities (game objects & CollisionManager)
– Levels (ILevel + concrete stages)
– Core classes: Program.cs, GameManager.cs, InputManager.cs, ScreenManager.cs, LevelManager.cs
- UnitTest: tests for InputManager, GameManager, etc.
- Build & CI: azure-pipelines.yml

##### Extract architectural insights from the README
- MonoGame Game class is extended by GameManager (central game loop).
- InputManager is event-driven: publishes input events.
- ScreenManager listens to InputManager, switches between UI screens & level screens.
- LevelManager renders level-selection screen and spawns levels.
- Entities (Player, Lava, Key, Door, Heart, Obstacle, etc.) encapsulate game objects and their logic.
- CollisionManager handles physics interactions.
- Content Pipeline (Content.mgcb) loads textures, fonts, sprites.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Framework Layer"
        MG["MonoGame Framework"]:::external
        DOTNET[".NET Runtime"]:::external
    end

    subgraph "Engine Layer"
        PR["Entry Point\n(Program)"]:::core
        GM["Game Loop\n(GameManager)"]:::core
        IM["Input Layer\n(InputManager)"]:::input
        SM["Screen Manager\n(ScreenManager)"]:::core
    end

    subgraph "Domain Layer"
        subgraph "UI Screens"
            MM["Main Menu"]:::ui
            GO["Game Over Screen"]:::ui
            PA["Pause Screen"]:::ui
            LC["Level Complete Screen"]:::ui
        end
        LM["Level Manager"]:::core
        I_LEVEL["Level Contract\n(ILevel)"]:::domain
        LEVELS["Concrete Levels\n(First/Second/Third)"]:::domain
        ENTITIES["Entities"]:::entities
        CM["Collision Manager"]:::entities
        HM["Health Manager"]:::entities
    end

    subgraph "Infrastructure Layer"
        CP["Content Pipeline\n(Content.mgcb + assets)"]:::infra
        SB["SpriteBatch\n(Rendering)"]:::infra
    end

    subgraph "Support"
        UT["UnitTest Project"]:::support
        CI["Azure Pipelines"]:::support
    end

    MG -->|"initializes"| GM
    DOTNET -->|"hosts"| GM

    GM -->|"calls Initialize/Update/Draw"| IM
    GM -->|"delegates Update/Draw"| SM
    GM -->|"renders via"| SB
    GM -->|"loads assets from"| CP

    IM -->|"publishes events"| SM
    IM -->|"publishes events"| ENTITIES

    SM -->|"manages screen"| MM
    SM -->|"manages screen"| GO
    SM -->|"manages screen"| PA
    SM -->|"manages screen"| LC
    SM -->|"manages screen"| LM

    LM -->|"spawns"| I_LEVEL
    I_LEVEL -->|"implemented by"| LEVELS
    LEVELS -->|"populates"| ENTITIES

    ENTITIES -->|"uses"| CM
    ENTITIES -->|"uses"| HM

    UT -->|"tests"| IM
    UT -->|"tests"| GM
    CI -->|"runs build & tests"| UT
    CI -->|"triggers on push"| GM

    click GM "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/GameManager.cs"
    click PR "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/Program.cs"
    click IM "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/InputManager.cs"
    click SM "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/ScreenManager.cs"
    click MM "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/MainMenu.cs"
    click LM "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/LevelManager.cs"
    click GO "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/Entities/GameOverScreen.cs"
    click PA "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/Entities/PausedScreen.cs"
    click LC "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/Entities/LevelCompleteScreen.cs"
    click I_LEVEL "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/Levels/ILevel.cs"
    click LEVELS "https://github.com/m-khallouf/stage-level-game/tree/master/Project1/Project1/Levels"
    click ENTITIES "https://github.com/m-khallouf/stage-level-game/tree/master/Project1/Project1/Entities"
    click CM "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/Entities/CollisionManager.cs"
    click HM "https://github.com/m-khallouf/stage-level-game/blob/master/Project1/Project1/Entities/HealthManager.cs"
    click CP "https://github.com/m-khallouf/stage-level-game/tree/master/Project1/Project1/Content"
    click UT "https://github.com/m-khallouf/stage-level-game/tree/master/Project1/UnitTest"
    click CI "https://github.com/m-khallouf/stage-level-game/blob/master/azure-pipelines.yml"

    classDef core fill:#d0e1f9,stroke:#333,stroke-width:1px
    classDef input fill:#f9d0c4,stroke:#333
    classDef ui fill:#b3cde0,stroke:#333
    classDef domain fill:#c7e9c0,stroke:#333
    classDef entities fill:#a1d99b,stroke:#333
    classDef external fill:#cccccc,stroke:#333
    classDef infra fill:#f2f0f7,stroke:#333
    classDef support stroke-dasharray:5 5,fill:#fff
```
