← Zur Doku

Projektstatus

🎵 MusicVoting

Stand: 28. September 2026

Worum geht's?

Auf einer Party bestimmen die Gäste per Smartphone, welche Musik läuft – der Gastgeber richtet nur alles ein.

Gastgeber
🎉

Party erstellen

Gastgeber
🎧

Musikanbieter verbinden

Gäste
📷

QR-Code scannen

Gäste
🔍

Songs wünschen

Gäste
❤️

Liken

Player (TV)
🔊

Beliebtester Song läuft

Ist-Zustand

👑

Gastgeber

Party erstellen, Spotify-Login, Standard-Playlist wählen, Wiedergabe steuern, Songs entfernen, Party beenden.

📱

Gäste

Beitritt per QR-Code oder 5-stelligem PIN, anonym. Songs suchen, wünschen und liken – alles live.

🖥️

Player (TV)

Spielt über das Spotify Web Playback SDK, zeigt QR-Code, aktuellen Song mit Fortschritt und die Warteschlange.

🔁

Musik geht nie aus

Bei leerer Warteschlange wird automatisch nachgefüllt (Standard-Playlist → ähnliche Songs → Top-Charts → Suche).

🍏

iOS-App

Gast- und Host-Ansicht in SwiftUI

🚀

Live & automatisiert

Läuft im HTL-Kubernetes-Cluster, jeder Push auf main wird automatisch gebaut und deployed.

Soll-Zustand

🚫

Songs an die Party anpassen

  • Blacklist: Der Host sperrt Wörter, passende Songs werden mit „Nicht erlaubt.“ abgelehnt
🎵

Mehrere Musikanbieter

  • Suche und Wiedergabe auch über andere Anbieter
  • z. B. Amazon Music, YouTube Music, …
🎤

Karaoke-Modus

  • Songtexte am Player (TV) anzeigen – zum Mitsingen

C4 · Level 1

Kontextdiagramm

PERSON📱 GastTritt per QR-Code / PIN bei,wünscht und liked SongsPERSON👑 GastgeberErstellt die Party, verbindetSpotify, steuert WiedergabeSOFTWARE-SYSTEM🎵 MusicVotingWeb-App: Gast, Host, Player/TV+ iOS-App (SwiftUI)Verwaltet Partys,Warteschlange und VotesEXTERNES SYSTEM🎧 SpotifyWeb API (Suche)OAuth (Login)Web Playback SDKWünscht &liked SongsSmartphone · HTTPSErstellt &steuert PartyBrowser / iOS · HTTPSSucht Songs,spielt Musik abHTTPSMeldet sich an· OAuthUnser SystemExternes System

Architektur

📱 GastAngular Webpage👑 HostAngular Webpage🍏 iOS-AppSwiftUI · Gast & Host🖥️ PlayerAngular + Playback SDK☕ Quarkus-Backend (Java 21) · /apiEndpointsREST · SSEServiceProviderSchedulerAuto-Ende 2 Tage🐘 PostgreSQL 16party · queue_entry · vote🎧 SpotifyWeb API · OAuthAudio über Web Playback SDKRESTSSE (live)

Projekttermine

DatumTermin
TT.MM.JJJJ…
TT.MM.JJJJ…
TT.MM.JJJJ…
TT.MM.JJJJ…

Meilensteine

MeilensteinbisStatus
…TT.MM.JJJJ⏳
…TT.MM.JJJJ⏳
…TT.MM.JJJJ⏳
…TT.MM.JJJJ⏳

Aktueller Stand

Screenshots aller Seiten – Gast, Gastgeber und Player.

Stand: 28. September 2026
Screenshot Startseite

Aktueller Stand · 1/9

Alle

Startseite

Einstieg für alle – als Gastgeber oder als Gast weiter.

/ · Stand 28. September 2026

Screenshot Gastgeber-Optionen

Aktueller Stand · 2/9

Gastgeber

Gastgeber-Optionen

Neue Party erstellen oder mit dem Host-PIN Dashboard bzw. Player einer laufenden Party öffnen.

/host-options · Stand 28. September 2026

Screenshot Party erstellen

Aktueller Stand · 3/9

Gastgeber

Party erstellen

Anbieter wählen – derzeit funktioniert nur Spotify („Amazon Music“ steht nur in der Auswahl). Danach geht es zum Spotify-Login.

/create-party · Stand 28. September 2026

Screenshot Standard-Playlist

Aktueller Stand · 4/9

Gastgeber

Standard-Playlist

Nach dem Login wählt der Host optional eine Playlist, aus der nachgefüllt wird, wenn niemand etwas wünscht.

/select-playlist · Stand 28. September 2026

Screenshot Host-Dashboard

Aktueller Stand · 5/9

Gastgeber

Host-Dashboard

Aktueller Song mit Steuerung (Neu starten, Play/Pause, Skip), Warteschlange mit Löschen, Host-PIN, QR-Code, Player öffnen und Party beenden.

/dashboard · Stand 28. September 2026

Screenshot Player

Aktueller Stand · 6/9

Player (TV)

Player

Läuft am Fernseher und spielt die Musik ab. Gäste scannen hier den QR-Code.

/startpage · Stand 28. September 2026

Screenshot Beitreten

Aktueller Stand · 7/9

Gast

Beitreten

Gäste geben den 5-stelligen PIN ein – oder landen direkt hier, wenn sie den QR-Code scannen.

/code · Stand 28. September 2026

Screenshot Voten

Aktueller Stand · 8/9

Gast

Voten

Die Warteschlange, sortiert nach Likes. Ein Tipp auf das Herz liked oder nimmt das Like zurück.

/voting · Stand 28. September 2026

Screenshot Songs hinzufügen

Aktueller Stand · 9/9

Gast

Songs hinzufügen

Suche bei Spotify; „+“ fügt den Song hinzu, ein Häkchen zeigt Songs, die schon warten.

/guest · Stand 28. September 2026

Weiter geht's

Mehr erfahren

Stand: 28. September 2026