# lagro222/spring_backend architecture

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

- Interactive diagram: https://gitdiagram.com/lagro222/spring_backend
- Repository: https://github.com/lagro222/spring_backend

## Overview

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: [`src/main/java/com/store/app/controllers`](https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/controllers) (Catalogue APIs), [`src/main/java/com/store/app/services/TrackService.java`](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/TrackService.java) (Track And Playback), [`src/main/java/com/store/app/repositories`](https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/repositories) (JPA Repositories), [`src/main/java/com/store/app/services/UserService.java`](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/UserService.java) (User Library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_api["Authentication API"]
  node_catalog_api["Catalogue APIs"]
  node_user_api["User API"]
  node_dto["Request Responses"]
  node_exception_handler["API Error Handling"]
end

subgraph group_domain["Music Domain"]
  node_user_service["User Library<br/>[UserService.java]"]
  node_artist_service["Artist Management<br/>[ArtistService.java]"]
  node_album_service["Album Management<br/>[AlbumService.java]"]
  node_track_service["Track And Playback<br/>[TrackService.java]"]
  node_playlist_service["Playlist Management"]
end

subgraph group_persistence["Persistence"]
  node_models["Music And User Models"]
  node_repositories["JPA Repositories"]
  node_postgres[("PostgreSQL")]
end

subgraph group_security["Security And Audio"]
  node_auth_service["Account And JWT<br/>[JwtService.java]"]
  node_jwt_filter["JWT Request Filter<br/>[JwtFilter.java]"]
  node_security_config["Access Rules"]
  node_file_storage["Audio File Storage"]
end

node_client(("API Client"))

node_client -->|"registers or logs in"| node_auth_api
node_client -->|"manages music"| node_catalog_api
node_client -->|"manages library"| node_user_api
node_auth_api -->|"uses accounts"| node_user_service
node_auth_api -->|"issues tokens"| node_auth_service
node_catalog_api -->|"manages artists"| node_artist_service
node_catalog_api -->|"manages albums"| node_album_service
node_catalog_api -->|"manages tracks"| node_track_service
node_catalog_api -->|"manages playlists"| node_playlist_service
node_user_api -->|"manages profiles"| node_user_service
node_auth_api -->|"accepts account data"| node_dto
node_catalog_api -->|"maps API data"| node_dto
node_user_api -->|"maps user data"| node_dto
node_user_service -->|"looks up tracks"| node_track_service
node_user_service -->|"looks up artists"| node_artist_service
node_artist_service -->|"looks up tracks"| node_track_service
node_artist_service -->|"looks up albums"| node_album_service
node_track_service -->|"looks up albums"| node_album_service
node_playlist_service -->|"looks up tracks"| node_track_service
node_track_service -->|"saves and loads audio"| node_file_storage
node_user_service -->|"accesses user and playlist data"| node_repositories
node_artist_service -->|"accesses artist and user data"| node_repositories
node_album_service -->|"accesses album data"| node_repositories
node_track_service -->|"accesses track data"| node_repositories
node_playlist_service -->|"accesses playlist data"| node_repositories
node_repositories -->|"persists entities"| node_models
node_models -->|"stored in"| node_postgres
node_jwt_filter -.->|"validates tokens"| node_auth_service
node_security_config -.->|"secures requests"| node_jwt_filter
node_catalog_api -.->|"errors handled by"| node_exception_handler

click node_auth_api "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/controllers/auth/AuthController.java"
click node_catalog_api "https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/controllers"
click node_user_api "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/controllers/UserController.java"
click node_auth_service "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/security/JwtService.java"
click node_user_service "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/UserService.java"
click node_artist_service "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/ArtistService.java"
click node_album_service "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/AlbumService.java"
click node_track_service "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/TrackService.java"
click node_playlist_service "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/PlaylistService.java"
click node_dto "https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/DTOs"
click node_models "https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/entities"
click node_repositories "https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/repositories"
click node_jwt_filter "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/security/JwtFilter.java"
click node_security_config "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/security/SecurityConfig.java"
click node_file_storage "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/FileStorageService.java"
click node_exception_handler "https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/exception/GlobalExceptionHandler.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_auth_api,node_catalog_api,node_user_api,node_dto,node_exception_handler,node_client toneBlue
class node_user_service,node_artist_service,node_album_service,node_track_service,node_playlist_service toneAmber
class node_models,node_repositories,node_postgres toneMint
class node_auth_service,node_jwt_filter,node_security_config,node_file_storage toneRose
```

## Components

### REST API

- [Authentication API](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/controllers/auth/AuthController.java): `src/main/java/com/store/app/controllers/auth/AuthController.java`
- [Catalogue APIs](https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/controllers): `src/main/java/com/store/app/controllers`
- [User API](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/controllers/UserController.java): `src/main/java/com/store/app/controllers/UserController.java`
- [Request Responses](https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/DTOs): `src/main/java/com/store/app/DTOs`
- [API Error Handling](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/exception/GlobalExceptionHandler.java): `src/main/java/com/store/app/exception/GlobalExceptionHandler.java`

### Music Domain

- [User Library](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/UserService.java): `src/main/java/com/store/app/services/UserService.java`
- [Artist Management](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/ArtistService.java): `src/main/java/com/store/app/services/ArtistService.java`
- [Album Management](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/AlbumService.java): `src/main/java/com/store/app/services/AlbumService.java`
- [Track And Playback](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/TrackService.java): `src/main/java/com/store/app/services/TrackService.java`
- [Playlist Management](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/PlaylistService.java): `src/main/java/com/store/app/services/PlaylistService.java`

### Persistence

- [Music And User Models](https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/entities): `src/main/java/com/store/app/entities`
- [JPA Repositories](https://github.com/lagro222/spring_backend/tree/main/src/main/java/com/store/app/repositories): `src/main/java/com/store/app/repositories`
- **PostgreSQL**

### Security And Audio

- [Account And JWT](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/security/JwtService.java): `src/main/java/com/store/app/security/JwtService.java`
- [JWT Request Filter](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/security/JwtFilter.java): `src/main/java/com/store/app/security/JwtFilter.java`
- [Access Rules](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/security/SecurityConfig.java): `src/main/java/com/store/app/security/SecurityConfig.java`
- [Audio File Storage](https://github.com/lagro222/spring_backend/blob/main/src/main/java/com/store/app/services/FileStorageService.java): `src/main/java/com/store/app/services/FileStorageService.java`

### Other components

- **API Client**

## Connections

- API Client → Authentication API: registers or logs in (evidence: `README.md`)
- API Client → Catalogue APIs: manages music (evidence: `README.md`)
- API Client → User API: manages library (evidence: `README.md`)
- Authentication API → User Library: uses accounts (evidence: `src/main/java/com/store/app/controllers/auth/AuthController.java`)
- Authentication API → Account And JWT: issues tokens (evidence: `src/main/java/com/store/app/controllers/auth/AuthController.java`)
- Catalogue APIs → Artist Management: manages artists (evidence: `src/main/java/com/store/app/controllers/ArtistController.java`)
- Catalogue APIs → Album Management: manages albums (evidence: `src/main/java/com/store/app/controllers/AlbumController.java`)
- Catalogue APIs → Track And Playback: manages tracks (evidence: `src/main/java/com/store/app/controllers/TrackController.java`)
- Catalogue APIs → Playlist Management: manages playlists (evidence: `src/main/java/com/store/app/controllers/PlaylistController.java`)
- User API → User Library: manages profiles (evidence: `src/main/java/com/store/app/controllers/UserController.java`)
- Authentication API → Request Responses: accepts account data (evidence: `src/main/java/com/store/app/controllers/auth/AuthController.java`)
- Catalogue APIs → Request Responses: maps API data (evidence: `src/main/java/com/store/app/controllers/TrackController.java`)
- User API → Request Responses: maps user data (evidence: `src/main/java/com/store/app/controllers/UserController.java`)
- User Library → Track And Playback: looks up tracks (evidence: `src/main/java/com/store/app/services/UserService.java`)
- User Library → Artist Management: looks up artists (evidence: `src/main/java/com/store/app/services/UserService.java`)
- Artist Management → Track And Playback: looks up tracks (evidence: `src/main/java/com/store/app/services/ArtistService.java`)
- Artist Management → Album Management: looks up albums (evidence: `src/main/java/com/store/app/services/ArtistService.java`)
- Track And Playback → Album Management: looks up albums (evidence: `src/main/java/com/store/app/services/TrackService.java`)
- Playlist Management → Track And Playback: looks up tracks (evidence: `src/main/java/com/store/app/services/PlaylistService.java`)
- Track And Playback → Audio File Storage: saves and loads audio (evidence: `src/main/java/com/store/app/services/TrackService.java`)
- User Library → JPA Repositories: accesses user and playlist data (evidence: `src/main/java/com/store/app/services/UserService.java`)
- Artist Management → JPA Repositories: accesses artist and user data (evidence: `src/main/java/com/store/app/services/ArtistService.java`)
- Album Management → JPA Repositories: accesses album data (evidence: `src/main/java/com/store/app/services/AlbumService.java`)
- Track And Playback → JPA Repositories: accesses track data (evidence: `src/main/java/com/store/app/services/TrackService.java`)
- Playlist Management → JPA Repositories: accesses playlist data (evidence: `src/main/java/com/store/app/services/PlaylistService.java`)
- JPA Repositories → Music And User Models: persists entities (evidence: `src/main/java/com/store/app/repositories/UserRepository.java`)
- Music And User Models → PostgreSQL: stored in (evidence: `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
