# artewm/diplom_project architecture

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

- Interactive diagram: https://gitdiagram.com/artewm/diplom_project
- Repository: https://github.com/artewm/diplom_project

## Overview

This is a Laravel REST API and Vue SPA for music streaming. The user workflow runs from authentication or browsing/searching through track selection and playback, with parallel branches for uploads, playlists, and favorites. Laravel controllers handle API requests and use Eloquent models for track, user, playlist, and favorite data; uploads also save audio and cover files locally. The README documents local or cloud audio storage, but sampled code shows local storage only. Some UI-to-API details are not excerpted, so those links are documented at the architecture level.

Main entry points: [`routes/api.php`](https://github.com/artewm/diplom_project/blob/main/routes/api.php) (API routes), [`resources/js/router.js`](https://github.com/artewm/diplom_project/blob/main/resources/js/router.js) (View router), [`app/Models/Track.php`](https://github.com/artewm/diplom_project/blob/main/app/Models/Track.php) (Track model), [`resources/js/components/tracks/TrackList.vue`](https://github.com/artewm/diplom_project/blob/main/resources/js/components/tracks/TrackList.vue) (Track list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Vue client"]
  node_app["App shell<br/>[App.vue]"]
  node_router["View router<br/>[router.js]"]
  node_main["Home content<br/>[MainContent.vue]"]
  node_searchui["Search view<br/>[Search.vue]"]
  node_libraryui["Library view<br/>[Library.vue]"]
  node_personal["Personal tracks<br/>[Personal.vue]"]
  node_tracklist["Track list<br/>[TrackList.vue]"]
  node_player["Audio player<br/>[Player.vue]"]
  node_playlistui["Playlist view<br/>[Playlist.vue]"]
  node_favoritesui["Favorites view<br/>[Favorites.vue]"]
  node_authservice["Auth service<br/>[auth.js]"]
  node_playlistservice["Playlist service<br/>[playlist.js]"]
  node_favoritesservice["Favorites service<br/>[favorites.js]"]
end

subgraph group_api["Laravel API"]
  node_apiroutes["API routes<br/>[api.php]"]
  node_authcontroller["Authentication<br/>[AuthController.php]"]
  node_registration["Registration"]
  node_usercontroller["User lookup<br/>[GetController.php]"]
  node_usermodel["User model<br/>[User.php]"]
end

subgraph group_catalog["Music catalog"]
  node_searchcontroller["Track search"]
  node_librarycontroller["Library API"]
  node_trackcontroller["Track API"]
  node_trackmodel["Track model<br/>[Track.php]"]
end

subgraph group_collections["User collections"]
  node_playlistcontroller["Playlist API"]
  node_favoritecontroller["Favorites API"]
  node_playlistmodel["Playlist model<br/>[Playlist.php]"]
  node_favoritemodel["Favorite model<br/>[Favorite.php]"]
end

node_listener(("Listener"))
node_database[("Application database")]
node_audiostorage[("Local audio files")]

node_listener -.->|"uses"| node_app
node_app -.->|"hosts views"| node_router
node_app -->|"renders"| node_player
node_router -->|"routes to"| node_main
node_router -->|"routes to"| node_searchui
node_router -->|"routes to"| node_libraryui
node_router -->|"routes to"| node_personal
node_router -->|"routes to"| node_playlistui
node_router -->|"routes to"| node_favoritesui
node_main -->|"uses"| node_tracklist
node_libraryui -->|"uses"| node_tracklist
node_personal -->|"uses"| node_tracklist
node_playlistui -->|"renders"| node_tracklist
node_favoritesui -->|"renders"| node_tracklist
node_app -->|"authenticates via"| node_authservice
node_playlistui -->|"uses"| node_playlistservice
node_favoritesui -->|"uses"| node_favoritesservice
node_listener -.->|"requests"| node_apiroutes
node_authservice -.->|"calls REST API"| node_apiroutes
node_playlistservice -.->|"calls REST API"| node_apiroutes
node_favoritesservice -.->|"calls REST API"| node_apiroutes
node_apiroutes -->|"dispatches"| node_authcontroller
node_apiroutes -->|"dispatches"| node_registration
node_apiroutes -->|"dispatches"| node_usercontroller
node_apiroutes -->|"dispatches"| node_searchcontroller
node_apiroutes -->|"dispatches"| node_librarycontroller
node_apiroutes -->|"dispatches"| node_trackcontroller
node_apiroutes -->|"dispatches"| node_playlistcontroller
node_apiroutes -->|"dispatches"| node_favoritecontroller
node_authcontroller -->|"uses"| node_usermodel
node_registration -->|"creates"| node_usermodel
node_usercontroller -->|"looks up"| node_usermodel
node_searchcontroller -->|"queries"| node_trackmodel
node_librarycontroller -->|"queries"| node_trackmodel
node_trackcontroller -->|"reads and writes"| node_trackmodel
node_playlistcontroller -->|"manages"| node_playlistmodel
node_playlistcontroller -->|"adds tracks"| node_trackmodel
node_favoritecontroller -->|"manages"| node_favoritemodel
node_favoritecontroller -->|"uses"| node_trackmodel
node_trackcontroller -->|"stores audio"| node_audiostorage
node_usermodel -.->|"persists records"| node_database
node_trackmodel -.->|"persists metadata"| node_database
node_playlistmodel -.->|"persists records"| node_database
node_favoritemodel -.->|"persists records"| node_database

click node_app "https://github.com/artewm/diplom_project/blob/main/resources/js/App.vue"
click node_router "https://github.com/artewm/diplom_project/blob/main/resources/js/router.js"
click node_main "https://github.com/artewm/diplom_project/blob/main/resources/js/components/layout/MainContent.vue"
click node_searchui "https://github.com/artewm/diplom_project/blob/main/resources/js/components/ui/Search.vue"
click node_libraryui "https://github.com/artewm/diplom_project/blob/main/resources/js/components/tracks/Library.vue"
click node_personal "https://github.com/artewm/diplom_project/blob/main/resources/js/components/auth/Personal.vue"
click node_tracklist "https://github.com/artewm/diplom_project/blob/main/resources/js/components/tracks/TrackList.vue"
click node_player "https://github.com/artewm/diplom_project/blob/main/resources/js/components/player/Player.vue"
click node_playlistui "https://github.com/artewm/diplom_project/blob/main/resources/js/components/playlist/Playlist.vue"
click node_favoritesui "https://github.com/artewm/diplom_project/blob/main/resources/js/components/playlist/Favorites.vue"
click node_authservice "https://github.com/artewm/diplom_project/blob/main/resources/js/services/auth.js"
click node_playlistservice "https://github.com/artewm/diplom_project/blob/main/resources/js/services/playlist.js"
click node_favoritesservice "https://github.com/artewm/diplom_project/blob/main/resources/js/services/favorites.js"
click node_apiroutes "https://github.com/artewm/diplom_project/blob/main/routes/api.php"
click node_authcontroller "https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/AuthController.php"
click node_registration "https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/User/StoreController.php"
click node_usercontroller "https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/User/GetController.php"
click node_searchcontroller "https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/SearchController.php"
click node_librarycontroller "https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/LibraryController.php"
click node_trackcontroller "https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/TrackController.php"
click node_playlistcontroller "https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/PlaylistController.php"
click node_favoritecontroller "https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/FavoriteController.php"
click node_usermodel "https://github.com/artewm/diplom_project/blob/main/app/Models/User.php"
click node_trackmodel "https://github.com/artewm/diplom_project/blob/main/app/Models/Track.php"
click node_playlistmodel "https://github.com/artewm/diplom_project/blob/main/app/Models/Playlist.php"
click node_favoritemodel "https://github.com/artewm/diplom_project/blob/main/app/Models/Favorite.php"

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_router,node_main,node_searchui,node_libraryui,node_personal,node_tracklist,node_player,node_playlistui,node_favoritesui,node_authservice,node_playlistservice,node_favoritesservice toneBlue
class node_apiroutes,node_authcontroller,node_registration,node_usercontroller,node_usermodel,node_database,node_audiostorage toneAmber
class node_searchcontroller,node_librarycontroller,node_trackcontroller,node_trackmodel toneMint
class node_playlistcontroller,node_favoritecontroller,node_playlistmodel,node_favoritemodel toneRose
class node_listener toneIndigo
```

## Components

### Vue client

- [App shell](https://github.com/artewm/diplom_project/blob/main/resources/js/App.vue): `resources/js/App.vue`
- [View router](https://github.com/artewm/diplom_project/blob/main/resources/js/router.js): `resources/js/router.js`
- [Home content](https://github.com/artewm/diplom_project/blob/main/resources/js/components/layout/MainContent.vue): `resources/js/components/layout/MainContent.vue`
- [Search view](https://github.com/artewm/diplom_project/blob/main/resources/js/components/ui/Search.vue): `resources/js/components/ui/Search.vue`
- [Library view](https://github.com/artewm/diplom_project/blob/main/resources/js/components/tracks/Library.vue): `resources/js/components/tracks/Library.vue`
- [Personal tracks](https://github.com/artewm/diplom_project/blob/main/resources/js/components/auth/Personal.vue): `resources/js/components/auth/Personal.vue`
- [Track list](https://github.com/artewm/diplom_project/blob/main/resources/js/components/tracks/TrackList.vue): `resources/js/components/tracks/TrackList.vue`
- [Audio player](https://github.com/artewm/diplom_project/blob/main/resources/js/components/player/Player.vue): `resources/js/components/player/Player.vue`
- [Playlist view](https://github.com/artewm/diplom_project/blob/main/resources/js/components/playlist/Playlist.vue): `resources/js/components/playlist/Playlist.vue`
- [Favorites view](https://github.com/artewm/diplom_project/blob/main/resources/js/components/playlist/Favorites.vue): `resources/js/components/playlist/Favorites.vue`
- [Auth service](https://github.com/artewm/diplom_project/blob/main/resources/js/services/auth.js): `resources/js/services/auth.js`
- [Playlist service](https://github.com/artewm/diplom_project/blob/main/resources/js/services/playlist.js): `resources/js/services/playlist.js`
- [Favorites service](https://github.com/artewm/diplom_project/blob/main/resources/js/services/favorites.js): `resources/js/services/favorites.js`

### Laravel API

- [API routes](https://github.com/artewm/diplom_project/blob/main/routes/api.php): `routes/api.php`
- [Authentication](https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/AuthController.php): `app/Http/Controllers/AuthController.php`
- [Registration](https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/User/StoreController.php): `app/Http/Controllers/User/StoreController.php`
- [User lookup](https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/User/GetController.php): `app/Http/Controllers/User/GetController.php`
- [User model](https://github.com/artewm/diplom_project/blob/main/app/Models/User.php): `app/Models/User.php`

### Music catalog

- [Track search](https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/SearchController.php): `app/Http/Controllers/SearchController.php`
- [Library API](https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/LibraryController.php): `app/Http/Controllers/LibraryController.php`
- [Track API](https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/TrackController.php): `app/Http/Controllers/TrackController.php`
- [Track model](https://github.com/artewm/diplom_project/blob/main/app/Models/Track.php): `app/Models/Track.php`

### User collections

- [Playlist API](https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/PlaylistController.php): `app/Http/Controllers/PlaylistController.php`
- [Favorites API](https://github.com/artewm/diplom_project/blob/main/app/Http/Controllers/FavoriteController.php): `app/Http/Controllers/FavoriteController.php`
- [Playlist model](https://github.com/artewm/diplom_project/blob/main/app/Models/Playlist.php): `app/Models/Playlist.php`
- [Favorite model](https://github.com/artewm/diplom_project/blob/main/app/Models/Favorite.php): `app/Models/Favorite.php`

### Other components

- **Listener**
- **Application database**
- **Local audio files**

## Connections

- Listener → App shell: uses
- App shell → View router: hosts views
- App shell → Audio player: renders (evidence: `resources/js/App.vue`)
- View router → Home content: routes to (evidence: `resources/js/router.js`)
- View router → Search view: routes to (evidence: `resources/js/router.js`)
- View router → Library view: routes to (evidence: `resources/js/router.js`)
- View router → Personal tracks: routes to (evidence: `resources/js/router.js`)
- View router → Playlist view: routes to (evidence: `resources/js/router.js`)
- View router → Favorites view: routes to (evidence: `resources/js/router.js`)
- Home content → Track list: uses (evidence: `resources/js/components/layout/MainContent.vue`)
- Library view → Track list: uses (evidence: `resources/js/components/tracks/Library.vue`)
- Personal tracks → Track list: uses (evidence: `resources/js/components/auth/Personal.vue`)
- Playlist view → Track list: renders (evidence: `resources/js/components/playlist/Playlist.vue`)
- Favorites view → Track list: renders (evidence: `resources/js/components/playlist/Favorites.vue`)
- App shell → Auth service: authenticates via (evidence: `resources/js/App.vue`)
- Playlist view → Playlist service: uses (evidence: `resources/js/components/playlist/Playlist.vue`)
- Favorites view → Favorites service: uses (evidence: `resources/js/components/playlist/Favorites.vue`)
- Listener → API routes: requests
- Auth service → API routes: calls REST API (evidence: `README.md`)
- Playlist service → API routes: calls REST API (evidence: `README.md`)
- Favorites service → API routes: calls REST API (evidence: `README.md`)
- API routes → Authentication: dispatches (evidence: `routes/api.php`)
- API routes → Registration: dispatches (evidence: `routes/api.php`)
- API routes → User lookup: dispatches (evidence: `routes/api.php`)
- API routes → Track search: dispatches (evidence: `routes/api.php`)
- API routes → Library API: dispatches (evidence: `routes/api.php`)
- API routes → Track API: dispatches (evidence: `routes/api.php`)
- API routes → Playlist API: dispatches (evidence: `routes/api.php`)
- API routes → Favorites API: dispatches (evidence: `routes/api.php`)
- Authentication → User model: uses (evidence: `app/Http/Controllers/AuthController.php`)
- Registration → User model: creates (evidence: `app/Http/Controllers/User/StoreController.php`)
- User lookup → User model: looks up (evidence: `app/Http/Controllers/User/GetController.php`)
- Track search → Track model: queries (evidence: `app/Http/Controllers/SearchController.php`)
- Library API → Track model: queries (evidence: `app/Http/Controllers/LibraryController.php`)
- Track API → Track model: reads and writes (evidence: `app/Http/Controllers/TrackController.php`)
- Playlist API → Playlist model: manages (evidence: `app/Http/Controllers/PlaylistController.php`)
- Playlist API → Track model: adds tracks (evidence: `app/Http/Controllers/PlaylistController.php`)
- Favorites API → Favorite model: manages (evidence: `app/Http/Controllers/FavoriteController.php`)
- Favorites API → Track model: uses (evidence: `app/Http/Controllers/FavoriteController.php`)
- Track API → Local audio files: stores audio (evidence: `app/Http/Controllers/TrackController.php`)
- User model → Application database: persists records (evidence: `README.md`)
- Track model → Application database: persists metadata (evidence: `README.md`)
- Playlist model → Application database: persists records (evidence: `README.md`)
- Favorite model → Application database: persists records (evidence: `README.md`)
