# moise7000/codename-java-clone architecture

> Architecture diagram of the GitHub repository moise7000/codename-java-clone, 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/moise7000/codename-java-clone
- Repository: https://github.com/moise7000/codename-java-clone

## Overview

##### Project type and purpose
- This is a desktop full-stack Java application built with JavaFX.
- Purpose: Implement a “Codenames”-style word/image guessing game with multiple modes (normal, images, blitz, duo, AI-assisted), with customizable decks, persistence (saved games, custom lists) and basic AI integration (LLM).

##### File structure
- Top-level:
- build.gradle, gradlew wrappers (build & run)
- data/ (SQLite DBs)
- release/ (final jar)
- src/main/java:
– gameInterface: MainApp (entry point)
– controllers: one controller per FXML view (handles user events, calls model/services)
– model: game domain objects, business logic, animations, LLMClient, Observer interfaces
– common: shared utilities (AiStrategy, JSON validation, popup, SceneLoader), DAO layer (DataManager, services, annotations)
– views: Java classes representing programmatic views (rare)
- src/main/resources:
– fxml views, CSS, assets (images, sounds), .env, saved_games folder
- Configuration & build scripts: Gradle files, INSTRUCTIONS.

##### README for additional insights
- Lists game modes, features, persistence, AI mode.
- Indicates use of JavaFX (javafx.controls, javafx.fxml), SQLite (data/data.db), JSON for deck files, LLM integration.

- UI Layer (controllers/views) – e.g., blue
- Domain Layer (models, AI) – e.g., green
- Persistence Layer (DAOs, DB) – e.g., orange
- External Services (LLM endpoint) – e.g., gray

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Application Layer
    subgraph "Application Layer"
        MainApp["MainApp"]:::application
        SceneLoader["SceneLoader"]:::application
    end

    %% UI Layer
    subgraph "UI Layer"
        Controllers["Controllers"]:::ui
        FXMLViews["FXML Views"]:::ui
        CSS["Stylesheet (Styles.css)"]:::ui
    end

    %% Domain Layer
    subgraph "Domain Layer"
        Game["Game"]:::domain
        GameGrid["GameGrid"]:::domain
        GameCard["GameCard"]:::domain
        GameImageCard["GameImageCard"]:::domain
        DuoGame["DuoGame"]:::domain
        DuoGameGrid["DuoGameGrid"]:::domain
        DuoGameCard["DuoGameCard"]:::domain
        Player["Player"]:::domain
        Team["Team"]:::domain
        WordListModel["WordList"]:::domain
        ImageListModel["ImageList"]:::domain
        LLMClient["LLMClient"]:::external
        AiStrategy["AiStrategy"]:::domain
        Observable["Observable"]:::domain
        SubjectObserver["SubjectObserver"]:::domain
        EntityAnimation["EntityAnimation"]:::domain
        ParallaxBackground["ParallaxBackground"]:::domain
        ParallaxLayer["ParallaxLayer"]:::domain
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        DataManager["DataManager"]:::persistence
        ImageDataManager["ImageDataManager"]:::persistence
        WordListService["WordListService"]:::persistence
        ImageListService["ImageListService"]:::persistence
        JsonValidator["JsonValidator"]:::persistence
        SQLiteDB["SQLite Database (data.db)"]:::persistence
        JSONDeck["Sample JSON Deck"]:::persistence
        SavedGames["Saved Games"]:::persistence
    end

    %% External Dependencies
    subgraph "External Services"
        JavaFX["JavaFX SDK"]:::external
        SQLiteLib["SQLite JDBC"]:::external
        LLMEndpoint["LLM Endpoint"]:::external
    end

    %% Relationships
    MainApp -->|"init()"| SceneLoader
    SceneLoader -->|"loadFXML()"| Controllers
    Controllers -->|"handleUserEvent()"| Game
    Game -->|"-startGame(), makeGuess(), nextTurn()"| Controllers
    Game -->|"-notifyObservers()"| Controllers
    Controllers -->|"loadView()"| FXMLViews
    Controllers -->|"applyStyles()"| CSS
    Controllers -->|"saveState(), loadState()"| DataManager
    DataManager -->|"CRUD"| SQLiteDB
    Controllers -->|"loadCustomDeck()"| JsonValidator
    JsonValidator -->|"parse()"| JSONDeck
    Controllers -->|"saveGame()"| SavedGames
    Game -->|"requestHint()"| LLMClient
    LLMClient -->|"REST call"| LLMEndpoint
    Game -->|"loadImages()"| ImageDataManager
    ImageDataManager -->|"CRUD"| SQLiteDB

    %% Click Events
    click MainApp "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/gameInterface/MainApp.java"
    click SceneLoader "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/common/SceneLoader.java"
    click Controllers "https://github.com/moise7000/codename-java-clone/tree/main/src/main/java/controllers/"
    click FXMLViews "https://github.com/moise7000/codename-java-clone/tree/main/src/main/resources/views/"
    click CSS "https://github.com/moise7000/codename-java-clone/blob/main/src/main/resources/styles/Styles.css"
    click Game "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/Game.java"
    click GameGrid "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/GameGrid.java"
    click GameCard "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/GameCard.java"
    click GameImageCard "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/GameImageCard.java"
    click DuoGame "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/DuoGame.java"
    click DuoGameGrid "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/DuoGameGrid.java"
    click DuoGameCard "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/DuoGameCard.java"
    click Player "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/Player.java"
    click Team "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/Team.java"
    click WordListModel "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/WordList.java"
    click ImageListModel "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/ImageList.java"
    click LLMClient "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/LLMClient.java"
    click AiStrategy "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/common/AiStrategy.java"
    click Observable "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/Observable.java"
    click SubjectObserver "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/common/SubjectObserver.java"
    click EntityAnimation "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/animation/EntityAnimation.java"
    click ParallaxBackground "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/animation/ParallaxBackground.java"
    click ParallaxLayer "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/model/animation/ParallaxLayer.java"
    click DataManager "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/common/sql/DataManager.java"
    click ImageDataManager "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/common/sql/ImageDataManager.java"
    click WordListService "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/common/sql/services/WordListService.java"
    click ImageListService "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/common/sql/services/ImageListService.java"
    click JsonValidator "https://github.com/moise7000/codename-java-clone/blob/main/src/main/java/common/JsonValidator.java"
    click SQLiteDB "https://github.com/moise7000/codename-java-clone/blob/main/data/data.db"
    click JSONDeck "https://github.com/moise7000/codename-java-clone/blob/main/src/main/resources/Test.json"
    click SavedGames "https://github.com/moise7000/codename-java-clone/tree/main/src/main/resources/saved_games/"

    %% Styles
    classDef application fill:#add8e6,stroke:#333,stroke-width:1px;
    classDef ui fill:#87CEFA,stroke:#333,stroke-width:1px;
    classDef domain fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef persistence fill:#FFA500,stroke:#333,stroke-width:1px;
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px;
```
