Updates & Roadmap

Als beheerder van survivalrunprestaties.nl
wil ik dat er automatisch een melding op de site verschijnt zodra er nieuwe content bij een run is geplaatst, waarbij meerdere content-items van dezelfde ronde in een melding worden gecombineerd,
zodat ook bezoekers die geen notificatiemail ontvangen de nieuwe analyses en media zien, en ik daar niet elke keer handmatig een melding voor hoef te schrijven.

Aanleiding

Op 5 september 2026 plaatste een maker twee Survivalrun Analyses (KSR en MSR) bij Grootebroek. De bestaande ronde app:dispatch-run-content-notifications mailde die netjes naar de 19 deelnemers met een opt-in, maar verder gebeurde er niets: de melding op de site moest met de hand geschreven worden. Terwijl juist de melding iedereen bereikt, ook wie de mail niet aan heeft staan.

Acceptatiecriteria

• Wanneer de content-ronde nieuwe, gepubliceerde content bij een run vindt, wordt naast de mails ook automatisch een melding (srp_announcement) aangemaakt.
• Meerdere content-items van dezelfde run in dezelfde ronde leveren een melding op, niet een melding per item.
• De melding noemt de run (locatie en datum), het soort content (analyse of media), en per licentiecategorie de kern (bijv. afstand, zwaarte, voorspelde finishtijd).
• De melding bevat een link naar de runpagina van die run.
• Staat er een bronlink bij de content (bijv. een Instagram-account), dan worden de maker en die link in de melding genoemd.
• Een melding wordt nooit dubbel aangemaakt: draait de ronde opnieuw, dan komt er voor dezelfde content geen tweede melding.
• De looptijd van de melding sluit aan op de wedstrijd: een vooruitblik loopt tot en met de wedstrijddag, een terugblik krijgt een vaste looptijd (voorstel: 14 dagen).
• De melding wordt aangemaakt in een status die de beheerder nog kan nalezen en bijschaven voordat hij live gaat, of hij gaat direct live: deze keuze staat nog open, zie de open vragen.
• Gaat het aanmaken van de melding mis, dan blijft het versturen van de mails gewoon doorgaan (en andersom).

Open vragen

• Gaat de gegenereerde melding meteen live, of komt hij als concept in /admin/meldingen te staan zodat er nog een menselijke blik overheen gaat?
  --> Antwoord: Meteen open
• Voor welk publiek (audience_type): alleen ingelogde gebruikers, of iedereen? Analyses zijn ook interessant voor bezoekers zonder account.
  --> Voor iedereen. Zorg dat als er een bezoeker komt die NIET ingelogd is, je de korte uitleg geeft om een account te maken (met de voordelen). Dit mag je standaard bij elke meldingdoen. Dan is dat dynamisch
• Moet de melding ook verschijnen bij media (foto's/video's), of alleen bij Survivalrun Analyses?
  --> beide

User Story

Als deelnemer die aan een run meedoet of heeft meegedaan wil ik bericht krijgen wanneer er bij die run media of een Survivalrun Analyse wordt geplaatst, en wil ik dat zelf in mijn profiel aan en uit kunnen zetten, zodat ik nieuwe content over mijn eigen wedstrijden niet mis zonder dat ik ongevraagd post krijg.

Achtergrond

Content bij runs (foto's, YouTube-video's, voorbeschouwingen, verslagen, aftermovies en Survivalrun Analyses) is opgeleverd in versie 5.0.0. Op dit moment merkt vrijwel niemand dat dit bestaat: er is geen melding, geen mail en geen attentie op ingericht. Deze story regelt zowel de structurele notificatie als de eenmalige aankondiging.

A. Nieuwe notificatievoorkeur in het profiel

• Bij de bestaande notificaties over mijn eigen runs (1. inschrijving bevestigd, 2. starttijd bekend, 3. uitslag binnen) komt een vierde optie: media of analyse toegevoegd.
• Die ene optie dekt zowel reguliere media als de Survivalrun Analyse. Er komt dus bewust geen apart vinkje per soort.
• De optie staat standaard uit. Een gebruiker moet hem zelf aanzetten.
• Uitzondering bij de uitrol: gebruikers die op dat moment al minstens een van de drie bestaande vinkjes aan hebben staan, krijgen de nieuwe optie automatisch aan. Zij hebben immers al aangegeven mail over hun eigen runs te willen. Gebruikers met alle drie de vinkjes uit blijven ongemoeid en krijgen dus niets.
• De bestaande knop waarmee je in een keer alle eigen-run notificaties uitzet, neemt de nieuwe optie mee.
• Wie de optie aanzet krijgt geen stortvloed aan mails over content die al eerder geplaatst is. Alleen content die na het aanzetten zichtbaar wordt levert een bericht op.

B. Wie krijgt bericht

• Alleen gebruikers die aan die run gekoppeld zijn: ze staan in de inschrijving van die run of hebben er een uitslag. Iemand die de run niet loopt of gelopen heeft krijgt niets, ook niet als hij de nieuwe optie aan heeft staan.
• De gebruiker moet een gekoppelde deelnemer (SBN) hebben. Zonder koppeling is niet vast te stellen of iemand aan de run meedoet, dus geen bericht.
• De nieuwe voorkeur moet aan staan. Staat hij uit, dan geen bericht.
• De maker van de content krijgt geen bericht over zijn eigen bijdrage.
• Over hetzelfde bericht gaat nooit een tweede mail naar dezelfde gebruiker.

C. Wanneer gaat het bericht eruit

• Er draait een keer per dag om 08:00 een cron die kijkt of er nieuwe content zichtbaar is geworden. Alle mails gaan in die ene ochtendronde de deur uit; er wordt niet direct bij het plaatsen gemaild. 08:00 past goed omdat content vaak 's avonds geplaatst wordt: de lezer pakt het dan bij het ontbijt of onderweg op, en het is geen tijdgevoelig bericht zoals een uitslag.
• Content telt pas mee wanneer die publiek zichtbaar is: gepubliceerd en de publicatiedatum bereikt. Vooruit ingeplande content mailt dus in de eerste ochtendronde nadat het geplande moment gepasseerd is, en niet bij het opslaan.
• Alle nog niet gemelde items van dezelfde run gaan samen in een mail. Heeft een tweede content-creator diezelfde dag ook iets bij die run geplaatst, dan lift dat mee in dezelfde mail.
• Wordt er een dag later opnieuw content bij dezelfde run geplaatst, dan gaat er wel een nieuwe mail uit. Per item gaat er dus precies een keer bericht uit; items die in dezelfde ochtendronde vallen worden gebundeld.
• Wordt een bestaand bericht later bewerkt, dan volgt geen nieuwe mail.
• Leeftijdsgrens: de run mag maximaal 4 maanden geleden zijn. Wordt er bij een oudere run alsnog een verslag of aftermovie geplaatst, dan verschijnt die gewoon op de runpagina maar krijgt het deelnemersveld van toen daar geen mail meer over.

D. Inhoud van de mail

• Onderwerp en inhoud maken meteen duidelijk om welke run het gaat (locatie en datum) en wat voor soort content er is, bijvoorbeeld Survivalrun Analyse of aftermovie.
• De titel van het bericht, wie het geplaatst heeft en een korte omschrijving of thumbnail.
• Een duidelijke knop naar de runpagina, naar de plek waar de content staat, met een # zodat je meteen bij de media-sectie of de Survivalrun Analyse-sectie uitkomt.
• Een verwijzing naar de notificatie-instellingen in het profiel, zodat afmelden altijd binnen een klik of twee kan.
• Dezelfde vormgeving en taalinstelling als de bestaande eigen-run mails.

E. Eenmalige aankondiging bij de lancering

• Er komt een melding (banner) op de site voor iedereen, dus ook voor bezoekers die niet zijn ingelogd, dat er bij runs media en Survivalrun Analyses te bekijken zijn, met een link naar een runpagina waar content staat. Type INFO, wegklikbaar, met een einddatum zodat de melding vanzelf verdwijnt. Ook met de uitleg hoe je aanzet dat je op de hoogte gebracht wordt van media bij runs waar je zelf aan meedoet.
• Daarnaast gaat er eenmalig een campagne-mail naar alle gebruikers met een account, dus uitdrukkelijk niet alleen naar wie de nieuwe voorkeur al aan heeft staan. De mail legt uit dat er bij runs media en Survivalrun Analyses staan, welke notificaties je over je eigen runs kunt instellen en hoe je die aanzet.
• Die mail gaat er pas uit nadat de nieuwe media-notificatie in het profiel live staat, zodat iedereen die op de uitleg klikt de schakelaar ook meteen kan omzetten.
• De mail bevat een directe link naar de notificatie-instellingen in het profiel.
• De boodschap richt zich op kijken en instellen, niet op zelf plaatsen. Uitleg over zelf media of een analyse toevoegen blijft in de FAQ staan.
• De hele flow wordt eerst op dev getest, waar de mail-override alle post naar het testadres stuurt.

User Story

Als deelnemer wil ik voor een wedstrijd een Survivalrun Analyse kunnen bekijken waarin het parcours en de zwaarte van die run worden geanalyseerd, zodat ik weet wat me te wachten staat. En als analist wil ik zo'n analyse zelf bij de juiste run en de juiste afstand kunnen plaatsen.

Acceptatiecriteria

• De Survivalrun Analyse is een eigen contentsoort naast de bestaande soorten voorbeschouwing, trailer, verslag en aftermovie.
• Een analyse hoort altijd bij een licentiecategorie (LSR, MSR, KSR of JSR), zodat duidelijk is over welke afstand de analyse gaat.
• Analyses krijgen een eigen sectie op de runpagina, los van de reguliere media.
• Er is een aparte rol voor analisten, los van de rol voor reguliere media. Iemand kan dus analyses plaatsen zonder media-maker te zijn, en andersom.
• Bij een analyse wordt een kleine afbeeldingspreview getoond die met een klik vergroot wordt.
• De maker kan optioneel een bron-URL meegeven, bijvoorbeeld een eigen website of social media, die extern geopend wordt.
• In de lijsten op de homepage, de kalender en de deelnemerpagina is per run te zien of er media en of een analyse beschikbaar is.
• De maker wordt getoond met zijn deelnemersnaam, niet met zijn accountnaam.
• Een beheerder kan content namens iemand anders plaatsen door de maker te kiezen.
• In de FAQ staat hoe je media of een Survivalrun Analyse toevoegt en hoe je daarvoor toegang aanvraagt.

User Story

Als een content creator voor runs, wil ik graag mijn youtube filmpjes en afbeeldingen kunnen koppelen aan een of meerdere runs, zodat ik snel meer mensen bereik die echt mee doen aan de run

Acceptatie Criteria

• Een speciale rol 01-RUN-CONTENT_CREATOR geeft een gebruiker rechten om aan alle runs content toe te voegen. 
• Zorg dat gebruikers meerdere rollen kunnen krijgen. Alle rollen onder de 10, zijn ALTIJD rollen die in combinatie met een andere rol is. Alleen de super admin heeft geen extra rollen nodig om alles te mogen. Maar alle rollen daaronder moeten 01-RUN-CONTENT_CREATOR hebben om content te kunnen CRUD van een run.
• Als de gebruiker naar een run gaat, dan ziet hij de knop "Media toevoegen"
• Hij krijgt dan een edit content pagina met daarin alle gekoppelde content aan de run. Hij of zij kan dan kiezen om zijn of haar eigen content aan te passen, te verwijderen of om er een toe te voegen
• Als de content creater het CRUD scherm opent dan kan hij/zij
  • Een titel toevoegen (max 80 lang)
  • Aangeven of het voor of na de run is (dus is het een inzicht in de hindernissen die gaan komen of is het een filmpje van een gelopen run)
    
    • Vooruitblik
    • Achteraf
  • Een of meerdere youtube filmpjes kunnen toevoegen
  • Een of meerdere PDF bestanden of afbeeldingen kunnen toevoegen
  • Een korte omschrijving
  • Een lange omschrijving
• Een gebruiker (algemeen) kan in zijn of haar profiel ook iets over zich zelf kwijt (WSYIWSY editor) met een extra afbeelding plaats. Deze informatie wordt automatisch getoond onder de content als deze gepubliceerd is
• Een content creator kan een run content publiceren of weer niet publiceren
• Een content creator kan de plaatsing datum aanpassen. Laatst aangepast wordt automatisch bijgewerkt
• Een content creator kan tags toevoegen. In het tag veld worden automatisch de tags getoon die al gemaakt zijn ooit (de content creator kan daar uit kiezen of zelf een tag aanmaken. Bijvoorbeeld #hindernissen, #MSR, #parcours
• Een content creator kan ook een gebruiker taggen. 
• Een gebruiker (algemeen) kan uitzetten dat hij of zij getagged kan worden
• De link "Volledige pagina" moet een veel opvallendere positie krijgen (opvallende kno).  (zie registraties, uitsllagen). De knop moet heten "Run pagina"
• In de home pagina blokken "Recente uitslagen" en "Komende runs" moet ook de een duidelijk knop zichtbaar worden "Run pagina"
• Op de run pagina moet het blok media naar boven geschoven worden (boven vereningsklassement) als:
  • Er voor de run media is toegevoegd met het label "Vooruitblik"
  • OF
  • Er na de run media is toegevoegd met het label "Achteraf"
    
    

Aanvullende acceptatiecriteria (iteratie 2)

• Op de runpagina wordt media getoond als een compact thumbnail-kaartgrid (2 kaarten naast elkaar op mobiel, 4 op desktop). Maximaal 4 kaarten; bij meer verschijnt een knop "Toon meer". Klik op een kaart opent het volledige bericht (alle media, omschrijving, tags, getagde deelnemers) in een pop-up.
• Het media-blok staat direct onder de sectie "Uitslagen". Heeft de run nog geen uitslagen, dan wordt het uitslagen-blok verborgen en is de volgorde: inschrijvingen, daarna media. Met uitslagen: uitslagen, media, inschrijvingen.
• Bezoekers kunnen een mediabericht "liken" (hartje). Berichten worden gesorteerd op publicatiedatum (nieuwste eerst); het aantal likes is zichtbaar. Liken vereist inloggen.
• De publicatiedatum en -tijd is instelbaar, maar alleen wanneer "Gepubliceerd" is aangevinkt. Een datum in de toekomst plant de publicatie in: het bericht verschijnt pas op de runpagina zodra dat moment bereikt is (in de beheeroverzichten herkenbaar als "Ingepland"). De publicatiedatum wordt ook op de runpagina getoond.
• Bij het toevoegen van een YouTube-filmpje voert de content-creator alleen het video-ID in (het deel na v=); de rest van de URL staat vast.
• De content-creator kan optioneel een eigen thumbnail uploaden voor de kaart. Zonder eigen thumbnail wordt de door YouTube gegenereerde thumbnail getoond.
• In de bewerkvorm is van bestaande media een voorbeeld zichtbaar (afbeelding/YouTube als thumbnail, PDF als icoon met link).
• In de bewerkvorm staan de knoppen Opslaan, Annuleren en Verwijderen zowel boven- als onderaan.
• De lange omschrijving is een WYSIWYG-editor met basisopmaak (vet, cursief, onderstrepen, opsommingen); links en kleuren zijn niet toegestaan.
• Een content-creator kan zijn eigen media ook direct vanaf de runpagina bewerken of verwijderen (met bevestiging). Een super beheerder kan alle content bewerken/verwijderen; een content-creator alleen zijn eigen content.
• Een content-creator heeft een overzichtspagina "Mijn content" met al zijn content over alle runs.
• De super beheerder heeft in /admin een sectie "Alle content": een tabel (met thumbnail) met titel, maker, laatst gewijzigd, publicatiedatum en gepubliceerd ja/nee, met acties depubliceren, bewerken en verwijderen.
• Wie de bewerkvorm opent vanuit een overzicht (admin of "Mijn content") keert na opslaan/annuleren/verwijderen terug naar dat overzicht.

User Story

Als bezoeker van een runpagina wil ik in de tab "Vorige edities" per eerdere editie in één oogopslag de belangrijkste cijfers zien, zodat ik snel een indruk krijg van de zwaarte en populariteit van die run zonder elke editie apart te hoeven openen.

Acceptatie Criteria

• De tab die nu "Historie" heet wordt hernoemd naar "Vorige edities" (zowel de blok-titel op de runpagina als de sprong-navigatie-knop bovenaan).
• De tabel toont per editie voortaan meer dan alleen een link naar de run. Per editie wordt getoond:
  • Per gelopen licentie (LSR, MSR, KSR, BSR, JSR...): het aantal deelnemers, de snelste tijd, de gemiddelde tijd, en het percentage DNF en percentage bandje niet gehaald.
  • Het totaal aantal inschrijvingen van die editie.
• Op desktop past alle informatie op één regel per editie.
• Op mobiel wordt per editie een compacte regel getoond die uitklapt (accordion) voor de detailinformatie.
• Klikken op een editie blijft navigeren naar de runpagina van die editie (bestaand gedrag).
• Verwant aan #102 (editie-overstijgende historische statistieken/grafieken) en voortgekomen uit #485 (media/content op de runpagina).

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.