joeni

#+language: nl

#+latex_class: article

#+latex_class_options: [a4paper]

#+latex_header: \usepackage{pdfpages}

#+latex_header: \usepackage[dutch]{babel}

#+OPTIONS: toc:nil

#+author: Maarten Vangeneugden

#+email: maarten.vangeneugden@student.uhasselt.be

#+title: Prioriteitenlijst bachelorproef

Zoals gevraagd bij de vorige vergadering, heb ik een prioriteitenlijst

opgesteld, waarin ik (informeel) oplijst hoe ik denk dat het project het beste

kan worden voortgezet.

In aflopende volgorde van prioriteit:

1. *Huidige staat Administration afwerken.* Ik heb op dit moment de basis gelegd

   voor wat de functionaliteit van het Studentendossier moet implementeren.

   Alhoewel het praktisch met

   zekerheid te zeggen is dat het nog niet af is, is afwerken wat ik nu al heb

   het beste om nu te doen. Als dat is afgewerkt, hoeft er ook niet meer worden

   omgekeken naar de basis, omdat die al klaar is, en kan er verder gewerkt

   worden aan nieuwe features.

   Dit betekent echter _niet_ dat, moesten er nieuwe features gevraagd worden,

   dat deze genegeerd worden. Deze zullen worden opgeslagen in een TODO-lijstje,

   zodat deze later kunnen worden toegevoegd.

2. *Huidige staat Courses afwerken.* Dezelfde redenering als Administration is van toepassing.

Administration en Courses zullen elk in een welbepaalde volgorde worden

afgewerkt. _Hoofdzakelijk_ zal dat in deze volgorde zijn:

   1. *URL's en Views.* De databank is ondertussen in orde. Het is nu zaak om

      URL's op te stellen, zodat de verschillende pagina's bereikt kunnen

      worden, en Views die op deze URL's kunnen antwoorden. In de Views (de

      functies die reageren als een URL wordt opgevraagd, en alle benodigde

      informatie verzamelen en terugsturen naar de gebruiker) zal ook

      toegezien worden op de status van de gebruiker, zodat een student bv. niet

      zijn/haar eigen punten kan aanpassen.

      De reden dat dit als eerste wordt gedaan, is omdat de volgende onderdelen

      niet kunnen werken zonder dat de Views/URL's er zijn.

   2. *Forms.* Forms laten toe dat de gebruiker via de website informatie

      voorziet aan de server (en dus aan de databank). Dit wordt gedaan via

      HTML-formulieren ("Forms"). Deze worden in Django echter apart opgesteld,

      zodat ze gemakkelijk verbonden kunnen worden met de databank, maar ook

      mooi in de templates kunnen worden voorgesteld.

   3. *Templates.* Dit zijn de HTML-templates die gebruikmaken van de

      [[https://docs.djangoproject.com/en/2.0/ref/templates/language/][Django Template Language]]. Hiermee zullen de uiteindelijke pagina's

      geconstrueerd worden, en zo aan de gebruiker getoond worden. Deze bouwen

      voort op de informatie van Views, construeren links met de informatie van

      URL's, en laten interactie toe met de informatie uit Forms. Merk op dat

      dit enkel over de HTML-pagina's gaat, *niet over de stylesheets (CSS)*.

Merk op dat ik zeg: "Hoofdzakelijk"; deze onderdelen houden allemaal in meer of

mindere mate verband met elkaar. Het is af en toe dus handig om van de

opgestelde volgorde af te wijken, om een bepaald onderdeel af te kunnen werken.

Het uiteindelijke resultaat hiervan zal er voor de eindgebruiker relatief

"barok'' uitzien; geen enkele pagina heeft op dit moment stylesheets (de

documenten die uitleggen hoe een webpagina eruit moet zien). Maar dit is ook

expres, omdat ik van mening ben dat de pagina's op zich ook bruikbaar moeten

zijn. Hiervoor maak ik veel/handig gebruik van de HTML(5)-tags, die /betekenis/

overbrengen aan de browser. (Een gedetailleerde uitleg over wat dit precies

betekent zal ik in de eigenlijke bachelorthesis uitleggen)

Als de bovenstaande punten zijn afgewerkt, zijn er nog enkele additionele

punten:

3. [@3] *(S)CSS-code schrijven.* Dit hoeft nog geen definitieve versie te zijn, maar

   het moet wel een bruikbaar geheel teweeg brengen, dat ook voor het oog fijn

   is om mee te werken.

4. *Nieuwe functionaliteit implementeren.* Dit gaat over de later aangebrachte

   verzoeken inzake nieuwe /features/ voor de applicaties. Deze zullen een stuk

   sneller kunnen worden geschreven, omdat alle onderliggende vereisten (zoals

   templates, URL's, ...) al deels geschreven zijn, of er voorbeelden zijn die

   gemakkelijk gekopieerd kunnen worden. Dankzij de CSS-bestanden zullen deze er

   ook al uitzien alsof ze al volledig klaar zijn.

5. *Vertalingen opstellen.* De code wordt overal in het Engels geschreven;

   teksten, menu's, ... Ik heb echter op voorhand (waar nodig) in de code

   aangegeven welke delen vertaald moeten worden. Als al het bovenstaande

   degelijk werkt, kan er begonnen worden met de Nederlandse vertaling.

Tussen al dit werk door, zal er ook gewerkt worden aan *tests*. Mijn methode om

te testen in dit project, is dat ik de code eerst schrijf, en als er fouten

optreden (of ik kan snel voorzien waar een fout zou kunnen zitten), dat ik voor

die functies direct tests schrijf. [[https://docs.djangoproject.com/en/2.0/ref/validators/][Validators]] (functies die controleren of wat

een gebruiker heeft ingevoerd wel in het juiste formaat is) zijn goede

voorbeelden van tests waarvan ik ze op voorhand al kan schrijven.

Ik zal geen testen schrijven van functionaliteit van de /software libraries/ die

ik gebruik van derden (zoals Django zelf). Ik ga er hierbij uit dat die al

getest ís.

Als deze punten zijn afgerond, kan de prioriteit verschuiven naar Agora.

Dezelfde volgorde zoals eerder opgesomd zal worden aangehouden.