# ciocks96/hfremastered architecture

> Architecture diagram of the GitHub repository ciocks96/hfremastered, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ciocks96/hfremastered
- Repository: https://github.com/ciocks96/hfremastered

## Overview

Per disegnare un diagramma di sistema chiaro e accurato per il progetto HELIFire (clone di Space Invaders in Java), segui questi passi:

##### Identifica il tipo di progetto e lo scopo
- È un’applicazione desktop Java standalone (non web), organizzata secondo il pattern MVC (Model–View–Controller).
- Scopo: gestire il loop di gioco, le collisioni, il rendering, l’input, i suoni e i punteggi.

##### Mappa la struttura delle directory in macro–componenti
- Entry point/Main: Main.java
- Controller layer: `controller/` (GameController, InputHandler)
- Model layer: `model/` (GameModel, GameState, entità di gioco, interfaccia GameModelListener)
- View layer: `view/` (GameFrame, GamePanel)
- Utility layer: `utility/` (ScoreManager, SoundManager)
- Asset manager: `assets/` (figure, fonts, sounds)
- Persistenza: `highscores.txt`

##### Individua le relazioni e i flussi di dati
- Main → istanzia GameController
- GameController → registra InputHandler e GameModelListener
- InputHandler → invia eventi (movimento, sparo, pausa) a GameController
- GameController → aggiorna GameModel (posizioni, collisioni, stato di gioco)
- GameModel → notifica GameModelListener (es. view o controller) tramite Observer
- View (GameFrame/GamePanel) ← riceve aggiornamenti dallo stato di GameModel → ridisegna la GUI
- GameController → richiama SoundManager per effetti sonori e ScoreManager per punteggi
- ScoreManager → salva/legge da `highscores.txt`
- Ogni componente attinge alle risorse in `assets/`

##### Evidenzia pattern e principi architetturali
- MVC: separazione netta tra logica di business (model), gestione input e regole di gioco (controller), grafica (view).
- Observer: GameModelListener per disaccoppiare aggiornamenti di stato.
- Game Loop classico: il controller gestisce un ciclo di tick/update → render.

##### Guida specifica per un’app desktop di gioco
- Illustra il ciclo di vita: inizializzazione (Main → Controller → inizializza Model/View/Utility) → loop di gioco → evento di chiusura.
- Mostra chiaramente i flussi di evento (input → controller), i flussi di update (controller → model → observer → view) e i flussi di utilità (controller → SoundManager/ScoreManager).
- Raggruppa le risorse asset in un blocco “Asset Manager” con frecce bidirezionali verso view e utility.

##### Elementi da includere nel diagramma
- Blocchi distinti (colore/forma differente) per:
- Entry Point/Main
- Controller Layer
- Model Layer
- View Layer
- Utility Layer
- Asset Repository
- Persistence (highscores.txt)
- Frecce direzionali per ogni flusso:
- Input → Controller
- Controller → Model
- Model → Observer → View
- Controller → Utility (Sound & Score)
- View/Utility → Assets
- ScoreManager ↔ Persistence
- Etichette chiare su ogni freccia (es. “updateState()”, “render()”, “playSound()”, “saveScore()”).
- Legenda o codifica colore:
- Blu = controller
- Verde = model
- Arancio = view
- Viola = utility
- Grigio = risorse/persistence

## Diagram (Mermaid)

```mermaid
graph TD
    %% Entry Point
    Main["Main"]:::entry

    %% Controller Layer
    subgraph "Controller Layer"
        GC["GameController"]:::controller
        IH["InputHandler"]:::controller
    end

    %% Model Layer
    subgraph "Model Layer"
        GM["GameModel"]:::model
        GS["GameState"]:::model
        GML["GameModelListener"]:::model
        subgraph "Game Entities"
            BH["BlueHeli"]:::model
            GH["GreenHeli"]:::model
            YH["YellowHeli"]:::model
            PL["Player"]:::model
            EN["Enemy"]:::model
            BU["Bullet"]:::model
            EB["EnemyBullet"]:::model
            EBo["EnemyBomb"]:::model
            EX["Explosion"]:::model
            SD["ShipDestroyer"]:::model
            BM["BonusSceneManager"]:::model
        end
    end

    %% View Layer
    subgraph "View Layer"
        GF["GameFrame"]:::view
        GP["GamePanel"]:::view
    end

    %% Utility Layer
    subgraph "Utility Layer"
        SMgr["ScoreManager"]:::utility
        SoMgr["SoundManager"]:::utility
    end

    %% Asset Repository
    subgraph "Asset Repository"
        AR["Assets"]:::resource
        FIG["figure/"]:::resource
        FNT["font/"]:::resource
        SND["sounds/"]:::resource
    end

    %% Persistence
    HS["highscores.txt"]:::resource

    %% Flows
    Main -->|"init()"| GC
    GC -->|"register()"| IH
    IH -->|"inputEvent()"| GC
    GC -->|"updateState()"| GM
    GM -->|"notify()"| GML
    GML -->|"update()"| GP
    GP -->|"render()"| GF

    GC -->|"playSound()"| SoMgr
    GC -->|"saveScore()"| SMgr

    SoMgr -->|"loadSound()"| SND
    GP -->|"loadImage()/loadFont()"| FIG
    GP -->|"loadImage()/loadFont()"| FNT

    SMgr -->|"read/write"| HS
    SMgr -->|"loadFont()"| FNT

    FIG --> AR
    FNT --> AR
    SND --> AR

    SMgr --> AR
    SoMgr --> AR
    GP --> AR

    %% Click Events
    click Main "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/Main.java"
    click GC "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/controller/GameController.java"
    click IH "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/controller/InputHandler.java"
    click GM "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/GameModel.java"
    click GS "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/GameState.java"
    click GML "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/GameModelListener.java"
    click BH "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/BlueHeli.java"
    click GH "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/GreenHeli.java"
    click YH "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/YellowHeli.java"
    click PL "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/Player.java"
    click EN "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/Enemy.java"
    click BU "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/Bullet.java"
    click EB "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/EnemyBullet.java"
    click EBo "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/EnemyBomb.java"
    click EX "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/Explosion.java"
    click SD "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/ShipDestroyer.java"
    click BM "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/model/BonusSceneManager.java"
    click GF "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/view/GameFrame.java"
    click GP "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/view/GamePanel.java"
    click SMgr "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/utility/ScoreManager.java"
    click SoMgr "https://github.com/ciocks96/hfremastered/blob/main/HELIFIRE/src/JHeliFire/utility/SoundManager.java"
    click AR "https://github.com/ciocks96/hfremastered/tree/main/HELIFIRE/src/assets/"
    click FIG "https://github.com/ciocks96/hfremastered/tree/main/HELIFIRE/src/assets/figure/"
    click FNT "https://github.com/ciocks96/hfremastered/tree/main/HELIFIRE/src/assets/font/"
    click SND "https://github.com/ciocks96/hfremastered/tree/main/HELIFIRE/src/assets/sounds/"
    click HS "https://github.com/ciocks96/hfremastered/blob/main/highscores.txt"

    %% Styles
    classDef entry fill:#ffffff,stroke:#000000
    classDef controller fill:#cce5ff,stroke:#004085
    classDef model fill:#d4edda,stroke:#155724
    classDef view fill:#ffe5b4,stroke:#e69500
    classDef utility fill:#e2d6f9,stroke:#5b2c6f
    classDef resource fill:#f2f2f2,stroke:#6c757d,stroke-dasharray: 5 5
```
