# ivensarj/jogo-infor architecture

> Architecture diagram of the GitHub repository ivensarj/jogo-infor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ivensarj/jogo-infor
- Repository: https://github.com/ivensarj/jogo-infor

## Overview

This repository is a Godot 4 2D platform game about Black history, culture, and representation. A player enters through the menus, explores levels using platforming mechanics, and is intended to encounter interactive objects, puzzles, and narrative; progress can be saved. The graph preserves documented gameplay systems and major supporting capabilities. The README supports the broad feature map, but sampled source covers only an unrelated web carousel, so most internal runtime connections are left unverified rather than inferred.

Main entry points: [`gameplay/player/player.gd`](https://github.com/ivensarj/jogo-infor/blob/main/gameplay/player/player.gd) (Platform Player), [`systems/interaction`](https://github.com/ivensarj/jogo-infor/tree/main/systems/interaction) (Interactions), [`ui/main_menu/main_menu.gd`](https://github.com/ivensarj/jogo-infor/blob/main/ui/main_menu/main_menu.gd) (Main Menu), [`scenes/levels`](https://github.com/ivensarj/jogo-infor/tree/main/scenes/levels) (Game Levels)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Player and Levels"]
  node_player["Platform Player<br/>[player.gd]"]
  node_camera["Dynamic Camera<br/>[camera.gd]"]
  node_levels["Game Levels"]
end

subgraph group_world["World Systems"]
  node_interactions["Interactions"]
  node_objects["World Objects"]
  node_puzzles["Sequence Puzzles<br/>[sequence_puzzle.gd]"]
  node_npc["NPCs<br/>[npc.gd]"]
end

subgraph group_shared["Shared Systems"]
  node_dialogue["Dialogue System"]
  node_progress["Game State<br/>[game_state.gd]"]
  node_save[("Save System<br/>[save_manager.gd]")]
  node_audio["Configurable Audio<br/>[audio_manager.gd]"]
  node_input["Input Devices"]
end

subgraph group_interface["Player Interface"]
  node_mainmenu["Main Menu<br/>[main_menu.gd]"]
  node_pause["Pause Menu<br/>[pause_menu.tscn]"]
  node_dialogueui["Dialogue UI<br/>[dialogue_ui.gd]"]
  node_prompt["Interaction Prompt"]
  node_audio_ui["Audio Settings<br/>[audio_settings.gd]"]
end

node_player_actor(("Player"))

node_player_actor -.->|"enters game"| node_mainmenu
node_player_actor -.->|"controls"| node_player
node_player -.->|"explores"| node_levels
node_mainmenu -.->|"starts play"| node_levels
node_pause -.->|"pauses play"| node_player
node_interactions -.->|"enables interaction"| node_objects
node_interactions -.->|"supports puzzles"| node_puzzles
node_npc -.->|"offers dialogue"| node_dialogue
node_progress -.->|"persists progress"| node_save
node_audio_ui -.->|"configures volumes"| node_audio
node_player -.->|"camera follows"| node_camera

click node_player "https://github.com/ivensarj/jogo-infor/blob/main/gameplay/player/player.gd"
click node_camera "https://github.com/ivensarj/jogo-infor/blob/main/gameplay/camera/camera.gd"
click node_levels "https://github.com/ivensarj/jogo-infor/tree/main/scenes/levels"
click node_interactions "https://github.com/ivensarj/jogo-infor/tree/main/systems/interaction"
click node_objects "https://github.com/ivensarj/jogo-infor/tree/main/gameplay/objects"
click node_puzzles "https://github.com/ivensarj/jogo-infor/blob/main/gameplay/objects/sequence_puzzle/sequence_puzzle.gd"
click node_npc "https://github.com/ivensarj/jogo-infor/blob/main/gameplay/npc/npc.gd"
click node_dialogue "https://github.com/ivensarj/jogo-infor/blob/main/systems/dialogue/dialogue_manager.gd"
click node_progress "https://github.com/ivensarj/jogo-infor/blob/main/systems/progress/game_state.gd"
click node_save "https://github.com/ivensarj/jogo-infor/blob/main/systems/save/save_manager.gd"
click node_audio "https://github.com/ivensarj/jogo-infor/blob/main/systems/audio/audio_manager.gd"
click node_input "https://github.com/ivensarj/jogo-infor/blob/main/systems/input/input_device_manager.gd"
click node_mainmenu "https://github.com/ivensarj/jogo-infor/blob/main/ui/main_menu/main_menu.gd"
click node_pause "https://github.com/ivensarj/jogo-infor/blob/main/systems/pause_menu.tscn"
click node_dialogueui "https://github.com/ivensarj/jogo-infor/blob/main/ui/dialogue/dialogue_ui.gd"
click node_prompt "https://github.com/ivensarj/jogo-infor/blob/main/ui/interaction_prompt/interaction_prompt.gd"
click node_audio_ui "https://github.com/ivensarj/jogo-infor/blob/main/ui/audio_settings/audio_settings.gd"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_player,node_camera,node_levels toneBlue
class node_interactions,node_objects,node_puzzles,node_npc toneAmber
class node_dialogue,node_progress,node_save,node_audio,node_input toneMint
class node_mainmenu,node_pause,node_dialogueui,node_prompt,node_audio_ui toneRose
class node_player_actor toneIndigo
```

## Components

### Player and Levels

- [Platform Player](https://github.com/ivensarj/jogo-infor/blob/main/gameplay/player/player.gd): `gameplay/player/player.gd`
- [Dynamic Camera](https://github.com/ivensarj/jogo-infor/blob/main/gameplay/camera/camera.gd): `gameplay/camera/camera.gd`
- [Game Levels](https://github.com/ivensarj/jogo-infor/tree/main/scenes/levels): `scenes/levels`

### World Systems

- [Interactions](https://github.com/ivensarj/jogo-infor/tree/main/systems/interaction): `systems/interaction`
- [World Objects](https://github.com/ivensarj/jogo-infor/tree/main/gameplay/objects): `gameplay/objects`
- [Sequence Puzzles](https://github.com/ivensarj/jogo-infor/blob/main/gameplay/objects/sequence_puzzle/sequence_puzzle.gd): `gameplay/objects/sequence_puzzle/sequence_puzzle.gd`
- [NPCs](https://github.com/ivensarj/jogo-infor/blob/main/gameplay/npc/npc.gd): `gameplay/npc/npc.gd`

### Shared Systems

- [Dialogue System](https://github.com/ivensarj/jogo-infor/blob/main/systems/dialogue/dialogue_manager.gd): `systems/dialogue/dialogue_manager.gd`
- [Game State](https://github.com/ivensarj/jogo-infor/blob/main/systems/progress/game_state.gd): `systems/progress/game_state.gd`
- [Save System](https://github.com/ivensarj/jogo-infor/blob/main/systems/save/save_manager.gd): `systems/save/save_manager.gd`
- [Configurable Audio](https://github.com/ivensarj/jogo-infor/blob/main/systems/audio/audio_manager.gd): `systems/audio/audio_manager.gd`
- [Input Devices](https://github.com/ivensarj/jogo-infor/blob/main/systems/input/input_device_manager.gd): `systems/input/input_device_manager.gd`

### Player Interface

- [Main Menu](https://github.com/ivensarj/jogo-infor/blob/main/ui/main_menu/main_menu.gd): `ui/main_menu/main_menu.gd`
- [Pause Menu](https://github.com/ivensarj/jogo-infor/blob/main/systems/pause_menu.tscn): `systems/pause_menu.tscn`
- [Dialogue UI](https://github.com/ivensarj/jogo-infor/blob/main/ui/dialogue/dialogue_ui.gd): `ui/dialogue/dialogue_ui.gd`
- [Interaction Prompt](https://github.com/ivensarj/jogo-infor/blob/main/ui/interaction_prompt/interaction_prompt.gd): `ui/interaction_prompt/interaction_prompt.gd`
- [Audio Settings](https://github.com/ivensarj/jogo-infor/blob/main/ui/audio_settings/audio_settings.gd): `ui/audio_settings/audio_settings.gd`

### Other components

- **Player**

## Connections

- Player → Main Menu: enters game
- Player → Platform Player: controls
- Platform Player → Game Levels: explores
- Main Menu → Game Levels: starts play
- Pause Menu → Platform Player: pauses play
- Interactions → World Objects: enables interaction
- Interactions → Sequence Puzzles: supports puzzles
- NPCs → Dialogue System: offers dialogue
- Game State → Save System: persists progress
- Audio Settings → Configurable Audio: configures volumes
- Platform Player → Dynamic Camera: camera follows
