# anderwins/codebase architecture

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

- Interactive diagram: https://gitdiagram.com/anderwins/codebase
- Repository: https://github.com/anderwins/codebase

## Overview

##### Project type and purpose
- This is a standalone desktop music-player application built with JavaFX and packaged via Maven.
- It follows a classic layered MVC pattern, with user interface (FXML & ViewControllers), Controllers, Models/Services, Data Access Objects (DAOs), and an embedded database (SQLite or similar).
- It reads/writes music files, stores metadata in a local DB, supports playlists, lyrics, karaoke, and radio streams.

##### File structure
- Top-level build files: `pom.xml`, `.gitlab-ci.yml`.
- Source packages under `src/main/java/ulb`:
- Config & Main launchers (`Config.java`, `GuiMain.java`, `Main.java`).
- `controller` package: JavaFX Controllers and FrontController (`MainController`, `PageController`, `PlayListFrontController`, `PlayerObserver`, error handlers).
- `view` package: FXML view controllers matching each UI screen (e.g., `HomeViewController`, `PlayerViewController`).
- `model` package: domain objects (`Track`, `Playlist`, `Queue`, `Radio`), management classes (`PlaylistManager`, `MetadataManager`, `LrcLibService`), observers, and error types.
- `dao` package: database initialization and CRUD (`DbInitializer`, `DbManager`, `SQLLoader`).
- `services` & `utils`: cross-cutting services (`AppServices`) and helpers (`ColorExtractor`, `AlertManager`).
- Test source tree mirrors main packages for unit tests.

##### README
- Confirms JavaFX stack, Maven build, fat-jar output, user directory for `.deezify_g8` data (music files + `deezify.db`).
- Lists high-level features: playlist management, advanced search, metadata display.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Entry Points
    subgraph "Configuration & Launch"
        Config["Config.java"]:::entry
        MainApp["Main.java"]:::entry
        GuiApp["GuiMain.java"]:::entry
    end

    %% UI Layer
    subgraph "UI Layer"
        FXML["FXML Layouts"]:::ui
        ViewCtrl["JavaFX View Controllers"]:::ui
    end

    %% Presentation / Controller Layer
    subgraph "Controller Layer"
        AppCtrl["Application Controllers"]:::controller
        subgraph "Front Controllers"
            MainFC["MainController"]:::controller
            PlaylistFC["PlayListFrontController"]:::controller
        end
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        Domain["Domain Models & Managers"]:::biz
        subgraph "Observers"
            PlayerObs["PlayerObserver"]:::biz
            PlaylistObs["PlaylistObserver"]:::biz
        end
        Services["AppServices"]:::biz
        Utils["Utilities"]:::biz
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        DAO["DAO Classes"]:::dao
        SQLLoader["SQLLoader"]:::dao
    end

    %% Persistence / External Resources
    subgraph "Persistence Layer"
        DB["SQLite Database: deezify.db"]:::db
        Files["User .deezify_g8 Folder"]:::fs
    end

    %% i18n & Styling & Media Samples
    subgraph "Resources"
        I18n["i18n Properties"]:::res
        LangMgr["LanguageManager.java"]:::res
        CSS["CSS Files"]:::res
        Media["Embedded Media Samples"]:::res
    end

    %% Flows
    User["User"]:::actor
    User -->|"interacts with"| FXML
    FXML -->|"loaded by"| ViewCtrl
    ViewCtrl -->|"calls"| AppCtrl
    AppCtrl -->|"routes to"| MainFC
    AppCtrl -->|"routes to"| PlaylistFC
    AppCtrl -->|"uses"| Services
    AppCtrl -->|"updates"| Domain
    Services -->|"business logic uses"| Domain
    Services -->|"uses utils"| Utils
    MainFC -->|"invokes"| Services
    PlaylistFC -->|"invokes"| Services
    Domain -->|"CRUD operations"| DAO
    DAO -->|"executes SQL"| SQLLoader
    DAO -->|"persists to"| DB
    Domain -->|"reads/writes media & lyrics"| Files
    PlayerObs -.->|"notifies"| ViewCtrl
    PlaylistObs -.->|"notifies"| ViewCtrl

    %% Entry flows
    Config --> MainApp
    MainApp --> GuiApp
    GuiApp --> FXML

    %% Resources connect
    I18n --> ViewCtrl
    LangMgr --> ViewCtrl
    CSS -.-> FXML
    Media --> Files

    %% Click Events
    click Config "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/Config.java"
    click MainApp "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/Main.java"
    click GuiApp "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/GuiMain.java"
    click FXML "https://github.com/anderwins/codebase/tree/main/src/main/resources/fxml"
    click ViewCtrl "https://github.com/anderwins/codebase/tree/main/src/main/java/ulb/view"
    click AppCtrl "https://github.com/anderwins/codebase/tree/main/src/main/java/ulb/controller"
    click MainFC "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/controller/MainController.java"
    click PlaylistFC "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/controller/PlayListFrontController.java"
    click Domain "https://github.com/anderwins/codebase/tree/main/src/main/java/ulb/model"
    click PlayerObs "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/controller/PlayerObserver.java"
    click PlaylistObs "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/model/PlaylistObserver.java"
    click Services "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/services/AppServices.java"
    click Utils "https://github.com/anderwins/codebase/tree/main/src/main/java/ulb/utils"
    click DAO "https://github.com/anderwins/codebase/tree/main/src/main/java/ulb/dao"
    click SQLLoader "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/dao/SQLLoader.java"
    click I18n "https://github.com/anderwins/codebase/tree/main/src/main/resources/i18n"
    click LangMgr "https://github.com/anderwins/codebase/blob/main/src/main/java/ulb/i18n/LanguageManager.java"
    click CSS "https://github.com/anderwins/codebase/tree/main/src/main/resources/css"
    click Media "https://github.com/anderwins/codebase/tree/main/src/main/resources/musiques"

    %% Styles
    classDef actor fill:#CCCCFF,stroke:#000,stroke-width:1px
    classDef entry fill:#E0E0E0,stroke:#000,stroke-width:1px
    classDef ui fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef controller fill:#98FB98,stroke:#000,stroke-width:1px
    classDef biz fill:#FFA500,stroke:#000,stroke-width:1px
    classDef dao fill:#FFFF99,stroke:#000,stroke-width:1px
    classDef db fill:#F5DEB3,stroke:#000,stroke-width:1px
    classDef fs fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef res fill:#D8BFD8,stroke:#000,stroke-width:1px
```
