Updates & Roadmap

Taak

Geef een deelnemer de mogelijkheid om in het profiel (onder e-mail) zijn/haar veteranen-categorie te zien en te zetten voor het huidige seizoen en het komende seizoen. Vooral relevant rond de eerste licentierun van een seizoen, zodat de categorie in de maanden ervoor goed wordt getoond op survivalrunprestaties.nl.

Regels

• Huidig seizoen alleen bewerkbaar als er nog GEEN licentie-uitslag dat seizoen is; komend seizoen altijd bewerkbaar.
• Zodra er een licentie-uitslag in een seizoen is: uitslag is leidend, waarde wordt daaruit gecorrigeerd en het veld wordt read-only.
• Keuze nooit lager dan bewezen (never get younger): alleen huidige bracket of hoger.
• De keuze stuurt ook de PUBLIEKE weergave (sub_category_vet op de inschrijvingen), net als de auto-afleiding van #129. Keuze wint van auto-afleiding.

Relatie

Bouwt voort op #129 (auto-afleiding doorstroming). Deelt het sub_category_vet-mechanisme en de crawl-bestendige her-toepassing na de nachtelijke aggregatie. Lost o.a. de Kerst-Wind-gevallen op die de zekere auto-afleiding mist.

User story

Als lid van meerdere clubs wil ik zelf kunnen kiezen voor welke club ik meetel in het verenigingsklassement, zodat ik voor de juiste club scoor in plaats van automatisch voor de eerste.

Acceptatiecriteria

• In mijn profiel, sectie Club, verschijnt - zodra ik lid ben van meer dan één club - een keuzeveld "Tel mee voor club (klassement)".
• Ik kies één van mijn clubs als voorkeursclub. Laat ik het leeg, dan val ik terug op de eerste club (bestaand gedrag).
• Het keuzeveld verschijnt en verdwijnt live terwijl ik clubs toevoeg of verwijder. Kies ik een club die ik daarna verwijder, dan vervalt de keuze automatisch.
• Mijn keuze raakt alleen het verenigingsklassement. Bij het filteren op clubleden blijf ik onder al mijn clubs zichtbaar.
• Een wijziging wordt in de nachtelijke verwerking doorgevoerd. Het verenigingsklassement klopt de volgende dag, ook op al afgeronde (definitieve) wedstrijden.

User Story

Als bezoeker wil ik op de homepage de eerstvolgende runs zien, inclusief uitklapbare inschrijf-categorieën,zodat ik snel zie welke runs eraan komen en me gericht kan inschrijven voor de juiste categorie.

Acceptatie Criteria

• Op de homepage is een blok met de eerstvolgende runs zichtbaar.
• De runs staan op volgorde van datum, met de eerstvolgende bovenaan.
• Een run telt mee als "aankomend" tot 17:00 uur op de dag van de run; daarna verdwijnt deze uit het overzicht.
• Elke run is uit- en in te klappen, zodat ik alleen de runs zie die ik wil bekijken.
• Meerdere runs kunnen tegelijk openstaan, los van elkaar.
• Ingeklapt zie ik minimaal de naam en datum van de run; uitgeklapt verschijnen de inschrijf-categorieën.
• Per run worden de beschikbare inschrijf-categorieën als overzichtelijke labels getoond.
• Door op een categorie te klikken kom ik direct bij de inschrijving of informatie voor die specifieke categorie.
• De categorienamen zijn overal op het platform hetzelfde, zodat ze herkenbaar blijven.
• Het blok werkt prettig en leesbaar op mobiel.

Als ingelogd lid wil ik op de homepage de top-5 van het verenigingsklassement van de laatste run zien zodat ik de clubstand volg

Verenigingsklassement-blok: laatste run met berekend SrpClubRanking (type_filter ALL), top 5 met clublink + deeplink naar run-uitslag, 'volledig klassement'-link, auth-gate met login-fallbackblok voor gasten.

Onderdeel: Homepage, Kalender, Klassement-pagina & Platform - complexiteit M.

User Story

Als gebruiker wil ik dat voorlopige uitslagen direct worden meegenomen in het klassement en de prognose, zodat ik na een wedstrijd meteen de actuele tussenstand en verwachte posities kan bekijken.

Acceptatiecriteria

• Resultaten met status VOORLOPIG worden meegenomen bij de berekening van het klassement (niet alleen DEFINITIEF).
• De prognose houdt rekening met voorlopige resultaten, zodat een deelnemer na een gelopen wedstrijd niet onterecht wegzakt in de ranking.
• Wanneer een voorlopige uitslag later definitief wordt, wordt het klassement bijgewerkt zonder dubbeltelling.
• Op de frontend is zichtbaar of een meegenomen resultaat voorlopig of definitief is.

User story

Als ingelogde survivalrunner wil ik kort na het einde van het seizoen een persoonlijke, Spotify-Wrapped-achtige terugblik als pop-up zien, zodat ik mijn hoogtepunten herbeleef, mijn progressie en klassementen zie, en gemotiveerd raak voor volgend seizoen.

Wanneer verschijnt het

• De wrap-up van een seizoen wordt onthuld 1 dag na de laatste licentierun van dat seizoen (uitslagen zijn binnen, maar lopers genieten er de dag erna al van). Daarvoor is er niets te zien.
• Voor elke ingelogde gebruiker met een gekoppeld lid en minimaal 2 uitgelopen runs (FINISHED) in dat seizoen.
• Verschijnt eenmalig automatisch; daarna altijd te heropenen via de menu-link "Mijn seizoen 'JJ/'JJ".
• Een lid dat zich net aanmeldt of koppelt krijgt de wrap-up direct te zien (on-demand gegenereerd), zonder te wachten op de nachtelijke batch.
• Sta je nog ingeschreven voor komende runs van dit seizoen, dan krijg je na je laatste run een verse wrap-up die opnieuw automatisch opent.
• Achter een feature-flag (season_wrapped.enabled) zodat hij per omgeving aan of uit kan.

Slides

1. Cover met naam, seizoen en badge (categorie).
2. Motiverende samenvatting, passend bij niveau-toon, prestatieverloop en eventuele mijlpaal. Duizenden unieke varianten, deterministisch per loper, NL en EN.
3. Deelnames (aan de start verschenen).
4. Uitgelopen runs en bandjes (FINISHED; bandje = alle hindernissen gehaald).
5. Verdeling per type: licentie (kort/midden/lang, niet bij de jeugd) en recreatief (kort/midden/lang x individueel/groep), inclusief DNF.
6. Beste punten (licentie en recreatief). Meerdere wedstrijden met exact dezelfde topscore worden als groep getoond (tot 3, met "en nog X meer").
7. Hoogste klasseringen (licentie en recreatief, algemeen en veteranen). Gelijke beste klasseringen (bijv. 2x 1e) worden als groep getoond.
8. Podia per licentiecategorie (goud/zilver/brons plus veteranenpodia) en recreatief.
9. Grootste sprong (periode met de meeste vooruitgang in punten).
10. Pittige periode (laagste puntentotaal of mindere fase).
11. Tegenover vorig seizoen (finishes, bandjes, oordeel beter/minder/gelijk).
12. Niveau per type: gemiddelde punten per licentietype, jaar-op-jaar.
13. Seizoen in grafiek: puntenverloop per discipline.
14. Kilometers en kaart van Nederland (heen en terug vanuit de woonplaats) plus aantal locaties.
15. Seizoensklassement per categorie: positie, veldgrootte en de jaar-op-jaar verschuiving. Alleen als je minstens 75% van de tellende runs liep; de jaar-vergelijking alleen als je vorig seizoen ook 75% haalde.
16. Clubklassement (clubs met meer dan 10 leden): jouw club en positie.
17. Nog ingeschreven (optioneel): sta je nog ingeschreven voor komende runs, dan een aparte slide dat je na je laatste run een verse wrap-up krijgt.
18. Slot: persoonlijke afsluiter met naam, concrete hoogtepunten en een motiverend slotwoord.
19. Deelkaart: deelbare samenvattingskaart (archetype, kerncijfers, beste posities, podia, eigen klassement en clubstand).

Toon en variatie

De teksten worden deterministisch samengesteld uit losse fragmenten (stabiel per loper, niet elke keer anders) en bestaan zowel in NL als EN.

• Niveau-toon: youth_kid, youth_teen, beginner, recreant, license, elite (landelijke top), vet_woman (veteranen-vrouw in de licenties), veteran.
• Prestatieverloop: breakthrough, steady_climb, consistent, dominant, dip_recovery, tough_season, first_season (echte nieuwkomer), few_runs (ervaren loper met weinig data).
• Mijlpalen: de eerste keer dat je een KSR, MSR of LSR met bandje uitloopt wordt gevierd in de samenvatting (LSR is een topprestatie).

Acceptatiecriteria

• De wrap-up verschijnt eenmalig als pop-up voor elke ingelogde gebruiker met een gekoppeld lid en minimaal 2 uitgelopen runs in het afgesloten seizoen; daarna te heropenen via een menu-link.
• Onthulling pas 1 dag na de laatste licentierun van het seizoen; daarvoor bestaat er geen payload en is er niets te tonen.
• Meerdelige, mobile-first slide-weergave; de deelkaart is op te slaan als afbeelding.
• De toon verschilt zichtbaar per niveau-toon en per prestatieverloop; landelijke toppers en zeldzame profielen (veteranen-vrouw in de licenties) krijgen een eigen, herkenbare toon.
• Statistieken per seizoen uit de officiele uitslagen; alleen FINISHED telt als uitgelopen; XXX-placeholders en DNS tellen niet mee (DNS mag wel benoemd worden).
• Jeugd (JSR) krijgt geen kort/midden/lang-splitsing in de licentie-sectie.
• Beste runs op punten en op positie tonen naam en datum van de wedstrijd; gelijke topscores en gelijke beste klasseringen worden als groep getoond.
• Seizoensklassement en clubklassement volgen de drempels (75% van de tellende runs; club groter dan 10 leden).
• Nette terugval-teksten voor lopers met weinig data (geen nieuwkomer-toon bij een ervaren loper).
• Duizenden unieke samenvattingen en slotteksten, deterministisch per loper, in NL en EN, allemaal via taalbestanden.
• Een gebruiker ziet alleen de eigen wrap-up (backend-guard, abort 403).

User story

Als bezoeker wil ik per wedstrijd een overzichtelijke landingspagina waarop alles over die run samenkomt (inschrijvingen, uitslagen, historie over de jaren, het verenigingsklassement en straks foto's en filmpjes), zodat ik niet meer tussen losse pagina's hoef te wisselen en een run als geheel kan beleven.

Achtergrond

Op dit moment bestaat een run alleen als selectie (?run_id=X) op de losse pagina's /uitslagen en /registrations; er is geen centrale pagina per run. Deze user story maakt die hub en wordt de container waarin twee andere user stories als sectie landen: de historie over de jaren (issue #102) en het verenigingsklassement (issue #27). Het verenigingsklassement (#27) wordt bewust pas gebouwd nadat deze landingspagina er staat.

Layout-voorstel t.o.v. de huidige structuur

/run/{run_id}/{slug?}  ->  RunController@show

[ HERO: locatie, datum, organisator, status (toekomst: header-foto + beschrijving) ]
[ sticky sectie-nav: Uitslagen | Inschrijvingen | Klassement | Historie | Media ]

  Uitslagen              (hergebruik ResultsController-logica)
  Inschrijvingen         (hergebruik RegistrationController-logica)
  Verenigingsklassement  (deze run)            -> issue #27
  Historie / over de jaren                     -> issue #102
  Media (foto's, filmpjes)                     -> toekomst

De landingspagina wordt de hub voor een run. De bestaande pagina's /uitslagen en /registrations blijven bestaan als filterbare views (en als render-engine die de secties hergebruiken) en krijgen een knop naar de volledige run-pagina.

Acceptatiecriteria

• Er is een publieke route /run/{run_id}/{slug?} die een landingspagina per run-editie toont.
• De pagina heeft een hero met locatie, datum, organisator en status, en een sticky sectie-navigatie met anchors.
• Secties: Uitslagen, Inschrijvingen, Verenigingsklassement (deze run), Historie / over de jaren, en Media.
• De secties Uitslagen en Inschrijvingen hergebruiken de bestaande logica van ResultsController en RegistrationController; geen gedupliceerde code.
• De bestaande pagina's /uitslagen en /registrations blijven bestaan en krijgen een knop naar de volledige run-pagina.
• Kalender, de run-dropdown en zoekresultaten linken naar /run/{run_id}.
• De sectie Historie toont de cross-editie inhoud uit issue #102 (categorieen per jaar, winnaars, zwaarte-indicatie) of linkt ernaar.
• De sectie Verenigingsklassement toont het clubklassement van die run (gevuld door issue #27).
• Alle nieuwe teksten via __() met entries in nl.json en en.json.

Niet in scope (mogelijke sub-stories)

• Media-velden op de run (afbeeldingen, filmpjes, beschrijving): vergt een migratie op srp_run of een aparte srp_run_content-tabel.
• De volledige uitwerking van de historie-sectie: dat is issue #102.
• De berekening en weergave van het verenigingsklassement: dat is issue #27.

User story

Als bezoeker van Survivalrunprestaties wil ik een ranglijst van verenigingen op basis van de prestaties van hun leden, zodat ik kan ontdekken welke club het sterkst presteert en clubs een (onofficiele) onderlinge competitie krijgen om mee te leven en op te scheppen.

Afhankelijkheid

Deze user story wordt pas gebouwd nadat de run-landingspagina bestaat (zie issue #105). Het verenigingsklassement landt namelijk als vaste sectie op die landingspagina, naast een eigen overzichtspagina en een sectie op de clubpagina.

Waar het klassement zichtbaar wordt

• Eigen overzichtspagina /verenigingsklassement: de volledige ranglijst met filters.
• Sectie op de run-landingspagina (issue #105): het verenigingsklassement van die run.
• Sectie op de clubpagina /club/{id}: hoe deze club presteert over runs en seizoenen heen (rang, scoreopbouw, bijdragende lopers).

Acceptatiecriteria

• Per club wordt minimaal getoond: rang, clubnaam, totaalscore, aantal scorende lopers, aantal meegetelde runs.
• De score is gebaseerd op de punten per run uit de database, voor zowel licentie- als recreatieve categorieen.
• De berekening combineert kwaliteit (gemiddelde punten) en breedte (aantal scorende lopers), zodat een kleine club met een topper en een grote middelmatige club allebei eerlijk meedoen.
• Standaardweergave is het lopende seizoen. Filters: seizoen (lopend + historisch) en type/afstand (alle, alleen licentie, alleen recreatief, of specifiek LSR/MSR/KSR/JSR/BSR).
• Per club is doorklikken mogelijk naar een transparant detailoverzicht: welke lopers met hoeveel punten hebben bijgedragen, plus de opbouw van de score (kwaliteit, aantal lopers, breedte-factor).
• Het klassement wordt dagelijks gerefresht in een cache-tabel na de nightly aggregate (analoog aan srp_prognose_ranking), niet live per pagebezoek.
• Lopers zonder gekoppelde club tellen niet mee.
• Alle nieuwe teksten via __() met entries in nl.json en en.json.

Besloten keuzes (na overleg met de reporter)

• Punten per loper per run: het hoogste resultaat per run telt (sub_categorieen niet optellen; max van hoofdklasse en veteraan).
• Veteranenpunten: in hetzelfde klassement, zoveel mogelijk samengevoegd (geen aparte tab).
• Categorieen: recreatief, KSR, MSR, LSR (en JSR/BSR) samen op een hoop = de beste allround vereniging. Uitsplitsen per type blijft een optioneel filter.
• Schaal: absolute score van 0 tot 1000, zodat de afstand tussen clubs zichtbaar is.
• Clubswitchers: punten worden toegerekend aan de club waar de loper op de wedstrijddag lid van was (historisch correct, maakt historie en stijgers/dalers mogelijk).
• Groeps- en koppelruns: een team waarvan alle leden bij dezelfde club horen telt als 1 loper-deelname (1x de punten); een team uit meerdere clubs geeft elke betrokken club de punten 1x.
• Drempel: een club telt pas mee vanaf een minimum aantal scorende lopers en runs (exacte waarden tunebaar).

Score-formule (voorstel, tunebaar)

De score combineert kwaliteit en breedte en blijft op de 0-1000 schaal:

• Kwaliteit K = gemiddelde van het beste resultaat per loper-deelname = som(punten) / aantal deelnames (0-1000).
• Breedte-factor B = min(1, log(1 + aantal scorende lopers) / log(1 + N_ref)), met N_ref bijvoorbeeld 40 (waarde 0-1, absoluut).
• Totaalscore = K × (β + (1 - β) × B), met β bijvoorbeeld 0.5.

Voorbeeld: een club met 1 topper (gem. 950) komt op ~513, een club met 25 lopers (gem. 650) op ~611, en een club met 60 lopers (gem. 500) op ~500. De gebalanceerde club wint; zowel de eenzame topper als de grote middelmatige club scoren lager. Bij elke club tonen we K, het aantal lopers en B, zodat zichtbaar is waarom een club die plek heeft.

Niet in scope

• Officiele SBN-erkenning; dit blijft een onofficieel klassement.
• Realtime updates tijdens wedstrijden; dagelijks bijwerken is voldoende.
• Prijzen of badges; dit is in eerste instantie alleen een ranglijst.

User story:

Als ingelogde gebruiker van survivalrunprestaties.nl wil ik meldingen ontvangen wanneer iemand die ik volg zich registreert voor een run of wanneer zijn of haar resultaten beschikbaar zijn, zodat ik altijd op de hoogte ben van de activiteit van de deelnemers die ik interessant vind.

Acceptatiecriteria:

• Een ingelogde gebruiker kan in zijn notificatie-instellingen een standaardvoorkeur instellen voor meldingen bij gevolgde deelnemers: aan of uit.
• De standaardinstelling geldt voor alle gevolgde deelnemers, maar kan per individuele volger worden overreden.
• De gebruiker ontvangt een melding wanneer een gevolgde deelnemer zich registreert voor een run.
• De gebruiker ontvangt een melding wanneer resultaten beschikbaar zijn voor een run waaraan een gevolgde deelnemer heeft meegedaan.
• Meldingen zijn instelbaar per kanaal (bijv. e-mail, pushmelding of in-app notificatie), afhankelijk van wat het systeem ondersteunt.
• De notificatie-instellingen zijn bereikbaar vanuit het dashboard en/of de profielpagina.
• De pagina is responsive en werkt op zowel mobiel als desktop.

User story:

Als gebruiker van survivalrunprestaties.nl wil ik op de uitslagen-, registraties- en klassementspagina meteen kunnen zien welke rij van mij is (en als ik via een mail-link binnenkom: welke rij van de gevolgde deelnemer is), zodat ik niet hoef te scrollen of zoeken.

Acceptatiecriteria:

• Op de pagina's /uitslagen, /registraties en /klassement krijgt mijn eigen rij (gekoppelde member van de ingelogde user) standaard een afwijkende achtergrondkleur.
• Een GET-parameter ?highlight=ID (of komma-gescheiden ?highlight=ID1,ID2) markeert ook de meegegeven member-id's.
• Eigen rij EN meegegeven highlights zijn beide actief (additief, niet exclusief).
• De "Bekijk uitslag/registratie"-knop in de e-mailnotificaties van de volg-functie geeft de gevolgde member-id's mee als highlight-parameter, zodat de ontvanger direct ziet om wie het gaat.
• Werkt ook voor niet-ingelogde bezoekers via alleen de URL-parameter.
• Responsive (zowel mobiel als desktop een duidelijk leesbare highlight).

Als bezoeker van de site
wil ik bij elke deelnemer zijn of haar avatar zien in de overzichten van uitslagen, klassement en inschrijvingen,
zodat ik personen die ik ken meteen visueel herken zonder dat ik op de naam hoef te klikken.

Acceptatiecriteria

• In de uitslagen-tabel wordt voor de naam van de deelnemer een kleine avatar getoond, mits de deelnemer een profielfoto heeft ingesteld.
• In de klassement-tabel wordt voor de naam van de deelnemer een kleine avatar getoond, mits de deelnemer een profielfoto heeft ingesteld.
• In de inschrijvingen-/registraties-tabel wordt voor de naam van de deelnemer een kleine avatar getoond, mits de deelnemer een profielfoto heeft ingesteld.
• Wanneer een deelnemer geen avatar heeft ingesteld, blijft het huidige gedrag zonder afbeelding behouden (of een neutrale placeholder, consistent met de rest van de site).
• De avatar wordt inline en klein weergegeven (rond, vergelijkbaar met de avatar in de navigatiebalk) zodat de leesbaarheid en compactheid van de tabellen niet wordt aangetast.
• Werkt zowel in de desktop-tabellen als in de mobiele kaartweergave.
• Avatars worden alleen getoond wanneer de deelnemer een gekoppeld user-account heeft met een ingestelde profielfoto, om extra queries en lege placeholders te voorkomen.

User story

Als deelnemer wil ik dat de prognose ook na 7 gelopen runs blijft meebewegen op basis van mijn nog komende inschrijvingen, zodat het verwachte klassement realistisch blijft wanneer ik mijn slechtste scores naar verwachting nog ga verbeteren.

Achtergrond

Het klassement telt de beste 7 scores. Zodra een lid 7 runs heeft gelopen verandert het puntentotaal in de prognose niet meer, ook niet als er nog runs op de planning staan waarop de score waarschijnlijk verbeterd wordt. Hierdoor onderschat de prognose het uiteindelijke klassement van leden die nog runs voor de boeg hebben.

Acceptatiecriteria

• Voor elk lid met 7 of meer gelopen runs wordt per nog openstaande inschrijving een verwachte score ingeschat (op basis van eerdere prestaties van het lid en/of de gemiddelde score op die run).
• Als de verwachte score van een geplande run hoger is dan de huidige laagste score in de top 7, wordt die laagste score in de prognose vervangen door de verwachte score.
• De prognose toont het bijgewerkte puntentotaal en het bijbehorende klassement op basis van deze projectie.
• De projectie wordt opnieuw berekend bij elke draai van app:calculate-prognose.
• Leden zonder geplande runs behouden hun huidige prognose ongewijzigd.
• De wijziging geldt voor alle disciplines (LSR, MSR, KSR, BSR, JSR).
• Voeg een vraagteken toe achter de kolom header "Prog" met de tooltip die uitlegt hoe de prognose wordt berekend (in jip en janneke taal)

User story:

Als ingelogde gebruiker van survivalrunprestaties.nl wil ik andere deelnemers kunnen volgen en een persoonlijk overzicht zien van hun aankomende runs en resultaten, zodat ik eenvoudig de prestaties kan bijhouden van de mensen die ik interessant vind.

Acceptatiecriteria:

• Een ingelogde gebruiker kan deelnemers zoeken en volgen, en ook weer ontvolgen via een dedicated pagina (bijv. /mijn-volgers of /following).
• Op het dashboard is een duidelijk blok zichtbaar met een knop naar deze pagina.
• De volgpagina bestaat uit drie secties:
  • Mensen die ik volg (met zoek- en aan/afvinkfunctie).
  • Aankomende runs waar minimaal één gevolgde deelnemer aan meedoet, met highlight als de ingelogde gebruiker zelf ook is ingeschreven.
  • Resultaten waar minimaal één gevolgde deelnemer aan heeft meegedaan.
• Bij de sectie "Mensen die ik volg" is ook een sectie "Mensen die mij volgen" zichtbaar.
• Bij het openen van een run (inschrijvingen/registratie) is in de filteropties een checkbox "Alleen mensen die ik volg" beschikbaar.
• Bij het openen van resultaten van een run is dezelfde filteroptie "Alleen mensen die ik volg" beschikbaar.
• De filteroptie is voor niet-ingelogde gebruikers grijs weergegeven met een tooltip: "Meld je aan om gebruik te maken van deze functie".
• De pagina is responsive en werkt op zowel mobiel als desktop.

Uitbreiding: e-mailnotificaties voor gevolgden

• Voor elke gevolgde deelnemer kan ik 3 onafhankelijke e-mailnotificaties in/uitschakelen (default aan):
  • Eerste uitslag (voorlopig of definitief) bekend - mail toont run, datum, categorie, ranking en tijd.
  • Eerste inschrijving voor een aankomende run - mail toont run, datum en categorie.
  • Eerste bekendmaking van starttijd - mail toont run, datum, categorie en de starttijd.
• Mails worden alleen verstuurd bij eerste bekendmaking; updates van hetzelfde event leiden niet tot herhaling.
• Per type is er een globale toggle (bijv. "alle uitslag-notificaties uit") die de per-volger toggles overschrijft.
• Bulk-knop "alle notificaties van mijn gevolgden uitzetten" zet in één klap alle globale toggles en alle per-volger toggles uit.
• Mails worden gegroepeerd per (gebruiker, run, type): meerdere gevolgden in dezelfde run leveren één digest-mail op.
• Op dev.survivalrunprestaties.nl mogen deze mails NOOIT naar echte gebruikers; de bestaande MAIL_OVERRIDE_TO-listener moet werken voor deze nieuwe mailables (verifieerbaar via testgebruiker-mailbox).

User story

Als gebruiker van Survivalrun Prestaties wil ik kunnen vertrouwen op de getoonde wedstrijdgegevens, zodat ik mijn eigen prestaties en die van anderen betrouwbaar kan volgen.

Wat is er nieuw in versie 1.0

Dit is de eerste stabiele release van Survivalrun Prestaties. Naast de bestaande crawl van uvponline.nl wordt de data nu ook gecontroleerd via een directe koppeling met de Survivalrun Bond Nederland (SBN). Verschillen tussen beide bronnen worden gesignaleerd, zodat de getoonde uitslagen en inschrijvingen extra betrouwbaar zijn.

Acceptatiecriteria

• Stabiele crawl van wedstrijdkalender, uitslagen en inschrijvingen.
• Extra controle via koppeling met de bond (SBN API), met automatische signalering van verschillen.
• Zichtbaar als versie 1.0 in de publieke roadmap.

User story

Als ingelogde gebruiker wil ik mijn woonplaats kunnen aanpassen via mijn profielpagina, zodat mijn correcte woonplaats wordt getoond bij mijn resultaten en inschrijvingen.

Acceptatiecriteria

• Op de profielpagina staat een veld "Woonplaats" onder de naam.
• Bij opslaan wordt zowel users.city als srp_member.place bijgewerkt.
• De woonplaats in alle bestaande aggregated results wordt direct gesynchroniseerd.
• Het veld is optioneel (nullable).

User Story

Als gebruiker wil ik dat gekozen filters (categorie, geslacht) behouden blijven wanneer ik van wedstrijd wissel, zodat ik niet steeds opnieuw hoef te filteren.

Daarnaast moet het veteranenfilter automatisch verborgen worden bij categorieën waar het niet van toepassing is (zoals JSR).

Acceptatiecriteria

• Categorie- en geslachtsfilters blijven actief bij het wisselen van wedstrijd
• Het veteranenfilter is alleen zichtbaar bij categorieën met veteranenklassementen
• Categorieën die niet beschikbaar zijn voor de geselecteerde wedstrijd worden als niet-kiesbaar getoond

User story:

Als bezoeker en ingelogde gebruiker van survivalrunprestaties.nl wil ik de historische en huidige klassementen van de Survival Run Bond kunnen raadplegen, en wil ik als ingelogde gebruiker op mijn dashboard mijn eigen ranking per jaar en categorie zien, zodat ik de ontwikkeling van mijn prestaties over de jaren heen kan volgen en mezelf kan vergelijken met andere licentielopers.

Acceptatiecriteria:

• De klassementen van survivalrunbond.nl worden gecrawld en opgeslagen, zowel historisch (vanaf 2007-2008) als het huidige seizoen (2025-2026).
• De te crawlen URL's zijn:
  • Historisch: https://survivalrunbond.nl/historie-klassementen/klassement-2007-2008/ t/m het laatste historische seizoen.
  • Huidig: https://survivalrunbond.nl/klassement-2025-2026/
• De gecrawlde klassementen zijn alleen van toepassing op licentieruns.
• Elk klassement krijgt een eigen pagina op survivalrunprestaties.nl, per seizoen en uitgesplitst per categorie en subcategorie.
• De klassementen worden periodiek opnieuw gecrawld zodat het huidige seizoen actueel blijft.
• Een ingelogde gebruiker heeft op zijn dashboard een sectie of aparte pagina waarop zijn eigen ranking per seizoen, per categorie en subcategorie wordt getoond.
• De rankingpagina toont de historische ontwikkeling van de gebruiker over meerdere seizoenen.
• De pagina is responsive en werkt op zowel mobiel als desktop.
• Personen die anoniem willen blijven, niet in het klassement terecht komen

Beschrijving

Deelnemers kunnen zich inschrijven met een afwijkende naam (bijv. zonder tweede voornaam, met/zonder accent). Hierdoor worden inschrijvingen soms niet correct gekoppeld aan het juiste profiel.

Oplossing

Er is een alias-systeem toegevoegd waarmee alternatieve namen aan een deelnemer gekoppeld kunnen worden. Bij het crawlen van inschrijvingen wordt nu ook in de alias-tabel gezocht als een directe naammatch niet lukt.

Hoe te gebruiken

• Als ingelogde gebruiker: ga naar Profiel en voeg aliassen toe onder Naamaliassen.
• Als admin: ga naar Beheer > Deelnemers > Bewerken en voeg aliassen toe in de sectie Aliassen.

Na het toevoegen van een alias worden toekomstige crawls automatisch correct gekoppeld. Voor bestaande inschrijvingen moet de betreffende run opnieuw gecrawld worden.

Beschrijving

Zie koppelrun Bathmen bijvoorbeeld. De personen staan niet onder de juiste koppelnaam

User Story

Klein detail, de hardloop-icoontjes staan in de verkeerde richting en zouden gespiegeld 'moeten' worden. :-)

User Story:

Als ingelogde gebruiker wil ik via mijn deelnemersdashboard kunnen melden dat bepaalde gegevens niet kloppen en bij welke run dit het geval is, zodat de beheerder dit kan controleren en corrigeren.

User story:

Als bezoeker van survivalrunprestaties.nl wil ik bij een aankomende licentierun een prognose ranking zien van ingeschreven deelnemers op basis van hun huidig klassement en eerder behaalde resultaten, zodat ik vooraf kan inschatten hoe de startnummerverdeling er naar verwachting uit zal zien voordat de officiële startnummers (ongeveer een week) voor de run bekend worden gemaakt.

Acceptatiecriteria:

• De prognose ranking is zichtbaar op de pagina van een aankomende licentierun zodra er inschrijvingen bekend zijn.
• De ranking is gebaseerd op het huidig klassement en eerder behaalde resultaten binnen survivalrunprestaties.nl.
• De prognose ranking is duidelijk gelabeld als "prognose" om verwarring met de officiële startnummers te voorkomen.
• Deelnemers zonder klassementsgegevens worden onderaan de ranking getoond of als "ongerangschikt" aangeduid.
• De ranking is filterbaar op categorie (bijv. geslacht, leeftijdscategorie of afstand).
• Zodra de officiële startnummers bekend zijn, wordt de prognose ranking vervangen door of aangevuld met de officiële volgorde.
• De pagina is responsive en werkt op zowel mobiel als desktop.

User Story

Bij de initiele aanmelding kun je een club selecteren. Dat ben ik vergeten, maar bij de optie "profiel aanpassen" kun je je niet alsnog bij een club aanmelden. Kan die optie erbij?

User story:

Als bezoeker van survivalrunprestaties.nl wil ik in de detailweergave van een deelnemer een visualisatie zien waarbij alle finishers als een hardloper-icoontje op een horizontale tijdlijn staan, van snelste (links) tot langzaamste (rechts), zodat ik in één oogopslag zie waar die deelnemer in het deelnemersveld staat — diens icoontje in een afwijkende kleur, de rest in grijs.

Acceptatiecriteria:

• De visualisatie is zichtbaar op drie plekken: bij uitklappen van een deelnemer (mobiel), bij klikken op "Meer details" (desktop), én op de individuele deelnemerspagina.
• De grafiek toont alle finishers als een hardloper/survivalrunner-icoontje op een horizontale tijdlijn.
• Snelste finisher staat links, langzaamste rechts.
• Het icoontje van de bekeken deelnemer is gemarkeerd in een afwijkende kleur (bijv. oranje), alle anderen zijn grijs.
• De grafiek is gefilterd op de relevante categorie (bijv. geslacht, leeftijdscategorie of afstand).
• De grafiek is responsive en werkt op zowel mobiel als desktop.

User Story

Als gebruiker van survivalrunprestaties.nl wil ik via een formulier kunnen aangeven dat mijn gegevens niet gebruikt mogen worden of geanonimiseerd moeten worden, zodat ik zelf controle heb over mijn privacy en zeker weet dat mijn persoonsgegevens niet zichtbaar of herleidbaar zijn binnen het platform.

Acceptatiecriteria:

• Er is een toegankelijk formulier beschikbaar (ook voor niet-ingelogde bezoekers) waarop een gebruiker een privacyverzoek kan indienen.
• De gebruiker kan kiezen tussen twee opties: gegevens volledig verwijderen of gegevens anonimiseren (naam vervangen door een anonieme aanduiding).
• Na het indienen van het formulier ontvangt de gebruiker een bevestiging per e-mail.
• De beheerder van survivalrunprestaties.nl ontvangt een notificatie van het verzoek en kan dit verwerken.
• Bij anonimisering zijn resultaten nog wel zichtbaar in overzichten, maar niet meer herleidbaar tot de persoon.
• Bij volledige verwijdering worden alle persoonsgegevens en resultaten van de gebruiker permanent verwijderd uit het systeem.
• Het formulier en de verwerking voldoen aan de AVG/GDPR-wetgeving.
• De pagina is responsive en werkt op zowel mobiel als desktop.
• De inschrijvingen worden alleen als ingelogde gebruiker getoond op de deelnemers pagina

User Story

De melding om de (web)app te installeren komt bij elke klik naar voren. De website gebruiken zonder installatie is amper meer mogelijk. Dat kan niet de bedoeling zijn lijkt mij. :-)

User Story: Als gebruiker van survivalrunprestaties.nl wil ik een wens kunnen indienen via een formulier, zodat mijn idee terechtkomt in de backlog, anderen erop kunnen stemmen en ik op de hoogte blijf van de voortgang.

Acceptatiecriteria:

1. Er is een pagina of sectie "Wens indienen" bereikbaar via de website.
2. Het formulier bevat de volgende velden:
   • Titel – een korte omschrijving van de wens
   • User story – in de vorm van "Als gebruiker wil ik … zodat …"
   • Details / acceptatiecriteria – verdere toelichting of voorwaarden waaraan de wens moet voldoen
3. Na het indienen ontvangt de gebruiker een bevestiging op het scherm dat de wens is ontvangen.
4. Er wordt automatisch een e-mail gestuurd naar info@survivalrunprestaties.nl met de ingediende gegevens.
5. Er wordt automatisch een issue aangemaakt in het systeem op basis van de ingediende gegevens.
6. De admin kan het issue beoordelen en instellen of het publiekelijk zichtbaar is op de Updates/Roadmap pagina.
7. Zolang een issue niet publiekelijk is gemaakt, is het alleen zichtbaar voor de admin.
8. In het issue is een knop "Update reporter" beschikbaar voor de admin.
9. Via de knop "Update reporter" opent een popup met een WYSIWYG-editor waarmee de admin een bericht kan opstellen.
10. Na verzending ontvangt de gebruiker die de wens heeft ingediend een e-mail met het bericht van de admin.
11. De gebruiker hoeft geen account te hebben om een wens in te dienen, maar vult wel een e-mailadres in zodat updates verstuurd kunnen worden.

User Story

Als gebruiker van survivalrunprestaties.nl wil ik een overzicht zien van wat er is gebouwd en wat er gepland staat, zodat ik weet wat ik de komende tijd kan verwachten.

Acceptatiecriteria

• Er is een publieke pagina /updates bereikbaar via de navigatie
• De pagina toont afgeronde versies met per versie een lijst van opgeleverde issues
• De pagina toont geplande versies met per versie de geplande functionaliteiten
• De huidige versie is visueel gemarkeerd (oranje border en label)
• Afgeronde versies hebben een groene markering, geplande versies een grijze
• Versies worden gesorteerd weergegeven, met de meest recente bovenaan
• Per issue zijn titel, beschrijving, status badge en aantal stemmen zichtbaar
• Subtaken worden als checklist onder het parent issue getoond
• Issues zonder versie verschijnen in een Backlog sectie onderaan
• De informatie komt dynamisch uit de srp_issue tabel (gepubliceerde issues)
• De about-pagina verwijst naar de updates pagina i.p.v. een hardcoded changelog

User Story

Als ontwikkelaar wil ik via een API toegang krijgen tot wedstrijdresultaten en deelnemersgegevens, zodat ik eigen applicaties, analyses of integraties kan bouwen bovenop de data van Survivalrun Prestaties.

Acceptatiecriteria

• Er is een publieke API-documentatie pagina (Swagger/OpenAPI) beschikbaar op /api/documentation
• Ontwikkelaars kunnen API-toegang aanvragen via info@survivalrunprestaties.nl
• Na goedkeuring ontvangt de ontwikkelaar een API-key (Bearer token via Sanctum)
• De API biedt endpoints voor: resultaten, deelnemers (zoeken), wedstrijden, seizoenen en clubs
• De API ondersteunt filtering op seizoen, categorie, datum en deelnemer
• De API heeft rate limiting (bijv. 60 requests per minuut)
• Persoonsgegevens (naam, woonplaats) zijn alleen beschikbaar voor geauthenticeerde API-gebruikers
• De API retourneert JSON met consistente structuur en foutafhandeling

User Story

Als deelnemer wil ik mijn persoonlijke statistieken zien in interactieve grafieken, zodat ik mijn prestaties over tijd kan analyseren en mijn voortgang kan volgen.

Acceptatiecriteria

• De deelnemer kan op zijn/haar profielpagina grafieken bekijken van prestaties over meerdere seizoenen
• Er is een grafiek die punten per wedstrijd toont over tijd (lijn- of staafdiagram)
• Er is een grafiek die rankings per categorie (KSR, MSR, LSR) vergelijkt
• Grafieken zijn interactief: hover toont details, klik filtert op seizoen of categorie
• De grafieken zijn responsive en werken goed op mobiel (PWA)
• Er is een samenvatting met kernstatistieken: totaal aantal runs, gemiddelde punten, beste ranking, aantal podiumplaatsen
• De data laadt snel, ook bij deelnemers met veel resultaten (100+ wedstrijden)

User Story

Als clublid of clubbeheerder wil ik een dashboard waarop ik inschrijvingen en uitslagen van alle clubleden kan bekijken, zodat ik een overzicht heb van de clubprestaties en kan zien wie waar meedoet.

Acceptatiecriteria

• Er is een club-dashboardpagina bereikbaar via de clubpagina
• Het dashboard toont een overzicht van aankomende wedstrijden waar clubleden voor zijn ingeschreven
• Het dashboard toont recente uitslagen van clubleden met ranking, punten en tijd
• Er is een filter op seizoen en categorie (KSR/MSR/LSR)
• Clubbeheerders zien alle leden; gewone leden zien alleen gepubliceerde resultaten
• Er is een totaaloverzicht met clubstatistieken: aantal actieve leden, totaal runs, podiumplaatsen
• De pagina is toegankelijk voor ingelogde gebruikers die aan een club zijn gekoppeld

User Story

Als gebruiker wil ik resultaten en statistieken kunnen exporteren naar Excel en PDF, zodat ik de gegevens offline kan bewaren, delen met anderen of gebruiken voor eigen analyses.

Acceptatiecriteria

• Op de resultatenpagina is een exportknop beschikbaar voor Excel (.xlsx) en PDF
• Op de persoonlijke profielpagina kan een deelnemer zijn/haar eigen resultaten exporteren
• De Excel-export bevat alle kolommen: wedstrijd, datum, categorie, ranking, punten, tijd, type finish
• De PDF-export heeft een nette opmaak met het Survivalrun Prestaties logo en datum van export
• Clubbeheerders kunnen clubresultaten exporteren
• De export respecteert de huidige filters (seizoen, categorie, etc.)
• Grote exports (1000+ rijen) worden asynchroon verwerkt met een downloadlink via e-mail

User story:

Als gast of gewone gebruiker van survivalrunprestaties.nl wil ik een overzichtelijke pagina kunnen raadplegen met de beschikbare API-functionaliteit, zodat ik kan bepalen of de API aansluit bij mijn behoefte en ik een weloverwogen keuze kan maken om toegang aan te vragen.

Acceptatiecriteria:

• Er is een publiek toegankelijke API-documentatiepagina beschikbaar op survivalrunprestaties.nl (bijv. /api of /developers).
• De pagina geeft een helder overzicht van de beschikbare endpoints en wat deze teruggeven (bijv. runs, resultaten, klassementen, deelnemers).
• De pagina toont per endpoint een korte omschrijving, het type data dat beschikbaar is en een voorbeeldresponse.
• De pagina maakt duidelijk dat toegang tot de API op aanvraag beschikbaar is, met een zichtbare knop of link om toegang aan te vragen.
• De documentatie is leesbaar voor zowel technische als niet-technische bezoekers.
• Niet-ingelogde bezoekers kunnen de documentatie volledig inzien zonder account.
• De pagina is responsive en werkt op zowel mobiel als desktop.