sr-stats Docs

Syncserver

Hoe sr-stats gegevens uit de bron importeert en hoe die import blijft draaien.

De gegevens in sr-stats komen van Survivalrun Bond Nederland. Een afgeschermde server die de hele dag draait importeert die bron voor de app. Het is een apart programma naast de website, dus een bezoek aan sr-stats roept de bron nooit rechtstreeks aan.

Wat de server doet

De server haalt de bron één keer op voor sr-stats, in plaats van voor iedere bezoeker. Dat gaat op drie manieren.

  • Volledige import. Twee keer per dag loopt de server de bron door en werkt wedstrijden, startlijsten, uitslagen en klassementen bij. Uitslagen die al definitief en ongewijzigd zijn, worden overgeslagen.
  • Live uitslagen op wedstrijddagen. Zolang er wedstrijden bezig zijn, controleert de server hun uitslagen vaker. Een antwoord dat niet is veranderd wordt herkend en raakt de gegevens niet.
  • Meldingen van de bron. De bond kan doorgeven dat er iets is veranderd. De server controleert die melding en haalt daarna alleen het betreffende onderdeel op. Een melding die twee keer binnenkomt, leidt niet tot een tweede ophaalronde.

Na een import geeft de server aan de app door dat de gegevens zijn veranderd, zodat overzichten de nieuwe waarden kunnen tonen.

Zorgvuldig met de bron

Alle verzoeken aan de bron gaan door één wachtrij met een vaste pauze tussen de verzoeken. Live-verzoeken gaan voor bulkwerk. Zo blijft de belasting op de bron van Survivalrun Bond Nederland laag.

Bewaking en back-ups

Coolify laat de server draaien en start hem opnieuw als hij stopt. Better Stack bewaakt hem: de server geeft om de paar minuten een signaal en een uitblijvend signaal geeft een melding. De gegevens worden daarnaast elke dag apart geback-upt. Verdere beheerdetails publiceren we niet.

Wat dit voor jou betekent

Als de bron een uitslag wijzigt, kunnen de gegevens in sr-stats daarna veranderen. De zichtbare status bij een uitslag blijft de uitleg voor wat op dat moment bekend is: voorlopig of definitief. Uitslagen worden nu ongeveer elk halfuur bijgewerkt; sneller kan misschien later, maar daar doet deze pagina geen belofte over. Zie Gegevens en actualiteit.