How blackdevil-com/patta-kelu works
Patta Kelu is a full-stack music-streaming platform: listeners browse or search a catalog, select tracks, and stream audio; they can also manage playlists and a personal library. The React client calls the Spring REST API, whose services implement catalog, account, library, streaming, recommendation, and administration capabilities over relational data and file storage. The graph preserves documented major features, but several service and controller relationships are represented at directory level because their source was not sampled.
Main entry points: controller REST endpoints · repository Data repositories · StorageService.java Storage interface · App.tsx Web app routing
Components 20
Listener application
- Web app routing
frontend/src/App.tsx - Search and browse
frontend/src/pages/SearchPage.tsx - Audio player
frontend/src/hooks/useAudioPlayer.ts - API client
frontend/src/api/client.ts - Auth state
frontend/src/stores/authStore.ts
Backend capabilities
- REST endpoints
backend/src/main/java/com/pattakelu/controller - Catalog search
backend/src/main/java/com/pattakelu/service/SearchService.java - Authentication
backend/src/main/java/com/pattakelu/service/AuthService.java - Administration
backend/src/main/java/com/pattakelu/service/AdminService.java - Catalog and listener services
backend/src/main/java/com/pattakelu/service - Audio streaming
backend/src/main/java/com/pattakelu/service/StreamService.java - Recommendations
backend/src/main/java/com/pattakelu/service/RecommendationService.java
Data and media
- Data repositories
backend/src/main/java/com/pattakelu/repository - Catalog mapping
backend/src/main/java/com/pattakelu/mapper/CatalogMapper.java - Storage interface
backend/src/main/java/com/pattakelu/storage/StorageService.java - Local storage
backend/src/main/java/com/pattakelu/storage/LocalStorageService.java - Supabase storage
backend/src/main/java/com/pattakelu/storage/SupabaseStorageService.java - Relational database
Identity and access
- JWT services
backend/src/main/java/com/pattakelu/security/JwtService.java
Other components
- Listener or admin
Connections 22
- Listener or admin → Web app routing: uses
- Web app routing → Search and browse: routes to
frontend/src/App.tsx - Search and browse → API client: requests through
frontend/src/pages/SearchPage.tsx - Audio player → API client: requests through
frontend/src/hooks/useAudioPlayer.ts - Web app routing → Auth state: checks auth
frontend/src/App.tsx - API client → REST endpoints: calls REST API
- REST endpoints → Catalog search: delegates search
- REST endpoints → Authentication: delegates auth
backend/src/main/java/com/pattakelu/controller/AuthController.java - REST endpoints → Administration: delegates admin
backend/src/main/java/com/pattakelu/controller/AdminController.java - REST endpoints → Catalog and listener services: handles domain actions
backend/src/main/java/com/pattakelu/controller/AuthController.java - REST endpoints → Audio streaming: requests streams
- Catalog search → Data repositories: queries catalog
backend/src/main/java/com/pattakelu/service/SearchService.java - Catalog search → Catalog mapping: maps results
backend/src/main/java/com/pattakelu/service/SearchService.java - Authentication → Data repositories: reads and writes
backend/src/main/java/com/pattakelu/service/AuthService.java - Authentication → JWT services: creates tokens
backend/src/main/java/com/pattakelu/service/AuthService.java - Administration → Data repositories: manages records
backend/src/main/java/com/pattakelu/service/AdminService.java - Administration → Storage interface: deletes media
backend/src/main/java/com/pattakelu/service/AdminService.java - Data repositories → Relational database: persists entities
- Storage interface → Local storage: implemented by
backend/src/main/java/com/pattakelu/configuration/StorageConfiguration.java - Storage interface → Supabase storage: implemented by
backend/src/main/java/com/pattakelu/configuration/StorageConfiguration.java - Audio streaming → Storage interface: reads audio ranges
- Recommendations → Data repositories: uses catalog data