# alessiapacca/ing-sw-2019-13 architecture

> Architecture diagram of the GitHub repository alessiapacca/ing-sw-2019-13, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alessiapacca/ing-sw-2019-13
- Repository: https://github.com/alessiapacca/ing-sw-2019-13

## Overview

##### Project type and purpose
- This is a full-stack Java multiplayer board-game application (“Adrenaline”) with:
- A Server component (game logic, controllers, network listeners)
- A Client component offering both CLI and JavaFX GUI, with support for Socket and RMI connections
- The README confirms: complete game rules, socket/RMI support, GUI/CLI, multiplayer.

##### File structure
- Top-level: pom.xml, UML folder, configfolder, src/main, src/test
- src/main/java splits into packages:
- answers (DTOs for server→client responses)
- client (cli/gui, ConnectionSocket/ConnectionRMI, Updater, GameModel)
- server (SocketServer/ServerRMI, ClientHandler, GameProxy, GameManager)
- server/controller (TurnHandler, validators/actuators for each player action)
- server/model (domain: gameboard, map, player, cards, items)
- constants, exceptions, launcher
- src/main/resources: fxml views, maps, JSON configs (weapons/powerups/ammo_tiles)

##### README
- Technologies: Java 11+, Maven, JavaFX, Sockets, RMI.

- Client Cluster (blue):
- UI Layer:
– CLI: CliInput, UpdaterCLI
– GUI: JavaFX controllers (StartMenuController, MainGuiController, LoadingScreenController, etc.)
- Controller Layer: ActionParser, InputAbstract, Updater, ReceiverInterface
- Model Layer: GameModel, DTO packages (Info)
- Network Adapters: ConnectionSocket, ConnectionRMI, ListenerSocketThread
- Network (orange):
- Server Cluster (green):
- Network Layer: SocketServer, SocketClientHandler, ServerRMI, GameProxyInterface
- Application Layer: GameProxy, GameManager
- Controller Layer: TurnHandler, TurnPhase, validators & actuators for each action
- Domain Model: packages under server.model (gameboard, map, player, cards, items)
- Timer sub-system: GameStartTimer, NextPlayerTimer, SpawnTimer, TagbackTimer

##### Final advice
- Layers but collapse low-level classes into packages for readability.
- Package with the main classes or responsibilities.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Cluster
    subgraph "Client Application"
        direction TB
        cli["CLI UI"]:::client
        gui["GUI UI"]:::client
        parser["ActionParser"]:::client
        inputAbs["InputAbstract"]:::client
        updater["Updater"]:::client
        receiver["ReceiverInterface"]:::client
        model["GameModel"]:::client
        dtos["Answer DTOs"]:::dto
        connSock["ConnectionSocket «Socket»"]:::network
        connRMI["ConnectionRMI «RMI»"]:::network
        listener["ListenerSocketThread"]:::client
        cli -->|uses| parser
        gui -->|uses| parser
        parser --> inputAbs
        inputAbs --> updater
        updater --> receiver
        receiver --> model
        parser --> connSock
        parser --> connRMI
        connSock --> listener
        listener --> dtos
        dtos --> model
        model --> updater
        updater --> cli
        updater --> gui
    end

    %% Network Boundary
    subgraph "Network" 
        direction TB
        sockProto["TCP Socket"]:::network
        rmiProto["RMI Stub"]:::network
    end
    connSock -->|"TCP"| sockProto
    connRMI -->|"RMI"| rmiProto

    %% Server Cluster
    subgraph "Server Application"
        direction TB
        socketSrv["SocketServer"]:::server
        socketHandler["SocketClientHandler"]:::server
        serverRMI["ServerRMI"]:::server
        proxyIface["GameProxyInterface"]:::server
        gameProxy["GameProxy"]:::server
        gameMgr["GameManager"]:::server
        controller["TurnHandler/TurnPhase"]:::server
        domain["Domain Model"]:::server
        timers["Timer Subsystem"]:::server

        sockProto --> socketSrv
        socketSrv --> socketHandler
        socketHandler --> proxyIface

        rmiProto --> serverRMI
        serverRMI --> proxyIface

        proxyIface --> gameProxy
        gameProxy --> gameMgr
        gameMgr --> controller
        controller --> domain
        domain --> dtos
        timers --> gameMgr
    end

    %% Resource Store
    resources[(Configuration & Resources)]:::resource
    resources -.-> domain
    resources -.-> gui

    %% Click Events
    click cli "https://github.com/alessiapacca/ing-sw-2019-13/tree/master/src/main/java/client"
    click updater "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/client/Updater.java"
    click parser "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/client/ActionParser.java"
    click inputAbs "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/client/InputAbstract.java"
    click receiver "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/client/ReceiverInterface.java"
    click model "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/client/GameModel.java"
    click connSock "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/client/ConnectionSocket.java"
    click connRMI "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/client/ConnectionRMI.java"
    click listener "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/client/ListenerSocketThread.java"
    click dtos "https://github.com/alessiapacca/ing-sw-2019-13/tree/master/src/main/java/answers"
    click socketSrv "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/server/SocketServer.java"
    click socketHandler "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/server/SocketClientHandler.java"
    click serverRMI "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/server/ServerRMI.java"
    click proxyIface "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/server/GameProxyInterface.java"
    click gameProxy "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/server/GameProxy.java"
    click gameMgr "https://github.com/alessiapacca/ing-sw-2019-13/blob/master/src/main/java/server/GameManager.java"

    %% Styles
    classDef client fill:#D0E8FF,stroke:#0277BD,color:#000;
    classDef server fill:#D0F8D0,stroke:#388E3C,color:#000;
    classDef network fill:#FFE0B2,stroke:#FB8C00,color:#000;
    classDef dto fill:#FFF9C4,stroke:#FBC02D,color:#000;
    classDef resource fill:#ECEFF1,stroke:#90A4AE,color:#000;
```
