📋 Bekercompetitie Reglement Regio Oost 2026

📖 Instructies — Hoe werkt de app?

📧 Vragen? Mail bekercompetitie@gmail.com

Seizoenscode

Bij je eerste bezoek aan de app vraagt het systeem om een seizoenscode. Deze code ontvang je van de wedstrijdleiding. Na een geldige code wordt hij in deze browser bewaard — volgende keren krijg je de overlay niet meer te zien.

Stap 1 — Jouw wedstrijd vinden

• Ga naar tab Wedstrijden
• Gebruik de 🔍 zoekbalk bovenaan om jouw team te zoeken
• Of klik op jouw poule (A t/m H) om alle wedstrijden in die poule te zien
• De poulestand verschijnt zodra je een poule kiest en toont het actuele klassement
• Klik op het ℹ icoontje achter een teamnaam in de poulestand voor verenigingsinfo (adres, speelavond, telefoon, contactpersoon)

Stap 2 — Wedstrijd starten

• Zoek jouw wedstrijd in de lijst onder de poulestand
• Klik op de status-cel (📅 Gepland) om een nieuwe wedstrijd te starten. Het icoon achter de uitslag is altijd klikbaar.
• Is de wedstrijd al bezig (🏓 Nu spelen)? Klik op de status-cel om verder te gaan.
• Klik op het 📍-icoontje achter het wedstrijdnummer voor adres + contactgegevens van de thuisvereniging.

Stap 3 — Spelers invullen

• Op tab Wedstrijdgegevens vul je de vier spelers per team in (thuis en uit)
• Typ een naam → kies de speler uit de suggestielijst. Bondsnummer en rating worden automatisch ingevuld
• Als alle 8 spelers ingevuld zijn: klik op ▶ Speelschema laden

Stap 4 — Scores invullen

• Op tab Wedstrijdformulier vul je per set de games in
• Het formulier bestaat uit 18 sets: 8 enkels, 2 dubbels en nog 8 enkels
• Vul alleen cijfers (0–99) in per game. Letters en streepjes worden geblokkeerd
• Vul altijd het laagste cijfer van een game in (of dat nu thuis of uit is). Druk op Tab → de winnaar wordt automatisch ingevuld op 11 (of bij verlenging vanaf 10-10: typ het laagste cijfer, bv. 13, en het hoogste wordt op 15 gezet)
• Na een afgesloten game springt de cursor vanzelf naar de eerstvolgende game in dezelfde set
• De setuitslag en eindstand worden live berekend
• Klik op het ℹ naast de startstand voor uitleg over de toegift (voorsprong op basis van ratingverschil)

Stap 5 — Akkoord geven

• Vóór akkoord-geven kun je de stand controleren via de tussenstand-pil rechtsboven elke set (bv. 1-2 in games) en de uitslag-balk onderaan met de huidige set-stand (bv. 7-11). Beide updaten live op desktop en mobiel
• Zodra alle sets een besliste uitslag hebben, kunnen beide kapiteins akkoord geven
• Vul in de balk van je eigen team je naam in en klik op ✓ Akkoord uitslag
• Na akkoord van beide teams is de wedstrijd ✅ Afgerond en officieel
• Het formulier kan dan niet meer gewijzigd worden — fouten kun je melden bij de wedstrijdleiding

Knock-out fase

Na de pouleronde volgt de knock-out fase:

• 🏆 AF — Achtste Finales (week 25, 15-19 juni)
• 🏆 KF — Kwart Finales (week 26, 22-26 juni)
• 🏆 HF — Halve Finales (week 27, vrijdag 3 juli, ATTV Blauw-Wit (Almelo))
• 🏆 BF — Bekerfinale (week 28, vrijdag 10 juli, ATTV Blauw-Wit (Almelo))
• ⏳ — wachtend op teams uit voorgaande ronde. Klik op de status-cel voor uitleg.

Klik op tab Wedstrijden op AF/KF/HF/BF om de wedstrijden van die ronde te zien.

Meerdere mensen tegelijk

• Meerdere mensen kunnen tegelijk scores invullen voor dezelfde wedstrijd
• Gebruik ↻ Vernieuwen om de laatste stand op te halen
• Wisselen van tab ververst automatisch
• Start je een wedstrijd die al op Nu spelen staat, dan verschijnt er een waarschuwing

Op je mobiele telefoon

Het formulier past zich automatisch aan kleinere schermen aan (vanaf ongeveer 768 pixels schermbreedte). Op je telefoon zie je daarom een compactere layout dan op de laptop, maar alle functies werken hetzelfde.

Vragen of problemen?

• 📧 stel je vraag
• 📞 Jos Reuvekamp: 06 1601 8309
• 📞 Eric Beld: 06 3741 8675

🔧 Instructies Beheerder

Inloggen

• Klik rechtsboven op 🔐 Beheerder
• Voer je inlognaam en wachtwoord in. Sessie verloopt automatisch na lange inactiviteit.
• Na inloggen verschijnen extra tabs: Instructies (B), Test en Import, Verenigingen, Poule-indelingen en Spelers. Het wedstrijdschema en de knock-out zijn samengevoegd met Wedstrijden — beheerder- acties verschijnen in de Acties-kolom.
• Na inloggen verandert de knop in 👁️ Bekijk als gebruiker — handig om snel te zien wat de eindgebruiker te zien krijgt. Klik nogmaals voor 👁️ Terug naar beheerderweergave.
• Sessie verloopt automatisch na lange inactiviteit. Volledig uitloggen via 🚪 Uitloggen als beheerder rechtsboven.

Seizoenscode beheren

• Onderaan deze pagina staat de kaart 🔑 Seizoenscode beheren
• Standaardcode bij start: BEKER2026
• Wijzig de code bij een nieuw seizoen → oude code wordt automatisch gedeactiveerd. Bestaande gebruikers krijgen dan opnieuw de overlay te zien

Verenigingen

• Verenigingen toevoegen, bewerken en verwijderen
• Velden: naam, adres, plaatsnaam, contactpersoon, email, telefoon, speelavond, tafels, tel. zaal, zaal beschikbaar tot
• Adres + plaatsnaam vormen automatisch een klikbare 🗺️ Google Maps-link op Wedstrijden
• Een vereniging kan pas verwijderd worden als er geen teams meer aan gekoppeld zijn

Poule-indelingen

• Klik op een poule (A t/m H) om de teams te zien
• Teams toevoegen per poule — bulk-toevoegen tot 4 tegelijk
• Team bewerken: nummer en bijnaam aanpassen
• Team verwijderen alleen mogelijk als er geen spelers of wedstrijden meer aan gekoppeld zijn

Spelers

• Spelers worden uitsluitend via deze tab toegevoegd — niet meer via het wedstrijdformulier op Wedstrijdgegevens
• Spelers toevoegen, bewerken en verwijderen
• Spelers koppelen aan een team (autocomplete)
• Bondsnummer moet uniek zijn
• Ratings worden bijgewerkt na ontvangst van de NTTB-lijst (eind april)
• Nieuwe spelers altijd in afstemming met de deelnemende teams toevoegen

Wedstrijden — beheerder-acties

• Wedstrijden plannen via + Wedstrijd toevoegen (boven de tabel): datum, thuis team, uit team, poule, optioneel een locatie.
• Filter op poule (pills), zoek op teamnaam (zoekbalk alleen actief zonder poule-filter), filter op status (Alle / Gepland / Nu spelen / Afgerond).
• Voor gebruikers: klik op de status-cel (kolom Uitslag) — het icoon bepaalt de actie:
  • 📅 GEPLAND → invullen-flow
  • 🏓 NU_SPELEN → doorgaan-flow
  • ✅ AFGEROND → wedstrijdformulier inzien
  • 📋 WL → eindstand-info-modal
  • ⏳ wachtend op teams → uitleg-modal
• Voor beheerder: extra knoppen in de Acties-kolom:
  • ✏️ — wedstrijdschema bewerken (datum, locatie, teams, poule)
  • 🗑 — wedstrijd verwijderen, met situatie-afhankelijke bevestiging:
    • Geen formulier → direct verwijderen na bevestiging
    • Wel formulier, geen scores → formulier + schema verwijderen
    • Wel scores → extra waarschuwing vereist
    • Afgerond → eerst ontdooien via het wedstrijdformulier
  • 📋 WL — eindstand invoeren door wedstrijdleiding
• ↻ Vernieuwen (boven de tabel) haalt de laatste lijst op.

Knock-outs in Wedstrijden

De knock-out fase wordt beheerd binnen de tab Wedstrijden — er is geen aparte tab meer. Filter via de KO-balk-knoppen AF / KF / HF / BF boven de wedstrijdtabel om alleen die ronde te zien.

De knop 🔄 Knock-outs bijwerken (boven de tabel, alleen voor beheerder zichtbaar) doet:

• Achtste finales: 1/8-koppels uit poule-eindstanden vullen (nr. 1 en nr. 2 per poule)
• Kwart/Halve finales en Finale: winnaars uit voorgaande ronde doorzetten

Klik op de ✏️-knop in de Acties-kolom om datum, locatie of teams aan te passen voor een specifieke KO-wedstrijd.

Wedstrijd ontdooien

Een al afgeronde wedstrijd corrigeren? Open 'm via Wedstrijden door op de status-cel ✅ te klikken. Daarna gebruik je op het wedstrijdformulier de knop 🔓 Ontdooien (beheerder). Drie opties:

• Alleen akkoord wissen — scores blijven, beide kapiteins kunnen opnieuw akkoord geven
• Alles wissen — scores én akkoord weg, status terug naar Gepland
• Annuleren — sluit de modal zonder wijzigen.

Wedstrijd vrijgeven

• Wedstrijd zonder akkoord (gepland of nu spelen): open de wedstrijd op Wedstrijdgegevens en gebruik Verwijder formulier. De scores worden gewist; de wedstrijd komt terug op Gepland.
• Wedstrijd afgerond (beide kapiteins akkoord): gebruik Ontdooien op het formulier (alleen zichtbaar voor beheerder).

Testfuncties

• Op Wedstrijdgegevens staat de groene knop 🧪 TEST: Vul testdata in (alleen beheerder) — vult automatisch 8 spelers en/of scores in
• Deze knoppen zijn alleen zichtbaar voor beheerders en hoeven niet handmatig verwijderd te worden voor productie

Naar productie

Productie-taken (IIS, SSL-certificaat, CORS, Windows Service voor uvicorn) worden buiten de app bijgehouden.

🔑 Seizoenscode beheren

Huidige actieve code: laden...

Test en Import — beheerscripts

Documentatie van de command-line scripts in de Import/-map. Deze scripts draaien lokaal via PowerShell op de werkmachine van de beheerder en zijn niet beschikbaar via de webinterface.

Quick-reference

Een complete poule-run duurt typisch ~30-60 seconden (eerder ~30 minuten in v0.2).

importeer_seizoen.py stable

Importeert verenigingen, teams, spelers en het volledige wedstrijdschema (poule + KO) op basis van de XLS-bestanden in de import-map. De cleanup van bestaande wedstrijddata gebeurt geïntegreerd via de --ook-opschonen flag — geen apart script meer nodig.

Aanroep (dry-run, geen DB-wijzigingen):

python Import/importeer_seizoen.py

Aanroep (echt uitvoeren, met cleanup):

python Import/importeer_seizoen.py --execute --ook-opschonen

Output: rapport in Rapporten/import_seizoen_YYYYMMDD_HHMM.md met snapshot, per-stap-resultaten en validatie-checks.

vul_uitslagen.py v0.5.1

Test-hulpscript dat wedstrijden via een gemengde flow invult, inclusief KO-trekking tussen fases en sync- verificatie tussen knockout en wedstrijd_schema.

Werking poule-fase (v0.4):

• Per poule de eerste 5 wedstrijden via productie-flow: POST /wedstrijden + PUT /sets + PUT /akkoord.
• De overige 10 per poule via WL-shortcut: POST /wedstrijden/{schema_id}/eindstand.
• Productie-wedstrijden krijgen 4 random echte spelers per team uit de DB, zodat ratings doorwerken op Persoonlijk (spelersresultaten).
• WL-wedstrijden hebben geen spelers — by design van de backend (eindstand-pad slaat alleen sets-totaal op).
• 9-9 eindstanden zijn toegestaan in het WL-poule-pad.
• Doorlooptijd staat in het run-rapport (sectie 1 + per fase).

Vereisten:

• Backend draait op http://localhost:8000
• Schema is geïmporteerd via importeer_seizoen.py

CLI-parameters

💡 Let op: schrijf de fase en -1 aan elkaar (AF-1, niet AF -1). Met spatie ertussen wordt -1 als losse optie gezien en faalt het script.

Geldige fases: poule, AF, KF, HF, BF (BF-1 niet ondersteund — bekerfinale is één wedstrijd).

• Productie-pad: vaste game-score 11-7, random welk team wint per game
• Productie-pad: 4 random echte spelers per team uit de DB (geen synthetische A1-A4/B1-B4 meer)
• WL-pad: alleen eindstand-totaal, geen spelers, geen individuele sets — 9-9 toegestaan
• Idempotent: skip wedstrijden waar akkoord_thuis al gevuld is

Output: rapport in Rapporten/run_vul_uitslagen_YYYYMMDD_HHMM.md, inclusief doorlooptijd in sectie 1 + per fase.

Aanbevolen testvolgorde

1. Verse import

   python Import/importeer_seizoen.py --execute --ook-opschonen

   Verwacht: 8 poules, 48 teams, 120 poule-rijen, 15 KO-rijen (alle KO nog NULL teams).
2. Backend herstarten (uvicorn)

   python -m uvicorn backend.main:app --reload

   Vereist na backend-wijzigingen.
3. Poule-fase

   python Import/vul_uitslagen.py --alleen poule

   Verwacht: 120 wedstrijden gespeeld (40 via productie- flow + 80 via WL-shortcut); sectie 5 in run-rapport leeg; doorlooptijd ~30-60s in sectie 1.
4. Tot en met AF (laatste leeg)

   python Import/vul_uitslagen.py --tm AF-1

   Verwacht: poule al ingevuld, 7 AF gespeeld + 1 overgeslagen.
5. Laatste AF + KF-trekking

   python Import/vul_uitslagen.py --alleen AF

   Verwacht: 1 AF nieuw gespeeld, 7 al ingevuld, KF-rijen krijgen team-id's.
6. Hele competitie afmaken

   python Import/vul_uitslagen.py --tm BF

   Verwacht: KF + HF + BF gespeeld, sync-tabellen voor 1/4, 1/2, finale.

Bijzonderheden poule-test

• Verdeling per poule: 5 wedstrijden via productie-flow, 10 via WL-shortcut. Totaal: 40 productie + 80 WL = 120 wedstrijden.
• Genereert in de DB: 120 wedstrijd-rijen, 720 set_uitslag-rijen (alleen productie-pad: 40 × 18), 120 eindstand-rijen, 320 wedstrijd_speler-rijen (alleen productie-pad: 40 × 8).
• Productie-wedstrijden gebruiken echte spelers met ratings, dus Persoonlijk (spelersresultaten) is gevuld na een poule-run.
• Looptijd ordegrootte ~30-60 seconden (afhankelijk van API-snelheid). Doorlooptijd staat in sectie 1 en per fase in het run-rapport.
• Sectie 5 in run-rapport blijft leeg (geen KO-rijen geraakt).
• Per-wedstrijd validatie (7 checks per wedstrijd) wordt samengevat aan het eind.
• Bij slechte API-snelheid kan een individuele wedstrijd 1+ seconde kosten — geen circuit-breaker, het script gaat door.

Visuele checklist na een poule-test

Twee weergaven met dezelfde checks, anders gegroepeerd. Klik op een knop om te wisselen.

Troubleshooting

python -m uvicorn backend.main:app --reload

Versies

• v0.5 — 9-9-scenario per KO-fase (beslissend dubbel) + 2 negatieve PUT /eindstand-tests per KO-fase
• v0.4 — doorlooptijd-logging, 9-9 toegestaan in WL-poule, echte spelers in productie-pad, verdeling 5+10 per poule
• v0.3 — quick-wins + WL-shortcut voor poule (was 2+13)
• v0.2 — CLI-parameters voor fase-selectie + KO-sync verificatie per fase
• v0.1 — één hardcoded poulewedstrijd