User Guide

Handout

Everything Veteranos can do, how to use it, and the few non-obvious things worth knowing.

Quick start

What Veteranos is and how to get going in two minutes.

Veteranos is the place where the team organises every kick-around: who's playing, who can't make it, who's on the waitlist, and (when there are enough players) automatically generated balanced teams.

1
Get an invitation. An admin shares a link such as https://veteranos.club/register?invite=…. Without that link the registration page won't accept you.
2
Register. Fill in first name, last name, email, password, and pick whether you join as Abo or Waitlist. The other fields are optional.
3
You're in. Open the homepage to see all upcoming matches and confirm or decline.

Skills, position, rank and admin notes are set by an adminafter you register — players can't edit those themselves.

Player types

Two kinds of players, with very different sign-up rules.

Abo

Fixed slot

·Has a guaranteed seat in every match by default.
·Per match they confirm In or Can't make it.
·If they decline, a waitlist player can step into their spot.
·PayPal info on the profile lets the replacement pay them back.

Waitlist

Per-match opt-in

·No fixed seat. Has to actively join the waitlist of each match.
·When an abo declines, the first waitlist player on the list steps in.
·Owes the abo for the slot — payment workflow takes care of tracking it.
·Multiple waitlisters: they fill in declines in order (1st replaces 1st out, …).

Admins can flip you from Abo to Waitlist (or back) any time on the player edit screen. The role you picked at registration is just the starting point.

Browsing matches

What the homepage shows and how to read it.

The homepage lists every upcoming match as a card. Each card has up to five sections, all with player counts:

Confirmed	Abos who said In and are playing.	In
Declined	Abos who said they can't make it.	Out
Replacements	Pairs of (abo who declined) → (waitlist player stepping in).	→
Waitlist	Everyone who signed up via the waitlist, in order.	Queue

Tap Match details → at the bottom of a card to open the full match page. There you also see the generated teams once an admin has created them.

The match-detail page only shows the back link — the “Match details” link is hidden when you're already on it.

Signing up for a match

Two-tap confirm or decline, depending on your role.

As an Abo

· I'm in — confirms your slot.
· Can't make it — frees your slot for the waitlist.
·You can flip your answer until the admin locks the match.

As Waitlist

· Join waitlist — queues you for that match.
·Your position in the queue follows the order you signed up in.
·If an abo declines and you're high enough, you step in automatically.
·You can Leave the waitlist as long as the match isn't locked.

When the admin locksa match, sign-ups freeze. Abos can no longer change their mind, and waitlisters can't join or leave.

Replacements & payments

How a waitlist player pays the abo whose slot they took.

When an abo declines and a waitlist player steps in, that's a replacement pair. The waitlist player owes the abo for the slot. Veteranos tracks the payment in four states:

No payment	No money is owed (e.g. nobody declined).
Payment pending	Waitlist player still has to pay.
Awaiting confirmation	Waitlist player marked it as paid; abo hasn't confirmed yet.
Paid	Abo confirmed receipt. Done.

1
Waitlist player pays the abo using the PayPal link or any other channel. If the abo has no PayPal info, just coordinate directly.
2
Tap Mark as paid in the replacement row. Status flips to Awaiting confirmation.
3
Abo sees the same row with Confirm received / Not received buttons. Tapping confirm flips it to Paid.

Payment info (status, PayPal link, action buttons) is only visible to the two players involved. Other players see a clean replacement row without any financial detail.

Your Profile page has a Payments card with two lists: You owe and Owed to you. Each entry is clickable and jumps straight to that match.

Your profile

What you can change yourself, and what stays in admin hands.

You can edit

·First name, last name, nickname.
·Phone, PayPal name, PayPal link.
·Profile photo (Camera icon → choose image → crop / zoom → save).
·Password.

Admin only

·Player type (Abo / Waitlist).
·Order / rank inside the list.
·Position (goalkeeper, defender, midfielder, striker).
·Skills (overall, technique, speed, stamina, defense, offense, passing, shooting, goalkeeping).
·Active flag and admin notes.

The avatar uploader lets you pan and zoom a picture inside the circular crop. Saved at 256×256 JPEG, so it stays small.

Forgot password

Self-service in two steps; admin can also help.

1
Open /forgot-password (link is on the login screen).
2
Type your first name + last name. If they uniquely match a player, you immediately get a Set new password button to set a fresh password.

If your name doesn't match (or matches more than one player), the form asks you to contact an admin. Admins can generate a one-hour reset link for any user in Admin → Players → [name].

Install as app

Veteranos is a PWA, so it installs straight from the browser.

iPhone (Safari)

·Open the site in Safari.
·Tap the Share button (square with up-arrow) in the toolbar.
·Choose Add to Home Screen.
·Veteranos opens in full-screen mode like a native app.

Android (Chrome)

·Open the site in Chrome.
·Either tap the Install pill in the bottom-right of the screen,
·or open the Chrome menu → Install app / Add to Home screen.

No app store. Updates roll out automatically — next time you open the app it fetches the latest version.

Admin features

Everything an admin can do that regular players can't.

Players

Create / edit / delete players (with or without a login account).
Edit skills (overall, technique, speed, stamina, defense, offense, passing, shooting, goalkeeping) and preferred position.
Switch a player between Abo and Waitlist, or set them inactive.
Promote a player to admin or demote them back. Self-demotion and demoting the last admin are blocked.
Generate a one-hour password reset link for any player.

Matches

Create matches with date, time, duration, location, team count (2–4) and notes.
New matches start with an empty sign-up list — every player has to actively confirm or decline.
Lock / unlock a match's sign-up list.
Manually add, decline, waitlist or remove a player on a specific match.
Cycle a payment status manually (Pending → Awaiting confirmation → Paid → Pending).
Delete a match (with confirmation).

Team generator

Builds balanced teams with a snake draft followed by ~800 random swap attempts that only stick if they reduce the spread between teams.

Default size	5 players per team. So 10 / 15 / 20 for 2 / 3 / 4 teams.
Priority	All IN abos first (by player rank), then waitlist signups (by waitlist rank).
Override	Use all signed-up players — extras stretch teams (e.g. 6 vs 6 vs 6).
Exclude list	Tick off individual players to leave them out of this draft.

Generate teams after locking the match — otherwise sign-ups can still shift the player pool.

Invitations

Create invite links with optional label, max-uses limit, expiry in days.
Copy the link and share it however you like (group chat, email, …).
Revoke a link to stop new sign-ups against it; delete to remove the entry.
Used count is tracked atomically, so two people racing the last slot can't both register.

Tips & gotchas

Small things that save a lot of confusion.

Lock the match before generating teams. The lock freezes signups so the pool is stable.
Mark as paid is on the waitlist player's side. The abo only sees Confirm received after that.
Replacement order is strict: 1st waitlister fills the 1st declined abo, 2nd fills 2nd, etc. Even when admin moves people around manually, the pairing stays rank-aligned.
Skills don't affect sign-ups, only the team generator. So newcomers without ratings can still play — admin can fill in skills later.
After installing the app, refresh once to make sure the latest service worker is active. The app updates itself silently afterwards.