# tekwan404/elyndormmorpg architecture

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

- Interactive diagram: https://gitdiagram.com/tekwan404/elyndormmorpg
- Repository: https://github.com/tekwan404/elyndormmorpg

## Overview

Elyndor is a Telegram Mini App MMORPG implemented as a .NET modular monolith with a Vue client. The intended player journey is to enter through the web app, interact with game systems, and receive persistent character or world results; the sampled evidence does not expose the client-to-server request flow, so that relationship is marked unverified. The graph retains major README capabilities and sampled internal layers. Several feature modules are represented by their exact source directories because their implementations were not excerpted.

Main entry points: [`src/Elyndor.Server/Program.cs`](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Server/Program.cs) (ASP.NET Server), [`src/Elyndor.Core/Content/GameContentPackage.cs`](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Content/GameContentPackage.cs) (Content Package), [`src/Elyndor.Infrastructure/Content/StaticContentSnapshotProvider.cs`](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Content/StaticContentSnapshotProvider.cs) (Content Snapshots), [`src/Elyndor.Core/Combat/Sessions`](https://github.com/tekwan404/elyndormmorpg/tree/main/src/Elyndor.Core/Combat/Sessions) (Combat Runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client Apps"]
  node_webapp["Game Client<br/>[App.vue]"]
  node_adminapp["Admin Client<br/>[App.vue]"]
end

subgraph group_server["Server Entry"]
  node_serverapp["ASP.NET Server<br/>[Program.cs]"]
  node_auth["Telegram Login"]
  node_defaults["Service Defaults<br/>[Extensions.cs]"]
end

subgraph group_gameplay["Game Systems"]
  node_character["Character State<br/>[Character.cs]"]
  node_vitals["Vitals State<br/>[CharacterVitals.cs]"]
  node_combat["Combat Runtime<br/>[Sessions]"]
  node_damage["Damage &amp; Effects<br/>[DamagePipeline.cs]"]
  node_effects["Effect Engine<br/>[EffectEngine.cs]"]
  node_talents["Talents"]
  node_world["World &amp; Travel"]
  node_dungeons["Dungeons<br/>[DungeonService.cs]"]
  node_afk["AFK Farming<br/>[AfkFarmService.cs]"]
  node_items["Items &amp; Inventory"]
  node_progression["Rewards &amp; Progression"]
  node_economy["Economy &amp; Trade<br/>[Economy]"]
  node_social["Party &amp; Social<br/>[PartyService.cs]"]
  node_pvp["Arena<br/>[Pvp]"]
end

subgraph group_content["Content Platform"]
  node_contentpkg["Content Package"]
  node_validation["Content Validation"]
  node_snapshots["Content Snapshots"]
  node_contentadmin["Content Publishing"]
end

subgraph group_persistence["Persistence"]
  node_db[("Game Database<br/>[GameDbContext.cs]")]
end

node_player(("Player"))

node_player -.->|"plays through"| node_webapp
node_webapp -.->|"uses API"| node_serverapp
node_adminapp -.->|"administers"| node_serverapp
node_serverapp -->|"configures"| node_auth
node_serverapp -->|"loads content"| node_snapshots
node_serverapp -->|"uses defaults"| node_defaults
node_damage -->|"calculates stats"| node_effects
node_combat -.->|"resolves damage"| node_damage
node_combat -.->|"grants rewards"| node_progression
node_dungeons -->|"coordinates parties"| node_social
node_items -->|"reads and writes"| node_db
node_progression -->|"reads and writes"| node_db
node_contentpkg -->|"validates"| node_validation
node_contentadmin -.->|"publishes to"| node_snapshots
node_snapshots -->|"provides snapshot"| node_contentpkg
node_validation -->|"checks package"| node_contentpkg

click node_webapp "https://github.com/tekwan404/elyndormmorpg/blob/main/web/elyndor-web/src/App.vue"
click node_adminapp "https://github.com/tekwan404/elyndormmorpg/blob/main/web/elyndor-admin/src/App.vue"
click node_serverapp "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Server/Program.cs"
click node_auth "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Server/Identity/TelegramWebAuthenticationService.cs"
click node_character "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Characters/Character.cs"
click node_vitals "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Characters/CharacterVitals.cs"
click node_combat "https://github.com/tekwan404/elyndormmorpg/tree/main/src/Elyndor.Core/Combat/Sessions"
click node_damage "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Combat/Damage/DamagePipeline.cs"
click node_effects "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Combat/Effects/EffectEngine.cs"
click node_talents "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Talents/CharacterTalentState.cs"
click node_world "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/World/CharacterLocation.cs"
click node_dungeons "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Dungeons/DungeonService.cs"
click node_afk "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Afk/AfkFarmService.cs"
click node_items "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Items/InventoryEquipmentService.cs"
click node_progression "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Progression/CombatRewardService.cs"
click node_economy "https://github.com/tekwan404/elyndormmorpg/tree/main/src/Elyndor.Infrastructure/Economy"
click node_social "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Parties/PartyService.cs"
click node_pvp "https://github.com/tekwan404/elyndormmorpg/tree/main/src/Elyndor.Core/Pvp"
click node_contentpkg "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Content/GameContentPackage.cs"
click node_validation "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Content/ContentValidationPipeline.cs"
click node_snapshots "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Content/StaticContentSnapshotProvider.cs"
click node_contentadmin "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Content/ContentAdministrationService.cs"
click node_db "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Persistence/GameDbContext.cs"
click node_defaults "https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.ServiceDefaults/Extensions.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_webapp,node_adminapp toneBlue
class node_serverapp,node_auth,node_defaults toneAmber
class node_character,node_vitals,node_combat,node_damage,node_effects,node_talents,node_world,node_dungeons,node_afk,node_items,node_progression,node_economy,node_social,node_pvp toneMint
class node_contentpkg,node_validation,node_snapshots,node_contentadmin toneRose
class node_db,node_player toneIndigo
```

## Components

### Client Apps

- [Game Client](https://github.com/tekwan404/elyndormmorpg/blob/main/web/elyndor-web/src/App.vue): `web/elyndor-web/src/App.vue`
- [Admin Client](https://github.com/tekwan404/elyndormmorpg/blob/main/web/elyndor-admin/src/App.vue): `web/elyndor-admin/src/App.vue`

### Server Entry

- [ASP.NET Server](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Server/Program.cs): `src/Elyndor.Server/Program.cs`
- [Telegram Login](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Server/Identity/TelegramWebAuthenticationService.cs): `src/Elyndor.Server/Identity/TelegramWebAuthenticationService.cs`
- [Service Defaults](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.ServiceDefaults/Extensions.cs): `src/Elyndor.ServiceDefaults/Extensions.cs`

### Game Systems

- [Character State](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Characters/Character.cs): `src/Elyndor.Core/Characters/Character.cs`
- [Vitals State](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Characters/CharacterVitals.cs): `src/Elyndor.Core/Characters/CharacterVitals.cs`
- [Combat Runtime](https://github.com/tekwan404/elyndormmorpg/tree/main/src/Elyndor.Core/Combat/Sessions): `src/Elyndor.Core/Combat/Sessions`
- [Damage & Effects](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Combat/Damage/DamagePipeline.cs): `src/Elyndor.Core/Combat/Damage/DamagePipeline.cs`
- [Effect Engine](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Combat/Effects/EffectEngine.cs): `src/Elyndor.Core/Combat/Effects/EffectEngine.cs`
- [Talents](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Talents/CharacterTalentState.cs): `src/Elyndor.Core/Talents/CharacterTalentState.cs`
- [World & Travel](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/World/CharacterLocation.cs): `src/Elyndor.Core/World/CharacterLocation.cs`
- [Dungeons](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Dungeons/DungeonService.cs): `src/Elyndor.Infrastructure/Dungeons/DungeonService.cs`
- [AFK Farming](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Afk/AfkFarmService.cs): `src/Elyndor.Infrastructure/Afk/AfkFarmService.cs`
- [Items & Inventory](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Items/InventoryEquipmentService.cs): `src/Elyndor.Infrastructure/Items/InventoryEquipmentService.cs`
- [Rewards & Progression](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Progression/CombatRewardService.cs): `src/Elyndor.Infrastructure/Progression/CombatRewardService.cs`
- [Economy & Trade](https://github.com/tekwan404/elyndormmorpg/tree/main/src/Elyndor.Infrastructure/Economy): `src/Elyndor.Infrastructure/Economy`
- [Party & Social](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Parties/PartyService.cs): `src/Elyndor.Infrastructure/Parties/PartyService.cs`
- [Arena](https://github.com/tekwan404/elyndormmorpg/tree/main/src/Elyndor.Core/Pvp): `src/Elyndor.Core/Pvp`

### Content Platform

- [Content Package](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Content/GameContentPackage.cs): `src/Elyndor.Core/Content/GameContentPackage.cs`
- [Content Validation](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Core/Content/ContentValidationPipeline.cs): `src/Elyndor.Core/Content/ContentValidationPipeline.cs`
- [Content Snapshots](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Content/StaticContentSnapshotProvider.cs): `src/Elyndor.Infrastructure/Content/StaticContentSnapshotProvider.cs`
- [Content Publishing](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Content/ContentAdministrationService.cs): `src/Elyndor.Infrastructure/Content/ContentAdministrationService.cs`

### Persistence

- [Game Database](https://github.com/tekwan404/elyndormmorpg/blob/main/src/Elyndor.Infrastructure/Persistence/GameDbContext.cs): `src/Elyndor.Infrastructure/Persistence/GameDbContext.cs`

### Other components

- **Player**

## Connections

- Player → Game Client: plays through
- Game Client → ASP.NET Server: uses API
- Admin Client → ASP.NET Server: administers
- ASP.NET Server → Telegram Login: configures (evidence: `src/Elyndor.Server/Program.cs`)
- ASP.NET Server → Content Snapshots: loads content (evidence: `src/Elyndor.Server/Program.cs`)
- ASP.NET Server → Service Defaults: uses defaults (evidence: `src/Elyndor.Server/Program.cs`)
- Damage & Effects → Effect Engine: calculates stats (evidence: `src/Elyndor.Core/Combat/Damage/DamagePipeline.cs`)
- Combat Runtime → Damage & Effects: resolves damage
- Combat Runtime → Rewards & Progression: grants rewards
- Dungeons → Party & Social: coordinates parties (evidence: `src/Elyndor.Infrastructure/Dungeons/DungeonService.cs`)
- Items & Inventory → Game Database: reads and writes (evidence: `src/Elyndor.Infrastructure/Items/InventoryEquipmentService.cs`)
- Rewards & Progression → Game Database: reads and writes (evidence: `src/Elyndor.Infrastructure/Progression/CombatRewardService.cs`)
- Content Package → Content Validation: validates (evidence: `src/Elyndor.Core/Content/ContentValidationPipeline.cs`)
- Content Publishing → Content Snapshots: publishes to
- Content Snapshots → Content Package: provides snapshot (evidence: `src/Elyndor.Infrastructure/Content/StaticContentSnapshotProvider.cs`)
- Content Validation → Content Package: checks package (evidence: `src/Elyndor.Core/Content/ContentValidationPipeline.cs`)
