Добавьте друзей в API чтения мыслей: обмен информацией в реальном времени

Готовы сделать свой API чтения мыслей по-настоящему социальным? В этом руководстве вы добавите надежную систему друзей и общий доступ к плейлистам, сохраняющийся в базе данных, чтобы пользователи могли просматривать общие плейлисты своих друзей, даже когда они не в сети. Мы будем использовать Socket.io для обновлений в реальном времени и MongoDB для постоянного хранения.

Что вы создадите

Система друзей — Добавляйте и управляйте друзьями по имени пользователя с помощью ObjectIds
Постоянный обмен плейлистами — Общие плейлисты сохраняются в базе данных и могут быть просмотрены в любое время
Уведомления в реальном времени — Получайте мгновенные уведомления, когда друзья делятся чем-либо (если они в сети)
Лента активности — Просматривайте недавние публикации друзей с помощью кликабельных предпросмотров плейлистов
Расширенный анализ настроения — Интеллектуальная генерация плейлистов с откатами поиска

Предварительные условия

Ваш готовый API чтения мыслей от Часть 2
Установлены MongoDB, Node.js и npm
Учётные данные API Spotify (идентификатор клиента и секретный код)
30–45 минут на написание кода

Во второй части вы создали учётные записи пользователей с историей настроения и интеллектуальными настройками. Теперь мы сделаем это социальным! Вы узнаете, как подключать пользователей, делиться плейлистами как в режиме реального времени, так и постоянно, и видеть, что слушают ваши друзья, в зависимости от их настроения.

Понимание ключевых концепций

Прежде чем мы погрузимся в код, давайте разберемся, что мы создаем:

Socket.io — библиотека, которая обеспечивает двустороннюю связь между вашим сервером и браузером в реальном времени. Представьте это как телефонный звонок, а не как текстовое сообщение — вы можете мгновенно отправлять и получать информацию, не обновляя страницу.
Постоянное хранилище — сохранение данных в базе данных MongoDB, чтобы они оставались там, даже когда пользователи выходят из системы. Это похоже на сохранение файла на жестком диске, а не простое хранение его в памяти.
Ссылки ObjectId — способ MongoDB создавать связи между данными. Вместо того, чтобы копировать всю информацию о друзьях в свой профиль, вы просто сохраняете ссылку (например, указатель) на их профиль.
Схемы — представьте их как чертежи, определяющие структуру ваших данных. Они сообщают MongoDB, какие поля должен содержать каждый документ и какой тип данных должен быть в каждом поле.

Шаг 1: Установка необходимых зависимостей

Откройте терминал в каталоге проекта и установите Socket.io для работы функций в режиме реального времени:

npm install socket.io

Что делает эта команда: Эта команда загружает и устанавливает библиотеку Socket.io в ваш проект. Команда npm install извлекает пакеты из реестра npm (огромной библиотеки кода JavaScript) и добавляет их в папку node_modules.

Остальные зависимости (sentiment, spotify-web-api-node, bcryptjs, jsonwebtoken, mongoose, express, dotenv) уже должны быть установлены из части 2.

Шаг 2: обновление модели пользователя с помощью социальных функций

Поскольку вы уже создали модель пользователя в части 2, мы обновим ее, чтобы добавить социальные функции. Модель пользователя похожа на шаблон, который определяет, какую информацию о каждом пользователе мы храним в нашей базе данных.

Что мы добавляем:

массив friends — список ссылок ObjectId на других пользователей. Вместо хранения полной информации о пользователе мы просто храним идентификаторы, указывающие на другие документы пользователя в базе данных.

 sharedWith и isShared поля — они отслеживают, какие записи настроения были опубликованы и с кем.
 sharedPlaylistSchema новая схема (чертеж), которая определяет, как выглядит общий плейлист: кто им поделился, какое у него настроение, треки и когда он был опубликован.
 sharedPlaylists массив — список, в котором хранятся все плейлисты, которыми с вами поделились ваши друзья.

 Замените ваш models/User.js на:
 const mongoose = require('mongoose'); const bcrypt = require('bcryptjs'); // Схема для отдельных записей настроения (каждый раз, когда пользователь создает плейлист) const moodEntrySchema = new mongoose.Schema({ text: String, // Что ввел пользователь (например, «чувствую себя счастливым сегодня») testedMood: String, // Настроение, которое обнаружил наш анализатор (например, «счастливый») belief: Number, // Насколько мы уверены в себе (0-10) playlistGenerated: [{ // Массив рекомендуемых нами треков trackName: String, artist: String, spotifyId: String, loved: { type: Boolean, default: null } // null = нет рейтинга, true = понравилось, false = не понравилось }], sharedWith: {[ type: mongoose.Schema.Types.ObjectId, ref: 'User' }], // С кем мы этим поделились? isShared: { type: Boolean, default: false }, // Кто-то этим поделился? timestamp: { type: Date, default: Date.now } // Когда это было создано? }); // Схема для пользовательских настроек (любимые жанры и т. д.) const userPreferencesSchema = new mongoose.Schema({ favoriteGenres: [String], preferedEnergyLevel: { type: Number, min: 0, max: 1 }, dislikedArtists: [String], moodMusicMapping: { happy: [String], sad: [String], energy: [String], chill: [String], angry: [String], romantic: [String], nostalgic: [String] } }); // НОВОЕ: Схема для плейлистов, которыми с вами делятся друзья const sharedPlaylistSchema = new mongoose.Schema({ sharedBy: { type: mongoose.Schema.Types.ObjectId, ref: 'User' }, // Ссылка на ObjectId друга, который поделился sharedByUsername: String, // Имя пользователя для удобства отображения (денормализовано для повышения производительности) mood: String, // Для какого настроения предназначен этот плейлист? playlist: [{ // Фактическое название трека: String, исполнитель: String, изображение_альбома: String, id: String }], timestamp: { type: Date, default: Date.now } // Когда этим поделились? }); // Основная схема пользователя — определяет структуру документа пользователя 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' }], // Массив ссылок ObjectId на друзей moodHistory: [moodEntrySchema], // Все плейлисты, сгенерированные этим пользователем sharedPlaylists: [sharedPlaylistSchema], // Плейлисты, которыми друзья поделились с этим пользователем preferences: { type: userPreferencesSchema, default: () => ({}) }, stats: { totalPlaylists: { type: Number, default: 0 }, favoriteTime: String, mostCommonMood: String, joinDate: { type: Date, default: Date.now } } }, { timestamps: true }); // Автоматически добавлять поля createdAt и updatedAt // Промежуточное ПО: запустить эту функцию перед сохранением пользователя (для хэширования его пароля) userSchema.pre('save', async function(next) { if (!this.isModified('password')) return next(); // Хэшировать только если пароль был изменен this.password = await bcrypt.hash(this.password, 12); // Хэшировать с 12 раундами соли next(); }); // Метод: проверить, совпадает ли пароль с хэшированным паролем userSchema.methods.comparePassword = function(p) { return bcrypt.compare(p, this.password); }; // Метод: обновить статистику пользователя на основе истории его настроения userSchema.methods.updateStats = function() { const moods = this.moodHistory.map(e => e.detectedMood).filter(Boolean); // Получить все непустые настроения this.stats.totalPlaylists = moods.length; if (moods.length > 0) { // Подсчитать, сколько раз встречается каждое настроение const counts = moods.reduce((a, m) => { a[m] = (a[m] || 0) + 1; return a; }, {}); // Найти настроение с наибольшим количеством this.stats.mostCommonMood = Object.keys(counts).reduce((a, b) => counts[a] > counts[b] ? a : b, 'neutral'); } else { this.stats.mostCommonMood = 'neutral'; } // Рассчитать любимое время суток на основе времени создания плейлистов 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 ? 'night' : avg < 12 ? 'morning' : avg < 18 ? 'afternoon' : 'evening'; } }; // Экспортируйте модель, чтобы использовать её в других файлах module.exports = mongoose.model('User', userSchema);
 Пояснение основных понятий:
  Ссылки ObjectId — массив friends не хранит целые объекты пользователей. Вместо этого он хранит ObjectId (уникальные идентификаторы), которые указывают на других пользователей. Это эффективно, поскольку если друг меняет своё имя пользователя, нам не нужно обновлять его везде — мы просто следуем ссылке.
 Денормализация — обратите внимание, что мы храним и sharedBy (ObjectId), и sharedByUsername (String). Это называется денормализацией — хранение одних и тех же данных в нескольких местах для повышения производительности. Мы сохраняем имя пользователя, чтобы не искать его каждый раз при отображении общих плейлистов.
 Промежуточное ПО (.pre()) — запускается автоматически перед определёнными операциями. В данном случае оно хеширует пароли перед сохранением в базе данных для безопасности.
 Методы экземпляра (.methods) — это функции, которые можно вызывать для отдельных пользовательских документов, например, user.comparePassword() или user.updateStats().
 
 Шаг 3: Добавьте социальные функции в HTML-интерфейс
 Теперь давайте обновим пользовательский интерфейс, добавив управление друзьями и ленту активности. HTML определяет структуру вашей веб-страницы — какие элементы отображаются и где они располагаются.
 Что мы добавляем в пользовательский интерфейс:
  Раздел списка друзей — показывает ваших текущих друзей
 Поле для добавления друзей — Текстовое поле для ввода имени пользователя друга
 Лента последних действий — отображает плейлисты, которыми поделились ваши друзья (кликните, чтобы просмотреть полный плейлист)
 Флажок «Поделиться» — возможность поделиться сгенерированным плейлистом с друзьями
 Область уведомлений — Всплывающие уведомления об обновлениях в режиме реального времени
 
 Замените свой public/index.html на:
 <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"/> <meta name="viewport" content="width=device-width, initial-scale=1.0"/> <title>Mind-Reading Music API - Social</title> <style> /* Сброс стилей браузера по умолчанию */ * { margin: 0; padding: 0; box-sizing: border-box; } /* Оформление основного текста с градиентным фоном */ body { font-family: 'Segoe UI', sans-serif; background: linear-gradient(135deg, #667eea, #764ba2); min-height: 100vh; color: #333; } /* Контейнер для всей панели мониторинга */ .dashboard { max-width: 1000px; margin: 0 auto; padding: 20px; } /* Раздел заголовка с приветственным сообщением */ .header { background: rgba(255,255,255,0.95); backdrop-filter: blur(10px); /* Эффект размытия для стекломорфизма */ border-radius: 20px; padding: 30px; margin-bottom: 30px; text-align: center; box-shadow: 0 8px 32px rgba(0,0,0,0.1); } /* Макет сетки из двух колонок: раздел плейлиста (больше) и раздел друзей (меньше) */ .main-content { display: grid; grid-template-columns: 2fr 1fr; gap: 30px; } /* Оформление карточек для обоих разделов */ .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); } /* Оформление элементов формы */ input, textarea, button { width: 100%; padding: 12px; margin: 10px 0; border: 2px solid #e1e5e9; border-radius: 8px; font-size: 16px; } /* Оформление кнопок с градиентным фоном */ button { background: linear-gradient(135deg, #667eea, #764ba2); color: #fff; border: none; cursor: pointer; font-weight: 600; } /* Незаметный эффект наведения на кнопки */ button:hover { transform: translateY(-2px); } /* Индивидуальный стиль элемента друга */ .friend-item { background: #f8f9fa; padding: 10px; margin: 5px 0; border-radius: 8px; border-left: 4px solid #667eea; /* Цвет акцента слева */ } /* Стиль всплывающего уведомления (скрыто по умолчанию, выезжает справа) */ .notification { position: fixed; top: 20px; right: 20px; background: rgba(102,126,234,0.95); color: #fff; padding: 15px 20px; border-radius: 8px; box-shadow: 0 4px 15px rgba(0,0,0,0.1); transform: translateX(400px); /* Запуск за пределами экрана */ transition: transform .3s ease; z-index: 1000; max-width: 300px; } /* Показать уведомление (вставить) */ .notification.show { transform: translateX(0); } /* Формы входа и регистрации */ .login-section, .register-section { background: rgba(255,255,255,0.95); border-radius: 20px; padding: 30px; max-width: 400px; margin: 50px auto; } /* Элементы управления флажками для совместного использования */ .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"> <!-- Раздел аутентификации (формы входа/регистрации) --> <div id="authSection"> <!-- Форма входа --> <div class="login-section"> <h2>🧠🎵 С возвращением!</h2> <input type="text" id="loginUsername" placeholder="Имя пользователя"/> <input type="password" id="loginPassword" placeholder="Пароль"/> <button onclick="login()">Войти</button> <p><a href="#" onclick="showRegister()">Нет аккаунта? Зарегистрируйтесь</a></p> </div> <!-- Регистрационная форма (по умолчанию скрыта) --> <div id="registerSection" class="register-section" style="display:none"> <h2>🎵 Создайте свой музыкальный профиль</h2> <input type="text" id="regUsername" placeholder="Имя пользователя"/> <input type="email" id="regEmail" placeholder="Email"/> <input type="password" id="regPassword" placeholder="Пароль"/> <button onclick="register()">Создать учетную запись</button> <p><a href="#" onclick="showLogin()">Уже есть учетная запись? Войти</a></p> </div> </div> <!-- Главный раздел панели инструментов (отображается после входа в систему) --> <div id="dashboardSection" style="display:none"> <!-- Заголовок с именем пользователя и кнопкой выхода --> <div class="header"> <h1>🧠🎵 Ваш персональный музыкальный телепат</h1> <p>Добро пожаловать, <span id="username"></span>!</p> <button onclick="logout()" style="width:auto; margin-top:10px">Выйти</button> </div> <!-- Двухколоночный макет: раздел «Плейлист» слева, раздел «Друзья» справа --> <div class="main-content"> <!-- Левый столбец: Формирование плейлиста --> <div class="playlist-section"> <h2>💭 Как вы себя чувствуете?</h2> <textarea id="moodText" placeholder="Опишите свое настроение..."></textarea> <div class="share-controls"> <label><input type="checkbox" id="shareWithFriends"/>Поделиться с друзьями</label> </div> <button onclick="generatePlaylist()">🎧 Сгенерировать плейлист</button> <!-- Результаты появятся здесь после создания плейлиста --> <div id="result" style="display:none"></div> </div> <!-- Правый столбец: Друзья и активность --> <div class="friends-section"> <h3>👥 Мои друзья</h3> <div id="friendsList"></div> <h4>Добавить друга</h4> <input type="text" id="friendUsername" placeholder="Имя пользователя друга"/> <button onclick="addFriend()">Добавить друга</button> <h4>Недавняя активность</h4> <!-- Здесь отображаются общие плейлисты друзей --> <div id="friendActivity">Здесь будет отображаться активность друзей...</div> </div> </div> </div> </div> <!-- Контейнер для всплывающих уведомлений --> <div id="notificationArea"></div> <!-- Включить библиотеку Socket.io (автоматически обслуживается нашим сервером) --> <script src="/socket.io/socket.io.js"></script> <!-- Включить наш пользовательский JavaScript --> <script src="./js/app.js"></script> </body> </html>
 Понимание структуры HTML:
  Два основных раздела: authSection (вход/регистрация) и dashboardSection (основное приложение). Одновременно виден только один элемент.
 Сетка: элемент .main-content использует CSS Grid для создания двух столбцов (2fr для плейлиста, 1fr для друзей). Это означает, что раздел плейлиста вдвое шире.
 Обработчики событий: onclick="functionName()" сообщает браузеру о необходимости вызова функции JavaScript при щелчке по элементу.
 Идентификаторы: элементы имеют уникальные идентификаторы (например, id="friendsList"), чтобы наш JavaScript мог найти и изменить их позже.
 
 Шаг 4: обновите server.js с помощью Socket.io, конечных точек друзей и постоянного обмена
 Теперь мы обновим наш сервер для обработки запросов на добавление в друзья, обмена плейлистами и общения в режиме реального времени. Сервер — это «мозг» вашего приложения: он обрабатывает запросы, взаимодействует с базой данных и отправляет ответы пользователям.
 Что мы добавляем на сервер:
  Сервер Socket.io — обеспечивает двустороннюю связь между сервером и клиентами в режиме реального времени.
 /api/add-friend конечная точка — обрабатывает запросы на добавление в друзья (взаимная дружба).
 /api/shared-playlists конечная точка — возвращает плейлисты, которыми с вами поделились друзья.
 Улучшенный /api/personalized-playlist — теперь сохраняет общие плейлисты в базах данных друзей.
 Обработчики событий Socket — отслеживают и генерируют события в режиме реального времени (аутентификация, общий доступ).
 
 Замените ваш server.js на:
 // Загрузка переменных окружения из файла .env require('dotenv').config(); // Импорт требуемых модулей 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'); // Инициализация генератора плейлистов const playlistGen = new PlaylistGenerator(); const PORT = process.env.PORT || 3000; // Подключение к базе данных MongoDB async function connectDB() { try { console.log('🔗 Подключение к MongoDB…'); await mongoose.connect(process.env.MONGODB_URI, { useNewUrlParser: true, useUnifiedTopology: true }); console.log('✅ MongoDB успешно подключено!'); } catch (err) { console.error('❌ Ошибка подключения к MongoDB:', err.message); process.exit(1); // Выйти, если подключение к базе данных не удалось } } connectDB(); // Создать приложение Express и HTTP-сервер const app = express(); const server = http.createServer(app); // Инициализировать Socket.io поверх HTTP-сервера const io = socketIo(server); // Карта для отслеживания пользователей в сети: userId => socketId // Это позволяет нам отправлять сообщения определенным пользователям, которые в данный момент подключены const connectedUsers = new Map(); // Обработчик подключений Socket.io — запускается при подключении клиента io.on('connection', socket => { console.log('🔗 Socket connected:', socket.id); // Обработка события 'authenticate' — клиент сообщает нам, кто он socket.on('authenticate', ({ userId, username }) => { // Сохраняем идентификатор сокета этого пользователя, чтобы позже можно было отправлять ему сообщения connectedUsers.set(userId, socket.id); socket.userId = userId; // Прикрепляем идентификатор пользователя к этому сокету socket.username = username; // Прикрепляем имя пользователя к этому сокету console.log(`✅ Пользователь прошел аутентификацию: ${username}`); }); // Обработка события 'share_playlist' — пользователь хочет поделиться с друзьями socket.on('share_playlist', async ({ friendName, mood, playlist, friendIds }) => { try { // Цикл по всем идентификаторам друзей for (let friendId of friendIds) { // Получаем идентификатор сокета для этого друга (если он в сети) const sid = connectedUsers.get(friendId.toString()); if (sid) { // Друг в сети! Отправьте ему уведомление в реальном времени io.to(sid).emit('friend_shared_playlist', { friendName, mood, playlist }); } // Если друг не в сети, он увидит плейлист в своей ленте активности при входе в систему } } catch (err) { console.error('Ошибка общего плейлиста:', err); } }); // Обработка отключения — удаление пользователя с онлайн-карты socket.on('disconnect', () => { if (socket.userId) { connectedUsers.delete(socket.userId); console.log(`👋 Отключено: ${socket.username}`); } }); }); // Промежуточное ПО для разбора тел запросов JSON app.use(express.json()); // Обслуживание статических файлов из папки 'public' (HTML, CSS, изображения) app.use(express.static(path.join(__dirname, 'public'))); // ===== КОНЕЧНЫЕ ТОЧКИ API ===== // POST /api/register - Создание новой учетной записи пользователя app.post('/api/register', async (req, res) => { try { const { username, email, password } = req.body; // Проверка входных данных if (!username || !email || !password) { return res.status(400).json({ error: 'Все поля обязательны для заполнения' }); } if (password.length < 6) { return res.status(400).json({ error: 'Пароль должен быть не менее 6 символов' }); } // Проверка наличия имени пользователя или адреса электронной почты const exist = await User.findOne({ $or: [{ username }, { email }] }); if (exists) { return res.status(400).json({ error: 'Имя пользователя или адрес электронной почты уже существует' }); } // Создать и сохранить нового пользователя (пароль будет автоматически хеширован нашим промежуточным программным обеспечением предварительного сохранения) const user = new User({ username, email, password }); await user.save(); res.status(201).json({ message: 'Пользователь успешно создан' }); } catch (err) { console.error('Ошибка регистрации:', err); res.status(500).json({ error: 'Регистрация не удалась' }); } }); // POST /api/login - аутентификация пользователя и возврат токена JWT app.post('/api/login', async (req, res) => { try { const { username, password } = req.body; // Поиск пользователя по имени или адресу электронной почты const user = await User.findOne({ $or: {[ username }, { email: username }] }); // Проверка существования пользователя и правильности пароля if (!user || !(await user.comparePassword(password))) { return res.status(401).json({ error: 'Invalid credentials' }); } // Создание токена JWT (например, временного удостоверения личности) const token = jwt.sign( { userId: user._id }, // Полезная нагрузка (то, что мы кодируем) process.env.JWT_SECRET, // Секретный ключ (обеспечивает безопасность) { expiresIn: '7d' } // Токен истекает через 7 дней ); // Отправляем токен обратно клиенту res.json({ token, user: { username: user.username, email: user.email, friends: user.friends } }); } catch (err) { console.error('Ошибка входа:', err); res.status(500).json({ error: 'Вход не удался' }); } }); // GET /api/profile - Получить профиль текущего пользователя // Промежуточное ПО 'auth' проверяет токен JWT и прикрепляет пользователя к req.user app.get('/api/profile', auth, async (req, res) => { try { // Обновить статистику пользователя req.user.updateStats(); await req.user.save(); // Заполнить массив друзей (заменить ObjectIds реальными объектами пользователя) 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('Ошибка профиля:', err); res.status(500).json({ ошибка: «Не удалось загрузить профиль» }); } }); // GET /api/shared-playlists - Получить плейлисты, которыми с вами поделились друзья app.get('/api/shared-playlists', auth, async (req, res) => { try { // Получить последние 10 общих плейлистов, отсортированных по дате последнего const sharedPlaylists = req.user.sharedPlaylists .sort((a, b) => b.timestamp - a.timestamp) // Сортировать по убыванию по временной метке .slice(0, 10); // Взять первые 10 res.json({ sharedPlaylists }); } catch (err) { console.error('Ошибка общих плейлистов:', err); res.status(500).json({ error: 'Не удалось загрузить общие плейлисты' }); } }); // POST /api/add-friend - Добавить друга (взаимная дружба) app.post('/api/add-friend', auth, async (req, res) => { try { const { friendUsername } = req.body; // Найти друга по имени пользователя const friend = await User.findOne({ username: friendUsername }); if (!friend) { return res.status(404).json({ error: 'Пользователь не найден' }); } // Проверить, есть ли уже друзья if (req.user.friends.some(friendId => friendId.toString() === friend._id.toString())) { return res.status(400).json({ error: 'Этот пользователь уже в друзьях' }); } // Добавить каждого пользователя в список друзей другого (взаимная дружба) req.user.friends.push(friend._id); friend.friends.push(req.user._id); // Сохраняем обоих пользователей await req.user.save(); await friend.save(); res.json({ message: 'Друг успешно добавлен', friendId: friend._id }); } catch (err) { console.error('Ошибка добавления друга:', err); console.error('Стек ошибок:', err.stack); res.status(500).json({ error: 'Не удалось добавить друга' }); } }); // POST /api/personalized-playlist - Создание плейлиста на основе настроения 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: 'Пожалуйста, скажите, как вы себя чувствуете!' }); } // 1. Анализ настроения по тексту пользователя const moodAnalysis = moodAnalyzer.analyzeMood(text); // 2. Создание плейлиста на основе настроения const playlist = await playlistGen.generatePlaylist( moodAnalysis.mood, moodAnalysis.intensity, playlistSize ); // 3. Сохранить в истории настроения пользователя const entry = { text, detectMood: moodAnalysis.mood, trust: 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. Если общий доступ включен, сохранить в массив sharedPlaylists каждого друга 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 => ({ // Поделиться первыми 5 треками name: t.name, artist: t.artist, album_image: t.album_image, id: t.id })) }; // Пройтись по всем друзьям и добавить этот плейлист в их sharedPlaylists for (let friendId of req.user.friends) { const friend = await User.findById(friendId); if (friend) { friend.sharedPlaylists.push(sharedPlaylistData); await friend.save(); } } } // 5. Отправить ответ обратно клиенту res.json({ moodAnalysis, playlist, personalizedMessage: `Основываясь на вашей истории, вот ваш идеальный плейлист ${moodAnalysis.mood}!` }); } catch (err) { console.error('Ошибка персонализированного плейлиста:', err); console.error('Стек ошибок:', err.stack); res.status(500).json({ error: 'Не удалось создать персонализированный плейлист. Повторите попытку.' }); } }); // Резервный вариант: обслуживать index.html для любых маршрутов, не относящихся к API (для маршрутизации SPA) app.use((req, res, next) => { if (req.method === 'GET' && !req.path.startsWith('/api/')) { res.sendFile(path.join(__dirname, 'public', 'index.html')); } else { next(); } }); // Глобальный обработчик ошибок app.use((err, req, res, next) => { console.error('Глобальная ошибка:', err); res.status(500).json({ error: 'Внутренняя ошибка сервера', details: err.message }); }); // Запустить сервер server.listen(PORT, () => { console.log(`🚀 Server running on http://localhost:${PORT}`); });
 Объяснение ключевых концепций сервера:
  Промежуточное ПО — функции, которые обрабатывают запросы до того, как они достигнут ваших обработчиков маршрутов. express.json() анализирует JSON из тел запросов, auth проверяет токены JWT.
 async/await — современный синтаксис JavaScript для обработки асинхронных операций (например, запросов к базе данных). await приостанавливает выполнение до завершения обещания.
 Коды состояния HTTP — числа, указывающие результат: 200 = успешно, 201 = создано, 400 = неверный запрос, 401 = неавторизовано, 404 = не найдено, 500 = ошибка сервера.
 События Socket.io — именованные сообщения, которые передаются между клиентом и сервером. socket.on() прослушивает события, socket.emit() отправляет события.
 JWT (JSON Web Token) — безопасный способ идентификации пользователей. При входе в систему мы выдаём им токен. Они отправляют этот токен с каждым запросом, чтобы подтвердить свою личность.
 
 Шаг 5: обновление JavaScript-кода фронтенда (public/js/app.js)
 Наконец, давайте добавим JavaScript-код, который сделает наш фронтенд интерактивным. Этот код выполняется в браузере пользователя и обрабатывает такие действия, как нажатия кнопок, запросы API и обновления в реальном времени.
 Что делает этот JavaScript:
  Управляет аутентификацией — Вход, регистрация, выход из системы и хранение токенов
 Инициализирует Socket.io — Подключается к серверу и прослушивает события в реальном времени
 Выполняет запросы API — Использует fetch() для связи с конечными точками сервера
 Обновляет пользовательский интерфейс — Динамически создает элементы HTML на основе данных с сервера
 Обрабатывает взаимодействия с пользователем — Нажатия кнопок, отправку форм и т. д.
 
 Замените свой public/js/app.js полным кодом, показанным в руководстве...
 (The Блок кода app.js выглядит точно так же, как и раньше, со всеми функциями для входа, регистрации, загрузки SharedPlaylists и т. д.
 Шаг 6: протестируйте свой API социальной музыки
 Теперь пора всё протестировать! Следуйте этим шагам внимательно:
  Запустите сервер: В терминале выполните команду npm start. Вы должны увидеть сообщения вроде «MongoDB подключен!» и «Сервер работает на http://localhost:3000».
 Откройте два окна браузера: Откройте http://localhost:3000 в двух отдельных окнах браузера (или в одном обычном окне и в одном в режиме инкогнито). Это имитирует двух разных пользователей.
 Регистрация пользователя 1: В первом окне нажмите «Зарегистрироваться» и создайте пользователя (например, имя пользователя: «Алиса»).
 Регистрация пользователя 2: Во втором окне создайте ещё одного пользователя (например, имя пользователя: «Боб»).
 Добавьте друг друга в друзья: В окне Алисы введите «Боб» в поле «Добавить друга» и нажмите «Добавить друга». Сделайте то же самое в окне Боба (введите «Алиса»). Вы должны увидеть друг друга в списках друзей!
 Поделитесь плейлистом: В окне Алисы введите что-то вроде «Я чувствую себя суперсчастливой сегодня!» в текстовом поле настроения. Установите флажок «Поделиться с друзьями», затем нажмите «Создать плейлист».
 Наблюдайте за волшебством:  Если Боб в сети (окно всё ещё открыто), он увидит всплывающее уведомление справа!
 Боб также должен увидеть, что общий плейлист Алисы появился в его разделе «Недавние действия».
 Боб может нажать на общий плейлист, чтобы просмотреть полный список песен.
 Если Боб выйдет из системы и снова войдет в неё позже, общий плейлист всё ещё будет там!
 
 
 
 Понимание того, как всё это работает вместе
 Давайте проследим, что происходит, когда Алиса делится плейлистом с Бобом:
  Алиса отмечает «Поделиться с друзьями» и нажимает «Создать плейлист»
 Фронтенд отправляет запрос POST на /api/personalized-playlist с shareWithFriends: true
 Сервер анализирует настроение Алисы и генерирует плейлист с помощью API Spotify
 Сервер сохраняет плейлист в массиве moodHistory Алисы
 Сервер просматривает друзей Алисы (включая Боба) и добавляет плейлист в массив sharedPlaylists каждого друга в MongoDB
 Фронтенд создает событие share_playlist Socket.io для уведомления друзей, которые находятся в сети
 Сервер получает событие и проверяет, находится ли Боб в сети (смотрит в карте connectedUsers)
 Если Боб в сети, сервер отправляет ему событие friend_shared_playlist с предварительным просмотром плейлиста
 Браузер Боба получает событие и вызывает showNotification() для отображения всплывающего окна
 Браузер Боба также вызывает loadSharedPlaylists() для обновления ленты активности
 Если Боб не в сети, он увидит плейлист в своей ленте активности при следующем входе в систему (потому что он сохранен в его sharedPlaylists массив)
 
 Что вы создали
 Поздравляем! Вы успешно создали полнофункциональное социальное музыкальное приложение! Вот чего вы достигли:
  🤝 Система друзей — пользователи могут добавлять друзей по имени пользователя. Дружба взаимна (оба пользователя становятся друзьями друг друга) и хранится в виде ссылок ObjectId в MongoDB.
 💾 Постоянный обмен плейлистами — общие плейлисты сохраняются в базе данных в массиве sharedPlaylists каждого друга. Это означает, что данные сохраняются даже после выхода пользователя из системы.
 📡 Уведомления в реальном времени — с помощью Socket.io пользователи онлайн получают мгновенные уведомления, когда друзья делятся плейлистами. Обновлять страницу не нужно!
 📰 Лента активности — пользователи могут видеть последние плейлисты, которыми поделились все их друзья, отсортированные по дате публикации. При нажатии на плейлист открывается полный список треков.
 🔐 Безопасная аутентификация — пароли хешируются с помощью bcrypt (никогда не хранятся в виде обычного текста), а для аутентификации запросов API используются токены JWT.
 ⏱️ Работает офлайн — друзья могут просматривать общие плейлисты, даже если они не были в сети во время публикации. Все данные сохраняются в базе данных!
 
 Основные понятия, которые вы изучили
  Общение в реальном времени с помощью Socket.io (WebSockets)
 Связи с базой данных с использованием ссылок MongoDB ObjectId
 Денормализация для повышения производительности (сохранение как ObjectId, так и имени пользователя)
 Проектирование RESTful API (конечные точки GET, POST с соответствующими кодами состояния HTTP)
 Шаблон промежуточного ПО для аутентификации и обработки запросов
 Async/await для обработки асинхронных операций
 Манипуляция DOM для динамического обновления пользовательского интерфейса
 Архитектура, управляемая событиями с помощью событий Socket.io
 
 Устранение неполадок. Распространенные Проблемы
  «Не удаётся подключиться к MongoDB» — Убедитесь, что ваш сервер MongoDB запущен и MONGODB_URI в .env указан правильно.
 «Неверные учётные данные» при входе — Проверьте имя пользователя и пароль. Помните, они чувствительны к регистру!
 «Пользователь не найден» при добавлении друга — Убедитесь, что вы вводите точное имя пользователя (с учётом регистра). Пользователь должен быть предварительно зарегистрирован.
 Общие плейлисты не отображаются — Проверьте консоль браузера (F12) на наличие ошибок. Убедитесь, что оба пользователя добавлены в друзья и установлен флажок «Поделиться с друзьями».
 Уведомления в режиме реального времени не работают — Убедитесь, что Socket.io подключён. Проверьте консоль браузера на наличие сообщения «🔗 Подключено к серверу».
 
 Дальнейшие шаги и идеи для расширения
 Теперь, когда у вас есть работающее социальное музыкальное приложение, вот несколько идей для его дальнейшего развития:
  Запросы на добавление в друзья — вместо мгновенной дружбы потребуйте от пользователей отправлять запросы, которые можно принять или отклонить
 Личные сообщения — добавьте систему чата с помощью Socket.io, чтобы друзья могли отправлять сообщения друг другу
 Комментарии к плейлистам — позвольте пользователям комментировать общие плейлисты
 Понравились/не понравились треки — добавьте кнопки «Нравится»/«Не нравится» для каждого трека в плейлисте
 Совместимость музыкальных вкусов — вычислите процент на основе схожести музыкальных предпочтений двух пользователей
 Поиск пользователей — добавьте функцию поиска, чтобы находить пользователей по Имя пользователя
 Удалить/удалить из друзей — возможность удалять друзей или общие плейлисты
 Страницы профилей — отображение статистики пользователя, любимых настроений и последних плейлистов
 Совместные плейлисты — разрешение нескольким друзьям добавлять треки в общий плейлист
 История плейлистов — просмотр всех ранее созданных плейлистов
 
 Вы создали полнофункциональное социальное музыкальное приложение с функциями реального времени и постоянным хранилищем данных! Это прочная основа для понимания современной веб-разработки. Продолжайте экспериментировать и творить!🎵✨