Merge remote-tracking branch 'origin/master' into state-of-the-wpi-2

This commit is contained in:
Robbe Van Herck 2019-10-03 16:09:00 +02:00
commit d83fe7faa7
No known key found for this signature in database
GPG key ID: A66F76F7B81BD784
5 changed files with 104 additions and 5 deletions

View file

@ -18,8 +18,7 @@ cache:
addons:
apt:
packages:
- pandoc
- texlive
- texlive-full
- lmodern
branches:
@ -32,6 +31,8 @@ notifications:
slack:
secure: tej68wbYns4DYg488iz+4ncU3/CHJvG/5c1qntGcEjti6vZp24atuH32BzNMY+gqa5ftZtcRfqIiJ0I0tkbiFWEDzjSk89bgjG4sgwXq1gMqi/Fj4bqEpjU5m7QLa786q4UfYyTF+srca1fHPLVS5REdGjRr2wxX+bcFnTRxreGCIrlNdWhoZPPJyS37R4RR9k+l5ZWZnqWgUN6bD448O8EzMRVRWoUSxQcJ6+u4QLpinEvem4iXe+WcHOyFfsNmavxGGMMpkOSed/tzA1l+gNpl224qOJl3yAk2qrGi4N6SOnSkeJFfUO5RzX56KDC/tcCL1oJpamhDmzDvRrbDNnCjSriv+g+PkXEjiwBF/tkZwIe7nMKyc9QF698Zvdgb6Ffbq21obsRnkkddkxijthdbUKMAIREPQuU7pXRL4ykPkBeB5GkNjPlErOooxvUHvQEVElJ8NMD4ychQqW6relaYJ0W0uy0QMvrtS+cHkpprZAOZzWLa3AdEOvD50kiS2hDhJway5JHJg/LMl3I6XVVMx6fNGdNWBcezeCqkDZM+nuMJqgAtQ+Tz8bwrHLCJgS5u0lQq/MbrDkYdpmmzvA5LXxn2SpjfOAlgiFKnSIwKSuuuwzW/zCEGdPo1pfBba2VfYAN4y1l863j5ph+eMtlHf7JG8mzIWTo3k+Jx8lQ=
before_install:
- wget https://github.com/jgm/pandoc/releases/download/2.7.3/pandoc-2.7.3-1-amd64.deb
- sudo dpkg -i pandoc-2.7.3-1-amd64.deb
- openssl aes-256-cbc -K $encrypted_6059a4f451fd_key -iv $encrypted_6059a4f451fd_iv
-in id_rsa.enc -out deploy_key -d
- mv deploy_key ~/.ssh/id_rsa

8
Rules
View file

@ -4,12 +4,17 @@
require 'json'
require 'icalendar'
# Important!!!
# First ignore the node_modules, we do not need any of it on the site directly.
ignore '/node_modules/**/*'
#
#
# PREPROCESS
#
#
preprocess do
`yarn`
@ -136,7 +141,7 @@ end
# Note drive/verslagen is 'linked' as a data source to /about/verslagen/
compile '/about/verslagen/*/*.md', rep: :pdf do
filter :pandoc_pdf, args: { f: :markdown } if production?
filter :pandoc_pdf, args: { f: :markdown, :'pdf-engine' => 'xelatex' } if production?
write ext: (production? ? 'pdf' : 'md')
end
@ -181,7 +186,6 @@ end
ignore '/assets/stylesheets/includes/**/*'
ignore '/data/**/*'
ignore '/node_modules/**/*'
compile '/assets/stylesheets/**/*.scss' do
sass_opts = {

View file

@ -0,0 +1,91 @@
---
title: "12 Uren Tellen"
created_at: 24-09-2019
description: Over rennen en tellen
author: Arne Bertrand
---
Men lope rondjes. Men telt die rondjes.
Het lijkt een eenvoudige opgave. Maar er komt zoals altijd heel wat meer bij kijken dan je verwacht. Bij een manuele telling wordt men moe, of mist men al eens een rondje.
Ook bij een automatisch systeem duiken er onverwachte problemen op, en natuurlijk is zo'n systeem onmiddelijk een stuk complexer. Daarbij komen dan nog software bugs, hardware ongelukjes, stroomuitvallingen, noem maar op. Hoe lang we dit lijstje ook maken, volgende editie is er toch weer iets waar we niet aan hadden gedacht.
Hieronder even een overzicht hoe we dit tot nu toe hebben aangepakt.
## Bluetooth en Espressos
Een eerste probleem waar een telsysteem mee kampt is hoe de passerende lopers te detecteren.
Hiervoor worden er een aantal telstations opgezet rondom het circuit.
Zo'n "telstation" bestaat uit een "espressobin", een mini-computertje met een bluetooth-ontvanger eraan, die telkens doorstuurt welke bluetooth-apparaten er zich in de omgeving bevinden.
En dan geven we de lopers een baton (lees "een stuk pvc-buis") waarin een bluetooth zendertje zit. Simpel, toch?
Het nadeel hieraan is dan dat het niet alleen de lopers detecteert, maar ook jan en alleman die zijn bluetooth niet heeft uitgezet...
## Graaf Tel
Al jaren doet het functioneel huzarenstukje [Count von Count][cvcrepo] dienst als brein van het 12urenloop telsysteem. En dat werkt. Denken we.
Om eerlijk te zijn hebben we geen idee. Het aantal mensen dat genoeg haskell kan om de codebase te doorgronden begint stilletjesaan kleiner te worden dan, uh, 1.
CVC gaat al een hoop edities mee, en het feit dat het blijft draaien zonder enige significante updates is eigenlijk een klein wonder. Maar stilaan komen we op het punt waar
we extra features nodig hebben, maar eigenlijk weet niemand hoe en waar die te steken... Functioneel programmeren is niet bepaald het meest populaire vak... (Sorry Jasper & Felix)
## Dan toch maar met de hand
Als backup hebben we sinds jaar en dag reeds het trouwe [manualcount][mcrepo], dat vorig jaar volledig herschreven is.
Idealiter is dit iets waar we enkel het eerste uur op steunen om ons er van te vergewissen dat de automatische telling correct is opgestart.
De realiteit loopt echter vaak anders...
Je merkt al dat er heel wat "maar"-en naar boven komen. Het is een publiek geheim dat er elke editie wel iets grondig misgaat, en in de meest recente edities kwam dit des te meer naar boven.
We spreken over de vorige editie als een success, maar eigenlijk is er heel de dag gewoon manueel geteld geweest.
Gelukkig werkte de bovenvermelde manualcount perfect en zijn we heelhuids de twaalf uren doorgekomen, op de keel van de spotters na dan.
Na afloop van zo'n desastreuze editie kunnen we steeds weer extra ervaring neerschrijven, en onszelf beloven dat we het volgend jaar beter doen.
Maar wat is er nu eigenlijk foutgelopen? Dat blijkt telkens een enorm lastige vraag om te beantwoorden. Het hele telsysteem bestaat uit een hoop losse onderdelen, die dan nog eens met vrij fragiele
ethernet-kabels verbonden zijn (zie editie 2018 voor verhalen over koetsen en kabels).
De telstations zelf kunnen het natuurlijk ook begeven (zie editie 2019 voor een les over batterijen en polariteit).
Er is daarnaast sprake van mogelijke bluetooth-interferentie, overbelasting van de servers, etc. En, in zo goed als alle gevallen, alles tegelijk.
## Een nieuwe start
Hoewel we zoals hierboven vermeld nooit echt zeker zijn van waar de druppel die de server doet kortsluiten vandaan komt, staat het buiten kijf dat we collectief doorheen de jaren een hoop ervaring hebben
verzameld. En daarbij kwamen steeds ideeën naar boven die we niet of moeilijk konden integreren in het bestaande systeem.
Vandaar dus de beslissing van het Zeus-bestuur om samen met het 12urenloop-comité onze schouders te zetten onder een volledig nieuw systeem. Nieuwe hardware, nieuwe software.
### Telraam
Hoofdrolspeler van het nieuwe systeem wordt Telraam, de spirituele opvolger van Count Von Count. Cruciaal doen we het deze keer niet in Haskell (want dat kunnen we niet) maar in het
gouwe ouwe, saaie Java. Ja, een stuk minder sexy. Maar wel garantie dat volgende generaties makkelijk het heft kunnen overnemen. Het is de taal die we als eerste leren in onze opleiding, wat
de zaken ook een stuk toegankelijker maakt.
De focus van telraam houden we zo nauw mogelijk: rondjes tellen, meer niet. In tegenstelling tot CvC laten we de detectie van valsspelers over aan de organisatie. Waar we wel op hameren is DOCUMENTATIE.
Het is altijd een ondankbaar werkje om steeds die wiki up to date te houden, maar het is van onschatbare waarde in het heetst van de strijd, om dan nog maar te zwijgen van het gemak bij de overdracht
naar volgende jaren.
Daarnaast willen we deze keer zeker echt jawel echt waar UNIT TESTS schrijven. Uit alles blijkt dat de 12urenloop een project van een heel ander kaliber is dan het gemiddelde
zeusproject. Het ding moet gewoon perfect werken.
### Golfjes
Naast nieuwe software komt er ook nieuwe hardware. Het vrijkomen van een iets groter budget hiervoor bij de 12urenloop organisatie is wat de hele discussie rond een nieuw ontwerp in gang heeft gezet.
We zijn er nog niet helemaal uit wat het precies zal worden, maar duidelijk is dat we bluetooth zullen achterlaten voor een andere draadloze technologie.
## Zeus needs you!
Een nieuw, schoon vers project waar ook nog eens leuke nieuwe speeltjes bij komen... Ik moet u natuurlijk al niet meer overtuigen om mee te doen, ge staat verzekers al te springen om eraan te beginnen!
### Hoe Wat Waar?
Kom eens langs in het [~12urenloop][12ulmm] kanaal op mattermost, en neem een kijkje op de [repo][telraamrepo].
Doorheen het jaar organiseren we themaweken rond de 12urenloop. Er is dan steeds iemand aanwezig in de kelder die weet heeft van de huidige status en van wat er nog moet gebeuren.
Telkens werken we naar een concreet doel op het einde van de week: een nieuwe versie, een pakket issues, een grote integratietest, etc.
Je mag mij (@abeformatter) natuurlijk ook steeds contacteren met vragen of ideeën.
[telraamrepo]: https://github.com/12urenloop/Telraam
[12ulmm]: https://mattermost.zeus.gent/zeus/channels/12urenloop
[cvcrepo]: https://github.com/12urenloop/cvc
[mcrepo]: https://github.com/12urenloop/manual-count-2

2
drive

@ -1 +1 @@
Subproject commit cca29766e7279487c7090fe851df55fb44c50d1d
Subproject commit 094215d93c38385384be6f92ee14b4d037de6684

View file

@ -5,11 +5,14 @@
bulma-divider@~0.2.0:
version "0.2.0"
resolved "https://registry.yarnpkg.com/bulma-divider/-/bulma-divider-0.2.0.tgz#a9b4d9fe8b270c7cb7573023c575062bc62616f3"
integrity sha512-REe3k56GECRfDaqFjC8cwLhV4RxXmV0RubuzDJqwior9wlJcdHlN0qfW0tvUX+qphikaTQegIeRuhjRIAqkjkw==
bulma-timeline@^3.0.4:
version "3.0.4"
resolved "https://registry.yarnpkg.com/bulma-timeline/-/bulma-timeline-3.0.4.tgz#494f458098a06dcf8dcc7fe8f2f158b63d1d1ef2"
integrity sha512-gCUOcSUuzHoeVMkCpLF49j5Z5yl78XQ+KgJcT+1ju5WIGgBgVytRUob/dw5NHAxPLO2rmcvwYNbCJFp7w4WT4Q==
bulma@0.7.5:
version "0.7.5"
resolved "https://registry.yarnpkg.com/bulma/-/bulma-0.7.5.tgz#35066c37f82c088b68f94450be758fc00a967208"
integrity sha512-cX98TIn0I6sKba/DhW0FBjtaDpxTelU166pf7ICXpCCuplHWyu6C9LYZmL5PEsnePIeJaiorsTEzzNk3Tsm1hw==