# sapirshenkor/winter-sports-competition-simulator architecture

> Architecture diagram of the GitHub repository sapirshenkor/winter-sports-competition-simulator, 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/sapirshenkor/winter-sports-competition-simulator
- Repository: https://github.com/sapirshenkor/winter-sports-competition-simulator

## Overview

This is a Swing winter-sports competition simulator. Users configure an arena and race, add or clone and decorate eligible competitors, then start a live race and inspect standings and states. The runtime centers on competitor threads publishing property changes: Competition tracks entrants and finishes, while the GUI observes updates for arena visualization and controls. The graph preserves README-documented builder, prototype, decorator, state, summer-arena, and scoreboard capabilities. Edges are limited to README statements and shown source references; unsampled implementation links are omitted or dashed where unverified.

Main entry points: [`src/Gui/ActionHandler.java`](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/Gui/ActionHandler.java) (UI Actions), [`src/game/entities/sportsman/Sportman.java`](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/Sportman.java) (Threaded Sportsman), [`src/game/competition/Competition.java`](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/Competition.java) (Competition Engine), [`src/game/entities/sportsman/WinterSportsman.java`](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/WinterSportsman.java) (Winter Sportsman)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Swing Interface"]
  node_program["Program Entry<br/>[Program.java]"]
  node_panel["Control Panel<br/>[BPanel.java]"]
  node_actions["UI Actions<br/>[ActionHandler.java]"]
  node_scoreboard["Arena and Scoreboard"]
end

subgraph group_setup["Arena Setup"]
  node_factory["Arena Factory<br/>[ArenaFactory.java]"]
  node_winter["Winter Arena<br/>[WinterArena.java]"]
  node_summer["Summer Arena<br/>[SummerArena.java]"]
  node_builder["Ski Builder"]
  node_surface["Arena Surface<br/>[SnowSurface.java]"]
  node_weather["Weather Rules"]
end

subgraph group_race["Competition Domain"]
  node_competition["Competition Engine<br/>[Competition.java]"]
  node_wintercomp["Winter Rules"]
  node_skicomp["Ski Competition"]
  node_snowcomp["Snowboard Competition"]
  node_league["League Rules<br/>[League.java]"]
end

subgraph group_racers["Competitors"]
  node_competitor["Competitor Contract<br/>[Competitor.java]"]
  node_winterman["Winter Sportsman"]
  node_sportman["Threaded Sportsman<br/>[Sportman.java]"]
  node_skier["Skier Prototype<br/>[Skier.java]"]
  node_snowboarder["Snowboarder Prototype<br/>[Snowboarder.java]"]
  node_decorators["Speed and Color<br/>[WSDecorator.java]"]
end

subgraph group_lifecycle["Race Lifecycle"]
  node_states["Competitor States"]
  node_point["Race Position<br/>[Point.java]"]
end

node_user(("Race Operator"))

node_user -->|"configures"| node_panel
node_program -->|"launches"| node_panel
node_panel -->|"handles actions"| node_actions
node_actions -->|"builds arena"| node_factory
node_factory -->|"creates"| node_winter
node_factory -->|"creates"| node_summer
node_actions -.->|"builds competition"| node_builder
node_builder -->|"creates arena"| node_factory
node_builder -->|"constructs"| node_skicomp
node_actions -->|"starts race"| node_competition
node_skicomp -->|"validates as"| node_wintercomp
node_snowcomp -->|"validates as"| node_wintercomp
node_wintercomp -->|"extends"| node_competition
node_competition -->|"registers and moves"| node_competitor
node_competition -->|"checks finish"| node_winter
node_wintercomp -->|"checks age"| node_league
node_winterman -->|"extends"| node_sportman
node_winterman -->|"implements"| node_competitor
node_skier -->|"specializes"| node_winterman
node_snowboarder -->|"specializes"| node_winterman
node_sportman -->|"changes state"| node_states
node_sportman -->|"publishes events"| node_competition
node_actions -->|"observes updates"| node_sportman
node_actions -->|"renders race"| node_scoreboard
node_actions -->|"clones competitor"| node_skier
node_actions -->|"applies customization"| node_decorators
node_decorators -->|"wraps sportsman"| node_winterman
node_sportman -->|"updates position"| node_point
node_winter -->|"uses friction"| node_surface
node_winter -->|"stores condition"| node_weather

click node_program "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/utilities/Program.java"
click node_panel "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/Gui/BPanel.java"
click node_actions "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/Gui/ActionHandler.java"
click node_scoreboard "https://github.com/sapirshenkor/winter-sports-competition-simulator/tree/main/src/Gui"
click node_factory "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/arena/ArenaFactory.java"
click node_winter "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/arena/WinterArena.java"
click node_summer "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/arena/SummerArena.java"
click node_builder "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/SkiCompetitionBuilder.java"
click node_competition "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/Competition.java"
click node_wintercomp "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/WinterCompetition.java"
click node_skicomp "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/SkiCompetition.java"
click node_snowcomp "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/SnowboardCompetition.java"
click node_competitor "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/Competitor.java"
click node_winterman "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/WinterSportsman.java"
click node_sportman "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/Sportman.java"
click node_skier "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/Skier.java"
click node_snowboarder "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/Snowboarder.java"
click node_decorators "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/WSDecorator.java"
click node_states "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/states/CompetitorState.java"
click node_point "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/utilities/Point.java"
click node_surface "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/enumm/SnowSurface.java"
click node_weather "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/enumm/WeatherCondition.java"
click node_league "https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/enumm/League.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_program,node_panel,node_actions,node_scoreboard toneBlue
class node_factory,node_winter,node_summer,node_builder,node_surface,node_weather toneAmber
class node_competition,node_wintercomp,node_skicomp,node_snowcomp,node_league toneMint
class node_competitor,node_winterman,node_sportman,node_skier,node_snowboarder,node_decorators toneRose
class node_states,node_point,node_user toneIndigo
```

## Components

### Swing Interface

- [Program Entry](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/utilities/Program.java): `src/utilities/Program.java`
- [Control Panel](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/Gui/BPanel.java): `src/Gui/BPanel.java`
- [UI Actions](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/Gui/ActionHandler.java): `src/Gui/ActionHandler.java`
- [Arena and Scoreboard](https://github.com/sapirshenkor/winter-sports-competition-simulator/tree/main/src/Gui): `src/Gui`

### Arena Setup

- [Arena Factory](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/arena/ArenaFactory.java): `src/game/arena/ArenaFactory.java`
- [Winter Arena](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/arena/WinterArena.java): `src/game/arena/WinterArena.java`
- [Summer Arena](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/arena/SummerArena.java): `src/game/arena/SummerArena.java`
- [Ski Builder](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/SkiCompetitionBuilder.java): `src/game/competition/SkiCompetitionBuilder.java`
- [Arena Surface](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/enumm/SnowSurface.java): `src/game/enumm/SnowSurface.java`
- [Weather Rules](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/enumm/WeatherCondition.java): `src/game/enumm/WeatherCondition.java`

### Competition Domain

- [Competition Engine](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/Competition.java): `src/game/competition/Competition.java`
- [Winter Rules](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/WinterCompetition.java): `src/game/competition/WinterCompetition.java`
- [Ski Competition](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/SkiCompetition.java): `src/game/competition/SkiCompetition.java`
- [Snowboard Competition](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/SnowboardCompetition.java): `src/game/competition/SnowboardCompetition.java`
- [League Rules](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/enumm/League.java): `src/game/enumm/League.java`

### Competitors

- [Competitor Contract](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/Competitor.java): `src/game/competition/Competitor.java`
- [Winter Sportsman](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/WinterSportsman.java): `src/game/entities/sportsman/WinterSportsman.java`
- [Threaded Sportsman](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/Sportman.java): `src/game/entities/sportsman/Sportman.java`
- [Skier Prototype](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/Skier.java): `src/game/entities/sportsman/Skier.java`
- [Snowboarder Prototype](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/entities/sportsman/Snowboarder.java): `src/game/entities/sportsman/Snowboarder.java`
- [Speed and Color](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/competition/WSDecorator.java): `src/game/competition/WSDecorator.java`

### Race Lifecycle

- [Competitor States](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/game/states/CompetitorState.java): `src/game/states/CompetitorState.java`
- [Race Position](https://github.com/sapirshenkor/winter-sports-competition-simulator/blob/main/src/utilities/Point.java): `src/utilities/Point.java`

### Other components

- **Race Operator**

## Connections

- Race Operator → Control Panel: configures (evidence: `README.md`)
- Program Entry → Control Panel: launches (evidence: `src/utilities/Program.java`)
- Control Panel → UI Actions: handles actions (evidence: `src/Gui/BPanel.java`)
- UI Actions → Arena Factory: builds arena (evidence: `src/Gui/ActionHandler.java`)
- Arena Factory → Winter Arena: creates (evidence: `src/game/arena/ArenaFactory.java`)
- Arena Factory → Summer Arena: creates (evidence: `src/game/arena/ArenaFactory.java`)
- UI Actions → Ski Builder: builds competition (evidence: `src/Gui/ActionHandler.java`)
- Ski Builder → Arena Factory: creates arena (evidence: `src/game/competition/SkiCompetitionBuilder.java`)
- Ski Builder → Ski Competition: constructs (evidence: `src/game/competition/SkiCompetitionBuilder.java`)
- UI Actions → Competition Engine: starts race (evidence: `README.md`)
- Ski Competition → Winter Rules: validates as (evidence: `src/game/competition/SkiCompetition.java`)
- Snowboard Competition → Winter Rules: validates as (evidence: `src/game/competition/SnowboardCompetition.java`)
- Winter Rules → Competition Engine: extends (evidence: `src/game/competition/WinterCompetition.java`)
- Competition Engine → Competitor Contract: registers and moves (evidence: `src/game/competition/Competition.java`)
- Competition Engine → Winter Arena: checks finish (evidence: `src/game/competition/Competition.java`)
- Winter Rules → League Rules: checks age (evidence: `src/game/competition/WinterCompetition.java`)
- Winter Sportsman → Threaded Sportsman: extends (evidence: `src/game/entities/sportsman/WinterSportsman.java`)
- Winter Sportsman → Competitor Contract: implements (evidence: `src/game/entities/sportsman/WinterSportsman.java`)
- Skier Prototype → Winter Sportsman: specializes (evidence: `src/game/entities/sportsman/Skier.java`)
- Snowboarder Prototype → Winter Sportsman: specializes (evidence: `src/game/entities/sportsman/Snowboarder.java`)
- Threaded Sportsman → Competitor States: changes state (evidence: `src/game/entities/sportsman/Sportman.java`)
- Threaded Sportsman → Competition Engine: publishes events (evidence: `README.md`)
- UI Actions → Threaded Sportsman: observes updates (evidence: `README.md`)
- UI Actions → Arena and Scoreboard: renders race (evidence: `README.md`)
- UI Actions → Skier Prototype: clones competitor (evidence: `README.md`)
- UI Actions → Speed and Color: applies customization (evidence: `README.md`)
- Speed and Color → Winter Sportsman: wraps sportsman (evidence: `src/game/competition/WSDecorator.java`)
- Threaded Sportsman → Race Position: updates position (evidence: `src/game/entities/sportsman/Sportman.java`)
- Winter Arena → Arena Surface: uses friction (evidence: `src/game/arena/WinterArena.java`)
- Winter Arena → Weather Rules: stores condition (evidence: `src/game/arena/WinterArena.java`)
