🎧 MoodWave – AI Playlist Studio

Ruh haline göre Spotify hesabına otomatik playlist oluşturan, Groq destekli premium bir web arayüzü. Kısaca: “Modunu yaz, AI senin için playlist oluştursun, Spotify hesabına otomatik eklesin.”

---

✨ Özellikler (Features)

• 🔐 Spotify ile güvenli giriş OAuth 2.0 Authorization Code Flow kullanarak Spotify hesabı ile login.

• 🧠 Groq + Llama tabanlı AI önerileri llama-3.3-70b-versatile modeli ile, yazdığın mood metnine göre şarkı listesi üretilir.

• 🎵 Gerçek şarkılardan oluşan playlist AI yalnızca title + artist çiftleri üretir, PHP backend bu şarkıları Spotify Web API üzerinden arar ve uygun track URI’larını bulur.

• ⚙️ JSON-only AI çıktısı Model ayrı bir metin, açıklama veya markdown değil; sadece geçerli JSON döndürmeye zorlanır.

• 🧩 Framework’süz sade backend Tamamen PHP 8+ ve cURL ile yazılmış; ek framework bağımlılığı yok.

• 💻 Modern, responsive web arayüzü Vanilla JS + modern CSS ile tasarlanmış, hem mobil hem desktop için uygun bir arayüz.

• 👤 Profil dropdown + logout Spotify ile giriş yaptıktan sonra sağ üstte kullanıcı adı ve avatar görünür, dropdown üzerinden çıkış yapılabilir.

---

🧱 Teknoloji Stack

Backend

• PHP 8+
• cURL (Spotify ve Groq HTTP istekleri için)
• Session tabanlı basit auth durumu

AI

• Groq API
• Model: llama-3.3-70b-versatile
• JSON-only içerik üretimi için özel prompt tasarımı

Spotify & Auth

• Spotify Web API
• OAuth 2.0 – Authorization Code Flow
• Kullanılan scope’lar:
  • user-top-read
  • playlist-modify-private
  • playlist-modify-public

Frontend

• Vanilla JavaScript (app.js)
• Modern CSS (style.css)
• Responsive layout (mobil + desktop)
• Basit, minimal form ve geri bildirim bileşenleri

---

📁 Proje Yapısı

MoodWave-AI-Playlist-Studio/
├─ index.php         # Ana arayüz: login butonu, mood formu, profil dropdown, sonuç mesajı
├─ backend.php       # Spotify login yönlendirmesi, playlist oluşturma (Groq çağrısı + Spotify playlist create)
├─ callback.php      # Spotify redirect endpoint: code → access_token, refresh_token + kullanıcı profili
├─ config.php        # Ortam ayarları (BASE_URL, Spotify ve Groq API key’leri) → .gitignore’da olmalı
├─ config.example.php# Örnek config dosyası (dummy değerler ile)
├─ app.js            # Form submit (AJAX), sonuç gösterimi, profil dropdown aç/kapa
├─ style.css         # Premium dark tema, responsive tasarım
└─ README.md         # Bu doküman