# aryangh-imp/genius-java architecture

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

- Interactive diagram: https://gitdiagram.com/aryangh-imp/genius-java
- Repository: https://github.com/aryangh-imp/genius-java

## Overview

##### Project type and purpose
- GENIUS is a standalone desktop application written in Java, using JavaFX and FXML for its graphical UI.
- It implements a classic layered MVC‐style monolith (no separate web server or microservices), focused on music management for three roles: Users, Artists, and Administrators.
- Data is stored in a custom file‐based system under the `data/` directory rather than a relational database.

##### File structure
- Top‐level directories:
- `src/main/java`: Java code organized by package (controllers, models, services, utils)
- `src/main/resources`: UI definitions (FXML), CSS, images, and configuration file
- `data/`: hierarchical file storage for user accounts, artist catalogs, lyrics requests, etc.
- `build.gradle`, Gradle wrapper files – build and run scripts
- `src/test`: unit tests for controllers and services
- Architectural patterns:
- MVC: Controllers handle UI events, Services encapsulate business logic, Models/DTOs carry data.
- Layered architecture: UI → Controller → Service → File‐based persistence.
- Utility components: config loader, file util, alert util, scene util.

##### README for additional insights
- Confirms JavaFX/FXML, themes (CSS) and file‐based data store.
- Describes user journeys (browse, like, request edits), artist workflows (CRUD songs & albums), admin workflows (approve/reject requests).
- No external APIs; all operations occur in‐process.

##### Detail without overthinking
- How the main flows work (e.g., “Search → SearchPageController → SearchAndChartManager → SongFileManager → data/artists/...”).
- Notes or callouts for key cross‐cutting utilities (ConfigLoader, AlertUtil, SessionManager).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% UI Layer
    subgraph "UI Layer (JavaFX)" 
        direction TB
        Main["Main<br/>app/Main.java"]:::ui
        FXML["FXML Files"]:::ui
        CSS["styles.css"]:::ui
        Pics["pics/"]:::ui
        ConfigRes["config.properties"]:::ui
    end

    %% Controllers
    subgraph "Controller Layer" 
        direction TB
        SignIn["SignInController"]:::controllers
        SignUp["SignUpController"]:::controllers

        subgraph "User Dashboard Controllers"
            direction TB
            UserDash["UserDashboardController"]:::controllers
            BaseUser["BaseUserController"]:::controllers
            SearchPage["SearchPageController"]:::controllers
            ChartsPage["ChartsPageController"]:::controllers
            Details["SongAndAlbumDetailsController"]:::controllers
            ArtistProfile["ArtistProfileController"]:::controllers
            LyricsReq["RequestLyricsEditController"]:::controllers
            UserMenu["UserMenuBarHandler"]:::controllers
        end

        subgraph "Artist Dashboard Controllers"
            direction TB
            ArtistDash["ArtistDashboardController"]:::controllers
            BaseArtist["BaseArtistController"]:::controllers
            ArtistMgmt["ArtistManagementController"]:::controllers
            AddSong["AddSongPageController"]:::controllers
            CreateAlbum["CreateAlbumController"]:::controllers
            EditSong["EditSongController"]:::controllers
            EditAlbum["EditAlbumController"]:::controllers
            DeleteSong["DeleteSongController"]:::controllers
            DeleteAlbum["DeleteAlbumController"]:::controllers
            ArtistMenu["ArtistMenuBarHandler"]:::controllers
        end

        AdminDash["AdminDashboardController"]:::controllers
    end

    %% Services
    subgraph "Service Layer" 
        direction TB
        AccountMgr["AccountManager"]:::services
        SessionMgr["SessionManager"]:::services
        ChartSvc["ChartService"]:::services
        SearchMgr["SearchAndChartManager"]:::services
    end

    %% Persistence
    subgraph "Persistence Layer (File Managers)"
        direction TB
        FileMgrIfc["FileManager (interface)"]:::persistence
        UserFile["UserFileManager"]:::persistence
        ArtistFile["ArtistFileManager"]:::persistence
        SongFile["SongFileManager"]:::persistence
        LyricsFile["LyricsRequestManager"]:::persistence
        AdminFile["AdminFileManager"]:::persistence
    end

    %% Data Store
    Data["data/"]:::datastore

    %% Models/DTO
    Models["Models & DTOs"]:::models

    %% Utilities
    subgraph "Utilities & Config"
        direction TB
        ConfigLoader["ConfigLoader"]:::utils
        FileUtil["FileUtil"]:::utils
        AlertUtil["AlertUtil"]:::utils
        SceneUtil["SceneUtil"]:::utils
    end

    %% Relationships
    Main --> UI
    Main --> FXML
    Main --> CSS
    Main --> Pics
    Main --> ConfigRes

    FXML --> SignIn
    FXML --> SignUp
    FXML --> UserDash
    FXML --> ArtistDash
    FXML --> AdminDash

    SignIn --> AccountMgr
    SignUp --> AccountMgr
    UserDash --> SearchMgr
    ChartsPage --> ChartSvc
    Details --> SearchMgr
    ArtistProfile --> SearchMgr
    LyricsReq --> SearchMgr

    ArtistMgmt --> AccountMgr
    AddSong --> SongFile
    EditSong --> SongFile
    DeleteSong --> SongFile
    CreateAlbum --> ArtistFile
    EditAlbum --> ArtistFile
    DeleteAlbum --> ArtistFile

    AdminDash --> AdminFile

    AccountMgr --> UserFile
    AccountMgr --> ArtistFile
    AccountMgr --> AdminFile
    SearchMgr --> SongFile
    SearchMgr --> LyricsFile
    ChartSvc --> SongFile

    UserFile --> Data
    ArtistFile --> Data
    SongFile --> Data
    LyricsFile --> Data
    AdminFile --> Data

    AccountMgr --> Models
    SessionMgr --> Models
    SearchMgr --> Models
    ChartSvc --> Models

    SignIn --> SessionMgr
    UserDash --> SessionMgr
    ArtistDash --> SessionMgr
    AdminDash --> SessionMgr

    ConfigLoader --> FileMgrIfc
    FileUtil --> FileMgrIfc
    AlertUtil --> Controllers
    SceneUtil --> Controllers

    %% Click Events
    click FXML "https://github.com/aryangh-imp/genius-java/tree/main/src/main/resources/FXML-files/"
    click CSS "https://github.com/aryangh-imp/genius-java/blob/main/src/main/resources/CSS/styles.css"
    click Pics "https://github.com/aryangh-imp/genius-java/tree/main/src/main/resources/pics/"
    click ConfigRes "https://github.com/aryangh-imp/genius-java/blob/main/src/main/resources/config.properties"
    click Main "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/app/Main.java"
    click SignIn "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/auth/SignInController.java"
    click SignUp "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/auth/SignUpController.java"
    click UserDash "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/user/UserDashboardController.java"
    click BaseUser "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/user/BaseUserController.java"
    click SearchPage "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/user/SearchPageController.java"
    click ChartsPage "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/user/ChartsPageController.java"
    click Details "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/user/SongAndAlbumDetailsController.java"
    click ArtistProfile "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/user/ArtistProfileController.java"
    click LyricsReq "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/user/RequestLyricsEditController.java"
    click UserMenu "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/user/UserMenuBarHandler.java"
    click ArtistDash "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/ArtistDashboardController.java"
    click BaseArtist "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/BaseArtistController.java"
    click ArtistMgmt "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/ArtistManagementController.java"
    click AddSong "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/AddSongPageController.java"
    click CreateAlbum "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/CreateAlbumController.java"
    click EditSong "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/EditSongController.java"
    click EditAlbum "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/EditAlbumController.java"
    click DeleteSong "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/DeleteSongController.java"
    click DeleteAlbum "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/DeleteAlbumController.java"
    click ArtistMenu "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/artist/ArtistMenuBarHandler.java"
    click AdminDash "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/controllers/dashBoard/admin/AdminDashboardController.java"
    click AccountMgr "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/AccountManager.java"
    click SessionMgr "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/SessionManager.java"
    click ChartSvc "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/ChartService.java"
    click SearchMgr "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/SearchAndChartManager.java"
    click FileMgrIfc "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/file/FileManager.java"
    click UserFile "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/file/UserFileManager.java"
    click ArtistFile "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/file/ArtistFileManager.java"
    click SongFile "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/file/SongFileManager.java"
    click LyricsFile "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/file/LyricsRequestManager.java"
    click AdminFile "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/services/file/AdminFileManager.java"
    click ConfigLoader "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/utils/ConfigLoader.java"
    click FileUtil "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/utils/FileUtil.java"
    click AlertUtil "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/utils/AlertUtil.java"
    click SceneUtil "https://github.com/aryangh-imp/genius-java/blob/main/src/main/java/utils/SceneUtil.java"

    %% Styles
    classDef ui fill:#fff2cc,stroke:#d6b656;
    classDef controllers fill:#d9eefa,stroke:#6c8ebf;
    classDef services fill:#d5e8d4,stroke:#82b366;
    classDef persistence fill:#f8cecc,stroke:#b85450;
    classDef datastore fill:#e1e1e1,stroke:#888888,stroke-dasharray: 5 5;
    classDef models fill:#fefefe,stroke:#aaaaaa;
    classDef utils fill:#e6f0fa,stroke:#6f86d6;
```
