# nick-2002b/pss25-gioco-oca architecture

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

- Interactive diagram: https://gitdiagram.com/nick-2002b/pss25-gioco-oca
- Repository: https://github.com/nick-2002b/pss25-gioco-oca

## Overview

Giocooca is a JavaFX board game. The main flow is from the player’s menu choice through game setup, which builds a configured board, dice and match, into turn-by-turn play and the displayed result. Separate screens handle rules and settings; settings persist locally, and audio supports music and sound effects. The graph follows documented navigation and sampled controller/model behavior; some unsampled screen wiring is omitted rather than inferred.

Main entry points: [`src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java`](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java) (Scene manager), [`src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java`](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java) (Game setup), [`src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java`](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java) (Match controller), [`src/main/java/it/unibo/giocooca/controller/impl/SettingsControllerImpl.java`](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/SettingsControllerImpl.java) (Settings screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application navigation"]
  node_application["Application startup<br/>[App.java]"]
  node_scene["Scene manager"]
end

subgraph group_screens["Screens and controllers"]
  node_menu["Menu screen"]
  node_rules["Rules screen"]
  node_settings["Settings screen"]
  node_setup["Game setup"]
  node_matchplay["Match controller"]
  node_menuview["Menu view<br/>[MenuViewImpl.java]"]
  node_rulesview["Rules view<br/>[RulesViewImpl.java]"]
  node_settingsview["Settings view"]
  node_setupview["Setup view<br/>[SetupViewImpl.java]"]
  node_matchview["Match view<br/>[MatchViewImpl.java]"]
end

subgraph group_game["Game domain"]
  node_boardcontroller["Board controller"]
  node_boardview["Board view<br/>[BoardViewImpl.java]"]
  node_match["Match state<br/>[MatchImpl.java]"]
  node_board["Board and cells<br/>[BoardImpl.java]"]
  node_players["Players and pieces<br/>[PlayerImpl.java]"]
  node_dice["Dice<br/>[DiceImpl.java]"]
  node_placement["Placement strategies"]
end

subgraph group_support["Settings and audio"]
  node_settingsstate["Settings model<br/>[Settings.java]"]
  node_settingsstore[("Settings file store")]
  node_audio["Sound manager<br/>[SoundManager.java]"]
end

node_player(("Player"))

node_player -.->|"starts"| node_application
node_application -->|"creates"| node_scene
node_scene -->|"opens"| node_menu
node_scene -->|"opens"| node_rules
node_scene -->|"opens"| node_settings
node_scene -->|"opens"| node_setup
node_scene -->|"starts"| node_matchplay
node_scene -->|"loads"| node_settingsstore
node_scene -->|"sets volume"| node_audio
node_setup -->|"shows"| node_setupview
node_setup -->|"selects"| node_placement
node_setup -->|"creates"| node_board
node_setup -->|"creates"| node_dice
node_setup -->|"creates"| node_match
node_setup -->|"opens match"| node_scene
node_settings -->|"updates"| node_settingsstate
node_settings -->|"saves"| node_settingsstore
node_settings -->|"sets volume"| node_audio
node_settings -->|"shows"| node_settingsview
node_settingsstore -->|"reads and writes"| node_settingsstate
node_matchplay -->|"reads and moves"| node_match
node_matchplay -->|"creates"| node_boardcontroller
node_matchplay -->|"updates positions"| node_boardview
node_matchplay -->|"updates display"| node_matchview
node_matchplay -->|"plays effects"| node_audio
node_boardcontroller -->|"reads"| node_board
node_boardcontroller -->|"reads positions"| node_players
node_boardview -->|"queries"| node_boardcontroller
node_menu -.->|"renders"| node_menuview
node_rules -.->|"renders"| node_rulesview
node_matchview -.->|"displays"| node_boardview

click node_application "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/App.java"
click node_scene "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java"
click node_menu "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/MenuControllerImpl.java"
click node_rules "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/RulesControllerImpl.java"
click node_settings "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/SettingsControllerImpl.java"
click node_setup "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java"
click node_matchplay "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java"
click node_menuview "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/MenuViewImpl.java"
click node_rulesview "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/RulesViewImpl.java"
click node_settingsview "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/SettingsViewImpl.java"
click node_setupview "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/SetupViewImpl.java"
click node_matchview "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/MatchViewImpl.java"
click node_boardcontroller "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/BoardControllerImpl.java"
click node_boardview "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/BoardViewImpl.java"
click node_match "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/MatchImpl.java"
click node_board "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/BoardImpl.java"
click node_players "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/PlayerImpl.java"
click node_dice "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/DiceImpl.java"
click node_placement "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/RandomPlacementStrategy.java"
click node_settingsstate "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/Settings.java"
click node_settingsstore "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/SettingsManager.java"
click node_audio "https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/audio/SoundManager.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_application,node_scene toneBlue
class node_menu,node_rules,node_settings,node_setup,node_matchplay,node_menuview,node_rulesview,node_settingsview,node_setupview,node_matchview toneAmber
class node_boardcontroller,node_boardview,node_match,node_board,node_players,node_dice,node_placement toneMint
class node_settingsstate,node_settingsstore,node_audio toneRose
class node_player toneIndigo
```

## Components

### Application navigation

- [Application startup](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/App.java): `src/main/java/it/unibo/giocooca/App.java`
- [Scene manager](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java): `src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java`

### Screens and controllers

- [Menu screen](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/MenuControllerImpl.java): `src/main/java/it/unibo/giocooca/controller/impl/MenuControllerImpl.java`
- [Rules screen](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/RulesControllerImpl.java): `src/main/java/it/unibo/giocooca/controller/impl/RulesControllerImpl.java`
- [Settings screen](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/SettingsControllerImpl.java): `src/main/java/it/unibo/giocooca/controller/impl/SettingsControllerImpl.java`
- [Game setup](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java): `src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java`
- [Match controller](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java): `src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java`
- [Menu view](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/MenuViewImpl.java): `src/main/java/it/unibo/giocooca/view/impl/MenuViewImpl.java`
- [Rules view](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/RulesViewImpl.java): `src/main/java/it/unibo/giocooca/view/impl/RulesViewImpl.java`
- [Settings view](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/SettingsViewImpl.java): `src/main/java/it/unibo/giocooca/view/impl/SettingsViewImpl.java`
- [Setup view](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/SetupViewImpl.java): `src/main/java/it/unibo/giocooca/view/impl/SetupViewImpl.java`
- [Match view](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/MatchViewImpl.java): `src/main/java/it/unibo/giocooca/view/impl/MatchViewImpl.java`

### Game domain

- [Board controller](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/controller/impl/BoardControllerImpl.java): `src/main/java/it/unibo/giocooca/controller/impl/BoardControllerImpl.java`
- [Board view](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/view/impl/BoardViewImpl.java): `src/main/java/it/unibo/giocooca/view/impl/BoardViewImpl.java`
- [Match state](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/MatchImpl.java): `src/main/java/it/unibo/giocooca/model/impl/MatchImpl.java`
- [Board and cells](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/BoardImpl.java): `src/main/java/it/unibo/giocooca/model/impl/BoardImpl.java`
- [Players and pieces](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/PlayerImpl.java): `src/main/java/it/unibo/giocooca/model/impl/PlayerImpl.java`
- [Dice](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/DiceImpl.java): `src/main/java/it/unibo/giocooca/model/impl/DiceImpl.java`
- [Placement strategies](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/RandomPlacementStrategy.java): `src/main/java/it/unibo/giocooca/model/impl/RandomPlacementStrategy.java`

### Settings and audio

- [Settings model](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/Settings.java): `src/main/java/it/unibo/giocooca/model/Settings.java`
- [Settings file store](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/model/impl/SettingsManager.java): `src/main/java/it/unibo/giocooca/model/impl/SettingsManager.java`
- [Sound manager](https://github.com/nick-2002b/pss25-gioco-oca/blob/main/src/main/java/it/unibo/giocooca/audio/SoundManager.java): `src/main/java/it/unibo/giocooca/audio/SoundManager.java`

### Other components

- **Player**

## Connections

- Player → Application startup: starts
- Application startup → Scene manager: creates (evidence: `src/main/java/it/unibo/giocooca/App.java`)
- Scene manager → Menu screen: opens (evidence: `src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java`)
- Scene manager → Rules screen: opens (evidence: `src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java`)
- Scene manager → Settings screen: opens (evidence: `src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java`)
- Scene manager → Game setup: opens (evidence: `src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java`)
- Scene manager → Match controller: starts (evidence: `src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java`)
- Scene manager → Settings file store: loads (evidence: `src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java`)
- Scene manager → Sound manager: sets volume (evidence: `src/main/java/it/unibo/giocooca/navigation/impl/SceneManagerImpl.java`)
- Game setup → Setup view: shows (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java`)
- Game setup → Placement strategies: selects (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java`)
- Game setup → Board and cells: creates (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java`)
- Game setup → Dice: creates (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java`)
- Game setup → Match state: creates (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java`)
- Game setup → Scene manager: opens match (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SetupControllerImpl.java`)
- Settings screen → Settings model: updates (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SettingsControllerImpl.java`)
- Settings screen → Settings file store: saves (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SettingsControllerImpl.java`)
- Settings screen → Sound manager: sets volume (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SettingsControllerImpl.java`)
- Settings screen → Settings view: shows (evidence: `src/main/java/it/unibo/giocooca/controller/impl/SettingsControllerImpl.java`)
- Settings file store → Settings model: reads and writes (evidence: `src/main/java/it/unibo/giocooca/model/impl/SettingsManager.java`)
- Match controller → Match state: reads and moves (evidence: `src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java`)
- Match controller → Board controller: creates (evidence: `src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java`)
- Match controller → Board view: updates positions (evidence: `src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java`)
- Match controller → Match view: updates display (evidence: `src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java`)
- Match controller → Sound manager: plays effects (evidence: `src/main/java/it/unibo/giocooca/controller/impl/MatchControllerImpl.java`)
- Board controller → Board and cells: reads (evidence: `src/main/java/it/unibo/giocooca/controller/impl/BoardControllerImpl.java`)
- Board controller → Players and pieces: reads positions (evidence: `src/main/java/it/unibo/giocooca/controller/impl/BoardControllerImpl.java`)
- Board view → Board controller: queries (evidence: `src/main/java/it/unibo/giocooca/view/impl/BoardViewImpl.java`)
- Menu screen → Menu view: renders (evidence: `src/main/java/it/unibo/giocooca/controller/impl/MenuControllerImpl.java`)
- Rules screen → Rules view: renders (evidence: `src/main/java/it/unibo/giocooca/controller/impl/RulesControllerImpl.java`)
- Match view → Board view: displays
