Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- howto:git:classroom50:lehrpersonen [2026/08/18 12:38] – Begriff Klassenzimmer durch Classroom ersetzt admin
+++ howto:git:classroom50:lehrpersonen [2026/08/25 10:06] (aktuell) – Veraltet - Inhalt jetzt unter github.com/BZZ-Commons/pygrader50/docs admin
@@ Zeile 1: / Zeile 1: @@
-====== Classroom 50: Classrooms und Aufgaben verwalten ======
-Diese Seite beschreibt den **laufenden Betrieb**. Einen Classroom neu
-aufsetzen: [[.:einrichtung|Einrichtung]]. Von GitHub Classroom umsteigen:
-[[.:migration|Migration]].
-===== Werkzeug =====
-Classroom 50 hat keine Web-Oberfläche zum Verwalten. Alles läuft über die
-GitHub-CLI-Erweiterung ''gh teacher'':
-<code bash>
-gh extension install foundation50/gh-teacher
-gh auth refresh -h github.com -s admin:org,read:org,repo,workflow
-</code>
-Der zweite Befehl ist keine Formalie: Ohne ''admin:org'' bricht **jeder**
-''gh teacher''-Aufruf mit einer Scope-Meldung ab. Er öffnet den Browser und
-braucht deshalb ein interaktives Terminal.
-<code bash>
-gh teacher classroom list <ORG>
-</code>
-===== Klassenliste (Roster) =====
-Die Klassenliste liegt als ''<CLASSROOM>/roster.csv'' im Config-Repo, mit
-diesem Header:
-<code>
-username,first_name,last_name,email,section,github_id,role
-</code>
-<WRAP center round important 90%>
-Ältere Classrooms haben stattdessen eine ''students.csv''. Damit scheitert
-jeder ''gh teacher roster''-Befehl, und die Namen in ''scores.json'' bleiben
-leer. Datei umbenennen und die Spalte ''role'' ergänzen.
-</WRAP>
-Das Roster steuert die Bewertung **nicht** — es liefert nur Anzeigedaten.
-Eingesammelt wird nach der Union aus Studenten-Team und **allen** Staff-Teams
-(''teacher'', ''hta'', ''ta''). Wer als Lehrperson eine Aufgabe annimmt, um den
-Ablauf zu testen, wird wie eine lernende Person bewertet und landet in
-''scores.json'' — und damit im Moodle-Übertrag, wo der Account dann fehlt.
-Testrepos nach dem Test löschen **und** den Eintrag aus ''scores.json''
-entfernen.
-===== Aufgaben =====
-Alle Aufgaben einer Klasse stehen in ''<CLASSROOM>/assignments.json'' im
-Config-Repo. Ein Eintrag verweist auf das Template-Repo, den Slug, den
-Abgabetermin und den zu verwendenden Autograder.
-An der BZZ steht bei allen Aufgaben ''"autograder": "default"'' und
-''"feedback_pr": true'', und **kein** ''tests''-Block. Damit greift überall der
-Klassen-Default, also pygrader50 mit pytest und pylint.
-Aufgaben auflisten:
-<code bash>
-gh api repos/<ORG>/classroom50/contents/<CLASSROOM>/assignments.json \
-   -H 'Accept: application/vnd.github.raw' | jq -r '.assignments[].slug'
-</code>
-Zu Templates siehe [[howto:git:template|Template-Repositories]], zum Aufbau des
-Config-Repos [[howto:git:classroom50repo|Das classroom50-Repository]].
-===== Resultate einsehen =====
-  * **Pro Abgabe** — Release und Commit-Status im Studi-Repo.
-  * **Pro Klasse** — ''<CLASSROOM>/scores.json'' im Config-Repo, nachts von ''collect-scores'' aktualisiert.
-  * **In Moodle** — nachts um 04:57 durch ''moodle-sync'', siehe [[.:moodle|]].
-<code bash>
-gh api repos/<ORG>/classroom50/contents/<CLASSROOM>/scores.json \
-   -H 'Accept: application/vnd.github.raw' | jq '.'
-</code>
-===== Nachbewerten =====
-Eine Abgabe neu bewerten lassen: im Studi-Repo unter **Actions** den
-Bewertungslauf erneut starten (//Re-run all jobs//). Das erzeugt ein neues
-Release; der nächste Moodle-Lauf überträgt die geänderte Punktzahl automatisch,
-weil sich die Punktzahl unterscheidet.
-Nur die Note in Moodle nachtragen, ohne neuen Lauf:
-<code bash>
-gh workflow run moodle-sync.yaml --repo <ORG>/classroom50 \
-  -f classroom=<CLASSROOM> -f assignment=<SLUG> -f force=true
-</code>
-===== Betriebsfallen =====
-==== scores.json wird nie aufgeräumt ====
-Das Einsammeln ist ein reiner Upsert, geschlüsselt auf den Repo-Owner. Ein
-Eintrag bleibt stehen, auch wenn das Repository gelöscht oder die Person
-ausgetragen wurde. Weil der Moodle-Übertrag mit Exit 1 endet, sobald **eine**
-Übertragung scheitert, färbt ein einziger solcher Karteileichen-Eintrag den
-Nachtlauf dauerhaft rot.
-**Nach einer Abmeldung den Eintrag von Hand aus ''<CLASSROOM>/scores.json''
-entfernen.**
-==== Der Service-Token braucht Administration-Rechte ====
-Fehlt dem ''CLASSROOM50_SERVICE_TOKEN'' das Recht
-//Repository → Administration: Read and write//, scheitert ''collect-scores''
-mit ''staff-team access grant failed with HTTP 403''. Die Punkte werden
-trotzdem gesammelt, der Job endet aber rot und die TA-Teams bekommen keinen
-Zugriff.
-<code bash>
-gh teacher rotate-service-token <ORG>
-</code>
-==== Python-Version ====
-Ohne Angabe von ''runtime.python'' wählt der Runner **Python 3.14**. Dort
-installieren sich pytest 9.x und pylint 4.x — die Lint-Punkte fallen strenger
-aus als mit den alten Template-Pins (''pytest==8.3.3'', ''pylint==3.2.7'').
-===== Weiter =====
-  * [[.:bewertung|Wie bewertet wird]]
-  * [[.:moodle|Noten nach Moodle übertragen]]
-  * [[.:troubleshooting|Problembehandlung]]