# nico-lrm/3d-solar-system architecture

> Architecture diagram of the GitHub repository nico-lrm/3d-solar-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nico-lrm/3d-solar-system
- Repository: https://github.com/nico-lrm/3d-solar-system

## Overview

This is a C++20/OpenGL solar-system visualizer. The principal workflow is application startup and frame orchestration: load shaders, textures and models, initialize a scene, process input, update scene systems, and render through an OpenGL window. The graph preserves the scene/ECS and camera, asset-management, rendering, UI and input, and window layers. Several implementation files were not sampled; uncertain links are omitted or marked dashed rather than inferred from filenames.

Main entry points: [`src/Core/Application.hpp`](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Core/Application.hpp) (Application loop), [`src/Render/Renderer.hpp`](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/Renderer.hpp) (Renderer), [`src/Manager/AssetsManager.hpp`](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Manager/AssetsManager.hpp) (Asset manager), [`src/Scene/Scene.hpp`](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Scene/Scene.hpp) (Scene and camera)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["Program entry<br/>[main.cpp]"]
  node_application["Application loop<br/>[Application.hpp]"]
  node_window["OpenGL window<br/>[Window.hpp]"]
end

subgraph group_assets["Assets"]
  node_asset_loader["Asset loader<br/>[AssetsLoader.hpp]"]
  node_asset_manager["Asset manager<br/>[AssetsManager.hpp]"]
  node_model_manager["Model manager<br/>[ModelManager.hpp]"]
  node_shader_manager["Shader manager<br/>[ShaderManager.hpp]"]
  node_texture_manager["Texture manager<br/>[TextureManager.hpp]"]
end

subgraph group_world["Scene and ECS"]
  node_scene["Scene and camera<br/>[Scene.hpp]"]
  node_ecs["Entity components"]
  node_entities["Entity manager<br/>[EntityManager.hpp]"]
  node_systems["Scene systems<br/>[SystemManager.hpp]"]
end

subgraph group_graphics["Rendering"]
  node_renderer["Renderer<br/>[Renderer.hpp]"]
  node_render_targets["Render targets<br/>[RenderTarget.hpp]"]
  node_orbit_renderer["Orbit renderer<br/>[OrbitRenderer.hpp]"]
  node_skybox["Skybox<br/>[Skybox.hpp]"]
  node_mesh["Mesh and model<br/>[Mesh.hpp]"]
  node_shader_storage["Shader storage<br/>[ShaderStorage.hpp]"]
end

subgraph group_interaction["Interaction"]
  node_input["Input handler<br/>[InputHandler.hpp]"]
  node_ui["User interface<br/>[UserInterface.hpp]"]
  node_logging["Console logging<br/>[ConsoleLog.hpp]"]
end

node_user(("User"))

node_user -->|"provides input"| node_input
node_entry -->|"starts"| node_application
node_application -->|"owns"| node_window
node_application -->|"owns"| node_asset_loader
node_application -->|"owns"| node_asset_manager
node_application -->|"owns"| node_scene
node_application -->|"owns"| node_renderer
node_application -->|"owns"| node_input
node_application -->|"owns"| node_ui
node_application -->|"owns"| node_logging
node_application -.->|"loads through"| node_asset_manager
node_asset_loader -.->|"supplies loaded assets"| node_asset_manager
node_asset_manager -->|"delegates models"| node_model_manager
node_asset_manager -->|"delegates shaders"| node_shader_manager
node_asset_manager -->|"delegates textures"| node_texture_manager
node_model_manager -->|"manages models"| node_mesh
node_scene -->|"inherits"| node_ecs
node_scene -.->|"updates systems"| node_systems
node_ecs -->|"uses entity manager"| node_entities
node_systems -.->|"updates scene"| node_scene
node_renderer -->|"renders scene"| node_scene
node_renderer -->|"uses window"| node_window
node_renderer -->|"uses targets"| node_render_targets
node_renderer -->|"uses orbit renderer"| node_orbit_renderer
node_renderer -->|"uses skybox"| node_skybox
node_shader_storage -.->|"binds shader"| node_shader_manager
node_input -->|"controls camera"| node_scene
node_input -->|"reads events"| node_window
node_input -->|"forwards input"| node_ui

click node_entry "https://github.com/nico-lrm/3d-solar-system/blob/main/src/main.cpp"
click node_application "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Core/Application.hpp"
click node_window "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Window/Window.hpp"
click node_asset_loader "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Loader/AssetsLoader.hpp"
click node_asset_manager "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Manager/AssetsManager.hpp"
click node_model_manager "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Manager/ModelManager.hpp"
click node_shader_manager "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Manager/ShaderManager.hpp"
click node_texture_manager "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Manager/TextureManager.hpp"
click node_scene "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Scene/Scene.hpp"
click node_ecs "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Scene/ECS/Component/ComponentManager.hpp"
click node_entities "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Scene/ECS/Entity/EntityManager.hpp"
click node_systems "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Scene/ECS/System/SystemManager.hpp"
click node_renderer "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/Renderer.hpp"
click node_render_targets "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/RenderTarget.hpp"
click node_orbit_renderer "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/OrbitRenderer.hpp"
click node_skybox "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/Skybox.hpp"
click node_mesh "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/Mesh.hpp"
click node_shader_storage "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/ShaderStorage.hpp"
click node_input "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Input/InputHandler.hpp"
click node_ui "https://github.com/nico-lrm/3d-solar-system/blob/main/src/UI/UserInterface.hpp"
click node_logging "https://github.com/nico-lrm/3d-solar-system/blob/main/src/Debug/ConsoleLog.hpp"

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_entry,node_application,node_window,node_user toneBlue
class node_asset_loader,node_asset_manager,node_model_manager,node_shader_manager,node_texture_manager toneAmber
class node_scene,node_ecs,node_entities,node_systems toneMint
class node_renderer,node_render_targets,node_orbit_renderer,node_skybox,node_mesh,node_shader_storage toneRose
class node_input,node_ui,node_logging toneIndigo
```

## Components

### Application

- [Program entry](https://github.com/nico-lrm/3d-solar-system/blob/main/src/main.cpp): `src/main.cpp`
- [Application loop](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Core/Application.hpp): `src/Core/Application.hpp`
- [OpenGL window](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Window/Window.hpp): `src/Window/Window.hpp`

### Assets

- [Asset loader](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Loader/AssetsLoader.hpp): `src/Loader/AssetsLoader.hpp`
- [Asset manager](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Manager/AssetsManager.hpp): `src/Manager/AssetsManager.hpp`
- [Model manager](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Manager/ModelManager.hpp): `src/Manager/ModelManager.hpp`
- [Shader manager](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Manager/ShaderManager.hpp): `src/Manager/ShaderManager.hpp`
- [Texture manager](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Manager/TextureManager.hpp): `src/Manager/TextureManager.hpp`

### Scene and ECS

- [Scene and camera](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Scene/Scene.hpp): `src/Scene/Scene.hpp`
- [Entity components](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Scene/ECS/Component/ComponentManager.hpp): `src/Scene/ECS/Component/ComponentManager.hpp`
- [Entity manager](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Scene/ECS/Entity/EntityManager.hpp): `src/Scene/ECS/Entity/EntityManager.hpp`
- [Scene systems](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Scene/ECS/System/SystemManager.hpp): `src/Scene/ECS/System/SystemManager.hpp`

### Rendering

- [Renderer](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/Renderer.hpp): `src/Render/Renderer.hpp`
- [Render targets](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/RenderTarget.hpp): `src/Render/RenderTarget.hpp`
- [Orbit renderer](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/OrbitRenderer.hpp): `src/Render/OrbitRenderer.hpp`
- [Skybox](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/Skybox.hpp): `src/Render/Skybox.hpp`
- [Mesh and model](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/Mesh.hpp): `src/Render/Mesh.hpp`
- [Shader storage](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Render/ShaderStorage.hpp): `src/Render/ShaderStorage.hpp`

### Interaction

- [Input handler](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Input/InputHandler.hpp): `src/Input/InputHandler.hpp`
- [User interface](https://github.com/nico-lrm/3d-solar-system/blob/main/src/UI/UserInterface.hpp): `src/UI/UserInterface.hpp`
- [Console logging](https://github.com/nico-lrm/3d-solar-system/blob/main/src/Debug/ConsoleLog.hpp): `src/Debug/ConsoleLog.hpp`

### Other components

- **User**

## Connections

- User → Input handler: provides input (evidence: `src/Input/InputHandler.hpp`)
- Program entry → Application loop: starts (evidence: `src/main.cpp`)
- Application loop → OpenGL window: owns (evidence: `src/Core/Application.hpp`)
- Application loop → Asset loader: owns (evidence: `src/Core/Application.hpp`)
- Application loop → Asset manager: owns (evidence: `src/Core/Application.hpp`)
- Application loop → Scene and camera: owns (evidence: `src/Core/Application.hpp`)
- Application loop → Renderer: owns (evidence: `src/Core/Application.hpp`)
- Application loop → Input handler: owns (evidence: `src/Core/Application.hpp`)
- Application loop → User interface: owns (evidence: `src/Core/Application.hpp`)
- Application loop → Console logging: owns (evidence: `src/Core/Application.hpp`)
- Application loop → Asset manager: loads through (evidence: `src/Core/Application.hpp`)
- Asset loader → Asset manager: supplies loaded assets
- Asset manager → Model manager: delegates models (evidence: `src/Manager/AssetsManager.hpp`)
- Asset manager → Shader manager: delegates shaders (evidence: `src/Manager/AssetsManager.hpp`)
- Asset manager → Texture manager: delegates textures (evidence: `src/Manager/AssetsManager.hpp`)
- Model manager → Mesh and model: manages models (evidence: `src/Manager/ModelManager.hpp`)
- Scene and camera → Entity components: inherits (evidence: `src/Scene/Scene.hpp`)
- Scene and camera → Scene systems: updates systems
- Entity components → Entity manager: uses entity manager (evidence: `src/Scene/ECS/Component/ComponentManager.hpp`)
- Scene systems → Scene and camera: updates scene
- Renderer → Scene and camera: renders scene (evidence: `src/Render/Renderer.hpp`)
- Renderer → OpenGL window: uses window (evidence: `src/Render/Renderer.hpp`)
- Renderer → Render targets: uses targets (evidence: `src/Render/Renderer.hpp`)
- Renderer → Orbit renderer: uses orbit renderer (evidence: `src/Render/Renderer.hpp`)
- Renderer → Skybox: uses skybox (evidence: `src/Render/Renderer.hpp`)
- Shader storage → Shader manager: binds shader
- Input handler → Scene and camera: controls camera (evidence: `src/Input/InputHandler.hpp`)
- Input handler → OpenGL window: reads events (evidence: `src/Input/InputHandler.hpp`)
- Input handler → User interface: forwards input (evidence: `src/Input/InputHandler.hpp`)
