Notation nbgrader¶

Le module Notation permet à un enseignant de créer des devoirs Jupyter, les distribuer aux étudiants, collecter les copies, les noter automatiquement et corriger manuellement (formgrader).

⚠️ Le système n'utilise pas l'exchange nbgrader : la distribution et la collecte se font par SCP directement entre la VM enseignant et les VMs étudiantes (orchestré par le Control Center).

Cycle de vie d'un devoir¶

flowchart LR
    A["1. Créer\n(JupyterLab → Nbgrader → Create Assignment,\nmarquer les cellules, Generate)"] --> B["2. Distribuer\n(SCP release → VMs étudiantes)"]
    B --> C["3. Étudiant édite\nnbgrader/<devoir>/*.ipynb"]
    C --> D["4. Soumettre\n(copie dans submitted_copies)"]
    D --> E["5. Collecter\n(SCP des copies → instructeur)"]
    E --> F["6. Notation auto\n(nbgrader autograde)"]
    F --> G["7. Correction manuelle\n(formgrader) + Export CSV"]

La page Notation (frontend)¶

frontend/src/routes/grading/+page.svelte : - Sélecteur de pool + d'assignment (liste = dossiers de nbgrader/source/). - Actions : Distribuer / Collecter / Notation automatique / Exporter CSV (avec confirmation puis bannière verte de succès). - Tableau de bord (panneau droite) : boutons « Ouvrir JupyterLab » / « Ouvrir Formgrader » (nouvel onglet), + stats (copies notées, moyenne, à corriger) et distribution des notes, ou un guide si aucun assignment noté. - Tableau des notes par étudiant + bouton Correction manuelle.

Endpoints backend (Control Center)¶

Tous dans control_center/grpc/nbgrader.go, exposés en REST /api/nbgrader/*. Ils se connectent en SSH à la VM enseignant (nbgraderSSHClient) et exécutent nbgrader dans le conteneur Docker (dockerExec).

Endpoint	Action
`GET /assignments`	liste les dossiers de `nbgrader/source/` (les vrais devoirs)
`POST /release`	`nbgrader release_assignment` + SCP des fichiers vers chaque VM étudiante
`POST /collect`	récupère par SCP les copies des étudiants → `submitted/<student>/<devoir>/`
`POST /autograde`	`nbgrader autograde <devoir>`
`GET /grades`	export CSV / lecture du gradebook (notes par étudiant)
`GET /export-csv`	export CSV téléchargeable
`POST /submit`	(étudiant) copie son travail dans `submitted_copies`
`GET /jupyter-url`	URL JupyterLab + URL proxy de la VM enseignant
`GET /submission-url`	URL formgrader directe pour corriger une copie

Distribution (release)¶

sequenceDiagram
    autonumber
    participant CC as Control Center
    participant INS as VM enseignant
    participant ETU as VMs étudiantes
    CC->>INS: nbgrader release_assignment <devoir> (dans le conteneur)
    CC->>INS: lit les fichiers de nbgrader/release/<devoir>/
    loop pour chaque étudiant (IP connue)
        CC->>ETU: mkdir ~/nbgrader/<devoir> + SCP des fichiers
    end

Soumission & collecte¶

L'étudiant clique Soumettre → /submit copie ~/nbgrader/<devoir> → ~/nbgrader/submitted_copies/<devoir> puis chmod -R a-w (lecture seule). ⚠️ On utilise a-w et pas 444 : 444 retire le bit d'exécution des dossiers → ils deviennent non traversables → la collecte trouve 0 copie.
Collecter lit submitted_copies/<devoir> (ou <devoir>) par SCP et reconstruit submitted/<student>/<devoir>/ côté enseignant + nbgrader db student add.

Correction manuelle (formgrader)¶

Le bouton Correction manuelle ouvre la page formgrader de la copie. ⚠️ La route correcte est /formgrader/submissions/<submitted_notebook_id>/?index=0 — l'identifiant est celui du notebook soumis (submitted_notebook.id), pas celui de l'assignment soumis. L'endpoint /api/nbgrader/submission-url résout cet UUID dans le gradebook ; à défaut, on retombe sur la liste /formgrader/manage_submissions/<devoir>.

flowchart LR
    BTN["« Correction manuelle »"] --> API["/api/nbgrader/submission-url\n(SELECT submitted_notebook.id …)"]
    API -->|uuid| URL["/formgrader/submissions/<uuid>/?index=0"]
    API -->|aucun| LIST["/formgrader/manage_submissions/<devoir>"]

Prérequis image ⚠️¶

Pour que la notation/formgrader marche, l'image doit avoir nbgrader ≥ 0.9.5 : - une image avec un vieux nbgrader (p.ex. 0.7.0.dev0 préinstallé) plante l'API formgrader (AttributeError: 'CompoundSelect' object has no attribute 'mapper', conflit SQLAlchemy) ; - d'où pip install -U nbgrader dans le Dockerfile des snapshots (cf. Snapshots & images). - Le dossier nbgrader doit être inscriptible par jovyan (UID 1000) sinon création d'assignment / gradebook impossible (cf. Provisionnement).

Notebook d'exemple¶

example/assignment-demo.ipynb — un devoir nbgrader complet (cellules auto-notées + tests cachés + une question à correction manuelle, schema_version 3) pour tester le cycle complet sur une image nbgrader 0.9.5.