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. Admin-Rechte können später nicht hinzugefügt werden. Um Admin zu werden, musst du dich mit dem korrekten Schlüssel neu registrieren.

## 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 oder private 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

Ü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
-   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)
-   Die Datenbank auf Werkseinstellungen zurücksetzen
-   Zu vorherigen Phasen zurückkehren

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

-   Einzelne Spielerbewertungen einsehen

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.

### „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.

## Daten & Datenschutz

-   Vorschläge, Stimmen und Phasenstatus werden in einer gemeinsamen **SQLite-Datenbank** gespeichert.
-   Passwörtwer werden mit einer SHA256 Verschlüsselung gespeichert.
-   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.
