# homyakin/project-seeker architecture

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

- Interactive diagram: https://gitdiagram.com/homyakin/project-seeker
- Repository: https://github.com/homyakin/project-seeker

## Overview

Krezar Tavern is a Telegram MMORPG backed by game-domain services and PostgreSQL, with a website backend for battle records. A principal player journey is interacting with the Telegram bot, managing a character and equipment, then joining group or world events whose battles produce results and rewards. The tree also shows quests, raids, anomalies, duels, outposts, badges, and social/group features. Edges are limited to relationships shown by excerpts or the SOURCE INDEX; unverified entry and event wiring is left out or marked dashed.

Main entry points: [`game/src/main/java/ru/homyakin/seeker/game/event/launched/LaunchedEventService.java`](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/event/launched/LaunchedEventService.java) (Event lifecycle), [`game/src/main/java/ru/homyakin/seeker/game/personage/PersonageService.java`](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/personage/PersonageService.java) (Character service), [`game/src/main/java/ru/homyakin/seeker/game/duel/DuelService.java`](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/duel/DuelService.java) (Duels), [`game/src/main/java/ru/homyakin/seeker/telegram`](https://github.com/homyakin/project-seeker/tree/master/game/src/main/java/ru/homyakin/seeker/telegram) (Telegram services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_telegram["Telegram interface"]
  node_telegram_service["Telegram services"]
  node_telegram_sender["Telegram sender"]
end

subgraph group_characters["Characters and gear"]
  node_personage["Character service"]
  node_personage_state["Character state<br/>[Personage.java]"]
  node_items["Items and equipment<br/>[ItemService.java]"]
  node_badges["Badges"]
end

subgraph group_events["Events and combat"]
  node_battle["Battle engine<br/>[Battle.java]"]
  node_duels["Duels<br/>[DuelService.java]"]
  node_events_core["Event lifecycle"]
  node_raids["Raids<br/>[RaidService.java]"]
  node_quests["Personal quests"]
  node_anomalies["Anomalies"]
  node_world_raid["World raid"]
end

subgraph group_groupsys["Groups and world"]
  node_groups["Groups<br/>[GetGroup.java]"]
  node_outpost["Outpost"]
  node_contraband["Contraband"]
end

subgraph group_web["Battle website"]
  node_website["Battle records API"]
  node_website_app["Website backend"]
end

node_player(("Player"))
node_telegram_api["Telegram API"]

node_player -.->|"uses"| node_telegram_service
node_telegram_service -.->|"sends through"| node_telegram_sender
node_telegram_sender -->|"sends requests"| node_telegram_api
node_personage -->|"loads gear"| node_items
node_personage -->|"initializes badges"| node_badges
node_personage -.->|"updates state"| node_personage_state
node_items -->|"uses character data"| node_personage
node_duels -->|"runs combat"| node_battle
node_duels -->|"records event"| node_events_core
node_duels -.->|"uses group identity"| node_groups
node_events_core -.->|"launches raid events"| node_raids
node_events_core -.->|"tracks quest events"| node_quests
node_events_core -.->|"tracks world events"| node_world_raid
node_events_core -.->|"tracks anomaly events"| node_anomalies
node_anomalies -->|"notifies players"| node_telegram_service
node_website_app -.->|"serves records"| node_website

click node_telegram_service "https://github.com/homyakin/project-seeker/tree/master/game/src/main/java/ru/homyakin/seeker/telegram"
click node_telegram_sender "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/telegram/TelegramSender.java"
click node_personage "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/personage/PersonageService.java"
click node_personage_state "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/personage/models/Personage.java"
click node_items "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/item/ItemService.java"
click node_badges "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/badge/action/PersonageBadgeService.java"
click node_battle "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/battle/Battle.java"
click node_duels "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/duel/DuelService.java"
click node_events_core "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/event/launched/LaunchedEventService.java"
click node_raids "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/event/raid/RaidService.java"
click node_quests "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/event/personal_quest/PersonalQuestService.java"
click node_anomalies "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/event/anomaly/action/AnomalyService.java"
click node_world_raid "https://github.com/homyakin/project-seeker/tree/master/game/src/main/java/ru/homyakin/seeker/game/event/world_raid/action"
click node_groups "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/group/action/GetGroup.java"
click node_outpost "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/outpost/action/OutpostService.java"
click node_contraband "https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/contraband/action/ContrabandService.java"
click node_website "https://github.com/homyakin/project-seeker/tree/master/website-backend/src/main/java/ru/homyakin/seeker/website/battle"
click node_website_app "https://github.com/homyakin/project-seeker/blob/master/website-backend/src/main/java/ru/homyakin/seeker/website/WebsiteApplication.java"

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_telegram_service,node_telegram_sender toneBlue
class node_personage,node_personage_state,node_items,node_badges toneAmber
class node_battle,node_duels,node_events_core,node_raids,node_quests,node_anomalies,node_world_raid,node_telegram_api toneMint
class node_groups,node_outpost,node_contraband toneRose
class node_website,node_website_app,node_player toneIndigo
```

## Components

### Telegram interface

- [Telegram services](https://github.com/homyakin/project-seeker/tree/master/game/src/main/java/ru/homyakin/seeker/telegram): `game/src/main/java/ru/homyakin/seeker/telegram`
- [Telegram sender](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/telegram/TelegramSender.java): `game/src/main/java/ru/homyakin/seeker/telegram/TelegramSender.java`

### Characters and gear

- [Character service](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/personage/PersonageService.java): `game/src/main/java/ru/homyakin/seeker/game/personage/PersonageService.java`
- [Character state](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/personage/models/Personage.java): `game/src/main/java/ru/homyakin/seeker/game/personage/models/Personage.java`
- [Items and equipment](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/item/ItemService.java): `game/src/main/java/ru/homyakin/seeker/game/item/ItemService.java`
- [Badges](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/badge/action/PersonageBadgeService.java): `game/src/main/java/ru/homyakin/seeker/game/badge/action/PersonageBadgeService.java`

### Events and combat

- [Battle engine](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/battle/Battle.java): `game/src/main/java/ru/homyakin/seeker/game/battle/Battle.java`
- [Duels](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/duel/DuelService.java): `game/src/main/java/ru/homyakin/seeker/game/duel/DuelService.java`
- [Event lifecycle](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/event/launched/LaunchedEventService.java): `game/src/main/java/ru/homyakin/seeker/game/event/launched/LaunchedEventService.java`
- [Raids](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/event/raid/RaidService.java): `game/src/main/java/ru/homyakin/seeker/game/event/raid/RaidService.java`
- [Personal quests](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/event/personal_quest/PersonalQuestService.java): `game/src/main/java/ru/homyakin/seeker/game/event/personal_quest/PersonalQuestService.java`
- [Anomalies](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/event/anomaly/action/AnomalyService.java): `game/src/main/java/ru/homyakin/seeker/game/event/anomaly/action/AnomalyService.java`
- [World raid](https://github.com/homyakin/project-seeker/tree/master/game/src/main/java/ru/homyakin/seeker/game/event/world_raid/action): `game/src/main/java/ru/homyakin/seeker/game/event/world_raid/action`

### Groups and world

- [Groups](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/group/action/GetGroup.java): `game/src/main/java/ru/homyakin/seeker/game/group/action/GetGroup.java`
- [Outpost](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/outpost/action/OutpostService.java): `game/src/main/java/ru/homyakin/seeker/game/outpost/action/OutpostService.java`
- [Contraband](https://github.com/homyakin/project-seeker/blob/master/game/src/main/java/ru/homyakin/seeker/game/contraband/action/ContrabandService.java): `game/src/main/java/ru/homyakin/seeker/game/contraband/action/ContrabandService.java`

### Battle website

- [Battle records API](https://github.com/homyakin/project-seeker/tree/master/website-backend/src/main/java/ru/homyakin/seeker/website/battle): `website-backend/src/main/java/ru/homyakin/seeker/website/battle`
- [Website backend](https://github.com/homyakin/project-seeker/blob/master/website-backend/src/main/java/ru/homyakin/seeker/website/WebsiteApplication.java): `website-backend/src/main/java/ru/homyakin/seeker/website/WebsiteApplication.java`

### Other components

- **Player**
- **Telegram API**

## Connections

- Player → Telegram services: uses
- Telegram services → Telegram sender: sends through (evidence: `game/src/main/java/ru/homyakin/seeker/telegram/anomaly/TelegramAnomalyService.java`)
- Telegram sender → Telegram API: sends requests (evidence: `game/src/main/java/ru/homyakin/seeker/telegram/TelegramSender.java`)
- Character service → Items and equipment: loads gear (evidence: `game/src/main/java/ru/homyakin/seeker/game/personage/PersonageService.java`)
- Character service → Badges: initializes badges (evidence: `game/src/main/java/ru/homyakin/seeker/game/personage/PersonageService.java`)
- Character service → Character state: updates state (evidence: `game/src/main/java/ru/homyakin/seeker/game/personage/PersonageService.java`)
- Items and equipment → Character service: uses character data (evidence: `game/src/main/java/ru/homyakin/seeker/game/item/ItemService.java`)
- Duels → Battle engine: runs combat (evidence: `game/src/main/java/ru/homyakin/seeker/game/duel/DuelService.java`)
- Duels → Event lifecycle: records event (evidence: `game/src/main/java/ru/homyakin/seeker/game/duel/DuelService.java`)
- Duels → Groups: uses group identity
- Event lifecycle → Raids: launches raid events (evidence: `game/src/main/java/ru/homyakin/seeker/game/event/raid/RaidService.java`)
- Event lifecycle → Personal quests: tracks quest events (evidence: `game/src/main/java/ru/homyakin/seeker/game/event/personal_quest/PersonalQuestService.java`)
- Event lifecycle → World raid: tracks world events
- Event lifecycle → Anomalies: tracks anomaly events (evidence: `game/src/main/java/ru/homyakin/seeker/game/event/anomaly/action/AnomalyService.java`)
- Anomalies → Telegram services: notifies players (evidence: `game/src/main/java/ru/homyakin/seeker/telegram/anomaly/TelegramAnomalyService.java`)
- Website backend → Battle records API: serves records
