Pick'n'play hilft Gruppen dabei, fair und transparent zu entscheiden, welches Spiel als Nächstes gespielt wird. Spieler können Vorschläge einreichen, diese unabhängig bewerten und durch strukturierte Phasen gehen, die den Prozess organisiert und anonym halten. Es löst das klassische „Was sollen wir spielen?"-Chaos, indem es Gruppenentscheidungen in einen klaren, ausgewogenen und stressfreien Ablauf verwandelt.

## Konten & Anmeldung

### Wie erstelle ich ein Konto?

Registriere dich mit:
 - Einem **eindeutigen Benutzernamen** (max. 24 Zeichen)
 - Einem **Passwort** 
 - Einem **Anzeigenamen** (max. 16 Zeichen)

Dein Anzeigename ist erforderlich ‒ er erscheint neben all deinen Vorschlägen und Bewertungen.

### Brauche ich Admin-Rechte?

Wenn du einen **Admin-Schlüssel** erhalten hast, gib ihn bei der Registrierung ein. Ist der Schlüssel ungültig, wird die Anfrage abgelehnt. Die Admin-Schlüssel-Registrierung ist nur verfügbar, bis das erste Admin-Konto erstellt wurde. Admin-Rechte können später nicht über die öffentliche Registrierung hinzugefügt werden.
Sobald ein Owner-Konto existiert, wird das Admin-Schlüssel-Feld in der Registrierung nicht mehr angezeigt.

## Phasen im Überblick

### Persönliche Phasen

Jeder Spieler durchläuft die Phasen unabhängig voneinander:

**Vorschlagen → Abstimmen → Ergebnisse**

Klicke auf **„Weiter"**, um fortzufahren. Admins können sich bei Bedarf auch wieder zurücksetzen.
In der **Vorschlagsphase** bleibt **„Weiter"** deaktiviert, bis dein Konto mindestens einen eigenen Spielvorschlag hat.

## Spiele vorschlagen

### Wie viele Spiele kann ich vorschlagen?

Bis zu **5 Vorschläge pro Spieler**.

### Pflichtfelder und Grenzen

-   **Name** ‒ erforderlich (max. 100 Zeichen)
-   **Genre** ‒ optional (max. 50 Zeichen)
-   **Beschreibung** ‒ optional (max. 500 Zeichen)
-   **Links** ‒ optional (URLs bis zu 2048 Zeichen)

### Min./Max. Spieleranzahl
- Müssen gemeinsam ausgefüllt werden (oder beide leer bleiben) 
- Werte müssen zwischen **1 und 32** liegen 
- Minimum muss ≤ Maximum sein

### Screenshot-Regeln

Wenn du eine Screenshot-URL angibst, muss sie:
 - **http oder https** verwenden 
 - Mit einer gültigen Bilddateiendung enden (`png`, `jpg`, `jpeg`, `gif`, `webp`, `avif`)
 - Direkt erreichbar sein (keine Weiterleitungen)
 - Innerhalb von ~3 Sekunden laden
 - Unter **5 MB**groß sein
 - Nicht auf lokale, private oder reservierte Hosts verweisen

Screenshots sind optional.

### Weitere Links

Spiel-Links und YouTube-Links müssen **http oder https** verwenden. Andere URL-Schemata werden abgelehnt.

### Vorschlag bearbeiten

Klicke auf das **Bearbeiten-Symbol (Stift)** auf einer Spielkarte, um Felder jederzeit zu aktualisieren.

### Vorschlag löschen

Klicke auf das **Löschen-Symbol (Kreuz)** auf einer Spielkarte, um sie zu entfernen ‒ außer du befindest dich bereits in der Abstimmungsphase (siehe unten).

### Warum wurde mein Vorschlag blockiert?

Häufige Gründe:
- Fehlender Anzeigename
- Das Limit von 5 Vorschlägen wurde erreicht
- Name überschreitet das Zeichenlimit
- Screenshot-URL ist ungültig, nicht erreichbar oder zu groß
- Min./Max.-Spieler fehlen oder sind ungültig
- Versuch, in der falschen Phase einen Vorschlag hinzuzufügen

Überprüfe Fehlermeldungen unten rechts auf dem Bildschirm.

## Abstimmung

### Wer darf abstimmen?

Authentifizierte Spieler während der **Abstimmungsphase**, welche mindestens ein Vorschlag hinzugefügt haben.

### Wie vergebe ich Punkte?

Nutze den Schieberegler, um eine ganze Zahl von **0 bis 10** zu vergeben.

### Bearbeiten während der Abstimmung

-   Die meisten Spieldetails können weiterhin bearbeitet werden
-   Der **Spielname ist während der Abstimmungsphase gesperrt**
-   Eigene Vorschläge können nicht mehr gelöscht werden
-   Admins können Vorschläge bei Bedarf löschen

### Verknüpfte Duplikate

Wenn ein Admin doppelte Spiele verknüpft:
 - Eine Punkteänderung wirkt sich auf alle verknüpften Einträge aus
 - Punkte werden pro Gruppe gespeichert, nicht pro Einzeleintrag

### Abstimmung finalisieren

Mit **„Finalisieren"** werden deine Bewertungen gesperrt. Deaktiviere es, um erneut zu bearbeiten.

„Finalisieren" ist nur während der Abstimmungsphase verfügbar und wird automatisch zurückgesetzt, wenn:
 - Ein Joker ein neues Spiel hinzufügt
 - Ein Admin Spiele verknüpft oder trennt

### Abstimmen nach Änderungen

Wenn neue Spiele hinzugefügt oder Verknüpfungen geändert werden:
 - Betroffene Stimmen werden gelöscht
 - Deine Abstimmung wird automatisch zurückgesetzt
 - Das Update-Popup erscheint nur, wenn sich deine bereits sichtbare Abstimmungsliste verändert

Überprüfe deine Liste und bewerte erneut, bevor du wieder finalisierst.

## Joker (Späte Ergänzungen)

### Was ist ein Joker?

Ein **Joker** ist ein einmaliger zusätzlicher Vorschlags-Slot, der nur während der **Abstimmungsphase** verfügbar ist. Ein Admin muss ihn dir gewähren.

### So funktioniert es

Wenn du einen Joker erhältst:
- Erscheint ein Button in der oberen Leiste, mit dem du ein weiteres Spiel hinzufügen kannst
- Nach der Nutzung wird der Joker sofort verbraucht
- Die Finalisierung aller Abstimmungen werden automatisch zurückgesetzt, damit das neue Spiel bewertet werden kann

Admins können bei Bedarf zusätzliche Joker vergeben.

## Ergebnisse

### Wann sind die Ergebnisse sichtbar?

Die Ergebnisse bleiben verborgen, bis ein Admin sie freigibt. Danach werden alle Spieler automatisch in die **Ergebnisphase** verschoben. Falls nötig, kann ein Admin die Ergebnisse wieder schließen: Konten mit mindestens einem eigenen Vorschlag kehren in die Abstimmungsphase zurück, Konten ohne Vorschläge in die Vorschlagsphase, und alle Abstimmungen werden zur Anpassung zurückgesetzt.

### Kann ich in der Ergebnisphase etwas bearbeiten?

Nein. Vorschläge und Bewertungen sind schreibgeschützt. Wende dich bei Bedarf an einen Admin.

## Admin-Tools (Für Hosts)

### Was können Admin-Konten tun?

-   Joker während der Abstimmung vergeben
-   Einen Bewerter zurück in die Vorschlagsphase setzen (stärker als ein Joker; sparsam einsetzen)
 -   Ergebniszugriff mit einem einzelnen Button umschalten (Beschriftung wechselt je nach Zustand)
-   Admin-Rechte für Nicht-Owner-Konten in der Spielertabelle vergeben oder entziehen
-   Doppelte Vorschläge verknüpfen oder trennen
-   Vorschläge löschen
-   Abstimmungsstatus einsehen (wer finalisiert hat)
-   Einen Spieler löschen (inklusive dessen Vorschläge und Stimmen)
-   Für Konto-Löschung, Zurücksetzen und Werkseinstellung das Admin-Passwort bestätigen
-   Die Datenbank auf Werkseinstellungen zurücksetzen
-   Zu vorherigen Phasen zurückkehren

### Was können Admin-Konten nicht tun?

-   Einzelne Spielerbewertungen einsehen
-   Owner-Rechte entziehen oder das Owner-Konto löschen

Die Abstimmung bleibt anonym und fair.

## Häufige Fehler & Lösungen

### „Screenshot-URL muss http(s) verwenden und mit einer Bilddateiendung enden."

Stelle sicher:
 - Der Link ist direkt (keine HTML-Seite)
 - Er endet mit einer gültigen Bilddateiendung
 - Die Datei ist unter 5 MB groß
 - Es gibt keine Weiterleitungen

### „Du hast das Limit von 5 Vorschlägen erreicht."

Warte auf die Abstimmungsphase und bitte bei Bedarf um einen Joker.

### „Füge mindestens einen Vorschlag hinzu, bevor du in die Abstimmungsphase wechselst."

Füge mit deinem aktuellen Konto mindestens einen Spielvorschlag hinzu. Erst dann kannst du von der Vorschlagsphase in die Abstimmungsphase wechseln. Diesese Verhalten erschwert die Abgabe von mehreren Stimmen pro Benutzer.
Bis dahin zeigt die Navigation in der Vorschlagsphase einen Hinweis statt eines Weiter-Buttons und wechselt direkt nach der ersten erfolgreichen Einreichung.

### „Ungültiger Admin-Schlüssel."

Registriere dich erneut mit dem korrekten Schlüssel vom Host ‒ oder lasse das Feld leer, um ein normales Konto zu erstellen.

### „Zu viele Anfragen. Bitte versuche es in Kürze erneut."

Auth- und Admin-sensitive Routen sind gegen Brute-Force-Angriffe rate-limitiert.
Warte kurz und versuche es dann erneut.

## Daten & Datenschutz

-   Vorschläge, Stimmen und Phasenstatus werden in einer gemeinsamen Datenbank gespeichert.
-   Passwörter werden als gesalzene Hashes gespeichert (nicht im Klartext).
-   Beim Abmelden wird dein Authentifizierungs-Cookie gelöscht und die Eingaben in Login/Registrierung werden zurückgesetzt.
-   Wenn ein Admin dein Spielerkonto löscht, werden auch deine Vorschläge und Stimmen entfernt.
