How kishorshelar07/kishor_kumar_songs works
Kishore Kumar is a full-screen music player with a public listening experience and a password-protected song-management panel. Visitors load the catalog, choose tracks, and control playback; admins log in to add, edit, reorder, or delete songs. The backend stores song metadata in MongoDB and media in Cloudinary, with optional iTunes artwork lookup. The graph preserves the documented admin and player capabilities; some admin-to-backend API wiring is based on the README because the admin route implementation was not excerpted.
Main entry points: HomePage.jsx Player experience · songs.js Song operations · App.jsx Route application · server.js HTTP server
Components 23
Web application
- Route application
frontend/src/App.jsx - Player experience
frontend/src/pages/HomePage.jsx - Audio player
frontend/src/components/Player.jsx - Song list
frontend/src/components/SongListDrawer.jsx - Navigation
frontend/src/components/Navbar.jsx - Playback shortcuts
frontend/src/hooks/useKeyboardShortcuts.js - Favorites state
frontend/src/context/FavoritesContext.jsx - Theme state
frontend/src/context/ThemeContext.jsx - API client
frontend/src/api.js - Admin route guard
frontend/src/components/RequireAuth.jsx - Admin login
frontend/src/pages/AdminLogin.jsx - Song dashboard
frontend/src/pages/AdminDashboard.jsx
API and access
- HTTP server
backend/server.js - Admin authentication
backend/routes/admin.js - JWT authorization
backend/middleware/auth.js
Catalog and media
- Song operations
backend/routes/songs.js - Song metadata
backend/models/Song.js - MongoDB connection
backend/config/db.js
External services
- Cloudinary client
backend/config/cloudinary.js - MongoDB
- Cloudinary media
- iTunes Search
Other components
- Listener / admin
Connections 26
- Listener / admin → Route application: opens
README.md - Route application → Player experience: routes to
frontend/src/App.jsx - Route application → Admin login: routes to
frontend/src/App.jsx - Route application → Admin route guard: guards admin
frontend/src/App.jsx - Admin route guard → Song dashboard: renders when authorized
frontend/src/App.jsx - Player experience → API client: fetches catalog
frontend/src/pages/HomePage.jsx - Player experience → Audio player: renders controls
frontend/src/pages/HomePage.jsx - Player experience → Song list: renders list
frontend/src/pages/HomePage.jsx - Player experience → Navigation: renders navigation
frontend/src/pages/HomePage.jsx - Player experience → Playback shortcuts: registers keys
frontend/src/pages/HomePage.jsx - Player experience → Theme state: reads theme
frontend/src/pages/HomePage.jsx - Audio player → Favorites state: reads favorites
frontend/src/components/Player.jsx - Song list → Favorites state: reads favorites
frontend/src/components/SongListDrawer.jsx - Admin login → API client: sends login
frontend/src/pages/AdminLogin.jsx - Song dashboard → API client: manages songs
frontend/src/pages/AdminDashboard.jsx - API client → HTTP server: sends API requests
- HTTP server → Song operations: mounts at songs
backend/server.js - HTTP server → Admin authentication: mounts at admin
backend/server.js - HTTP server → MongoDB connection: connects database
backend/server.js - MongoDB connection → MongoDB: connects
backend/config/db.js - Song operations → JWT authorization: guards admin actions
backend/routes/songs.js - Song operations → Song metadata: reads and writes
backend/routes/songs.js - Song operations → Cloudinary client: uploads and deletes media
backend/routes/songs.js - Cloudinary client → Cloudinary media: configures client
- Song operations → iTunes Search: looks up artwork
backend/routes/songs.js - Admin authentication → JWT authorization: protects admin operations