How aryangh-imp/genius-java works
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).