# odeluna/goodburger architecture

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

- Interactive diagram: https://gitdiagram.com/odeluna/goodburger
- Repository: https://github.com/odeluna/goodburger

## Overview

This JavaFX desktop app combines a rewards-points screen with Pipe Flight. A user views rewards or starts a paid game; the app checks and updates persistent progress, while the game runs through noir-city, ocean, and underwater stages, with hazards, card collection, poker, upgrades, and an ending. The UI renders the game with a Canvas and loads sprite and audio assets. The sampled sources show key calls among the app, game, rendering, audio, and progress store; README statements support several game capabilities whose implementation details were not sampled.

Main entry points: [`src/main/java/rewards/PipeFlightGame.java`](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightGame.java) (Flight rules), [`src/main/java/rewards/RewardsApp.java`](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/RewardsApp.java) (Rewards app), [`src/main/java/rewards/ProgressStore.java`](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/ProgressStore.java) (Progress store), [`src/main/java/rewards/GameAudio.java`](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/GameAudio.java) (Game audio)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Rewards interface"]
  node_app["Rewards app<br/>[RewardsApp.java]"]
  node_flight_canvas["Game canvas"]
end

subgraph group_flight["Pipe Flight"]
  node_game["Flight rules"]
  node_city["Noir city"]
  node_ocean["Ocean stage"]
  node_underwater["Underwater stage"]
  node_poker["Poker rounds<br/>[Poker.java]"]
end

subgraph group_economy["Points economy"]
  node_progress[("Progress store<br/>[ProgressStore.java]")]
  node_economy_rules["Economy rules<br/>[EconomyRules.java]"]
  node_achievements["Achievements<br/>[Achievements.java]"]
end

subgraph group_assets["Game assets"]
  node_sprites["Sprite atlas<br/>[SpriteAtlas.java]"]
  node_audio["Game audio<br/>[GameAudio.java]"]
  node_audio_files["Audio assets"]
end

node_user(("Player"))

node_user -->|"uses"| node_app
node_app -->|"starts plays"| node_progress
node_app -->|"creates session"| node_game
node_app -->|"creates canvas"| node_flight_canvas
node_app -->|"updates audio"| node_audio
node_app -->|"loads sprites"| node_sprites
node_flight_canvas -->|"renders state"| node_game
node_game -->|"runs rounds"| node_poker
node_game -->|"records wins"| node_progress
node_game -->|"reads size"| node_sprites
node_audio -->|"reads state"| node_game
node_audio -->|"loads WAVs"| node_audio_files
node_progress -->|"applies rules"| node_economy_rules
node_progress -->|"grants definitions"| node_achievements
node_game -->|"supports stage"| node_city
node_game -->|"supports stage"| node_ocean
node_game -->|"supports stage"| node_underwater
node_game -->|"offers showdown"| node_poker

click node_app "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/RewardsApp.java"
click node_flight_canvas "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightCanvas.java"
click node_game "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightGame.java"
click node_city "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightGame.java"
click node_ocean "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightGame.java"
click node_underwater "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightGame.java"
click node_poker "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/Poker.java"
click node_progress "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/ProgressStore.java"
click node_economy_rules "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/EconomyRules.java"
click node_achievements "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/Achievements.java"
click node_sprites "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/SpriteAtlas.java"
click node_audio "https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/GameAudio.java"
click node_audio_files "https://github.com/odeluna/goodburger/tree/main/src/main/resources/rewards/assets/audio"

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_app,node_flight_canvas toneBlue
class node_game,node_city,node_ocean,node_underwater,node_poker toneAmber
class node_progress,node_economy_rules,node_achievements toneMint
class node_sprites,node_audio,node_audio_files toneRose
class node_user toneIndigo
```

## Components

### Rewards interface

- [Rewards app](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/RewardsApp.java): `src/main/java/rewards/RewardsApp.java`
- [Game canvas](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightCanvas.java): `src/main/java/rewards/PipeFlightCanvas.java`

### Pipe Flight

- [Flight rules](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightGame.java): `src/main/java/rewards/PipeFlightGame.java`
- [Noir city](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightGame.java): `src/main/java/rewards/PipeFlightGame.java`
- [Ocean stage](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightGame.java): `src/main/java/rewards/PipeFlightGame.java`
- [Underwater stage](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/PipeFlightGame.java): `src/main/java/rewards/PipeFlightGame.java`
- [Poker rounds](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/Poker.java): `src/main/java/rewards/Poker.java`

### Points economy

- [Progress store](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/ProgressStore.java): `src/main/java/rewards/ProgressStore.java`
- [Economy rules](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/EconomyRules.java): `src/main/java/rewards/EconomyRules.java`
- [Achievements](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/Achievements.java): `src/main/java/rewards/Achievements.java`

### Game assets

- [Sprite atlas](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/SpriteAtlas.java): `src/main/java/rewards/SpriteAtlas.java`
- [Game audio](https://github.com/odeluna/goodburger/blob/main/src/main/java/rewards/GameAudio.java): `src/main/java/rewards/GameAudio.java`
- [Audio assets](https://github.com/odeluna/goodburger/tree/main/src/main/resources/rewards/assets/audio): `src/main/resources/rewards/assets/audio`

### Other components

- **Player**

## Connections

- Player → Rewards app: uses (evidence: `README.md`)
- Rewards app → Progress store: starts plays (evidence: `src/main/java/rewards/RewardsApp.java`)
- Rewards app → Flight rules: creates session (evidence: `src/main/java/rewards/RewardsApp.java`)
- Rewards app → Game canvas: creates canvas (evidence: `src/main/java/rewards/RewardsApp.java`)
- Rewards app → Game audio: updates audio (evidence: `src/main/java/rewards/RewardsApp.java`)
- Rewards app → Sprite atlas: loads sprites (evidence: `src/main/java/rewards/RewardsApp.java`)
- Game canvas → Flight rules: renders state (evidence: `src/main/java/rewards/PipeFlightCanvas.java`)
- Flight rules → Poker rounds: runs rounds (evidence: `src/main/java/rewards/PipeFlightGame.java`)
- Flight rules → Progress store: records wins (evidence: `src/main/java/rewards/PipeFlightGame.java`)
- Flight rules → Sprite atlas: reads size (evidence: `src/main/java/rewards/PipeFlightGame.java`)
- Game audio → Flight rules: reads state (evidence: `src/main/java/rewards/GameAudio.java`)
- Game audio → Audio assets: loads WAVs (evidence: `src/main/java/rewards/GameAudio.java`)
- Progress store → Economy rules: applies rules (evidence: `src/main/java/rewards/ProgressStore.java`)
- Progress store → Achievements: grants definitions (evidence: `src/main/java/rewards/ProgressStore.java`)
- Flight rules → Noir city: supports stage (evidence: `README.md`)
- Flight rules → Ocean stage: supports stage (evidence: `README.md`)
- Flight rules → Underwater stage: supports stage (evidence: `README.md`)
- Flight rules → Poker rounds: offers showdown (evidence: `README.md`)
