Nosta ajatuksia lukevan musiikin API:n tasoa: Lisää käyttäjätilejä mielialahistorian ja älykkäiden asetusten avulla

Muunna tunteita tunnistava soittolistageneraattorisi henkilökohtaiseksi musiikkikumppaniksi, joka oppii jokaisesta vuorovaikutuksesta. Tämä jatko-opas lisää käyttäjän todennuksen, mielialan seuranta-analytiikan ja älykkään mieltymysten oppimisen luodaksesi todella yksilöllisiä musiikkikokemuksia.

Mitä rakennamme tänään

Muistatko ajatuksia lukevan musiikin API:n, joka pystyi tunnistamaan tunteita ja luomaan soittolistoja? Tänään teemme siitä henkilökohtaisen. Lisäämme:

Käyttäjän todennus, joka todella toimii (ei monimutkaisia OAuth-päänsärkyjä)
Mielialahistorian kojelauta kauniilla analytiikalla
Älykkäät soittolista-asetukset, jotka oppivat käyttäjien käyttäytymisestä
Henkilökohtaiset suositukset, jotka paranevat ajan myötä
Tietojen säilyvyys, jotta käyttäjät eivät koskaan kadota musiikillista matkaansa

Tämän tutoriaalin loppuun mennessä API:si muistaa, että Sarah rakastaa indie rockia surullisena, kun taas Mike suosii klassista musiikkia keskittymissessioissa.

Mitä tarvitset

Valmistuneen ajatuksia lukevan musiikin API:n edellisestä tutoriaalista
30 minuuttia keskittynyttä koodausaikaa
MongoDB Atlas -tili (vapaa taso toimii täydellisesti)
Tietokantojen perusymmärrys (pidämme sen yksinkertaisena!)

Käyttäjätodennuksen määrittäminen (helppo tapa)

Lisätään ensin käyttäjähallintaan tarvittavat paketit.

Mene koodieditorin pääteikkunaan, kirjoita tai liitä seuraava komento ja paina enteriä:

npm install mongoose bcryptjs jsonwebtoken express-session connect-mongo

Vaihe 1: Tietokantayhteyden määrittäminen

Kun asennus on valmis, luo uusi tiedosto nimeltä database.js ja lisää seuraava koodi:

const mongoose = require('mongoose'); const connectDB = async () => { try { console.log('🔗 Yhdistetään MongoDB:hen...'); await mongoose.connect(process.env.MONGODB_URI, { useNewUrlParser: true, useUnifiedTopology: true, }); console.log('✅ MongoDB-yhteys muodostettu onnistuneesti!'); } catch (error) { console.error('❌ MongoDB-yhteys epäonnistui:', error.message); process.exit(1); } }; module.exports = connectDB;

Ja tallenna painamalla cmd + s, ctrl + s tai tiedosto ja sitten tallenna.

Luo MongoDB Atlas -tilisi

Käy osoitteessa: mongodb.com/cloud/atlas
Napsauta: "Aloita" -painiketta (yleensä oikeassa yläkulmassa)

Rekisteröitymisvaihtoehdot

Voit luoda tilin kolmella tavalla:

Vaihtoehto A: Sähköpostitilin rekisteröinti

Napsauta "Rekisteröidy sähköpostilla"
Anna sähköpostiosoitteesi
Luo vahva salasana
Napsauta "Luo Atlas-tilisi"

Vaihtoehto B: Google-tilin rekisteröinti

Napsauta "Rekisteröidy Googlella"
Valitse Google-tilisi
Myönnä tarvittavat käyttöoikeudet

Vaihtoehto C: GitHub-tilin rekisteröinti

Napsauta "Rekisteröidy GitHubilla"
Valtuuta MongoDB Atlas käyttämään GitHub-tiliäsi

Vahvista sähköpostiosoitteesi

Tarkista sähköpostisi
Napsauta MongoDB:n vahvistuslinkkiä
Tämä vahvistaa, että tilisi on oikea

Luo ensimmäinen tietokantaklusterisi

Jos et näe kojelautaasi sisäänkirjautumisen jälkeen, sinun on ehkä napsautettava nimeäsi oikeassa yläkulmassa avataksesi seuraavan alasvetovalikon ja napsautettava Atlas-linkkiä:

Näet sitten Atlas-kojelaudan. Aika luoda tietokanta!

Valitse käyttöönottotyyppisi

Napsauta "Klusterit" vasemman sivupalkin "Tietokanta"-kohdasta

Napsauta "Luo klusteri"

Valitse "Ilmainen"

Sinut ohjataan klusterin käyttöönottosivulle ja haluat valita ilmaisen sopimuksen.

Pilvipalveluntarjoajan valinta: Näet kolme palveluntarjoajavaihtoehtoa:

AWS (Amazon Web Services) ⭐ Suositeltu
Google Cloud Platform
Microsoft Azure

Valitse: AWS (se on suosituin ja sillä on eniten alueita)

Alueen valinta: Kun olet valinnut AWS:n, näet alasvetovalikon, jossa on useita alueita. Valitse lähimpänä sijaintiasi paremman suorituskyvyn saavuttamiseksi:

🇺🇸 Yhdysvallat:

us-east-1 (Pohjois-Virginia) - Itärannikko
us-west-2 (Oregon) - Länsirannikko
us-central-1 (Iowa) - Keski-Eurooppa

🇪🇺 Eurooppa:

eu-west-1 (Irlanti) - Länsi-Eurooppa
eu-central-1 (Frankfurt) - Keski-Eurooppa
eu-west-2 (Lontoo) - Iso-Britannia

🌏 Aasian ja Tyynenmeren alue:

ap-southeast-1 (Singapore) - Kaakkois-Aasia
ap-south-1 (Mumbai) - Intia
ap-northeast-1 (Tokio) - Japani

💡 Vinkki: Jos olet epävarma, us-east-1 on yleensä turvallisin vaihtoehto, jolla on eniten ominaisuuksia.

Napsauta sitten "Luo käyttöönotto"-painiketta

Luo tietokannan käyttäjä

Vaihe 3.1: Lisää tietokannan käyttäjä

Näet "Suojauksen pika-aloitus" -näytön
Todennusmenetelmä: Pidä "Käyttäjätunnus ja salasana" valittuna
Käyttäjätunnus: Anna käyttäjätunnus (esim. mood-music-user)
Salasana:
- Vaihtoehto A: Napsauta "Luo suojattu salasana automaattisesti" (suositus)
- Vaihtoehto B: Luo oma vahva salasanasi (vähintään 8 merkkiä)
Kopioi salasana heti! Tarvitset tätä yhteysmerkkijonoasi varten

⚠️ Kopioi ja tallenna salasanasi heti!

Klikkaa: "Luo tietokanta Käyttäjä"
Napsauta: "Valitse yhteystapa"

Valitse yhteystapa

Näet useita yhteysvaihtoehtoja:

Ajurit 👈 Tätä haluamme Node.js-sovelluksille
Compass (MongoDB:n työpöytäkäyttöliittymä)
Shell (MongoDB:n komentorivikäyttöliittymä)
MongoDB VS Codelle (VS Code -laajennus)
Atlas SQL (SQL-käyttöliittymä MongoDB:lle)

Valitse: "Ajurit" - tämä antaa sinulle yhteysmerkkijonon sovelluksille, kuten Node.js

Määritä ajuriyhteys

Kun olet valinnut "Ajurit":

Ajuri: Valitse "Node.js" pudotusvalikosta
Versio: Valitse Node.js-versiosi tai jätä se oletusarvoiseksi (yleensä toimii hyvin)
Yhteysmerkkijono: Yhteysmerkkijono näkyy alla

Kopioi yhteysmerkkijonosi

Näet jotain tällaista tämä:

mongodb+srv://<käyttäjänimi>:<salasana>@cluster0.abc123.mongodb.net/?retryWrites=true&w=majority

Tärkeää: Tämä on mallipohja! Sinun täytyy:

Korvata <username> tietokannan käyttäjätunnuksellasi
Korvata <password> tietokannan salasanallasi
Lisätä tietokannan nimi .net/

Esimerkkimuunnos

Ennen (mallipohja):

mongodb+srv://<username>:<password>@cluster0.abc123.mongodb.net/?retryWrites=true&w=majority

Jälkeen (käyttövalmis):

mongodb+srv://mood-music-user:MySecurePassword123@cluster0.abc123.mongodb.net/mood-music-db?retryWrites=true&w=majority

Huomautus:

<käyttäjänimi> → mood-music-user
<password> → MySecurePassword123
Lisätty /mood-music-db tietokannan nimeksi

Napsauta 'valmis'

Vaihe 5: Lisää yhteysmerkkijono projektiisi

Päivitä .env-tiedostosi

Avaa .env tiedosto ja lisää:

MONGODB_URI=mongodb+srv://mood-music-user:MySecurePassword123@cluster0.abc123.mongodb.net/mood-music-db?retryWrites=true&w=majority JWT_SECRET=your-super-secret-jwt-key-here-make-it-long-and-random SESSION_SECRET=another-secret-key-for-sessions-also-long-and-random

Luo vahvoja salaisuuksia

Muotojen JWT_SECRET ja SESSION_SECRET osalta tarvitset satunnaisia merkkijonoja, jotka eivät riko asetustiedostojasi.

⚠️ Tärkeää: Vältä salasanoissa erikoismerkkejä, kuten @, #, $, %, /, ?, koska ne voivat rikkoa yhteysmerkkijonoja ja JSON-tiedostoja.

Vaihtoehto A: Yksinkertainen online-generaattori (suositeltu)

Käy osoitteessa: JWTSECRETS
Asetukset:
- Salasanojen määrä: 1
- Salasanan pituus: 32
- ✅ Tarkista "isot kirjaimet (A-Z)"
- ✅ Tarkista "pienet kirjaimet" (a-z)"
- ✅ Tarkista "numerot (0-9)"
- ❌ Poista valinta kohdasta "välimerkit"
Napsauta "Hae salasanat"

Vaihtoehto B: Käytä selainkonsolia (superhelppoa!)

Avaa mikä tahansa verkkosivusto (kuten google.com)
Paina F12-näppäintä (tai napsauta hiiren kakkospainikkeella → Tarkista)
Napsauta "Konsoli"-välilehteä

Liitä tämä koodi ja paina Enter:

Math.random().toString(36).substring(2) + Math.random().toString(36).substring(2) + Math.random().toString(36).substring(2)

Kopioi tulos - se on jotakuinkin seuraavanlainen: k8m9x2n7p4q1w3e5r6t8y9u2i4o7p1a5s3d6f8g2h4j7k9l

Vaihtoehto C: Manuaalinen menetelmä (jos mikään muu ei auta)

Kirjoita vain pitkä satunnainen merkkijono käyttäen:

Kirjaimet: A-Z, a-z
Numerot: 0-9
Esimerkki: MyApp2024SecretKey789RandomString456Auth

Lopullinen .env-esimerkki

SPOTIFY_CLIENT_ID=spotify_client_id_here SPOTIFY_CLIENT_SECRET=sinun_spotify_asiakkaan_salaisuutesi_tähän MONGODB_URI=mongodb+srv://mood-music-käyttäjä:MySecurePassword123@cluster0.abc123.mongodb.net/mood-music-db?retryWrites=true&w=majority JWT_SECRET=A8f2K9mP3qR7sT1vW5yX8bC4eN6jL2oU9iH7gF3dS6aZ1mQ4wE8rT5yU2pI9oL SESSION_SECRET=B7gT3mK9pL2sF6vW1yX4eR8aC5qN9jM7oU3iH6dG2fS8aZ4mQ1wE5rT7yU9pI3oL PORTTI=3000

Keskeiset kohdat:

✅ Ei erikoismerkkejä JWT_SECRET- ja SESSION_SECRET-muuttujassa
✅ MongoDB-salasana välttää URL-osoitteita rikkovia merkkejä
✅ Kaikki salaisuudet ovat pitkiä ja satunnaisia
✅ Turvallinen käyttää JSON-tiedostoissa ja yhteysmerkkijonoissa

Vaihe 2: Käyttäjämalli mielialan seurannalla

Luo kansio nimeltään models ja lisää kansioon tiedosto nimeltä User.js. Lisää sitten tiedostoon seuraava koodi ja tallenna se:

const mongoose = require('mongoose'); const bcrypt = require('bcryptjs'); const moodEntrySchema = new mongoose.Schema({ text: String, detectedMood: String, confidence: Number, playlistGenerated: [{ trackName: String, artist: String, spotifyId: String, liked: { type: Boolean, default: null } }], timestamp: { type: Date, default: Date.now } }); const userPreferencesSchema = new mongoose.Schema({ favoriteGenres: [String], preferredEnergyLevel: { type: Number, min: 0, max: 1 }, dislikedArtists: [String], moodMusicMapping: { happy: [String], sad: [String], energetic: [String], chill: [String], angry: [String], romantic: [String], nostalgic: [String] } }); 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 }, moodHistory: [moodEntrySchema], preferences: { type: userPreferencesSchema, default: () => ({}) }, stats: { totalPlaylists: { type: Number, default: 0 }, favoriteTime: String, mostCommonMood: String, joinDate: { type: Date, default: Date.now } } }, { timestamps: true }); // Tiivistä salasana ennen tallennusta userSchema.pre('save', async function(next) { if (!this.isModified('password')) return next(); this.password = await bcrypt.hash(this.password, 12); next(); }); // Vertaile salasanoja userSchema.methods.comparePassword = async function(password) { return bcrypt.compare(password, this.password); }; // Laske käyttäjätilastot userSchema.methods.updateStats = function() { const moods = this.moodHistory.map(entry => entry.detectedMood); this.stats.totalPlaylists = this.moodHistory.length; // Etsi yleisimmät mielialat const moodCounts = moods.reduce((acc, mood) => { acc[mood] = (acc[mood] || 0) + 1; return acc; }, {}); this.stats.mostCommonMood = Object.keys(mielialaLukumäärät).reduce((a, b) => mielialaLukumäärät[a] > mielialaLukumäärät[b] ? a : b, 'neutral' ); // Määritä suosikkikellonaika const hours = this.mielialaHistory.map(entry => entry.timestamp.getHours()); const avgHour = hours.reduce((a, b) => a + b, 0) / hours.length; if (avgHour < 6) this.stats.favoriteTime = 'yö'; else if (avgHour < 12) this.stats.favoriteTime = 'aamu'; else if (avgHour < 18) this.stats.favoriteTime = 'iltapäivä'; else this.stats.favoriteTime = 'ilta'; }; module.exports = mongoose.model('Käyttäjä', userSchema);

Vaihe 3: Todennuksen väliohjelmisto

Luo kansio nimeltä middleware ja lisää sen sisään tiedosto nimeltä auth.js. Lisää sitten tiedostoon seuraava koodi ja tallenna se:

const jwt = require('jsonwebtoken'); const User = require('../models/User'); const auth = async (req, res, next) => { try { const token = req.header('Valtuutus')?.replace('Bearer ', '') || req.session.token; if (!token) { return res.status(401).json({ error: 'Valtuutustietoja ei annettu' }); } const decoded = jwt.verify(token, process.env.JWT_SECRET); const user = await User.findById(decoded.userId); if (!user) { return res.status(401).json({ virhe: 'Käyttäjää ei löytynyt' }); } req.user = user; next(); } catch (error) { res.status(401).json({ virhe: 'Virheellinen token' }); } }; module.exports = auth;

Käyttäjänäkymä kauniilla analytiikalla

Luo uusi kansio projektiisi ja nimeä se public, lisää sitten tiedosto tämän kansion sisään ja nimeä se index.html:

<!DOCTYPE html> <html> <head> Ajatuksia lukevan musiikin API - Henkilökohtainen kojelauta/title>