Implement Phase 2 Frontend and Phase 3 Data Enrichment

- Initialize React+Vite Frontend with Ant Design Dashboard.
- Implement Data Enrichment: ReccoBeats (Audio Features) and Spotify (Genres).
- Update Database Schema via Alembic Migrations.
- Add Docker support (Dockerfile, docker-compose.yml).
- Update README with hosting instructions.

backend/app/services/reccobeats_client.py

@@ -0,0 +1,18 @@
+import httpx
+from typing import List, Dict, Any
+
+RECCOBEATS_API_URL = "https://api.reccobeats.com/v1/audio-features"
+
+class ReccoBeatsClient:
+    async def get_audio_features(self, spotify_ids: List[str]) -> List[Dict[str, Any]]:
+        if not spotify_ids:
+            return []
+        ids_param = ",".join(spotify_ids)
+        async with httpx.AsyncClient() as client:
+            try:
+                response = await client.get(RECCOBEATS_API_URL, params={"ids": ids_param})
+                if response.status_code != 200:
+                    return []
+                return response.json().get("content", [])
+            except Exception:
+                return []

backend/app/services/spotify_client.py

@@ -3,6 +3,7 @@ import base64
 import time
 import httpx
 from fastapi import HTTPException
+from typing import List, Dict, Any
 
 SPOTIFY_TOKEN_URL = "https://accounts.spotify.com/api/token"
 SPOTIFY_API_BASE = "https://api.spotify.com/v1"
@@ -68,3 +69,26 @@ class SpotifyClient:
             if response.status_code != 200:
                 return None
             return response.json()
+
+    async def get_artists(self, artist_ids: List[str]) -> List[Dict[str, Any]]:
+        """
+        Fetches artist details (including genres) for a list of artist IDs.
+        Spotify allows up to 50 IDs per request.
+        """
+        if not artist_ids:
+            return []
+
+        token = await self.get_access_token()
+        ids_param = ",".join(artist_ids)
+
+        async with httpx.AsyncClient() as client:
+            response = await client.get(
+                f"{SPOTIFY_API_BASE}/artists",
+                params={"ids": ids_param},
+                headers={"Authorization": f"Bearer {token}"},
+            )
+            if response.status_code != 200:
+                print(f"Error fetching artists: {response.text}")
+                return []
+
+            return response.json().get("artists", [])