How ivanvysocinas/soundify works
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: Pages Music pages · routes HTTP routes · PlaylistService.js Playlist service · TrackService.js Track service
Components 25
Listener web app
- App routes
client/src/router.tsx - Music pages
client/src/Pages - API client
client/src/shared/api.ts - Player and queue
client/src/components/mainPage/aside/components/player - Search and charts
client/src/Pages/Search.tsx - Playlist tools
client/src/Pages/Playlist.tsx - Sign-in and signup
client/src/Pages/Login.tsx
Publishing and admin
- Artist studio
client/src/Pages/ArtistStudio.tsx - Album creation
client/src/Pages/CreateAlbumPage.tsx - Platform playlists
client/src/Pages/Admin/AdminPlatfromPlaylists.tsx
Server API
- HTTP routes
server/routes - Playlist controller
server/controllers/playlist.controller.js - Track controller
server/controllers/track.controller.js - Chart controller
server/controllers/chart.controller.js - JWT authentication
server/middleware/auth.middleware.js
Music services
- Playlist service
server/services/PlaylistService.js - Track service
server/services/TrackService.js - Chart service
server/services/ChartService.js - Global search
server/services/GlobalSearchService.js
Data and media
- Track records
server/models/Track.model.js - Playlist records
server/models/Playlist.model.js - Chart records
server/models/Chart.model.js - User records
server/models/User.model.js - B2 media storage
server/utils/upload.js
Other components
- Listener
Connections 27
- Listener → App routes: opens app
client/src/router.tsx - App routes → Music pages: routes to
client/src/router.tsx - Music pages → Player and queue: renders shared shell
client/src/Pages/Main.tsx - Music pages → API client: requests data
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
client/src/router.tsx - Music pages → Artist studio: routes to studio
client/src/router.tsx - Artist studio → Album creation: offers album creation
client/src/router.tsx - Music pages → Platform playlists: protects admin routes
client/src/router.tsx - API client → HTTP routes: calls server
- HTTP routes → Playlist controller: dispatches playlist requests
server/routes/playlist.routes.js - HTTP routes → JWT authentication: authenticates requests
server/routes/playlist.routes.js - HTTP routes → Track controller: dispatches track requests
server/routes/track.routes.js - HTTP routes → Chart controller: dispatches chart requests
server/routes/chart.routes.js - Playlist controller → Playlist service: delegates operations
server/controllers/playlist.controller.js - Track controller → Track service: delegates operations
server/controllers/track.controller.js - Chart controller → Chart service: delegates chart queries
server/controllers/chart.controller.js - Playlist service → Playlist records: reads and writes
server/services/PlaylistService.js - Playlist service → Track records: loads tracks
server/services/PlaylistService.js - Track service → Track records: manages tracks
server/services/TrackService.js - Chart service → Chart records: reads and writes
server/services/ChartService.js - Chart service → Track records: queries tracks
server/services/ChartService.js - JWT authentication → User records: loads user
server/middleware/auth.middleware.js - Global search → Track service: searches tracks
server/services/GlobalSearchService.js - Playlist service → B2 media storage: uploads covers
server/services/PlaylistService.js - Track service → B2 media storage: uploads audio
server/services/TrackService.js