Split auth UI module and load FAQ from markdown assets
This commit is contained in:
187
wwwroot/data/i18n/faq/de.md
Normal file
187
wwwroot/data/i18n/faq/de.md
Normal file
@@ -0,0 +1,187 @@
|
||||
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.
|
||||
|
||||
## 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, im falschen Phase einen Vorschlag hinzuzufügen
|
||||
|
||||
Überprüfe Fehlermeldungen unten rechts auf dem Bildschirm.
|
||||
|
||||
## Abstimmung
|
||||
|
||||
### Wer darf abstimmen?
|
||||
|
||||
Authentifizierte Spieler während der **Abstimmungsphase**.
|
||||
|
||||
### 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: Alle kehren in die Abstimmungsphase zurück 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.
|
||||
|
||||
### „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.
|
||||
- Wenn ein Admin dein Spielerkonto löscht, werden auch deine Vorschläge und Stimmen entfernt.
|
||||
191
wwwroot/data/i18n/faq/en.md
Normal file
191
wwwroot/data/i18n/faq/en.md
Normal file
@@ -0,0 +1,191 @@
|
||||
Pick'n'play helps groups fairly and transparently choose what game to play next. Players can suggest options, score them independently, and move through structured phases that keep the process organized and anonymous. It solves the classic “what should we play?” chaos by turning group decision-making into a clear, balanced, and drama-free flow.
|
||||
|
||||
## Accounts & Login
|
||||
|
||||
### How do I create an account?
|
||||
|
||||
Register with:
|
||||
- A **unique username** (max 24 characters)
|
||||
- A **password**
|
||||
- A **display name** (max 16 characters)
|
||||
|
||||
Your display name is required ‒ it appears next to all of your suggestions and scores.
|
||||
|
||||
### Do I need admin privileges?
|
||||
|
||||
If you've been given an **admin key**, enter it during registration. If the key is invalid, the request is rejected.
|
||||
Admin access cannot be added later. To become an admin, you must re-register with the correct key.
|
||||
|
||||
## Phases at a Glance
|
||||
|
||||
### Personal phases
|
||||
|
||||
Each player progresses independently through the phases:
|
||||
|
||||
**Suggest → Vote → Results**
|
||||
|
||||
Click **"Next"** to move forward. Admins can move themselves backward if needed.
|
||||
|
||||
## Suggesting Games
|
||||
|
||||
### How many games can I suggest?
|
||||
|
||||
Up to **5 suggestions per player**.
|
||||
|
||||
### Required fields and limits
|
||||
|
||||
- **Name** ‒ required (max 100 characters)
|
||||
- **Genre** ‒ optional (max 50 characters)
|
||||
- **Description** ‒ optional (max 500 characters)
|
||||
- **Links** ‒ optional (URLs up to 2048 characters)
|
||||
|
||||
### Min/Max players
|
||||
|
||||
- Must be filled together (or both left empty)
|
||||
- Values must be between **1 and 32**
|
||||
- Minimum must be ≤ maximum
|
||||
|
||||
### Screenshot rules
|
||||
|
||||
If you include a screenshot URL, it must:
|
||||
- Use **http or https**
|
||||
- End with a valid image extension (`png`, `jpg`, `jpeg`, `gif`, `webp`, `avif`)
|
||||
- Be directly accessible (no redirects)
|
||||
- Load within ~3 seconds
|
||||
- Be under **5 MB**
|
||||
- Not point to local or private hosts
|
||||
|
||||
Screenshots are optional.
|
||||
|
||||
### Other links
|
||||
|
||||
Game links and YouTube links must use **http or https**. Other URL schemes are rejected.
|
||||
|
||||
### Editing a suggestion
|
||||
|
||||
Click the **edit (pencil) icon** on a game card to update any field at any time.
|
||||
|
||||
### Deleting a suggestion
|
||||
|
||||
Click the **delete (cross) icon** on a game card to remove it ‒ unless you're already in the Vote phase (see below).
|
||||
|
||||
### Why was my suggestion blocked?
|
||||
|
||||
Common reasons:
|
||||
- Missing display name
|
||||
- Already reached the 5-suggestion limit
|
||||
- Name exceeds character limit
|
||||
- Screenshot URL is invalid, unreachable, or too large
|
||||
- Min/max players missing or invalid
|
||||
- Attempting to add a suggestion in the wrong phase
|
||||
|
||||
Check the bottom-right corner of the screen for error messages.
|
||||
|
||||
## Jokers (Late Additions)
|
||||
|
||||
### What is a joker?
|
||||
|
||||
A **joker** is a one-time extra suggestion slot available only during the **Vote phase**. An admin must grant it to you.
|
||||
|
||||
### How it works
|
||||
|
||||
If you receive a joker:
|
||||
- A button appears in the top bar allowing you to add one more game.
|
||||
- Once used, the joker is consumed immediately.
|
||||
- Your ballot becomes unfinalized.
|
||||
- All players are unfinalized so the new game can be scored.
|
||||
|
||||
Admins may grant additional jokers if necessary.
|
||||
|
||||
## Voting
|
||||
|
||||
### Who can vote?
|
||||
|
||||
Authenticated players during the **Vote phase**.
|
||||
|
||||
### How do I score games?
|
||||
|
||||
Use the slider to assign a whole number from **0 to 10**.
|
||||
|
||||
### Editing during Vote
|
||||
|
||||
- You can still edit most game details.
|
||||
- The **game name becomes locked** during the Vote phase.
|
||||
- You can no longer delete your own suggestions.
|
||||
- Admins may delete suggestions if necessary.
|
||||
|
||||
### Linked duplicates
|
||||
|
||||
If an admin links duplicate games:
|
||||
- Changing the score for one updates all linked entries.
|
||||
- Scores are stored per group, not per individual entry.
|
||||
|
||||
### Finalizing your ballot
|
||||
|
||||
Toggling **"Finalize"** locks your scores. Toggle it off to edit again.
|
||||
|
||||
Finalize is only available during the Vote phase and will automatically reset if:
|
||||
- A joker adds a new game
|
||||
- An admin links or unlinks games
|
||||
|
||||
### Voting after changes
|
||||
|
||||
If new games are added or links are modified:
|
||||
- Affected votes are cleared
|
||||
- You are automatically unfinalized
|
||||
|
||||
Review your list and rescore before finalizing again.
|
||||
|
||||
## Results
|
||||
|
||||
### When are results visible?
|
||||
|
||||
Results are hidden until an admin opens them. When opened, all players are automatically moved to the **Results phase**.
|
||||
If needed, an admin can close the Results: everyone returns to the Vote phase, and all ballots are unfinalized for adjustments.
|
||||
|
||||
### Can I edit anything in Results?
|
||||
|
||||
No. Suggestions and votes are read-only. Contact an admin for assistance.
|
||||
|
||||
## Admin Tools (For Hosts)
|
||||
|
||||
### What can admin accounts do?
|
||||
|
||||
- Grant jokers during Vote
|
||||
- Link or unlink duplicate suggestions
|
||||
- Delete suggestions
|
||||
- View vote readiness (who has finalized)
|
||||
- Delete a player (removes their suggestions and votes)
|
||||
- Reset the database to factory defaults
|
||||
- Move backward to previous phases
|
||||
|
||||
### What can't admin accounts do?
|
||||
|
||||
- View individual player votes
|
||||
|
||||
Voting remains anonymous and fair.
|
||||
|
||||
## Common Errors & Fixes
|
||||
|
||||
### "Screenshot URL must be http(s) and end with an image file extension."
|
||||
|
||||
Make sure:
|
||||
- The link is direct (not a page or html content)
|
||||
- It ends with a valid image extension
|
||||
- The file is under 5 MB
|
||||
- There are no redirects
|
||||
|
||||
### "You have reached the 5 suggestion limit."
|
||||
|
||||
Wait for the Vote phase and request a joker if needed.
|
||||
|
||||
### "Invalid admin key."
|
||||
|
||||
Register again using the correct key from the host ‒ or leave it blank to create a regular account.
|
||||
|
||||
## Data & Privacy
|
||||
|
||||
- Suggestions, votes, and phase states are stored in a shared **SQLite database**.
|
||||
- Passwords are stored with a SHA256 encryption.
|
||||
- Logging out clears your authentication cookie.
|
||||
- If an admin deletes your player account, your suggestions and votes are removed as well.
|
||||
Reference in New Issue
Block a user