Zihin Okuma Müzik API'nize Arkadaş Ekleyin: Gerçek Zamanlı Sosyal Paylaşım

Zihin Okuma Müzik API'nizi gerçekten sosyal hale getirmeye hazır mısınız? Bu eğitimde, veritabanında kalıcı olan güçlü bir arkadaş sistemi ve çalma listesi paylaşımı ekleyeceksiniz. Böylece kullanıcılar, çevrimiçi olmadıklarında bile arkadaşlarının paylaşılan çalma listelerini görüntüleyebilirler. Gerçek zamanlı güncellemeler için Socket.io'yu ve kalıcı depolama için MongoDB'yi kullanacağız.

Neler Oluşturacaksınız

Arkadaş sistemi – ObjectId'leri kullanarak karşılıklı arkadaşlıklarla kullanıcı adına göre arkadaş ekleyin ve yönetin
Kalıcı çalma listesi paylaşımı – Paylaşılan çalma listeleri veritabanına kaydedilir ve her zaman görüntülenebilir
Gerçek zamanlı bildirimler – Arkadaşlarınız paylaşım yaptığında (çevrimiçiyse) anında bildirim alın
Etkinlik akışı – Tıklanabilir çalma listesi önizlemeleriyle son arkadaş paylaşımlarını görün
Gelişmiş ruh hali analizi – Arama geri dönüşleriyle akıllı çalma listesi oluşturma

Önkoşullar

Bölüm 2
MongoDB, Node.js ve npm yüklü
Spotify API kimlik bilgileri (İstemci Kimliği ve Gizli Anahtar)
30–45 dakika kodlama süresi

Bölüm 2'de, ruh hali geçmişi ve akıllı tercihlere sahip kullanıcı hesapları oluşturdunuz. Şimdi bunu sosyal hale getireceğiz! Kullanıcıları nasıl bağlayacağınızı, çalma listelerini hem gerçek zamanlı hem de kalıcı olarak nasıl paylaşacağınızı ve arkadaşlarınızın ruh hallerine göre ne dinlediklerini nasıl göreceğinizi öğreneceksiniz.

Temel Kavramları Anlama

Koda dalmadan önce, ne oluşturduğumuzu anlayalım:

Socket.io – Sunucunuz ve tarayıcınız arasında gerçek zamanlı, iki yönlü iletişimi sağlayan bir kütüphane. Bunu kısa mesaj yerine bir telefon görüşmesi gibi düşünün; sayfayı yenilemeden anında bilgi gönderip alabilirsiniz.
Kalıcı Depolama – Verilerin MongoDB veritabanınıza kaydedilmesi, böylece kullanıcılar oturumu kapattığında bile orada kalması. Bu, bir dosyayı yalnızca bellekte tutmak yerine sabit diskinize kaydetmek gibidir.
ObjectId Referansları – MongoDB'nin veriler arasında ilişki kurma yöntemi. Arkadaşlarınızın tüm bilgilerini profilinize kopyalamak yerine, profillerine bir referans (işaretçi gibi) depolarsınız.
Şemalar – Bunları, verilerinizin yapısını tanımlayan planlar olarak düşünün. Bunlar MongoDB'ye her belgenin hangi alanlara sahip olması gerektiğini ve her alana ne tür verilerin gireceğini söyler.

Adım 1: Gerekli Bağımlılıkları Yükleyin

Proje dizininizdeki terminali açın ve gerçek zamanlı özellikler için Socket.io'yu yükleyin:

npm install socket.io

Bu ne işe yarar: Bu komut, Socket.io kütüphanesini projenize indirir ve yükler. npm install komutu, paketleri npm kayıt defterinden (büyük bir JavaScript kodu kütüphanesi) alır ve bunları node_modules klasörünüze ekler.

Diğer bağımlılıklar (sentiment, spotify-web-api-node, bcryptjs, jsonwebtoken, mongoose, express, dotenv) Bölüm 2'den itibaren yüklenmiş olmalıdır.

Adım 2: Kullanıcı Modelinizi Sosyal Özelliklerle Güncelleyin

Bölüm 2'de zaten bir Kullanıcı modeli oluşturduğunuz için, sosyal özellikler eklemek üzere onu güncelleyeceğiz. Kullanıcı modeli, veritabanımızda her kullanıcı hakkında hangi bilgileri depolayacağımızı tanımlayan bir şablon gibidir.

Ekleyeceklerimiz:

friends dizisi – Diğer kullanıcılara ait ObjectId referanslarının bir listesi. Tam kullanıcı bilgilerini depolamak yerine, veritabanındaki diğer kullanıcı belgelerine işaret eden kimlikleri depolarız.
sharedWith ve isShared alanları – Bunlar hangi ruh hali girdilerinin paylaşıldığını ve kiminle paylaşıldığını izler.
sharedPlaylistSchema – Paylaşılan bir çalma listesinin nasıl göründüğünü tanımlayan yeni bir şema (taslak): kimin paylaştığı, hangi ruh hali için olduğu, parçalar ve ne zaman paylaşıldığı.
sharedPlaylists dizisi – Arkadaşlarınızın sizinle paylaştığı tüm çalma listelerini depolayan bir liste.

models/User.js dosyanızı şununla değiştirin:

const mongoose = require('mongoose'); const bcrypt = require('bcryptjs'); // Her bir ruh hali girişi için şema (kullanıcı her çalma listesi oluşturduğunda) const moodEntrySchema = new mongoose.Schema({ text: String, // Kullanıcının yazdığı (örn. "bugün mutlu hissediyorum") detectedMood: String, // Analiz cihazımızın algıladığı ruh hali (örn. "mutlu") confidence: Sayı, // Ne kadar eminiz (0-10) playlistGenerated: [{ // Önerdiğimiz parçaların dizisi trackName: String, artist: String, spotifyId: String, liked: { type: Boolean, default: null } // null = not rated, true = liked, false = disliked }], sharedWith: {[ type: mongoose.Schema.Types.ObjectId, ref: 'User' }], // Bunu kiminle paylaştık? isShared: { type: Boolean, default: false }, // Bu paylaşıldı mı? timestamp: { type: Tarih, varsayılan: Date.now } // Bu ne zaman oluşturuldu? }); // Kullanıcı tercihleri için şema (favori türler, vb.) const userPreferencesSchema = new mongoose.Schema({ favoriteGenres: [Dize], preferredEnergyLevel: { type: Number, min: 0, max: 1 }, dislikedArtists: [Dize], moodMusicMapping: { happy: [Dize], sad: [Dize], energetic: [Dize], chill: [Dize], angry: [Dize], romantic: [Dize], nostalgic: [Dize] } }); // YENİ: Arkadaşlarınızın sizinle paylaştığı çalma listeleri için şema const sharedPlaylistSchema = new mongoose.Schema({ sharedBy: { type: mongoose.Schema.Types.ObjectId, ref: 'User' }, // sharedByUsername'i paylaşan arkadaşınıza ait ObjectId referansı: String, // Kolay görüntüleme için kullanıcı adı (performans için normalleştirilmemiş) mood: String, // Bu çalma listesi hangi ruh haline uygundu? playlist: [{ // Gerçek parçaların adı: String, sanatçı: String, album_image: String, id: String }], timestamp: { type: Date, default: Date.now } // Bu ne zaman paylaşıldı? }); // Ana kullanıcı şeması - bir kullanıcı belgesinin yapısını tanımlar const userSchema = new mongoose.Schema({ username: { type: String, required: true, unique: true, trim: true, minlength: 3 }, email: { type: String, required: true, unique: true, lowercase: true }, password: { type: String, required: true, minlength: 6 }, friends: {[ type: mongoose.Schema.Types.ObjectId, ref: 'User' }], // Arkadaşlara ait ObjectId referanslarının dizisi moodHistory: [moodEntrySchema], // Bu kullanıcının oluşturduğu tüm çalma listeleri sharedPlaylists: [sharedPlaylistSchema], // Arkadaşlarının bu kullanıcıyla paylaştığı çalma listeleri preferences: { type: userPreferencesSchema, default: () => ({}) }, stats: { totalPlaylists: { type: Number, default: 0 }, favoriteTime: String, mostCommonMood: String, joinDate: { type: Date, default: Date.now } } }, { timestamps: true }); // createdAt ve updatedAt alanlarını otomatik olarak ekle // Ara yazılım: Bir kullanıcıyı kaydetmeden önce bu fonksiyonu çalıştır (şifrelerini karıştırmak için) userSchema.pre('save', async function(next) { if (!this.isModified('password')) return next(); // Yalnızca şifre değiştirildiyse karıştır this.password = await bcrypt.hash(this.password, 12); // 12 tur tuzla karıştır next(); }); // Yöntem: Bir şifrenin karıştırılmış şifreyle eşleşip eşleşmediğini kontrol et userSchema.methods.comparePassword = function(p) { return bcrypt.compare(p, this.password); }; // Yöntem: Kullanıcı istatistiklerini ruh hali geçmişine göre güncelle userSchema.methods.updateStats = function() { const moods = this.moodHistory.map(e => e.detectedMood).filter(Boolean); // Boş olmayan tüm ruh hallerini al this.stats.totalPlaylists = moods.length; if (moods.length > 0) { // Her ruh halinin kaç kez göründüğünü say const counts = moods.reduce((a, m) => { a[m] = (a[m] || 0) + 1; return a; }, {}); // En yüksek sayıya sahip ruh halini bul this.stats.mostCommonMood = Object.keys(counts).reduce((a, b) => counts[a] > counts[b] ? a : b, 'neutral'); } else { this.stats.mostCommonMood = 'neutral'; } // Çalma listeleri oluşturdukları zamana göre günün favori saatini hesapla const hours = this.moodHistory.map(e => e.timestamp.getHours()).filter(h => !isNaN(h)); if (hours.length) { const avg = hours.reduce((a, b) => a + b, 0) / hours.length; this.stats.favoriteTime = avg < 6 ? 'gece' : avg < 12 ? 'sabah' : avg < 18 ? 'öğleden sonra' : 'akşam'; } }; // Modeli diğer dosyalarda kullanabilmek için dışa aktarın module.exports = mongoose.model('User', userSchema);

Açıklanan Temel Kavramlar:

ObjectId Referansları – friends dizisi tüm kullanıcı nesnelerini depolamaz. Bunun yerine, diğer kullanıcıları işaret eden ObjectId'leri (benzersiz tanımlayıcılar) depolar. Bu verimlidir çünkü bir arkadaş kullanıcı adını değiştirirse, her yerde güncellememize gerek kalmaz; sadece referansı takip ederiz.
Denormalizasyon – Hem sharedBy (ObjectId) hem de sharedByUsername (Dize) depoladığımıza dikkat edin. Buna denormalizasyon denir; performans için aynı verileri birden fazla yerde depolamak. Kullanıcı adını saklıyoruz, böylece paylaşılan çalma listelerini her görüntülediğimizde kullanıcıyı aramak zorunda kalmıyoruz.
Ara Yazılım (.pre()) – Bu, belirli işlemlerden önce otomatik olarak çalışır. Burada, güvenlik amacıyla veritabanına kaydetmeden önce parolaları karıştırır.
Örnek Yöntemleri (.methods) – Bunlar, user.comparePassword() veya user.updateStats() gibi, bireysel kullanıcı belgelerinde çağırabileceğiniz işlevlerdir.

Adım 3: HTML Ön Ucunuzu Sosyal Özelliklerle Güncelleyin

Şimdi, arkadaş yönetimi ve etkinlik akışı eklemek için kullanıcı arayüzünü güncelleyelim. HTML, web sayfanızın yapısını tanımlar; hangi öğelerin görüneceğini ve nerede konumlandırılacağını belirler.

Kullanıcı arayüzüne eklediklerimiz:

Arkadaş listesi bölümü – Mevcut arkadaşlarınızı gösterir
Arkadaş girişi ekle – Bir arkadaşınızın kullanıcı adını girmek için metin alanı
Son etkinlik akışı – Arkadaşlarınızın paylaştığı çalma listelerini görüntüler (tüm çalma listesini görüntülemek için tıklanabilir)
Paylaşım onay kutusu – Oluşturduğunuz çalma listesini arkadaşlarınızla paylaşma seçeneği
Bildirim alanı – Gerçek zamanlı güncellemeler için açılır bildirimler

public/index.html dosyanızı şununla değiştirin:

<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"/> <meta name="viewport" content="width=device-width, initial-scale=1.0"/> <title>Zihin Okuma Müzik API'si - Sosyal</title> <style> /* Varsayılan tarayıcı stillerini sıfırla */ * { margin: 0; padding: 0; box-sizing: border-box; } /* Degrade arka planlı ana gövde stili */ body { font-family: 'Segoe UI', sans-serif; background: linear-gradient(135deg, #667eea, #764ba2); min-height: 100vh; color: #333; } /* Tüm kontrol paneli için kapsayıcı */ .dashboard { max-width: 1000px; margin: 0 auto; padding: 20px; } /* Hoş geldiniz mesajının bulunduğu başlık bölümü */ .header { background: rgba(255,255,255,0.95); backdrop-filter: blur(10px); /* Cammorfizm için bulanıklık efekti */ border-radius: 20px; padding: 30px; margin-bottom: 30px; text-align: center; box-shadow: 0 8px 32px rgba(0,0,0,0.1); } /* İki sütunlu ızgara düzeni: çalma listesi bölümü (daha büyük) ve arkadaşlar bölümü (daha küçük) */ .main-content { display: grid; grid-template-columns: 2fr 1fr; gap: 30px; } /* Her iki bölüm için kart stili */ .playlist-section, .friends-section { background: rgba(255,255,255,0.95); border-radius: 20px; padding: 30px; box-shadow: 0 8px 32px rgba(0,0,0,0.1); } /* Form elemanlarının stili */ input, textarea, button { width: 100%; padding: 12px; margin: 10px 0; border: 2px solid #e1e5e9; border-radius: 8px; font-size: 16px; } /* Degrade arka planlı düğmeye özgü stil */ button { background: linear-gradient(135deg, #667eea, #764ba2); color: #fff; border: none; cursor: pointer; font-weight: 600; } /* Düğmelerde ince gezinme efekti */ button:hover { transform: translateY(-2px); } /* Bireysel arkadaş öğesi stili */ .friend-item { background: #f8f9fa; dolgu: 10px; kenar boşluğu: 5px 0; kenarlık yarıçapı: 8px; kenarlık solu: 4px düz #667eea; /* Soldaki vurgu rengi */ } /* Bildirim açılır penceresi stili (varsayılan olarak gizli, sağdan kayar) */ .notification { konum: sabit; üst: 20px; sağ: 20px; arka plan: rgba(102,126,234,0.95); renk: #fff; dolgu: 15px 20px; kenarlık yarıçapı: 8px; kutu gölgesi: 0 4px 15px rgba(0,0,0,0.1); dönüşüm: translateX(400px); /* Ekran dışından başla */ geçiş: dönüşüm .3s kolaylık; z-indeksi: 1000; maksimum genişlik: 300px; } /* Bildirimi göster (kaydır) */ .notification.show { transform: translateX(0); } /* Giriş ve kayıt formları */ .login-section, .register-section { background: rgba(255,255,255,0.95); border-radius: 20px; padding: 30px; max-width: 400px; margin: 50px auto; } /* Paylaşım için onay kutusu denetimleri */ .share-controls { display: flex; gap: 10px; margin: 10px 0; } .share-controls input[type=checkbox] { width: auto; margin-right: 5px; } </style> </head> <body> <div class="dashboard"> <!-- Kimlik Doğrulama Bölümü (Giriş/Kayıt formları) --> <div id="authSection"> <!-- Giriş Formu --> <div class="login-section"> <h2>🧠🎵 Tekrar Hoş Geldiniz!</h2> <input type="text" id="loginUsername" placeholder="Kullanıcı Adı"/> <input type="password" id="loginPassword" placeholder="Şifre"/> <button onclick="login()">Giriş</button> <p><a href="#" onclick="showRegister()">Hesabınız yok mu? Kayıt Ol</a></p> </div> <!-- Kayıt Formu (varsayılan olarak gizli) --> <div id="registerSection" class="register-section" style="display:none"> <h2>🎵 Müzik Profilinizi Oluşturun</h2> <input type="text" id="regUsername" placeholder="Kullanıcı Adı"/> <input type="email" id="regEmail" placeholder="E-posta"/> <input type="password" id="regPassword" placeholder="Şifre"/> <button onclick="register()">Hesap Oluştur</button> <p><a href="#" onclick="showLogin()">Zaten bir hesabınız var mı? Giriş Yap</a></p> </div> </div> <!-- Ana Kontrol Paneli Bölümü (girişten sonra gösterilir) --> <div id="dashboardSection" style="display:none"> <!-- Kullanıcı adı ve çıkış düğmesi olan başlık --> <div class="header"> <h1>🧠🎵 Kişisel Müzik Zihin Okuyucunuz</h1> <p>Hoş geldiniz, <span id="username"></span>!</p> <button onclick="logout()" style="width:auto; margin-top:10px">Çıkış</button> </div> <!-- İki sütunlu düzen: Solda çalma listesi bölümü, sağda arkadaşlar bölümü --> <div class="main-content"> <!-- Sol sütun: Çalma listesi oluşturma --> <div class="playlist-section"> <h2>💭 Nasıl hissediyorsun?</h2> <textarea id="moodText" placeholder="Ruh halinizi anlatın..."></textarea> <div class="share-controls"> <label><input type="checkbox" id="shareWithFriends"/>Arkadaşlarla paylaş</label> </div> <button onclick="generatePlaylist()">🎧 Çalma Listesi Oluştur</button> <!-- Sonuçlar, çalma listesi oluşturulduktan sonra burada görünür --> <div id="result" style="display:none"></div> </div> <!-- Sağ sütun: Arkadaşlar ve etkinlik --> <div class="friends-section"> <h3>👥 Arkadaşlarım</h3> <div id="friendsList"></div> <h4>Arkadaş Ekle</h4> <input type="text" id="friendUsername" placeholder="Arkadaşın kullanıcı adı"/> <button onclick="addFriend()">Arkadaş Ekle</button> <h4>Son Aktivite</h4> <!-- Arkadaşların paylaşılan çalma listeleri burada görünür --> <div id="friendActivity">Arkadaş aktivitesi burada görünecek...</div> </div> </div> </div> </div> <!-- Bildirim açılır pencereleri için kapsayıcı --> <div id="notificationArea"></div> <!-- Socket.io kütüphanesini ekleyin (sunucumuz tarafından otomatik olarak sunulur) --> <script src="/socket.io/socket.io.js"></script> <!-- Özel JavaScript'imizi ekleyin --> <script src="./js/app.js"></script> </body> </html>

HTML Yapısını Anlamak:

İki ana bölüm: authSection (giriş/kayıt) ve dashboardSection (ana uygulama). Aynı anda yalnızca bir tanesi görünür.
Izgara düzeni: .main-content, iki sütun oluşturmak için CSS Izgarası kullanır (çalma listesi için 2fr, arkadaşlar için 1fr). Bu, çalma listesi bölümünün iki kat daha geniş olduğu anlamına gelir.
Olay işleyicileri: onclick="functionName()", öğeye tıklandığında tarayıcıya bir JavaScript işlevi çağırmasını söyler.
Kimlikler: Öğelerin benzersiz kimlikleri vardır (örneğin id="friendsList"), böylece JavaScript'imiz bunları daha sonra bulabilir ve değiştirebilir.

4. Adım: server.js'yi Socket.io, Arkadaş Uç Noktaları ve Kalıcı Paylaşım ile güncelleyin

Şimdi, arkadaş isteklerini, çalma listesi paylaşımını ve gerçek zamanlı iletişimi işleyecek şekilde sunucumuzu güncelleyeceğiz. Sunucu, uygulamanızın "beynidir"; istekleri işler, veritabanıyla iletişim kurar ve kullanıcılara yanıtlar gönderir.

Sunucuya eklediklerimiz:

Socket.io sunucusu – Sunucu ve istemciler arasında gerçek zamanlı, çift yönlü iletişimi etkinleştirir
/api/add-friend uç noktası – Arkadaşlık isteklerini (karşılıklı arkadaşlık) işler
/api/shared-playlists uç noktası – Arkadaşlarınızın sizinle paylaştığı çalma listelerini döndürür
Geliştirilmiş /api/personalized-playlist – Artık paylaşılan çalma listelerini arkadaşlarınızın veritabanlarına kaydeder
Socket olay işleyicileri – Gerçek zamanlı olayları dinler ve yayınlar (kimlik doğrulama, paylaşım)

server.js dosyanızı şununla değiştirin:

// Ortam değişkenlerini .env dosyasından yükle require('dotenv').config(); // Gerekli modülleri içe aktar const path = require('path'); const express = require('express'); const http = require('http'); const socketIo = require('socket.io'); const mongoose = require('mongoose'); const jwt = require('jsonwebtoken'); const auth = require('./middleware/auth'); const User = require('./models/User'); const moodAnalyzer = require('./moodAnalyzer'); const PlaylistGenerator = require('./playlistGenerator'); // Çalma listesi oluşturucusunu başlat const playlistGen = new PlaylistGenerator(); const PORT = process.env.PORT || 3000; // MongoDB veritabanına bağlan async function connectDB() { try { console.log('🔗 MongoDB'ye bağlanılıyor…'); await mongoose.connect(process.env.MONGODB_URI, { useNewUrlParser: true, useUnifiedTopology: true }); console.log('✅ MongoDB başarıyla bağlandı!'); } catch (err) { console.error('❌ MongoDB bağlantısı başarısız oldu:', err.message); process.exit(1); // Veritabanı bağlantısı başarısız olursa çık } } connectDB(); // Express uygulamasını ve HTTP sunucusunu oluştur const app = express(); const server = http.createServer(app); // Socket.io'yu HTTP sunucusunun üstünde başlat const io = socketIo(server); // Çevrimiçi kullanıcıları izlemek için harita: userId => socketId // Bu, şu anda bağlı olan belirli kullanıcılara mesaj göndermemizi sağlar const connectedUsers = new Map(); // Socket.io bağlantı işleyicisi - bir istemci io.on('connection', socket => { console.log('🔗 Socket connected:', socket.id); // 'authenticate' olayını işle - istemci bize kim olduklarını söyler socket.on('authenticate', ({ userId, username }) => { // Daha sonra kendilerine mesaj gönderebilmemiz için bu kullanıcının soket kimliğini depolar connectedUsers.set(userId, socket.id); socket.userId = userId; // Kullanıcı kimliğini bu sokete ekle socket.username = username; // Kullanıcı adını bu sokete ekle console.log(`✅ Kimliği doğrulanmış kullanıcı: ${username}`); }); // 'share_playlist' olayını işle - kullanıcı arkadaşlarıyla paylaşmak istiyor socket.on('share_playlist', async ({ friendName, mood, playlist, friendIds }) => { try { // Döngü tüm arkadaş kimlikleri üzerinden (let friendId of friendIds) { // Bu arkadaşın soket kimliğini al (eğer çevrimiçiyse) const sid = connectedUsers.get(friendId.toString()); if (sid) { // Arkadaş çevrimiçi! Onlara gerçek zamanlı bildirim gönder io.to(sid).emit('friend_shared_playlist', { friendName, mood, playlist }); } // Arkadaş çevrimdışıysa, oturum açtıklarında aktivite akışında çalma listesini görecekler } } catch (err) { console.error('Çalma listesini paylaşma hatası:', err); } }); // Bağlantıyı yönet - kullanıcıyı çevrimiçi haritadan kaldır socket.on('disconnect', () => { if (socket.userId) { connectedUsers.delete(socket.userId); console.log(`👋 Bağlantı Kesildi: ${socket.username}`); } }); }); // JSON istek gövdelerini ayrıştırmak için ara yazılım app.use(express.json()); // 'public' klasöründeki statik dosyaları (HTML, CSS, resimler) sunar app.use(express.static(path.join(__dirname, 'public'))); // ===== API UÇ NOKTALARI ===== // POST /api/register - Yeni bir kullanıcı hesabı oluştur app.post('/api/register', async (req, res) => { try { const { username, email, password } = req.body; // Girişi doğrula if (!username || !email || !password) { return res.status(400).json({ error: 'Tüm alanlar gereklidir' }); } if (password.length < 6) { return res.status(400).json({ error: 'Parola en az 6 karakterden oluşmalıdır' }); } // Kullanıcı adı veya e-postanın zaten mevcut olup olmadığını kontrol et const exists = await User.findOne({ $or: [{ username }, { email }] }); if (exists) { return res.status(400).json({ error: 'Kullanıcı adı veya e-posta zaten mevcut' }); } // Yeni kullanıcı oluştur ve kaydet (şifre, önceden kaydedilmiş ara yazılımımız tarafından otomatik olarak karıştırılacaktır) const user = new User({ username, email, password }); await user.save(); res.status(201).json({ message: 'Kullanıcı başarıyla oluşturuldu' }); } catch (err) { console.error('Kayıt hatası:', err); res.status(500).json({ error: 'Kayıt başarısız oldu' }); } }); // POST /api/login - Kullanıcıyı doğrula ve JWT belirtecini döndür app.post('/api/login', async (req, res) => { try { const { username, password } = req.body; // Kullanıcıyı kullanıcı adı veya e-posta ile bul const user = await User.findOne({ $or: {[ username }, { email: username }] }); // Kullanıcının var olup olmadığını ve parolanın doğru olup olmadığını kontrol et if (!user || !(await user.comparePassword(password))) { return res.status(401).json({ error: 'Invalid credentials' }); } // JWT belirtecini oluştur (geçici kimlik kartı gibi) const token = jwt.sign( { userId: user._id }, // Yük (kodladığımız şey) process.env.JWT_SECRET, // Gizli anahtar (güvenliğini korur) { expiresIn: '7d' } // Jeton 7 gün içinde sona eriyor ); // Jetonu istemciye geri gönder res.json({ token, user: { username: user.username, email: user.email, friends: user.friends } }); } catch (err) { console.error('Giriş hatası:', err); res.status(500).json({ error: 'Giriş başarısız oldu' }); } }); // GET /api/profile - Geçerli kullanıcının profilini al // 'auth' ara yazılımı JWT belirtecini doğrular ve kullanıcıyı req.user'a bağlar app.get('/api/profile', auth, async (req, res) => { try { // Kullanıcı istatistiklerini güncelle req.user.updateStats(); await req.user.save(); // Arkadaşlar dizisini doldur (ObjectId'leri gerçek kullanıcı nesneleriyle değiştir) await req.user.populate('friends', 'username _id'); const { username, email, friends } = req.user; res.json({ _id: req.user._id, username, email, friends: friends.map(f => ({ username: f.username, _id: f._id })) }); } catch (err) { console.error('Profil hata:', err); res.status(500).json({ hata: 'Profil yüklenemedi' }); } }); // GET /api/shared-playlists - Arkadaşlarınızın sizinle paylaştığı çalma listelerini alın app.get('/api/shared-playlists', auth, async (req, res) => { try { // En son paylaşılan 10 çalma listesini en sonuncusundan başlayarak sıralayın const sharedPlaylists = req.user.sharedPlaylists .sort((a, b) => b.timestamp - a.timestamp) // Zaman damgasına göre azalan sıraya göre sırala .slice(0, 10); // İlk 10'u al res.json({ sharedPlaylists }); } catch (err) { console.error('Paylaşılan çalma listeleri hatası:', err); res.status(500).json({ error: 'Paylaşılan çalma listeleri yüklenemedi' }); } }); // POST /api/add-friend - Arkadaş ekle (karşılıklı arkadaşlık) app.post('/api/add-friend', auth, async (req, res) => { try { const { friendUsername } = req.body; // Kullanıcı adına göre arkadaşı bul const friend = await User.findOne({ username: friendUsername }); if (!friend) { return res.status(404).json({ error: 'Kullanıcı bulunamadı' }); } // Zaten arkadaş olup olmadıklarını kontrol et if (req.user.friends.some(friendId => friendId.toString() === friend._id.toString())) { return res.status(400).json({ error: 'Bu kullanıcıyla zaten arkadaş' }); } // Her kullanıcıyı diğerinin arkadaş listesine ekle (karşılıklı arkadaşlık) req.user.friends.push(friend._id); friend.friends.push(req.user._id); // Her iki kullanıcıyı da kaydet await req.user.save(); await friend.save(); res.json({ message: 'Arkadaş başarıyla eklendi', friendId: friend._id }); } catch (err) { console.error('Arkadaş ekleme hatası:', err); console.error('Hata yığını:', err.stack); res.status(500).json({ error: 'Arkadaş eklenemedi' }); } }); // POST /api/personalized-playlist - Ruh haline göre çalma listesi oluştur app.post('/api/personalized-playlist', auth, async (req, res) => { try { const { text, shareWithFriends = false, playlistSize = 15 } = req.body; if (!text) { return res.status(400).json({ error: 'Lütfen bana nasıl hissettiğini söyle!' }); } // 1. Kullanıcının metninden ruh halini analiz et const moodAnalysis = moodAnalyzer.analyzeMood(text); // 2. Ruh haline göre çalma listesi oluştur const playlist = await playlistGen.generatePlaylist( moodAnalysis.mood, moodAnalysis.intensity, playlistSize ); // 3. Kullanıcının ruh hali geçmişine kaydet const entry = { text, detectedMood: moodAnalysis.mood, güven: moodAnalysis.confidence, isShared: shareWithFriends, sharedWith: shareWithFriends ? req.user.friends : [], playlistGenerated: playlist.map(t => ({ trackName: t.name, artist: t.artist, spotifyId: t.id })) }; req.user.moodHistory.push(entry); req.user.updateStats(); await req.user.save(); // 4. Paylaşım etkinleştirilmişse, her arkadaşın sharedPlaylists dizisine kaydet if (shareWithFriends && req.user.friends.length > 0) { const sharedPlaylistData = { sharedBy: req.user._id, sharedByUsername: req.user.username, mood: moodAnalysis.mood, playlist: playlist.slice(0, 5).map(t => ({ // İlk 5 parçayı paylaş name: t.name, sanatçı: t.artist, album_image: t.album_image, id: t.id })) }; // Tüm arkadaşlar arasında döngü kur ve bu çalma listesini onların paylaşılanÇalma Listelerine ekle for (let friendId of req.user.friends) { const friend = await User.findById(friendId); if (friend) { friend.sharedPlaylists.push(sharedPlaylistData); await friend.save(); } } } // 5. Yanıtı istemciye geri gönder res.json({ moodAnalysis, playlist, personalizedMessage: `Geçmişinize dayanarak, işte mükemmel ${moodAnalysis.mood} çalma listeniz!` }); } catch (err) { console.error('Kişiselleştirilmiş çalma listesi hatası:', err); console.error('Hata yığını:', err.stack); res.status(500).json({ hata: 'Kişiselleştirilmiş çalma listesi oluşturulamadı. Lütfen tekrar deneyin.' }); } }); // Geri Dönüş: API dışı rotalar için (SPA yönlendirmesi için) index.html'yi sunun app.use((req, res, next) => { if (req.method === 'GET' && !req.path.startsWith('/api/')) { res.sendFile(path.join(__dirname, 'public', 'index.html')); } else { next(); } }); // Genel hata işleyicisi app.use((err, req, res, next) => { console.error('Genel hata:', err); res.status(500).json({ error: 'Dahili sunucu hatası', details: err.message }); }); // Sunucuyu başlatın server.listen(PORT, () => { console.log(`🚀 http://localhost:${PORT} üzerinde çalışan sunucu`); });

Ana Sunucu Kavramlarının Açıklaması:

Ara Yazılım – İstekleri rota işleyicilerinize ulaşmadan önce işleyen işlevler. express.json() istek gövdelerinden JSON'u ayrıştırır, auth JWT belirteçlerini doğrular.
async/await – Eşzamansız işlemleri (veritabanı sorguları gibi) işlemek için modern JavaScript sözdizimi. await, söz verilene kadar yürütmeyi duraklatır.
HTTP Durum Kodları – Sonucu gösteren sayılar: 200 = başarılı, 201 = oluşturuldu, 400 = hatalı istek, 401 = yetkisiz, 404 = bulunamadı, 500 = sunucu hatası.
Socket.io Olayları – İstemci ve sunucu arasında gidip gelen adlandırılmış mesajlar. socket.on() olayları dinler, socket.emit() olayları gönderir.
JWT (JSON Web Simgesi) – Kullanıcıları tanımlamanın güvenli bir yolu. Oturum açtıklarında onlara bir simge veririz. Kim olduklarını kanıtlamak için her istekle birlikte bu belirteci gönderirler.

Adım 5: Ön Uç JavaScript'i Güncelleyin (public/js/app.js)

Son olarak, ön uçumuzu etkileşimli hale getiren JavaScript'i ekleyelim. Bu kod, kullanıcının tarayıcısında çalışır ve düğme tıklamaları, API istekleri ve gerçek zamanlı güncellemeler gibi işlemleri gerçekleştirir.

Bu JavaScript şunları yapar:

Kimlik doğrulamasını yönetir – Giriş, kayıt, çıkış ve belirteç depolama
Socket.io'yu başlatır – Sunucuya bağlanır ve gerçek zamanlı olayları dinler
API istekleri yapar – Sunucu uç noktalarıyla iletişim kurmak için fetch() kullanır
Kullanıcı arayüzünü günceller – Sunucudan gelen verilere dayalı olarak HTML öğelerini dinamik olarak oluşturur
Kullanıcı etkileşimlerini yönetir – Düğme tıklamaları, form gönderimleri vb.

public/js/app.js dosyanızı eğitimde gösterilen tam kodla değiştirin...

(app.js kod bloğu, giriş yapma, kayıt olma, loadSharedPlaylists vb. tüm işlevlerle öncekiyle aynıdır.)

Adım 6: Sosyal Müzik API'nizi Test Edin

Şimdi her şeyi test etme zamanı! Aşağıdaki adımları dikkatlice izleyin:

Sunucunuzu başlatın: Terminalinizde npm start komutunu çalıştırın. "MongoDB connected!" ve "Server running on http://localhost:3000" gibi mesajlar görmelisiniz.
İki tarayıcı penceresi açın: http://localhost:3000 adresini iki ayrı tarayıcı penceresinde (veya bir normal pencere ve bir gizli pencere) açın. Bu, iki farklı kullanıcıyı simüle eder.
Kullanıcı 1'i Kaydet: İlk pencerede "Kaydol"a tıklayın ve bir kullanıcı oluşturun (örneğin, kullanıcı adı: "alice").
Kullanıcı 2'yi Kaydet: İkinci pencerede başka bir kullanıcı oluşturun (örneğin, kullanıcı adı: "bob").
Birbirinizi arkadaş olarak ekleyin: Alice'in penceresinde, "Arkadaş Ekle" alanına "bob" yazın ve Arkadaş Ekle'ye tıklayın. Aynısını Bob'un penceresinde de yapın ("alice" yazın). Arkadaş listelerinizde birbirinizi görmelisiniz!
Bir çalma listesi paylaşın: Alice'in penceresinde, ruh hali metin kutusuna "Bugün kendimi çok mutlu hissediyorum!" gibi bir şey yazın. "Arkadaşlarla paylaş" onay kutusunu işaretleyin ve ardından "Çalma Listesi Oluştur"a tıklayın.
Sihrin gerçekleşmesini izleyin:
- Bob çevrimiçiyse (pencere hala açıksa), sağdan bir bildirim kayar!
- Bob ayrıca Alice'in paylaşılan çalma listesinin "Son Aktiviteler" bölümünde göründüğünü görmelidir.
- Bob, şarkıların tam listesini görüntülemek için paylaşılan çalma listesine tıklayabilir.
- Bob oturumu kapatıp daha sonra tekrar oturum açarsa, paylaşılan çalma listesi hala orada olacaktır!

Her Şeyin Birlikte Nasıl Çalıştığını Anlamak

Alice, Bob ile bir çalma listesi paylaştığında ne olduğunu izleyelim:

Alice, "Arkadaşlarla paylaş"ı işaretler ve "Çalma Listesi Oluştur"a tıklar
Ön uç, shareWithFriends: true ile /api/personalized-playlist adresine bir POST isteği gönderir
Sunucu, Alice'in ruh halini analiz eder ve Spotify API'sini kullanarak bir çalma listesi oluşturur
Sunucu, çalma listesini Alice'in moodHistory dizisine kaydeder
Sunucu, Alice'in arkadaşları (Bob dahil) arasında dolaşır ve çalma listesini MongoDB'deki her arkadaşın sharedPlaylists dizisine ekler
Ön uç share_playlist Socket.io olayını çevrimiçi arkadaşlarına bildirmek için yayar
Sunucu olayı alır ve Bob'un çevrimiçi olup olmadığını kontrol eder (connectedUsers Haritasına bakar)
Bob çevrimiçiyse, sunucu ona çalma listesi önizlemesiyle bir friend_shared_playlist olayı gönderir
Bob'un tarayıcısı olayı alır ve bir açılır pencere görüntülemek için showNotification()'ı çağırır
Bob'un tarayıcısı ayrıca etkinlik akışını yenilemek için loadSharedPlaylists()'ı çağırır
Bob çevrimdışıysa, bir sonraki oturum açışında çalma listesini etkinlik akışında görür (çünkü sharedPlaylists dizisinde kaydedilmiştir)

Ne Yaptınız Oluşturuldu

Tebrikler! Tam özellikli bir sosyal müzik uygulamasını başarıyla oluşturdunuz! İşte başardıklarınız:

🤝 Arkadaş Sistemi – Kullanıcılar kullanıcı adlarına göre arkadaş ekleyebilir. Arkadaşlıklar karşılıklıdır (her iki kullanıcı da birbirinin arkadaşı olur) ve MongoDB'de ObjectId referansları olarak saklanır.
💾 Kalıcı Çalma Listesi Paylaşımı – Paylaşılan çalma listeleri, her arkadaşın sharedPlaylists dizisinde veritabanına kaydedilir. Bu, veriler kullanıcılar oturumu kapattıktan sonra bile saklanır.
📡 Gerçek Zamanlı Bildirimler – Socket.io kullanarak, çevrimiçi kullanıcılar arkadaşları çalma listelerini paylaştığında anında bildirim alır. Sayfa yenilemeye gerek yok!
📰 Etkinlik Akışı – Kullanıcılar, tüm arkadaşlarının en son paylaştığı çalma listelerini en yenisinden başlayarak sıralanmış olarak görebilir. Bir çalma listesine tıklandığında tam parça listesi gösterilir.
🔐 Güvenli Kimlik Doğrulama – Parolalar bcrypt ile karıştırılır (asla düz metin olarak saklanmaz) ve API isteklerini doğrulamak için JWT belirteçleri kullanılır.
⏱️ Çevrimdışı Uyumlu – Arkadaşlar, çalma listesi paylaşıldığında çevrimiçi olmasalar bile paylaşılan çalma listelerini görüntüleyebilirler. Her şey veritabanına kaydedilir!

Öğrendiğiniz Temel Kavramlar

Socket.io (WebSockets) ile gerçek zamanlı iletişim
MongoDB ObjectId referanslarını kullanarak veritabanı ilişkileri
Performans için Denormalizasyon (hem ObjectId'yi hem de kullanıcı adını depolama)
RESTful API tasarımı (uygun HTTP durum kodlarıyla GET, POST uç noktaları)
Kimlik doğrulama ve istek işleme için ara yazılım deseni
Asenkron işlemleri ele almak için Async/await
Kullanıcı arayüzünü dinamik olarak güncellemek için DOM manipülasyonu
Socket.io olaylarıyla Olay odaklı mimari

Ortak Sorun Giderme Sorunlar

"MongoDB'ye bağlanılamıyor" – MongoDB sunucunuzun çalıştığından ve .env dosyasındaki MONGODB_URI'nizin doğru olduğundan emin olun.
Giriş yaparken "Geçersiz kimlik bilgileri" – Kullanıcı adınızı ve parolanızı tekrar kontrol edin. Unutmayın, büyük/küçük harfe duyarlıdırlar!
Arkadaş eklerken "Kullanıcı bulunamadı" – Kullanıcı adınızı tam olarak yazdığınızdan emin olun (büyük/küçük harfe duyarlı). Önce kaydolmuş olmaları gerekir.
Paylaşılan çalma listeleri görünmüyor – Tarayıcınızın konsolunu (F12) hatalara karşı kontrol edin. Her iki kullanıcının da arkadaş olduğundan ve "Arkadaşlarla paylaş" onay kutusunun işaretli olduğundan emin olun.
Gerçek zamanlı bildirimler çalışmıyor – Socket.io'nun bağlı olduğundan emin olun. Tarayıcı konsolunda "🔗 Sunucuya bağlandı" ifadesini kontrol edin.

Sonraki Adımlar ve Genişletme Fikirleri

Artık çalışan bir sosyal müzik uygulamanız olduğuna göre, bunu daha da ileriye taşımak için bazı fikirler:

Arkadaşlık istekleri – Anında arkadaşlık yerine, kullanıcıların kabul edilebilir veya reddedilebilir istekler göndermesini zorunlu kılın
Özel mesajlaşma – Arkadaşların birbirlerine mesaj gönderebilmesi için Socket.io kullanarak bir sohbet sistemi ekleyin
Çalma listesi yorumları – Kullanıcıların paylaşılan çalma listelerine yorum yapmasına izin verin
Parçaları beğen/beğenme – Bir çalma listesindeki her parçaya beğenme/beğenmeme düğmeleri ekleyin
Müzik zevki uyumluluğu – İki kullanıcının müzik tercihlerinin ne kadar benzer olduğuna göre bir yüzde hesaplayın
Kullanıcıları ara – Kullanıcıları kullanıcı adına göre bulmak için bir arama özelliği ekleyin
Sil/arkadaşlıktan çıkar – Arkadaşları kaldırma veya paylaşılan çalma listelerini silme özelliği ekleyin
Profil sayfaları – Kullanıcı istatistiklerini, favori ruh hallerini ve son çalma listelerini görüntüleyin
Ortak çalma listeleri – Birden fazla arkadaşınızın paylaşılan bir çalma listesine parça eklemesine izin verin
Çalma listesi geçmişi – Daha önce oluşturduğunuz tüm çalma listelerini görüntüleyin

Gerçek zamanlı özellikler ve kalıcı veri depolama ile eksiksiz bir sosyal müzik uygulaması oluşturdunuz! Bu, modern web geliştirmeyi anlamak için sağlam bir temeldir. Denemeye ve geliştirmeye devam edin!🎵✨