Uitleg - Rubriek Beoordeling Tool

Doel van de Tool

Deze tool helpt bij het efficiënt beoordelen van studenten op basis van een rubriek. Het stroomlijnt het proces van rubriekcreatie, studentbeheer en het genereren van beoordelingen, inclusief optionele AI-gegenereerde feedback.

Pagina's en Workflow

De tool is opgedeeld in drie hoofdpagina's:

• AI Generator: Genereert 3 rubrieksuggesties in CSV-formaat op basis van jouw input. Download de gewenste CSV.
• Handmatige Editor: Maak handmatig een rubriek of importeer een CSV (van de generator of zelfgemaakt) om deze te bewerken. Exporteer de voltooide rubriek als CSV.
• Beoordelen (Hoofdpagina):
  1. Importeer de rubriek (CSV) die je wilt gebruiken.
  2. Importeer de studentenlijst (CSV).
  3. Selecteer een student uit de lijst.
  4. Vul de beoordeling in en voeg eventueel notities toe.
  5. Klik op "Sla Beoordeling op voor Student".
  6. Herhaal stap 3-5 voor alle studenten.
  7. Kies de gewenste download opties (toggles).
  8. Klik op "Genereer Alle Opgeslagen Beoordelingen".
  9. Download de individuele .txt bestanden uit de resultatenlijst.

CSV Formaten

Rubriek CSV

Gebruik de "Download Voorbeeld CSV" knop op de hoofdpagina of maak/exporteer via de andere tools. Vereiste header en kolommen (in deze volgorde):

"CriteriumNaam","Weging","Desc_Onvoldoende","Desc_Matig","Desc_Voldoende","Desc_RuimVoldoende","Desc_Goed"

• Weging: Getal (bv. 1, 0.5, 2). Gebruik een punt (.) als decimaalteken.
• Beschrijvingen: Mogen leeg zijn. Gebruik dubbele quotes (") rond velden met komma's of nieuwe regels.

Studenten CSV

Vereiste header en kolommen:

Stamnummer,Roepnaam,Tussenvoegsel,Achternaam,Klas

• Stamnummer moet uniek zijn.
• Tussenvoegsel is optioneel.
• Extra kolommen worden genegeerd.

OpenAI API Key & Beveiliging

Voor AI-functies (rubriek suggesties, feedback) is een OpenAI API Key nodig.

• De communicatie met OpenAI verloopt nu via een PHP-script (`api_proxy.php`) op de server. Dit script voegt jouw geheime API key toe aan het verzoek.
• De API key staat niet meer in de JavaScript-bestanden (`generator.js`, `script.js`).
• BELANGRIJK: Je moet je API key veilig instellen in `api_proxy.php`. De **aanbevolen methode** is via een Environment Variable op je Hostinger server (zoek in hun documentatie of controlepaneel hoe je dit instelt, bv. via `.htaccess` met `SetEnv OPENAI_API_KEY "jouw_key_hier"` of via een specifiek paneel).
• Als fallback kun je de key *tijdelijk* direct in `api_proxy.php` zetten, maar dit is **zeer onveilig** voor een live website. Verwijder dit voordat je online gaat!
• Zorg dat de bestandsrechten van `api_proxy.php` correct zijn ingesteld (niet wereldwijd leesbaar).

Privacy & Data Opslag

• Studentenlijst: Opgeslagen in `localStorage` van je browser (blijft bewaard op hetzelfde apparaat/browser).
• Rubriek: Wordt *niet* opgeslagen op de hoofdpagina; importeer per sessie.
• Ingevulde Beoordelingen: Opgeslagen *tijdens de sessie* in het geheugen van de browser (gaan verloren bij sluiten/herladen van `index.html` voordat je "Genereer Alles" hebt geklikt).
• Data naar Server: Alleen de data nodig voor AI-verzoeken (bv. rubriek specificaties, beoordelingsscores/notities *zonder namen*) wordt naar jouw `api_proxy.php` script gestuurd. Studentnamen worden *nooit* naar de AI/proxy gestuurd.

JSON Logging (Testen/Debuggen)

Elke pagina (`generator.html`, `editor.html`, `index.html`) heeft een "Download Log (JSON)" knop. Deze downloadt een bestand met technische details over de acties en data van die specifieke pagina tijdens je sessie.

• Handig voor foutopsporing.
• Bevat timestamps, actietypes, en relevante data (ook AI prompts/responses).
• Log wordt gereset bij het herladen van de pagina.

---

Start met Beoordelen