How nauqh/resonance works
Main Components
a) Data Layer:
• Spotify Million Playlist Dataset Storage
• PostgreSQL Database
• Raw Data Storage (JSON/CSV files)
• Processed Data Storage
b) Backend Components:
• FastAPI Web Server
• Recommendation Engine
• Music Taste Analyzer
• Song Recommender (KNN-based)
• OpenAI LLM Integration
• Data Processing Pipeline
c) Frontend Components:
• React Application
• User Interface Components
• API Integration Layer
┌─ User Interface Layer ─────────────────────┐
• React Components │
• Music Preference Input │
• Playlist Integration │
• Results Display │
• ┬───────────────────────┘
• ↕
┌─ API Layer ───────┴───────────────────────┐
• FastAPI Endpoints │
• /analysis │
• /songs │
• /artists │
• ┬───────────────────────┘
• ↕
┌─ Processing Layer ┴───────────────────────┐
• Recommendation Engine │
• ┌─────────────────┐ ┌────────────────┐ │
• Music Taste │ │ Song │ │
• Analyzer │ │ Recommender │ │
• ┘ └────────────────┘ │
• OpenAI LLM Integration │
• ┬───────────────────────┘
• ↕
┌─ Data Layer ──────┴───────────────────────┐
• ┌─────────────┐ ┌──────────────────────┐ │
• Raw Data │→│ Data Pipeline │ │
• ┘ │ - Extraction │ │
• ┌─────────────┐ │ - Transformation │ │
• PostgreSQL │←│ - Loading │ │
• ┘ └──────────────────────┘ │
• ┘
Important Flows to Highlight
a) Data Processing Flow:
• Spotify Million Playlist Dataset → Data Pipeline → PostgreSQL
• User Playlist → Spotify API → Feature Extraction → Recommendation Engine
b) Recommendation Flow:
• User Input → API → Recommendation Engine → Results
• Playlist Analysis → KNN Algorithm → Similar Songs
Additional Elements
Specific technical details in annotations:
• Python 3.10
• React/TypeScript
• FastAPI
• PostgreSQL
• Docker containers
• AWS deployment