# strange4/renaengine architecture

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

## Overview

RenaEngine runs code-driven strategy competitions: participants submit bot archives, the server runs game rooms, and the website provides participant/admin workflows plus live viewing and replay. The Battleship game is the sample game; generated SDKs support bot development. The graph includes documented website capabilities and major server subsystems, but several routes and orchestration modules were not excerpted, so uncertain runtime links are omitted rather than inferred.

Main entry points: [`game-server/Rena/Server/GameSockets/GameRoomManager.cs`](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/GameSockets/GameRoomManager.cs) (Room manager), [`website/src/app/(pages)`](https://github.com/strange4/renaengine/tree/main/website/src/app/(pages)) (Competition pages), [`game-server/Rena/Server/RenaServerHandlers.cs`](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/RenaServerHandlers.cs) (HTTP handlers), [`website/src/app/components`](https://github.com/strange4/renaengine/tree/main/website/src/app/components) (Live and replay UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Competition website"]
  node_website_pages["Competition pages"]
  node_token_ui["Token manager"]
  node_website_routes["Website routes"]
  node_website_lib["Website services"]
  node_website_db[("Website database<br/>[db.ts]")]
end

subgraph group_server["Game server"]
  node_server_entry["Server entry<br/>[Program.cs]"]
  node_rena_server["Rena server<br/>[RenaServer.cs]"]
  node_handlers["HTTP handlers"]
  node_rooms["Room manager<br/>[GameRoomManager.cs]"]
  node_room["Game room<br/>[GameRoom.cs]"]
  node_socket["Socket handler"]
  node_docker["Docker orchestration"]
  node_broadcaster["Renderable broadcaster"]
end

subgraph group_game["Battleship game"]
  node_battleship["Battleship rules<br/>[GameLogic.cs]"]
  node_game_models["Game state models"]
  node_bot["Sample bots<br/>[main.ts]"]
end

subgraph group_viewer["Viewing and replay"]
  node_viewer_ui["Live and replay UI"]
  node_live_renderer["Live renderer"]
  node_replay["Replay controller"]
end

subgraph group_generation["Bot SDK generation"]
  node_sdk_builder["SDK builder<br/>[SDKBuilder.cs]"]
  node_ts_generator["TypeScript generator"]
end

node_participant(("Participant"))
node_admin(("Administrator"))

node_participant -->|"uses"| node_website_pages
node_admin -->|"manages"| node_website_pages
node_website_pages -->|"renders"| node_token_ui
node_token_ui -->|"requests tokens"| node_website_routes
node_website_routes -.->|"delegates to"| node_website_lib
node_website_lib -.->|"uses"| node_website_db
node_server_entry -->|"starts"| node_rena_server
node_handlers -->|"gets broadcaster"| node_rooms
node_rooms -->|"runs room"| node_room
node_socket -->|"uses connection"| node_room
node_rooms -->|"gets broadcaster"| node_broadcaster
node_handlers -->|"streams changes"| node_broadcaster
node_docker -.->|"manages containers"| node_docker
node_battleship -->|"uses state types"| node_game_models
node_bot -.->|"uses game actions"| node_game_models
node_viewer_ui -.->|"renders live view"| node_live_renderer
node_viewer_ui -.->|"controls replay"| node_replay
node_replay -.->|"updates renderables"| node_live_renderer
node_sdk_builder -->|"selects generator"| node_ts_generator

click node_website_pages "https://github.com/strange4/renaengine/tree/main/website/src/app/(pages)"
click node_token_ui "https://github.com/strange4/renaengine/blob/main/website/src/app/components/ParticipantTokenManager.tsx"
click node_website_routes "https://github.com/strange4/renaengine/tree/main/website/src/server/routes"
click node_website_lib "https://github.com/strange4/renaengine/tree/main/website/src/server/lib"
click node_website_db "https://github.com/strange4/renaengine/blob/main/website/src/server/lib/db.ts"
click node_server_entry "https://github.com/strange4/renaengine/blob/main/game-server/BattleshipServer/Program.cs"
click node_rena_server "https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/RenaServer.cs"
click node_handlers "https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/RenaServerHandlers.cs"
click node_rooms "https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/GameSockets/GameRoomManager.cs"
click node_room "https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/GameSockets/GameRoom.cs"
click node_socket "https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/GameSockets/GameSocketHandler.cs"
click node_docker "https://github.com/strange4/renaengine/tree/main/game-server/Rena/Server/DockerManager"
click node_broadcaster "https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/Rendering/RenderableBroadcaster.cs"
click node_battleship "https://github.com/strange4/renaengine/blob/main/game-server/BattleshipServer/Game/Logic/GameLogic.cs"
click node_game_models "https://github.com/strange4/renaengine/tree/main/game-server/BattleshipServer/Game/Models"
click node_bot "https://github.com/strange4/renaengine/blob/main/game-server/BattleshipServer/BasicBot/main.ts"
click node_viewer_ui "https://github.com/strange4/renaengine/tree/main/website/src/app/components"
click node_live_renderer "https://github.com/strange4/renaengine/blob/main/website/src/app/viewer/liveViewRenderer.ts"
click node_replay "https://github.com/strange4/renaengine/blob/main/website/src/app/viewer/replayController.ts"
click node_sdk_builder "https://github.com/strange4/renaengine/blob/main/game-server/Rena/Generator/SDKBuilder.cs"
click node_ts_generator "https://github.com/strange4/renaengine/blob/main/game-server/Rena/Generator/TypescriptSDKGenerator.cs"

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_website_pages,node_token_ui,node_website_routes,node_website_lib,node_website_db toneBlue
class node_server_entry,node_rena_server,node_handlers,node_rooms,node_room,node_socket,node_docker,node_broadcaster toneAmber
class node_battleship,node_game_models,node_bot toneMint
class node_viewer_ui,node_live_renderer,node_replay toneRose
class node_sdk_builder,node_ts_generator,node_participant,node_admin toneIndigo
```

## Components

### Competition website

- [Competition pages](https://github.com/strange4/renaengine/tree/main/website/src/app/(pages)): `website/src/app/(pages)`
- [Token manager](https://github.com/strange4/renaengine/blob/main/website/src/app/components/ParticipantTokenManager.tsx): `website/src/app/components/ParticipantTokenManager.tsx`
- [Website routes](https://github.com/strange4/renaengine/tree/main/website/src/server/routes): `website/src/server/routes`
- [Website services](https://github.com/strange4/renaengine/tree/main/website/src/server/lib): `website/src/server/lib`
- [Website database](https://github.com/strange4/renaengine/blob/main/website/src/server/lib/db.ts): `website/src/server/lib/db.ts`

### Game server

- [Server entry](https://github.com/strange4/renaengine/blob/main/game-server/BattleshipServer/Program.cs): `game-server/BattleshipServer/Program.cs`
- [Rena server](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/RenaServer.cs): `game-server/Rena/Server/RenaServer.cs`
- [HTTP handlers](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/RenaServerHandlers.cs): `game-server/Rena/Server/RenaServerHandlers.cs`
- [Room manager](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/GameSockets/GameRoomManager.cs): `game-server/Rena/Server/GameSockets/GameRoomManager.cs`
- [Game room](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/GameSockets/GameRoom.cs): `game-server/Rena/Server/GameSockets/GameRoom.cs`
- [Socket handler](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/GameSockets/GameSocketHandler.cs): `game-server/Rena/Server/GameSockets/GameSocketHandler.cs`
- [Docker orchestration](https://github.com/strange4/renaengine/tree/main/game-server/Rena/Server/DockerManager): `game-server/Rena/Server/DockerManager`
- [Renderable broadcaster](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Server/Rendering/RenderableBroadcaster.cs): `game-server/Rena/Server/Rendering/RenderableBroadcaster.cs`

### Battleship game

- [Battleship rules](https://github.com/strange4/renaengine/blob/main/game-server/BattleshipServer/Game/Logic/GameLogic.cs): `game-server/BattleshipServer/Game/Logic/GameLogic.cs`
- [Game state models](https://github.com/strange4/renaengine/tree/main/game-server/BattleshipServer/Game/Models): `game-server/BattleshipServer/Game/Models`
- [Sample bots](https://github.com/strange4/renaengine/blob/main/game-server/BattleshipServer/BasicBot/main.ts): `game-server/BattleshipServer/BasicBot/main.ts`

### Viewing and replay

- [Live and replay UI](https://github.com/strange4/renaengine/tree/main/website/src/app/components): `website/src/app/components`
- [Live renderer](https://github.com/strange4/renaengine/blob/main/website/src/app/viewer/liveViewRenderer.ts): `website/src/app/viewer/liveViewRenderer.ts`
- [Replay controller](https://github.com/strange4/renaengine/blob/main/website/src/app/viewer/replayController.ts): `website/src/app/viewer/replayController.ts`

### Bot SDK generation

- [SDK builder](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Generator/SDKBuilder.cs): `game-server/Rena/Generator/SDKBuilder.cs`
- [TypeScript generator](https://github.com/strange4/renaengine/blob/main/game-server/Rena/Generator/TypescriptSDKGenerator.cs): `game-server/Rena/Generator/TypescriptSDKGenerator.cs`

### Other components

- **Participant**
- **Administrator**

## Connections

- Participant → Competition pages: uses (evidence: `README.md`)
- Administrator → Competition pages: manages (evidence: `README.md`)
- Competition pages → Token manager: renders (evidence: `website/src/app/components/ParticipantTokenManager.tsx`)
- Token manager → Website routes: requests tokens (evidence: `website/src/app/components/ParticipantTokenManager.tsx`)
- Website routes → Website services: delegates to
- Website services → Website database: uses
- Server entry → Rena server: starts (evidence: `game-server/BattleshipServer/Program.cs`)
- HTTP handlers → Room manager: gets broadcaster (evidence: `game-server/Rena/Server/RenaServerHandlers.cs`)
- Room manager → Game room: runs room (evidence: `game-server/Rena/Server/GameSockets/GameRoomManager.cs`)
- Socket handler → Game room: uses connection (evidence: `game-server/Rena/Server/GameSockets/GameSocketHandler.cs`)
- Room manager → Renderable broadcaster: gets broadcaster (evidence: `game-server/Rena/Server/GameSockets/GameRoomManager.cs`)
- HTTP handlers → Renderable broadcaster: streams changes (evidence: `game-server/Rena/Server/RenaServerHandlers.cs`)
- Docker orchestration → Docker orchestration: manages containers
- Battleship rules → Game state models: uses state types (evidence: `game-server/BattleshipServer/Game/Logic/GameLogic.cs`)
- Sample bots → Game state models: uses game actions
- Live and replay UI → Live renderer: renders live view
- Live and replay UI → Replay controller: controls replay
- Replay controller → Live renderer: updates renderables
- SDK builder → TypeScript generator: selects generator (evidence: `game-server/Rena/Generator/SDKBuilder.cs`)
