# velbazhdsoftwarellc/melsambria-slot-simulation architecture

> Architecture diagram of the GitHub repository velbazhdsoftwarellc/melsambria-slot-simulation, 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/velbazhdsoftwarellc/melsambria-slot-simulation
- Repository: https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation

## Overview

Melsambria is a Java slot-game simulator, with a command-line entry point that also searches reel configurations using Jenetics. Its evaluation callback installs a candidate reel genotype, runs a simulation, rejects invalid models, and scores the result against return-to-player and hit-frequency targets. The game class holds reel and statistics state and implements base, free, and shark-game mechanics. The excerpts show some internal game calls, but omit parts of the simulation loop; the graph avoids asserting the missing dispatch sequence.

Main entry points: [`src/main/java/eu/veldsoft/melsambria/Main.java`](https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Main.java) (Fitness callback), [`src/main/java/eu/veldsoft/melsambria/Melsambria.java`](https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java) (Game model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Orchestration"]
  node_entry["Main entry<br/>[Main.java]"]
end

subgraph group_game["Game simulation"]
  node_game["Game model<br/>[Melsambria.java]"]
  node_baseplay["Base play<br/>[Melsambria.java]"]
  node_sharkplay["Shark play<br/>[Melsambria.java]"]
  node_freegames["Free-game setup<br/>[Melsambria.java]"]
  node_paylines["Line evaluation<br/>[Melsambria.java]"]
end

subgraph group_evaluation["Optimization"]
  node_jenetics["Jenetics engine"]
  node_fitness["Fitness callback<br/>[Main.java]"]
end

node_operator(("CLI user"))

node_operator -->|"runs"| node_entry
node_entry -->|"configures"| node_jenetics
node_jenetics -->|"evaluates candidates"| node_fitness
node_fitness -->|"creates and configures"| node_game
node_fitness -->|"runs simulation"| node_game
node_fitness -->|"scores statistics"| node_game
node_baseplay -->|"spins reels"| node_game
node_baseplay -->|"checks scatters"| node_freegames
node_baseplay -->|"evaluates lines"| node_paylines
node_sharkplay -->|"sets up free games"| node_freegames
node_sharkplay -->|"evaluates lines"| node_paylines

click node_entry "https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Main.java"
click node_fitness "https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Main.java"
click node_game "https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java"
click node_baseplay "https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java"
click node_sharkplay "https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java"
click node_freegames "https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java"
click node_paylines "https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.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_entry,node_operator toneBlue
class node_game,node_baseplay,node_sharkplay,node_freegames,node_paylines toneAmber
class node_jenetics,node_fitness toneMint
```

## Components

### Orchestration

- [Main entry](https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Main.java): `src/main/java/eu/veldsoft/melsambria/Main.java`

### Game simulation

- [Game model](https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java): `src/main/java/eu/veldsoft/melsambria/Melsambria.java`
- [Base play](https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java): `src/main/java/eu/veldsoft/melsambria/Melsambria.java`
- [Shark play](https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java): `src/main/java/eu/veldsoft/melsambria/Melsambria.java`
- [Free-game setup](https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java): `src/main/java/eu/veldsoft/melsambria/Melsambria.java`
- [Line evaluation](https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Melsambria.java): `src/main/java/eu/veldsoft/melsambria/Melsambria.java`

### Optimization

- **Jenetics engine**
- [Fitness callback](https://github.com/velbazhdsoftwarellc/melsambria-slot-simulation/blob/main/src/main/java/eu/veldsoft/melsambria/Main.java): `src/main/java/eu/veldsoft/melsambria/Main.java`

### Other components

- **CLI user**

## Connections

- CLI user → Main entry: runs (evidence: `src/main/java/eu/veldsoft/melsambria/Main.java`)
- Main entry → Jenetics engine: configures (evidence: `src/main/java/eu/veldsoft/melsambria/Main.java`)
- Jenetics engine → Fitness callback: evaluates candidates (evidence: `src/main/java/eu/veldsoft/melsambria/Main.java`)
- Fitness callback → Game model: creates and configures (evidence: `src/main/java/eu/veldsoft/melsambria/Main.java`)
- Fitness callback → Game model: runs simulation (evidence: `src/main/java/eu/veldsoft/melsambria/Main.java`)
- Fitness callback → Game model: scores statistics (evidence: `src/main/java/eu/veldsoft/melsambria/Main.java`)
- Base play → Game model: spins reels (evidence: `src/main/java/eu/veldsoft/melsambria/Melsambria.java`)
- Base play → Free-game setup: checks scatters (evidence: `src/main/java/eu/veldsoft/melsambria/Melsambria.java`)
- Base play → Line evaluation: evaluates lines (evidence: `src/main/java/eu/veldsoft/melsambria/Melsambria.java`)
- Shark play → Free-game setup: sets up free games (evidence: `src/main/java/eu/veldsoft/melsambria/Melsambria.java`)
- Shark play → Line evaluation: evaluates lines (evidence: `src/main/java/eu/veldsoft/melsambria/Melsambria.java`)
