# chris-jcm/battlearena architecture

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

- Interactive diagram: https://gitdiagram.com/chris-jcm/battlearena
- Repository: https://github.com/chris-jcm/battlearena

## Overview

This is a console-based turn-based battle game: a player chooses a fighter and actions, battles a randomly chosen computer fighter, sees turn and match results, and can view or save battle history. GameService coordinates fighter creation, turns, and history requests; BattleService applies combat rules. The client uses a localhost socket for history exchange. The README is empty, and server-side excerpts show no wiring, so server persistence relationships are not asserted.

Main entry points: [`src/battlearena/service/GameService.java`](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/service/GameService.java) (Game orchestration), [`src/battlearena/service/FighterFactory.java`](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/service/FighterFactory.java) (Fighter factory), [`src/battlearena/service/BattleService.java`](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/service/BattleService.java) (Battle engine), [`src/battlearena/ui/GameUI.java`](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/ui/GameUI.java) (Game UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Console experience"]
  node_gameui["Game UI<br/>[GameUI.java]"]
  node_menu["Menu options<br/>[MenuOptions.java]"]
  node_afterbattle["After-battle choices"]
end

subgraph group_gameplay["Game coordination"]
  node_game["Game orchestration<br/>[GameService.java]"]
  node_factory["Fighter factory"]
end

subgraph group_combat["Combat domain"]
  node_playerstate["Player state<br/>[Player.java]"]
  node_battle["Battle engine<br/>[BattleService.java]"]
  node_fighter["Fighter mechanics<br/>[Fighter.java]"]
  node_warrior["Warrior fighter<br/>[Warrior.java]"]
  node_rogue["Rogue fighter<br/>[Rogue.java]"]
  node_mage["Mage fighter<br/>[Mage.java]"]
  node_fightertype["Fighter types<br/>[FighterType.java]"]
  node_playeraction["Player actions<br/>[PlayerAction.java]"]
  node_specialaction["Special actions<br/>[SpecialAction.java]"]
  node_battlelog["Turn log<br/>[BattleLog.java]"]
  node_turnresult["Turn result<br/>[TurnResult.java]"]
end

subgraph group_history["History exchange"]
  node_result["Match result<br/>[BattleResult.java]"]
  node_gameresult["Win or loss<br/>[GameResult.java]"]
  node_client["Arena socket client<br/>[ArenaClient.java]"]
  node_server["Arena server<br/>[ArenaServer.java]"]
  node_fileservice["File service<br/>[FileService.java]"]
end

node_player(("Player"))
node_arenauser(("Arena user"))

node_arenauser -->|"chooses and acts"| node_gameui
node_gameui -->|"requests game operations"| node_game
node_gameui -->|"displays choices"| node_menu
node_gameui -->|"displays choices"| node_afterbattle
node_game -->|"creates fighters"| node_factory
node_game -->|"executes actions"| node_battle
node_game -->|"requests history exchange"| node_client
node_game -->|"maintains players"| node_playerstate
node_factory -->|"selects archetype"| node_fightertype
node_factory -->|"constructs"| node_warrior
node_factory -->|"constructs"| node_rogue
node_factory -->|"constructs"| node_mage
node_warrior -->|"extends mechanics"| node_fighter
node_rogue -->|"extends mechanics"| node_fighter
node_mage -->|"extends mechanics"| node_fighter
node_battle -->|"dispatches action"| node_playeraction
node_battle -->|"applies special rules"| node_specialaction
node_battle -->|"changes combat state"| node_fighter
node_battle -->|"creates log"| node_battlelog
node_game -->|"returns turn outcome"| node_turnresult
node_turnresult -->|"contains log"| node_battlelog
node_game -->|"builds match record"| node_result
node_result -->|"records fighter types"| node_fightertype
node_result -->|"records outcome"| node_gameresult
node_client -->|"serializes and parses"| node_result
node_client -.->|"exchanges socket requests"| node_server

click node_gameui "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/ui/GameUI.java"
click node_menu "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/ui/MenuOptions.java"
click node_afterbattle "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/ui/AfterBattleOptions.java"
click node_game "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/service/GameService.java"
click node_factory "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/service/FighterFactory.java"
click node_playerstate "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Player.java"
click node_battle "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/service/BattleService.java"
click node_fighter "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Fighter.java"
click node_warrior "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Warrior.java"
click node_rogue "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Rogue.java"
click node_mage "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Mage.java"
click node_fightertype "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/FighterType.java"
click node_playeraction "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/PlayerAction.java"
click node_specialaction "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/SpecialAction.java"
click node_battlelog "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/BattleLog.java"
click node_turnresult "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/TurnResult.java"
click node_result "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/BattleResult.java"
click node_gameresult "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/GameResult.java"
click node_client "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/client/ArenaClient.java"
click node_server "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/server/ArenaServer.java"
click node_fileservice "https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/server/FileService.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_gameui,node_menu,node_afterbattle,node_arenauser toneBlue
class node_game,node_factory toneAmber
class node_playerstate,node_battle,node_fighter,node_warrior,node_rogue,node_mage,node_fightertype,node_playeraction,node_specialaction,node_battlelog,node_turnresult toneMint
class node_result,node_gameresult,node_client,node_server,node_fileservice toneRose
class node_player toneIndigo
```

## Components

### Console experience

- [Game UI](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/ui/GameUI.java): `src/battlearena/ui/GameUI.java`
- [Menu options](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/ui/MenuOptions.java): `src/battlearena/ui/MenuOptions.java`
- [After-battle choices](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/ui/AfterBattleOptions.java): `src/battlearena/ui/AfterBattleOptions.java`

### Game coordination

- [Game orchestration](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/service/GameService.java): `src/battlearena/service/GameService.java`
- [Fighter factory](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/service/FighterFactory.java): `src/battlearena/service/FighterFactory.java`

### Combat domain

- [Player state](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Player.java): `src/battlearena/model/Player.java`
- [Battle engine](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/service/BattleService.java): `src/battlearena/service/BattleService.java`
- [Fighter mechanics](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Fighter.java): `src/battlearena/model/Fighter.java`
- [Warrior fighter](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Warrior.java): `src/battlearena/model/Warrior.java`
- [Rogue fighter](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Rogue.java): `src/battlearena/model/Rogue.java`
- [Mage fighter](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/Mage.java): `src/battlearena/model/Mage.java`
- [Fighter types](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/FighterType.java): `src/battlearena/model/FighterType.java`
- [Player actions](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/PlayerAction.java): `src/battlearena/model/PlayerAction.java`
- [Special actions](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/SpecialAction.java): `src/battlearena/model/SpecialAction.java`
- [Turn log](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/BattleLog.java): `src/battlearena/model/BattleLog.java`
- [Turn result](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/TurnResult.java): `src/battlearena/model/TurnResult.java`

### History exchange

- [Match result](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/BattleResult.java): `src/battlearena/model/BattleResult.java`
- [Win or loss](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/model/GameResult.java): `src/battlearena/model/GameResult.java`
- [Arena socket client](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/client/ArenaClient.java): `src/battlearena/client/ArenaClient.java`
- [Arena server](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/server/ArenaServer.java): `src/battlearena/server/ArenaServer.java`
- [File service](https://github.com/chris-jcm/battlearena/blob/master/src/battlearena/server/FileService.java): `src/battlearena/server/FileService.java`

### Other components

- **Player**
- **Arena user**

## Connections

- Arena user → Game UI: chooses and acts (evidence: `src/battlearena/ui/GameUI.java`)
- Game UI → Game orchestration: requests game operations (evidence: `src/battlearena/ui/GameUI.java`)
- Game UI → Menu options: displays choices (evidence: `src/battlearena/ui/GameUI.java`)
- Game UI → After-battle choices: displays choices (evidence: `src/battlearena/ui/GameUI.java`)
- Game orchestration → Fighter factory: creates fighters (evidence: `src/battlearena/service/GameService.java`)
- Game orchestration → Battle engine: executes actions (evidence: `src/battlearena/service/GameService.java`)
- Game orchestration → Arena socket client: requests history exchange (evidence: `src/battlearena/service/GameService.java`)
- Game orchestration → Player state: maintains players (evidence: `src/battlearena/service/GameService.java`)
- Fighter factory → Fighter types: selects archetype (evidence: `src/battlearena/service/FighterFactory.java`)
- Fighter factory → Warrior fighter: constructs (evidence: `src/battlearena/service/FighterFactory.java`)
- Fighter factory → Rogue fighter: constructs (evidence: `src/battlearena/service/FighterFactory.java`)
- Fighter factory → Mage fighter: constructs (evidence: `src/battlearena/service/FighterFactory.java`)
- Warrior fighter → Fighter mechanics: extends mechanics (evidence: `src/battlearena/model/Warrior.java`)
- Rogue fighter → Fighter mechanics: extends mechanics (evidence: `src/battlearena/model/Rogue.java`)
- Mage fighter → Fighter mechanics: extends mechanics (evidence: `src/battlearena/model/Mage.java`)
- Battle engine → Player actions: dispatches action (evidence: `src/battlearena/service/BattleService.java`)
- Battle engine → Special actions: applies special rules (evidence: `src/battlearena/service/BattleService.java`)
- Battle engine → Fighter mechanics: changes combat state (evidence: `src/battlearena/service/BattleService.java`)
- Battle engine → Turn log: creates log (evidence: `src/battlearena/service/BattleService.java`)
- Game orchestration → Turn result: returns turn outcome (evidence: `src/battlearena/service/GameService.java`)
- Turn result → Turn log: contains log (evidence: `src/battlearena/model/TurnResult.java`)
- Game orchestration → Match result: builds match record (evidence: `src/battlearena/service/GameService.java`)
- Match result → Fighter types: records fighter types (evidence: `src/battlearena/model/BattleResult.java`)
- Match result → Win or loss: records outcome (evidence: `src/battlearena/model/BattleResult.java`)
- Arena socket client → Match result: serializes and parses (evidence: `src/battlearena/client/ArenaClient.java`)
- Arena socket client → Arena server: exchanges socket requests
