📋 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 1. 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 ▶ Invullen om een nieuwe wedstrijd te starten
• Is de wedstrijd al bezig? Klik ▶ Doorgaan om verder te gaan
• Per wedstrijd kun je via de Informatie-knop de adres- en contactgegevens van de thuisvereniging opvragen

Stap 3 — Spelers invullen

• Op tab 2. 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 3. 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
• Typ je 8 en druk op Tab → de tegenscore wordt automatisch op 11 gezet
• 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

• 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))

Klik op tab 1 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

Vragen of problemen?

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

🔧 Instructies Beheerder

Inloggen

• Klik rechtsboven op 🔐 Beheerderweergave
• Voer het beheerwachtwoord in
• Na inloggen verschijnen extra tabs: 0. Instructies (B), 5. Verenigingen, 6. Poule-indelingen, 7. Spelers, 8. Wedstrijdschema en 9. Knock-out
• Met dezelfde knop wissel je tussen gebruikers- en beheerderweergave — handig om snel te zien wat de eindgebruiker te zien krijgt
• De sessie blijft actief tot je de browser sluit

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

Tab 5. 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 in tab 1
• Een vereniging kan pas verwijderd worden als er geen teams meer aan gekoppeld zijn

Tab 6. 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

Tab 7. Spelers

• Spelers worden uitsluitend via deze tab toegevoegd — niet meer via het wedstrijdformulier op tab 2
• 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

Tab 8. Wedstrijdschema

• Wedstrijden plannen: 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)
• ✏️ — wedstrijd inline bewerken
• 🗑 — 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
• Per status verschijnen acties: ▶ Invullen (gepland), ▶ Doorgaan + 👁 Bekijken (nu spelen), 👁 Bekijken (afgerond)
• ↻ Vernieuwen haalt de laatste lijst op

Tab 9. Knock-out

Beheer de knock-out fase na de pouleronde. Genereer automatisch de 1/8 finale koppels op basis van de poulestand, of voeg handmatig koppels toe. Per ronde: 1/8, 1/4, 1/2 finale en Bekerfinale.

Knock-out fase beheren

Knock-out wedstrijden worden automatisch aangemaakt zodra teams bekend zijn na afgeronde poulewedstrijden.

• Achtste finales: nr. 1 en nr. 2 per poule
• Kwart/Halve finales en Finale: winnaar van vorige ronde

Via tab 8 kun je per wedstrijd aanpassen:

• Datum
• Locatie (overruled thuisvereniging)
• Teams (indien nodig)

Wedstrijd ontdooien

Een al afgeronde wedstrijd corrigeren? Open 'm via tab 1 → 👁 Bekijken of tab 7 → 👁 Bekijken en gebruik 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 in tab 2 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 tab 2 staat de groene knop 🧪 TEST: Vul testdata in (alleen beheerder) — vult automatisch 8 spelers en/of scores in
• ⚠️ Deze knoppen moeten verwijderd worden voor productie (zie actielijst)

Naar productie

Open actielijst_bekercompetitie.html in de projectmap voor de openstaande productie-taken: IIS configuratie, SSL-certificaat, CORS instellingen, Windows Service voor uvicorn, etc. (label naar-productie).

🔑 Seizoenscode beheren

Huidige actieve code: laden...

0. 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 in tab 4 (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 tab 4 (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