Implement admin back-pass flow and guarded admin actions

This commit is contained in:
2026-02-08 14:20:38 +01:00
parent 4ee327fb4e
commit 5595bfd3b1
25 changed files with 572 additions and 109 deletions

View File

@@ -82,21 +82,20 @@ Common reasons:
Check the bottom-right corner of the screen for error messages.
## Jokers (Late Additions)
## Back Pass (One-Time Return)
### What is a joker?
### What is a back pass?
A **joker** is a one-time extra suggestion slot available only during the **Vote phase**. An admin must grant it to you.
A **back pass** is a one-time permission that lets you move from **Vote** back to **Suggest**. An admin must grant it to you during Vote.
### 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.
If you receive a back pass:
- A **Back** button appears in Vote for your account.
- Using it moves you to Suggest once and consumes the pass.
- Your finalized flag is cleared when you move back.
Admins may grant additional jokers if necessary.
Admins may grant another pass later if needed.
## Voting
@@ -126,7 +125,7 @@ If an admin links duplicate games:
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
- You move back to Suggest with a granted back pass
- An admin links or unlinks games
### Voting after changes
@@ -142,7 +141,7 @@ Review your list and rescore before finalizing again.
### 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.
If needed, an admin can close the Results: players with at least one suggestion return to Vote, players without suggestions return to Suggest, and finalized ballots are cleared.
### Can I edit anything in Results?
@@ -152,13 +151,15 @@ No. Suggestions and votes are read-only. Contact an admin for assistance.
### 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)
- Move players from Vote back to Suggest from the status dropdown
- Grant one-time back passes
- Reset the database to factory defaults
- Move backward to previous phases
- Confirm reset/delete actions with their own admin password
### What can't admin accounts do?
@@ -178,7 +179,7 @@ Make sure:
### "You have reached the 5 suggestion limit."
Wait for the Vote phase and request a joker if needed.
Ask an admin to grant a back pass if you need to return to Suggest and adjust your list.
### "Add at least one suggestion before entering the Vote phase."