# mongodb-developer/leafsteroids architecture

> Architecture diagram of the GitHub repository mongodb-developer/leafsteroids, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mongodb-developer/leafsteroids
- Repository: https://github.com/mongodb-developer/leafsteroids

## Overview

Leafsteroids is a multiplayer arcade game with a Blazor website and ASP.NET API backed by MongoDB Atlas. The documented player workflow is to choose an event, play and submit a timed run, then compare scores and gameplay-style similarities. The sampled API shows recording creation and vector-based similarity search, plus player and event lookup. The README documents the game client and real-time scoreboards, but their implementation is not present in the supplied tree; website-to-API wiring is likewise not shown, so those relationships are not asserted as verified.

Main entry points: [`rest_service/Controllers/PlayersController.cs`](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/PlayersController.cs) (Player Lookup), [`rest_service/Controllers/RecordingsController.cs`](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/RecordingsController.cs) (Run Submission), [`rest_service/Controllers/EventsController.cs`](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/EventsController.cs) (Event Management), [`rest_service/Controllers/BaseController.cs`](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/BaseController.cs) (Database Access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Website"]
  node_website["Blazor Website<br/>[Program.cs]"]
  node_restclient["REST Client"]
  node_charts["Chart URLs<br/>[ChartsUrl.cs]"]
end

subgraph group_api["REST API"]
  node_apiroot["API Entry<br/>[RootController.cs]"]
  node_events["Event Management"]
  node_configs["Game Configuration"]
  node_players["Player Lookup"]
  node_recordings["Run Submission"]
  node_base["Database Access<br/>[BaseController.cs]"]
end

subgraph group_domain["Game Data"]
  node_requests["Request DTOs"]
  node_responses["Response DTOs"]
  node_playerschema["Player Records<br/>[Player.cs]"]
  node_eventschema["Event Records<br/>[Event.cs]"]
  node_recordingschema["Recording Records<br/>[Recording.cs]"]
  node_embeddedrefs["Embedded References<br/>[RecordingPlayer.cs]"]
end

subgraph group_atlas["Atlas Search"]
  node_mongo[("MongoDB Atlas")]
  node_autocomplete[("Autocomplete Index")]
  node_vectorindex[("Vector Index<br/>[vector_index.js]")]
end

node_player(("Player"))
node_gameclient["Unity Game Client"]

node_player -->|"views"| node_website
node_player -->|"plays"| node_gameclient
node_gameclient -->|"submits runs"| node_recordings
node_gameclient -.->|"selects event"| node_events
node_website -.->|"uses client"| node_restclient
node_restclient -.->|"HTTP requests"| node_events
node_restclient -.->|"HTTP requests"| node_players
node_player -->|"checks service"| node_apiroot
node_events -->|"inherits access"| node_base
node_configs -->|"inherits access"| node_base
node_players -->|"inherits access"| node_base
node_recordings -->|"inherits access"| node_base
node_events -->|"reads and writes"| node_mongo
node_players -->|"queries and writes"| node_mongo
node_recordings -->|"stores and searches"| node_mongo
node_players -->|"searches index"| node_autocomplete
node_recordings -->|"vector searches"| node_vectorindex
node_mongo -.->|"uses index"| node_autocomplete
node_mongo -.->|"uses index"| node_vectorindex
node_recordings -->|"accepts recording DTO"| node_requests
node_players -->|"accepts player DTO"| node_requests
node_events -->|"accepts event DTO"| node_requests
node_players -->|"returns player data"| node_responses
node_events -->|"returns event data"| node_responses
node_recordings -->|"returns similarity data"| node_responses
node_recordings -->|"creates runs"| node_recordingschema
node_recordingschema -->|"embeds player and event"| node_embeddedrefs
node_players -->|"queries player records"| node_playerschema
node_events -->|"queries event records"| node_eventschema

click node_website "https://github.com/mongodb-developer/leafsteroids/blob/main/website/Program.cs"
click node_restclient "https://github.com/mongodb-developer/leafsteroids/blob/main/website/Utils/RestServiceClient.cs"
click node_charts "https://github.com/mongodb-developer/leafsteroids/blob/main/website/Utils/ChartsUrl.cs"
click node_apiroot "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/RootController.cs"
click node_events "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/EventsController.cs"
click node_configs "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/ConfigsController.cs"
click node_players "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/PlayersController.cs"
click node_recordings "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/RecordingsController.cs"
click node_base "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/BaseController.cs"
click node_requests "https://github.com/mongodb-developer/leafsteroids/tree/main/rest_service/Dtos/RequestObjects"
click node_responses "https://github.com/mongodb-developer/leafsteroids/tree/main/rest_service/Dtos/ResponseObjects"
click node_playerschema "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Entities/Player.cs"
click node_eventschema "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Entities/Event.cs"
click node_recordingschema "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Entities/Recording.cs"
click node_embeddedrefs "https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Entities/RecordingPlayer.cs"
click node_autocomplete "https://github.com/mongodb-developer/leafsteroids/blob/main/deployment/game_database/search_autocomplete_index.js"
click node_vectorindex "https://github.com/mongodb-developer/leafsteroids/blob/main/deployment/game_database/vector_index.js"

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,node_restclient,node_charts,node_gameclient toneBlue
class node_apiroot,node_events,node_configs,node_players,node_recordings,node_base toneAmber
class node_requests,node_responses,node_playerschema,node_eventschema,node_recordingschema,node_embeddedrefs toneMint
class node_mongo,node_autocomplete,node_vectorindex toneRose
class node_player toneIndigo
```

## Components

### Website

- [Blazor Website](https://github.com/mongodb-developer/leafsteroids/blob/main/website/Program.cs): `website/Program.cs`
- [REST Client](https://github.com/mongodb-developer/leafsteroids/blob/main/website/Utils/RestServiceClient.cs): `website/Utils/RestServiceClient.cs`
- [Chart URLs](https://github.com/mongodb-developer/leafsteroids/blob/main/website/Utils/ChartsUrl.cs): `website/Utils/ChartsUrl.cs`

### REST API

- [API Entry](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/RootController.cs): `rest_service/Controllers/RootController.cs`
- [Event Management](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/EventsController.cs): `rest_service/Controllers/EventsController.cs`
- [Game Configuration](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/ConfigsController.cs): `rest_service/Controllers/ConfigsController.cs`
- [Player Lookup](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/PlayersController.cs): `rest_service/Controllers/PlayersController.cs`
- [Run Submission](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/RecordingsController.cs): `rest_service/Controllers/RecordingsController.cs`
- [Database Access](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Controllers/BaseController.cs): `rest_service/Controllers/BaseController.cs`

### Game Data

- [Request DTOs](https://github.com/mongodb-developer/leafsteroids/tree/main/rest_service/Dtos/RequestObjects): `rest_service/Dtos/RequestObjects`
- [Response DTOs](https://github.com/mongodb-developer/leafsteroids/tree/main/rest_service/Dtos/ResponseObjects): `rest_service/Dtos/ResponseObjects`
- [Player Records](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Entities/Player.cs): `rest_service/Entities/Player.cs`
- [Event Records](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Entities/Event.cs): `rest_service/Entities/Event.cs`
- [Recording Records](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Entities/Recording.cs): `rest_service/Entities/Recording.cs`
- [Embedded References](https://github.com/mongodb-developer/leafsteroids/blob/main/rest_service/Entities/RecordingPlayer.cs): `rest_service/Entities/RecordingPlayer.cs`

### Atlas Search

- **MongoDB Atlas**
- [Autocomplete Index](https://github.com/mongodb-developer/leafsteroids/blob/main/deployment/game_database/search_autocomplete_index.js): `deployment/game_database/search_autocomplete_index.js`
- [Vector Index](https://github.com/mongodb-developer/leafsteroids/blob/main/deployment/game_database/vector_index.js): `deployment/game_database/vector_index.js`

### Other components

- **Player**
- **Unity Game Client**

## Connections

- Player → Blazor Website: views
- Player → Unity Game Client: plays
- Unity Game Client → Run Submission: submits runs
- Unity Game Client → Event Management: selects event
- Blazor Website → REST Client: uses client
- REST Client → Event Management: HTTP requests
- REST Client → Player Lookup: HTTP requests
- Player → API Entry: checks service
- Event Management → Database Access: inherits access (evidence: `rest_service/Controllers/EventsController.cs`)
- Game Configuration → Database Access: inherits access (evidence: `rest_service/Controllers/ConfigsController.cs`)
- Player Lookup → Database Access: inherits access (evidence: `rest_service/Controllers/PlayersController.cs`)
- Run Submission → Database Access: inherits access (evidence: `rest_service/Controllers/RecordingsController.cs`)
- Event Management → MongoDB Atlas: reads and writes (evidence: `rest_service/Controllers/EventsController.cs`)
- Player Lookup → MongoDB Atlas: queries and writes (evidence: `rest_service/Controllers/PlayersController.cs`)
- Run Submission → MongoDB Atlas: stores and searches (evidence: `rest_service/Controllers/RecordingsController.cs`)
- Player Lookup → Autocomplete Index: searches index (evidence: `rest_service/Controllers/PlayersController.cs`)
- Run Submission → Vector Index: vector searches (evidence: `rest_service/Controllers/RecordingsController.cs`)
- MongoDB Atlas → Autocomplete Index: uses index
- MongoDB Atlas → Vector Index: uses index
- Run Submission → Request DTOs: accepts recording DTO (evidence: `rest_service/Controllers/RecordingsController.cs`)
- Player Lookup → Request DTOs: accepts player DTO (evidence: `rest_service/Controllers/PlayersController.cs`)
- Event Management → Request DTOs: accepts event DTO (evidence: `rest_service/Controllers/EventsController.cs`)
- Player Lookup → Response DTOs: returns player data (evidence: `rest_service/Controllers/PlayersController.cs`)
- Event Management → Response DTOs: returns event data (evidence: `rest_service/Controllers/EventsController.cs`)
- Run Submission → Response DTOs: returns similarity data (evidence: `rest_service/Controllers/RecordingsController.cs`)
- Run Submission → Recording Records: creates runs (evidence: `rest_service/Controllers/RecordingsController.cs`)
- Recording Records → Embedded References: embeds player and event (evidence: `rest_service/Entities/Recording.cs`)
- Player Lookup → Player Records: queries player records (evidence: `rest_service/Controllers/PlayersController.cs`)
- Event Management → Event Records: queries event records (evidence: `rest_service/Controllers/EventsController.cs`)
