# faberuser/sprk architecture

> Architecture diagram of the GitHub repository faberuser/sprk, 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/faberuser/sprk
- Repository: https://github.com/faberuser/sprk

## Overview

SPRK combines a real-time RPG client, a Rust private-server backend, and a Windows launcher that selects a server and installs signed client updates. The principal player workflow is choosing a server in the launcher, updating the game from that server’s update service, then playing against the game server. The graph preserves documented game domains and sampled server/API and account-state layers. Several client domains and server routes are represented by enclosing directories because their implementations were not sampled; edges are limited to documented or indexed relationships.

Main entry points: [`server/src/db.rs`](https://github.com/faberuser/sprk/blob/main/server/src/db.rs) (Database access), [`client/launcher/SprkLauncher/Program.cs`](https://github.com/faberuser/sprk/blob/main/client/launcher/SprkLauncher/Program.cs) (Windows launcher), [`server/src/main.rs`](https://github.com/faberuser/sprk/blob/main/server/src/main.rs) (Server runtime), [`client/launcher/SprkLauncher.Core/UpdateEngine.cs`](https://github.com/faberuser/sprk/blob/main/client/launcher/SprkLauncher.Core/UpdateEngine.cs) (Update engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launcher["Launcher and updates"]
  node_launcher_app["Windows launcher<br/>[Program.cs]"]
  node_server_profiles["Server profiles"]
  node_update_engine["Update engine<br/>[UpdateEngine.cs]"]
  node_update_service["Client update service"]
end

subgraph group_game["Game client"]
  node_game_client["RPG client"]
  node_hero_equipment["Heroes and equipment"]
  node_storage_ui["Preset storage UI"]
  node_storage_web["Storage requests"]
end

subgraph group_server["Game server"]
  node_game_api["Game API"]
  node_campaign_api["Campaign handlers"]
  node_storage_api["Storage APIs<br/>[storage.rs]"]
  node_system_api["System APIs"]
  node_server_runtime["Server runtime<br/>[main.rs]"]
  node_db_layer["Database access<br/>[db.rs]"]
  node_postgres[("PostgreSQL<br/>[database.rs]")]
end

subgraph group_state["Account and persistence"]
  node_account_state["Account managers<br/>[AccountManager.cs]"]
  node_equip_presets["Equipment presets"]
end

node_player(("Player"))

node_player -->|"starts"| node_launcher_app
node_launcher_app -->|"manages servers"| node_server_profiles
node_launcher_app -.->|"installs updates"| node_update_engine
node_update_engine -->|"downloads manifest and files"| node_update_service
node_player -->|"plays"| node_game_client
node_storage_web -->|"applies responses"| node_equip_presets
node_game_client -.->|"uses account state"| node_account_state
node_server_runtime -->|"mounts APIs"| node_game_api
node_server_runtime -->|"initializes database access"| node_db_layer
node_campaign_api -->|"uses database"| node_db_layer
node_storage_api -->|"uses database"| node_db_layer
node_system_api -->|"uses database"| node_db_layer
node_db_layer -.->|"persists game data"| node_postgres

click node_launcher_app "https://github.com/faberuser/sprk/blob/main/client/launcher/SprkLauncher/Program.cs"
click node_server_profiles "https://github.com/faberuser/sprk/blob/main/client/launcher/SprkLauncher/ServerManagerForm.cs"
click node_update_engine "https://github.com/faberuser/sprk/blob/main/client/launcher/SprkLauncher.Core/UpdateEngine.cs"
click node_game_client "https://github.com/faberuser/sprk/tree/main/client/managed/Assembly-CSharp"
click node_account_state "https://github.com/faberuser/sprk/blob/main/client/managed/Assembly-CSharp/NGame2.NAccount/AccountManager.cs"
click node_hero_equipment "https://github.com/faberuser/sprk/tree/main/client/managed/Assembly-CSharp/NShared"
click node_storage_ui "https://github.com/faberuser/sprk/blob/main/client/managed/Assembly-CSharp/NGame2.NUI.NComponent2/HeroEquipStoragePanel.cs"
click node_storage_web "https://github.com/faberuser/sprk/blob/main/client/managed/Assembly-CSharp/NGame2.NUI.NManager/HeroPresetStorageWebManager.cs"
click node_equip_presets "https://github.com/faberuser/sprk/blob/main/client/managed/Assembly-CSharp/NGame2.NAccount/UserEquipPresetStorageManager.cs"
click node_game_api "https://github.com/faberuser/sprk/tree/main/server/src/api"
click node_campaign_api "https://github.com/faberuser/sprk/blob/main/server/src/api/battle/campaign_handlers.rs"
click node_storage_api "https://github.com/faberuser/sprk/blob/main/server/src/api/extensions/storage.rs"
click node_system_api "https://github.com/faberuser/sprk/tree/main/server/src/api/system"
click node_server_runtime "https://github.com/faberuser/sprk/blob/main/server/src/main.rs"
click node_db_layer "https://github.com/faberuser/sprk/blob/main/server/src/db.rs"
click node_postgres "https://github.com/faberuser/sprk/blob/main/server/src/database.rs"

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_launcher_app,node_server_profiles,node_update_engine,node_update_service toneBlue
class node_game_client,node_hero_equipment,node_storage_ui,node_storage_web toneAmber
class node_game_api,node_campaign_api,node_storage_api,node_system_api,node_server_runtime,node_db_layer,node_postgres toneMint
class node_account_state,node_equip_presets toneRose
class node_player toneIndigo
```

## Components

### Launcher and updates

- [Windows launcher](https://github.com/faberuser/sprk/blob/main/client/launcher/SprkLauncher/Program.cs): `client/launcher/SprkLauncher/Program.cs`
- [Server profiles](https://github.com/faberuser/sprk/blob/main/client/launcher/SprkLauncher/ServerManagerForm.cs): `client/launcher/SprkLauncher/ServerManagerForm.cs`
- [Update engine](https://github.com/faberuser/sprk/blob/main/client/launcher/SprkLauncher.Core/UpdateEngine.cs): `client/launcher/SprkLauncher.Core/UpdateEngine.cs`
- **Client update service**

### Game client

- [RPG client](https://github.com/faberuser/sprk/tree/main/client/managed/Assembly-CSharp): `client/managed/Assembly-CSharp`
- [Heroes and equipment](https://github.com/faberuser/sprk/tree/main/client/managed/Assembly-CSharp/NShared): `client/managed/Assembly-CSharp/NShared`
- [Preset storage UI](https://github.com/faberuser/sprk/blob/main/client/managed/Assembly-CSharp/NGame2.NUI.NComponent2/HeroEquipStoragePanel.cs): `client/managed/Assembly-CSharp/NGame2.NUI.NComponent2/HeroEquipStoragePanel.cs`
- [Storage requests](https://github.com/faberuser/sprk/blob/main/client/managed/Assembly-CSharp/NGame2.NUI.NManager/HeroPresetStorageWebManager.cs): `client/managed/Assembly-CSharp/NGame2.NUI.NManager/HeroPresetStorageWebManager.cs`

### Game server

- [Game API](https://github.com/faberuser/sprk/tree/main/server/src/api): `server/src/api`
- [Campaign handlers](https://github.com/faberuser/sprk/blob/main/server/src/api/battle/campaign_handlers.rs): `server/src/api/battle/campaign_handlers.rs`
- [Storage APIs](https://github.com/faberuser/sprk/blob/main/server/src/api/extensions/storage.rs): `server/src/api/extensions/storage.rs`
- [System APIs](https://github.com/faberuser/sprk/tree/main/server/src/api/system): `server/src/api/system`
- [Server runtime](https://github.com/faberuser/sprk/blob/main/server/src/main.rs): `server/src/main.rs`
- [Database access](https://github.com/faberuser/sprk/blob/main/server/src/db.rs): `server/src/db.rs`
- [PostgreSQL](https://github.com/faberuser/sprk/blob/main/server/src/database.rs): `server/src/database.rs`

### Account and persistence

- [Account managers](https://github.com/faberuser/sprk/blob/main/client/managed/Assembly-CSharp/NGame2.NAccount/AccountManager.cs): `client/managed/Assembly-CSharp/NGame2.NAccount/AccountManager.cs`
- [Equipment presets](https://github.com/faberuser/sprk/blob/main/client/managed/Assembly-CSharp/NGame2.NAccount/UserEquipPresetStorageManager.cs): `client/managed/Assembly-CSharp/NGame2.NAccount/UserEquipPresetStorageManager.cs`

### Other components

- **Player**

## Connections

- Player → Windows launcher: starts (evidence: `README.md`)
- Windows launcher → Server profiles: manages servers (evidence: `client/launcher/SprkLauncher/ServerManagerForm.cs`)
- Windows launcher → Update engine: installs updates (evidence: `client/launcher/SprkLauncher/Program.cs`)
- Update engine → Client update service: downloads manifest and files (evidence: `client/launcher/SprkLauncher.Core/UpdateEngine.cs`)
- Player → RPG client: plays (evidence: `README.md`)
- Storage requests → Equipment presets: applies responses (evidence: `client/managed/Assembly-CSharp/NGame2.NUI.NManager/HeroPresetStorageWebManager.cs`)
- RPG client → Account managers: uses account state (evidence: `client/managed/Assembly-CSharp/NGame2.NUI.NManager/HeroPresetStorageWebManager.cs`)
- Server runtime → Game API: mounts APIs (evidence: `server/src/main.rs`)
- Server runtime → Database access: initializes database access (evidence: `server/src/main.rs`)
- Campaign handlers → Database access: uses database (evidence: `server/src/api/battle/campaign_handlers.rs`)
- Storage APIs → Database access: uses database (evidence: `server/src/api/extensions/storage.rs`)
- System APIs → Database access: uses database (evidence: `server/src/api/system/storage.rs`)
- Database access → PostgreSQL: persists game data (evidence: `server/src/database.rs`)
