# atigerlee/oop architecture

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

- Interactive diagram: https://gitdiagram.com/atigerlee/oop
- Repository: https://github.com/atigerlee/oop

## Overview

Guga Music is a JavaFX desktop music player backed by SQLite. Its documented workflow starts at the application entry point, loads the main screen, and lets the user search songs through the UI controller and database manager; the README also documents playback controls and locally stored music. The tree shows separate playback, playlist, and account modules, but their runtime wiring was not sampled, so those relationships are left unverified rather than asserted.

Main entry points: [`src/main/java/com/example/oop/HelloController.java`](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/HelloController.java) (Main Controller), [`src/main/java/com/example/oop/playmodel/Playmodel.java`](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/playmodel/Playmodel.java) (Play Mode), [`src/main/java/com/example/oop/LoginController.java`](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/LoginController.java) (Login Controller), [`src/main/java/com/example/oop/MusicApp.java`](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/MusicApp.java) (Music App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Application UI"]
  node_app["Music App<br/>[MusicApp.java]"]
  node_mainview["Main View<br/>[GugaMusic.fxml]"]
  node_maincontroller["Main Controller"]
  node_loginview["Login View<br/>[login-view.fxml]"]
  node_logincontroller["Login Controller"]
end

subgraph group_catalog["Music Catalog"]
  node_dbmanager["Music Database<br/>[DBManager.java]"]
  node_song["Song Model<br/>[Song.java]"]
  node_musicdb[("Music Database File<br/>[music.db]")]
  node_playlistmanager["Playlist Manager"]
  node_playlist["Playlist Model<br/>[Playlist.java]"]
end

subgraph group_playback["Playback"]
  node_player["Player Service"]
  node_playmode["Play Mode<br/>[Playmodel.java]"]
  node_normal["Normal Mode<br/>[Normal.java]"]
  node_repeat["Repeat One<br/>[RepeatOne.java]"]
  node_shuffle["Shuffle Mode<br/>[Shuffle.java]"]
end

subgraph group_accounts["Accounts"]
  node_savedb["Saved Data Manager<br/>[SaveDBManager.java]"]
  node_userdb["User Database<br/>[UserDBManager.java]"]
  node_user["User Model<br/>[User.java]"]
  node_session["User Session<br/>[UserSession.java]"]
end

node_listener(("Listener"))

node_listener -.->|"starts"| node_app
node_app -->|"loads"| node_mainview
node_mainview -->|"uses controller"| node_maincontroller
node_listener -->|"searches songs"| node_maincontroller
node_maincontroller -->|"fuzzy searches"| node_dbmanager
node_dbmanager -->|"reads and writes"| node_musicdb
node_maincontroller -.->|"controls playback"| node_player
node_player -.->|"uses mode"| node_playmode
node_playmode -.->|"selects"| node_normal
node_playmode -.->|"selects"| node_repeat
node_playmode -.->|"selects"| node_shuffle
node_maincontroller -.->|"manages playlists"| node_playlistmanager
node_playlistmanager -.->|"uses model"| node_playlist
node_loginview -.->|"uses controller"| node_logincontroller
node_logincontroller -.->|"authenticates"| node_userdb
node_userdb -.->|"loads user"| node_user
node_logincontroller -.->|"sets session"| node_session
node_savedb -.->|"persists session"| node_session

click node_app "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/MusicApp.java"
click node_mainview "https://github.com/atigerlee/oop/blob/main/src/main/resources/com/example/oop/GugaMusic.fxml"
click node_maincontroller "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/HelloController.java"
click node_loginview "https://github.com/atigerlee/oop/blob/main/src/main/resources/com/example/oop/login-view.fxml"
click node_logincontroller "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/LoginController.java"
click node_dbmanager "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/database/DBManager.java"
click node_song "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/Song.java"
click node_musicdb "https://github.com/atigerlee/oop/blob/main/music.db"
click node_player "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/service/MusicPlayerService.java"
click node_playmode "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/playmodel/Playmodel.java"
click node_normal "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/playmodel/Normal.java"
click node_repeat "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/playmodel/RepeatOne.java"
click node_shuffle "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/playmodel/Shuffle.java"
click node_playlistmanager "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/PlaylistManager.java"
click node_playlist "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/Playlist.java"
click node_savedb "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/database/SaveDBManager.java"
click node_userdb "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/database/UserDBManager.java"
click node_user "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/User.java"
click node_session "https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/UserSession.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_mainview,node_maincontroller,node_loginview,node_logincontroller toneBlue
class node_dbmanager,node_song,node_musicdb,node_playlistmanager,node_playlist toneAmber
class node_player,node_playmode,node_normal,node_repeat,node_shuffle toneMint
class node_savedb,node_userdb,node_user,node_session toneRose
class node_listener toneIndigo
```

## Components

### Application UI

- [Music App](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/MusicApp.java): `src/main/java/com/example/oop/MusicApp.java`
- [Main View](https://github.com/atigerlee/oop/blob/main/src/main/resources/com/example/oop/GugaMusic.fxml): `src/main/resources/com/example/oop/GugaMusic.fxml`
- [Main Controller](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/HelloController.java): `src/main/java/com/example/oop/HelloController.java`
- [Login View](https://github.com/atigerlee/oop/blob/main/src/main/resources/com/example/oop/login-view.fxml): `src/main/resources/com/example/oop/login-view.fxml`
- [Login Controller](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/LoginController.java): `src/main/java/com/example/oop/LoginController.java`

### Music Catalog

- [Music Database](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/database/DBManager.java): `src/main/java/com/example/oop/database/DBManager.java`
- [Song Model](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/Song.java): `src/main/java/com/example/oop/model/Song.java`
- [Music Database File](https://github.com/atigerlee/oop/blob/main/music.db): `music.db`
- [Playlist Manager](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/PlaylistManager.java): `src/main/java/com/example/oop/model/PlaylistManager.java`
- [Playlist Model](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/Playlist.java): `src/main/java/com/example/oop/model/Playlist.java`

### Playback

- [Player Service](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/service/MusicPlayerService.java): `src/main/java/com/example/oop/service/MusicPlayerService.java`
- [Play Mode](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/playmodel/Playmodel.java): `src/main/java/com/example/oop/playmodel/Playmodel.java`
- [Normal Mode](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/playmodel/Normal.java): `src/main/java/com/example/oop/playmodel/Normal.java`
- [Repeat One](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/playmodel/RepeatOne.java): `src/main/java/com/example/oop/playmodel/RepeatOne.java`
- [Shuffle Mode](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/playmodel/Shuffle.java): `src/main/java/com/example/oop/playmodel/Shuffle.java`

### Accounts

- [Saved Data Manager](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/database/SaveDBManager.java): `src/main/java/com/example/oop/database/SaveDBManager.java`
- [User Database](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/database/UserDBManager.java): `src/main/java/com/example/oop/database/UserDBManager.java`
- [User Model](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/User.java): `src/main/java/com/example/oop/model/User.java`
- [User Session](https://github.com/atigerlee/oop/blob/main/src/main/java/com/example/oop/model/UserSession.java): `src/main/java/com/example/oop/model/UserSession.java`

### Other components

- **Listener**

## Connections

- Listener → Music App: starts
- Music App → Main View: loads (evidence: `README.md`)
- Main View → Main Controller: uses controller (evidence: `README.md`)
- Listener → Main Controller: searches songs (evidence: `README.md`)
- Main Controller → Music Database: fuzzy searches (evidence: `README.md`)
- Music Database → Music Database File: reads and writes (evidence: `README.md`)
- Main Controller → Player Service: controls playback
- Player Service → Play Mode: uses mode
- Play Mode → Normal Mode: selects
- Play Mode → Repeat One: selects
- Play Mode → Shuffle Mode: selects
- Main Controller → Playlist Manager: manages playlists
- Playlist Manager → Playlist Model: uses model
- Login View → Login Controller: uses controller
- Login Controller → User Database: authenticates
- User Database → User Model: loads user
- Login Controller → User Session: sets session
- Saved Data Manager → User Session: persists session
