How lagro222/spring_backend works
This is a Spring Boot music-player backend. A client calls REST controllers; domain services handle authentication, catalogue management, playlists, and user-library actions, with repositories persisting entities and file storage supporting audio upload and playback. The README documents JWT security, role-based authorization, and PostgreSQL. Several service excerpts are partial, so edges are limited to relationships visible in excerpts, the source index, or README rather than reconstructing unshown control flow.
Main entry points: controllers Catalogue APIs · TrackService.java Track And Playback · repositories JPA Repositories · UserService.java User Library
Components 18
REST API
- Authentication API
src/main/java/com/store/app/controllers/auth/AuthController.java - Catalogue APIs
src/main/java/com/store/app/controllers - User API
src/main/java/com/store/app/controllers/UserController.java - Request Responses
src/main/java/com/store/app/DTOs - API Error Handling
src/main/java/com/store/app/exception/GlobalExceptionHandler.java
Music Domain
- User Library
src/main/java/com/store/app/services/UserService.java - Artist Management
src/main/java/com/store/app/services/ArtistService.java - Album Management
src/main/java/com/store/app/services/AlbumService.java - Track And Playback
src/main/java/com/store/app/services/TrackService.java - Playlist Management
src/main/java/com/store/app/services/PlaylistService.java
Persistence
- Music And User Models
src/main/java/com/store/app/entities - JPA Repositories
src/main/java/com/store/app/repositories - PostgreSQL
Security And Audio
- Account And JWT
src/main/java/com/store/app/security/JwtService.java - JWT Request Filter
src/main/java/com/store/app/security/JwtFilter.java - Access Rules
src/main/java/com/store/app/security/SecurityConfig.java - Audio File Storage
src/main/java/com/store/app/services/FileStorageService.java
Other components
- API Client
Connections 30
- API Client → Authentication API: registers or logs in
README.md - API Client → Catalogue APIs: manages music
README.md - API Client → User API: manages library
README.md - Authentication API → User Library: uses accounts
src/main/java/com/store/app/controllers/auth/AuthController.java - Authentication API → Account And JWT: issues tokens
src/main/java/com/store/app/controllers/auth/AuthController.java - Catalogue APIs → Artist Management: manages artists
src/main/java/com/store/app/controllers/ArtistController.java - Catalogue APIs → Album Management: manages albums
src/main/java/com/store/app/controllers/AlbumController.java - Catalogue APIs → Track And Playback: manages tracks
src/main/java/com/store/app/controllers/TrackController.java - Catalogue APIs → Playlist Management: manages playlists
src/main/java/com/store/app/controllers/PlaylistController.java - User API → User Library: manages profiles
src/main/java/com/store/app/controllers/UserController.java - Authentication API → Request Responses: accepts account data
src/main/java/com/store/app/controllers/auth/AuthController.java - Catalogue APIs → Request Responses: maps API data
src/main/java/com/store/app/controllers/TrackController.java - User API → Request Responses: maps user data
src/main/java/com/store/app/controllers/UserController.java - User Library → Track And Playback: looks up tracks
src/main/java/com/store/app/services/UserService.java - User Library → Artist Management: looks up artists
src/main/java/com/store/app/services/UserService.java - Artist Management → Track And Playback: looks up tracks
src/main/java/com/store/app/services/ArtistService.java - Artist Management → Album Management: looks up albums
src/main/java/com/store/app/services/ArtistService.java - Track And Playback → Album Management: looks up albums
src/main/java/com/store/app/services/TrackService.java - Playlist Management → Track And Playback: looks up tracks
src/main/java/com/store/app/services/PlaylistService.java - Track And Playback → Audio File Storage: saves and loads audio
src/main/java/com/store/app/services/TrackService.java - User Library → JPA Repositories: accesses user and playlist data
src/main/java/com/store/app/services/UserService.java - Artist Management → JPA Repositories: accesses artist and user data
src/main/java/com/store/app/services/ArtistService.java - Album Management → JPA Repositories: accesses album data
src/main/java/com/store/app/services/AlbumService.java - Track And Playback → JPA Repositories: accesses track data
src/main/java/com/store/app/services/TrackService.java - Playlist Management → JPA Repositories: accesses playlist data
src/main/java/com/store/app/services/PlaylistService.java - JPA Repositories → Music And User Models: persists entities
src/main/java/com/store/app/repositories/UserRepository.java - Music And User Models → PostgreSQL: stored in
README.md - JWT Request Filter → Account And JWT: validates tokens
- Access Rules → JWT Request Filter: secures requests
- Catalogue APIs → API Error Handling: errors handled by