# sorayahossain/data-driven-kotte architecture

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

- Interactive diagram: https://gitdiagram.com/sorayahossain/data-driven-kotte
- Repository: https://github.com/sorayahossain/data-driven-kotte

## Overview

This repository is a C++ Bomberman-style game built on the shared Kotte foundations. Its central runtime is Application: it manages entities and gameplay, including movement, bombs, blast effects, enemies, and rendering. The available excerpts show entity creation and destruction, spatial queries, and render-command execution, but do not expose all frame-phase calls. The README is an unfilled submission template, so controls, win/loss rules, and extensions cannot be confirmed; the graph focuses on capabilities evidenced by the source.

Main entry points: [`kotte/src/application.cpp`](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/application.cpp) (Game application), [`kotte/src/spatial_grid.cpp`](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/spatial_grid.cpp) (Spatial grid), [`kotte/src/renderer.cpp`](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/renderer.cpp) (Renderer), [`kotte/src/window.cpp`](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/window.cpp) (Window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game runtime"]
  node_application["Game application<br/>[application.cpp]"]
  node_gameplay["Gameplay simulation<br/>[application.cpp]"]
  node_bombs["Bombs and blasts<br/>[application.cpp]"]
  node_enemies["Enemy movement<br/>[application.cpp]"]
end

subgraph group_world["World and entities"]
  node_entity_store[("Entity store<br/>[entity_store.cpp]")]
  node_entity_model["Entity model<br/>[entity.hpp]"]
  node_spatial_grid["Spatial grid<br/>[spatial_grid.cpp]"]
  node_tile_map[("Tile map<br/>[tile_map.cpp]")]
  node_random["Random generator<br/>[random.hpp]"]
end

subgraph group_presentation["Presentation"]
  node_camera["Camera<br/>[camera.cpp]"]
  node_renderer["Renderer<br/>[renderer.cpp]"]
end

subgraph group_platform["Platform"]
  node_window["Window<br/>[window.cpp]"]
end

node_player(("Player"))
node_raylib["raylib"]

node_application -->|"creates entities"| node_entity_store
node_application -->|"destroys entities"| node_entity_store
node_application -->|"inserts entities"| node_spatial_grid
node_application -->|"queries contacts"| node_spatial_grid
node_application -->|"queries visibility"| node_spatial_grid
node_application -->|"sorts and executes"| node_renderer
node_application -->|"constructs entities"| node_entity_model
node_application -->|"updates gameplay"| node_gameplay
node_application -->|"resolves detonations"| node_bombs
node_application -->|"moves enemies"| node_enemies
node_application -.->|"uses map"| node_tile_map
node_application -->|"chooses headings"| node_random
node_application -.->|"updates camera"| node_camera
node_application -.->|"checks close state"| node_window
node_application -.->|"draws via"| node_raylib
node_window -->|"opens window"| node_raylib
node_renderer -->|"executes drawing"| node_raylib

click node_application "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/application.cpp"
click node_gameplay "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/application.cpp"
click node_bombs "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/application.cpp"
click node_enemies "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/application.cpp"
click node_entity_store "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/entity_store.cpp"
click node_entity_model "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/include/kotte/entity.hpp"
click node_spatial_grid "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/spatial_grid.cpp"
click node_tile_map "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/tile_map.cpp"
click node_random "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/include/kotte/random.hpp"
click node_camera "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/camera.cpp"
click node_renderer "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/renderer.cpp"
click node_window "https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/window.cpp"

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_application,node_gameplay,node_bombs,node_enemies toneBlue
class node_entity_store,node_entity_model,node_spatial_grid,node_tile_map,node_random toneAmber
class node_camera,node_renderer toneMint
class node_window toneRose
class node_player,node_raylib toneIndigo
```

## Components

### Game runtime

- [Game application](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/application.cpp): `kotte/src/application.cpp`
- [Gameplay simulation](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/application.cpp): `kotte/src/application.cpp`
- [Bombs and blasts](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/application.cpp): `kotte/src/application.cpp`
- [Enemy movement](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/application.cpp): `kotte/src/application.cpp`

### World and entities

- [Entity store](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/entity_store.cpp): `kotte/src/entity_store.cpp`
- [Entity model](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/include/kotte/entity.hpp): `kotte/include/kotte/entity.hpp`
- [Spatial grid](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/spatial_grid.cpp): `kotte/src/spatial_grid.cpp`
- [Tile map](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/tile_map.cpp): `kotte/src/tile_map.cpp`
- [Random generator](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/include/kotte/random.hpp): `kotte/include/kotte/random.hpp`

### Presentation

- [Camera](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/camera.cpp): `kotte/src/camera.cpp`
- [Renderer](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/renderer.cpp): `kotte/src/renderer.cpp`

### Platform

- [Window](https://github.com/sorayahossain/data-driven-kotte/blob/main/kotte/src/window.cpp): `kotte/src/window.cpp`

### Other components

- **Player**
- **raylib**

## Connections

- Game application → Entity store: creates entities (evidence: `kotte/src/application.cpp`)
- Game application → Entity store: destroys entities (evidence: `kotte/src/application.cpp`)
- Game application → Spatial grid: inserts entities (evidence: `kotte/src/application.cpp`)
- Game application → Spatial grid: queries contacts (evidence: `kotte/src/application.cpp`)
- Game application → Spatial grid: queries visibility (evidence: `kotte/src/application.cpp`)
- Game application → Renderer: sorts and executes (evidence: `kotte/src/application.cpp`)
- Game application → Entity model: constructs entities (evidence: `kotte/src/application.cpp`)
- Game application → Gameplay simulation: updates gameplay (evidence: `kotte/src/application.cpp`)
- Game application → Bombs and blasts: resolves detonations (evidence: `kotte/src/application.cpp`)
- Game application → Enemy movement: moves enemies (evidence: `kotte/src/application.cpp`)
- Game application → Tile map: uses map
- Game application → Random generator: chooses headings (evidence: `kotte/src/application.cpp`)
- Game application → Camera: updates camera
- Game application → Window: checks close state
- Game application → raylib: draws via
- Window → raylib: opens window (evidence: `kotte/src/window.cpp`)
- Renderer → raylib: executes drawing (evidence: `kotte/src/renderer.cpp`)
