# ivanvysocinas/soundify architecture

> Architecture diagram of the GitHub repository ivanvysocinas/soundify, 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/ivanvysocinas/soundify
- Repository: https://github.com/ivanvysocinas/soundify

## Overview

Soundify is a music-streaming and artist-publishing application. Listeners browse and search music, open artist/album/track pages, manage playlists and likes, and use a shared player; artists upload tracks and create albums, while administrators manage platform playlists and charts. The tree also shows authentication, profiles, analytics, and recommendations. The frontend-to-backend HTTP wiring and several server route/controller pairs were not sampled, so those links are shown only where route excerpts or source-index references support them.

Main entry points: [`client/src/Pages`](https://github.com/ivanvysocinas/soundify/tree/main/client/src/Pages) (Music pages), [`server/routes`](https://github.com/ivanvysocinas/soundify/tree/main/server/routes) (HTTP routes), [`server/services/PlaylistService.js`](https://github.com/ivanvysocinas/soundify/blob/main/server/services/PlaylistService.js) (Playlist service), [`server/services/TrackService.js`](https://github.com/ivanvysocinas/soundify/blob/main/server/services/TrackService.js) (Track service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Listener web app"]
  node_router["App routes<br/>[router.tsx]"]
  node_pages["Music pages"]
  node_clientapi["API client<br/>[api.ts]"]
  node_player["Player and queue"]
  node_discovery["Search and charts<br/>[Search.tsx]"]
  node_playlistsui["Playlist tools<br/>[Playlist.tsx]"]
  node_authui["Sign-in and signup<br/>[Login.tsx]"]
end

subgraph group_creator["Publishing and admin"]
  node_artiststudio["Artist studio<br/>[ArtistStudio.tsx]"]
  node_albumcreate["Album creation"]
  node_admin["Platform playlists"]
end

subgraph group_api["Server API"]
  node_routes["HTTP routes"]
  node_playlistctrl["Playlist controller"]
  node_trackctrl["Track controller"]
  node_chartctrl["Chart controller"]
  node_authmw["JWT authentication<br/>[auth.middleware.js]"]
end

subgraph group_domain["Music services"]
  node_playlistservice["Playlist service<br/>[PlaylistService.js]"]
  node_trackservice["Track service<br/>[TrackService.js]"]
  node_charts["Chart service<br/>[ChartService.js]"]
  node_searchservice["Global search"]
end

subgraph group_storage["Data and media"]
  node_trackmodel[("Track records<br/>[Track.model.js]")]
  node_playlistmodel[("Playlist records<br/>[Playlist.model.js]")]
  node_chartmodel[("Chart records<br/>[Chart.model.js]")]
  node_usermodel[("User records<br/>[User.model.js]")]
  node_media["B2 media storage<br/>[upload.js]"]
end

node_listener(("Listener"))

node_listener -->|"opens app"| node_router
node_router -->|"routes to"| node_pages
node_pages -->|"renders shared shell"| node_player
node_pages -.->|"requests data"| node_clientapi
node_pages -.->|"includes discovery"| node_discovery
node_pages -.->|"includes playlists"| node_playlistsui
node_pages -->|"routes to auth"| node_authui
node_pages -->|"routes to studio"| node_artiststudio
node_artiststudio -->|"offers album creation"| node_albumcreate
node_pages -->|"protects admin routes"| node_admin
node_clientapi -.->|"calls server"| node_routes
node_routes -->|"dispatches playlist requests"| node_playlistctrl
node_routes -->|"authenticates requests"| node_authmw
node_routes -->|"dispatches track requests"| node_trackctrl
node_routes -->|"dispatches chart requests"| node_chartctrl
node_playlistctrl -->|"delegates operations"| node_playlistservice
node_trackctrl -->|"delegates operations"| node_trackservice
node_chartctrl -->|"delegates chart queries"| node_charts
node_playlistservice -->|"reads and writes"| node_playlistmodel
node_playlistservice -->|"loads tracks"| node_trackmodel
node_trackservice -->|"manages tracks"| node_trackmodel
node_charts -->|"reads and writes"| node_chartmodel
node_charts -->|"queries tracks"| node_trackmodel
node_authmw -->|"loads user"| node_usermodel
node_searchservice -->|"searches tracks"| node_trackservice
node_playlistservice -->|"uploads covers"| node_media
node_trackservice -->|"uploads audio"| node_media

click node_router "https://github.com/ivanvysocinas/soundify/blob/main/client/src/router.tsx"
click node_pages "https://github.com/ivanvysocinas/soundify/tree/main/client/src/Pages"
click node_clientapi "https://github.com/ivanvysocinas/soundify/blob/main/client/src/shared/api.ts"
click node_player "https://github.com/ivanvysocinas/soundify/tree/main/client/src/components/mainPage/aside/components/player"
click node_discovery "https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/Search.tsx"
click node_playlistsui "https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/Playlist.tsx"
click node_authui "https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/Login.tsx"
click node_artiststudio "https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/ArtistStudio.tsx"
click node_albumcreate "https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/CreateAlbumPage.tsx"
click node_admin "https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/Admin/AdminPlatfromPlaylists.tsx"
click node_routes "https://github.com/ivanvysocinas/soundify/tree/main/server/routes"
click node_playlistctrl "https://github.com/ivanvysocinas/soundify/blob/main/server/controllers/playlist.controller.js"
click node_trackctrl "https://github.com/ivanvysocinas/soundify/blob/main/server/controllers/track.controller.js"
click node_chartctrl "https://github.com/ivanvysocinas/soundify/blob/main/server/controllers/chart.controller.js"
click node_authmw "https://github.com/ivanvysocinas/soundify/blob/main/server/middleware/auth.middleware.js"
click node_playlistservice "https://github.com/ivanvysocinas/soundify/blob/main/server/services/PlaylistService.js"
click node_trackservice "https://github.com/ivanvysocinas/soundify/blob/main/server/services/TrackService.js"
click node_charts "https://github.com/ivanvysocinas/soundify/blob/main/server/services/ChartService.js"
click node_searchservice "https://github.com/ivanvysocinas/soundify/blob/main/server/services/GlobalSearchService.js"
click node_trackmodel "https://github.com/ivanvysocinas/soundify/blob/main/server/models/Track.model.js"
click node_playlistmodel "https://github.com/ivanvysocinas/soundify/blob/main/server/models/Playlist.model.js"
click node_chartmodel "https://github.com/ivanvysocinas/soundify/blob/main/server/models/Chart.model.js"
click node_usermodel "https://github.com/ivanvysocinas/soundify/blob/main/server/models/User.model.js"
click node_media "https://github.com/ivanvysocinas/soundify/blob/main/server/utils/upload.js"

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_router,node_pages,node_clientapi,node_player,node_discovery,node_playlistsui,node_authui toneBlue
class node_artiststudio,node_albumcreate,node_admin toneAmber
class node_routes,node_playlistctrl,node_trackctrl,node_chartctrl,node_authmw toneMint
class node_playlistservice,node_trackservice,node_charts,node_searchservice toneRose
class node_trackmodel,node_playlistmodel,node_chartmodel,node_usermodel,node_media,node_listener toneIndigo
```

## Components

### Listener web app

- [App routes](https://github.com/ivanvysocinas/soundify/blob/main/client/src/router.tsx): `client/src/router.tsx`
- [Music pages](https://github.com/ivanvysocinas/soundify/tree/main/client/src/Pages): `client/src/Pages`
- [API client](https://github.com/ivanvysocinas/soundify/blob/main/client/src/shared/api.ts): `client/src/shared/api.ts`
- [Player and queue](https://github.com/ivanvysocinas/soundify/tree/main/client/src/components/mainPage/aside/components/player): `client/src/components/mainPage/aside/components/player`
- [Search and charts](https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/Search.tsx): `client/src/Pages/Search.tsx`
- [Playlist tools](https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/Playlist.tsx): `client/src/Pages/Playlist.tsx`
- [Sign-in and signup](https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/Login.tsx): `client/src/Pages/Login.tsx`

### Publishing and admin

- [Artist studio](https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/ArtistStudio.tsx): `client/src/Pages/ArtistStudio.tsx`
- [Album creation](https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/CreateAlbumPage.tsx): `client/src/Pages/CreateAlbumPage.tsx`
- [Platform playlists](https://github.com/ivanvysocinas/soundify/blob/main/client/src/Pages/Admin/AdminPlatfromPlaylists.tsx): `client/src/Pages/Admin/AdminPlatfromPlaylists.tsx`

### Server API

- [HTTP routes](https://github.com/ivanvysocinas/soundify/tree/main/server/routes): `server/routes`
- [Playlist controller](https://github.com/ivanvysocinas/soundify/blob/main/server/controllers/playlist.controller.js): `server/controllers/playlist.controller.js`
- [Track controller](https://github.com/ivanvysocinas/soundify/blob/main/server/controllers/track.controller.js): `server/controllers/track.controller.js`
- [Chart controller](https://github.com/ivanvysocinas/soundify/blob/main/server/controllers/chart.controller.js): `server/controllers/chart.controller.js`
- [JWT authentication](https://github.com/ivanvysocinas/soundify/blob/main/server/middleware/auth.middleware.js): `server/middleware/auth.middleware.js`

### Music services

- [Playlist service](https://github.com/ivanvysocinas/soundify/blob/main/server/services/PlaylistService.js): `server/services/PlaylistService.js`
- [Track service](https://github.com/ivanvysocinas/soundify/blob/main/server/services/TrackService.js): `server/services/TrackService.js`
- [Chart service](https://github.com/ivanvysocinas/soundify/blob/main/server/services/ChartService.js): `server/services/ChartService.js`
- [Global search](https://github.com/ivanvysocinas/soundify/blob/main/server/services/GlobalSearchService.js): `server/services/GlobalSearchService.js`

### Data and media

- [Track records](https://github.com/ivanvysocinas/soundify/blob/main/server/models/Track.model.js): `server/models/Track.model.js`
- [Playlist records](https://github.com/ivanvysocinas/soundify/blob/main/server/models/Playlist.model.js): `server/models/Playlist.model.js`
- [Chart records](https://github.com/ivanvysocinas/soundify/blob/main/server/models/Chart.model.js): `server/models/Chart.model.js`
- [User records](https://github.com/ivanvysocinas/soundify/blob/main/server/models/User.model.js): `server/models/User.model.js`
- [B2 media storage](https://github.com/ivanvysocinas/soundify/blob/main/server/utils/upload.js): `server/utils/upload.js`

### Other components

- **Listener**

## Connections

- Listener → App routes: opens app (evidence: `client/src/router.tsx`)
- App routes → Music pages: routes to (evidence: `client/src/router.tsx`)
- Music pages → Player and queue: renders shared shell (evidence: `client/src/Pages/Main.tsx`)
- Music pages → API client: requests data (evidence: `client/src/shared/api.ts`)
- Music pages → Search and charts: includes discovery
- Music pages → Playlist tools: includes playlists
- Music pages → Sign-in and signup: routes to auth (evidence: `client/src/router.tsx`)
- Music pages → Artist studio: routes to studio (evidence: `client/src/router.tsx`)
- Artist studio → Album creation: offers album creation (evidence: `client/src/router.tsx`)
- Music pages → Platform playlists: protects admin routes (evidence: `client/src/router.tsx`)
- API client → HTTP routes: calls server
- HTTP routes → Playlist controller: dispatches playlist requests (evidence: `server/routes/playlist.routes.js`)
- HTTP routes → JWT authentication: authenticates requests (evidence: `server/routes/playlist.routes.js`)
- HTTP routes → Track controller: dispatches track requests (evidence: `server/routes/track.routes.js`)
- HTTP routes → Chart controller: dispatches chart requests (evidence: `server/routes/chart.routes.js`)
- Playlist controller → Playlist service: delegates operations (evidence: `server/controllers/playlist.controller.js`)
- Track controller → Track service: delegates operations (evidence: `server/controllers/track.controller.js`)
- Chart controller → Chart service: delegates chart queries (evidence: `server/controllers/chart.controller.js`)
- Playlist service → Playlist records: reads and writes (evidence: `server/services/PlaylistService.js`)
- Playlist service → Track records: loads tracks (evidence: `server/services/PlaylistService.js`)
- Track service → Track records: manages tracks (evidence: `server/services/TrackService.js`)
- Chart service → Chart records: reads and writes (evidence: `server/services/ChartService.js`)
- Chart service → Track records: queries tracks (evidence: `server/services/ChartService.js`)
- JWT authentication → User records: loads user (evidence: `server/middleware/auth.middleware.js`)
- Global search → Track service: searches tracks (evidence: `server/services/GlobalSearchService.js`)
- Playlist service → B2 media storage: uploads covers (evidence: `server/services/PlaylistService.js`)
- Track service → B2 media storage: uploads audio (evidence: `server/services/TrackService.js`)
