Terms and states¶
Core terms¶
| Term | Exact meaning |
|---|---|
| Draft | The mutable working copy of an exam. Draft edits do not change an already published version. |
| Published version | A read-only exam version used by Print, Scan, Rubric, Grade, and Reports. Later draft edits do not change it. |
| Canonical / administration version | The published version used by ordinary Print, Scan, Rubric, Grade, and Reports navigation. |
| Packet | The logical identity of one exam copy. It can be named, numbered, or created from one scanned master-packet group. |
| Batch | A print job containing named or numbered packets. A master PDF is version-owned and is not an ordinary batch. |
| Response workspace / workbox | A mapped region in which a student writes or marks an answer. |
| Detected response | A crop derived from a scanned response workspace. Only the accepted crop enters grading. |
| Canonical packet | The chosen packet for a student when multiple worked packets are matched to that identity. |
| Rubric draft / revision / canonical rubric | Editable grading instructions; a numbered published revision; the selected revision used for grading. |
| AI candidate assessment | A model-produced scoring proposal. It is not a final grade. |
| Provisional assessment | A saved assessment awaiting human approval. It may originate from AI agreement, human edits, or human authorship. Current- and old-rubric provisional assessments have separate filters in Bulk review. |
| Final assessment | The saved grading record for one packet and gradeable question. Its name does not guarantee approval: its state may be provisional, approved, or revoked. |
| Approved assessment | A saved assessment approved by a human. It counts as a current approved grade only against the current canonical rubric and within the applicable packet/report scope. |
| Revoked assessment | Approval was removed while the saved score, text, and revision history were retained. It appears in Needs review and can be saved as provisional or approved in either review workflow. |
| Re-review | A historically approved assessment whose rubric is no longer current. It requires renewed approval against the canonical rubric. Stale provisional assessments use the separate Provisional · Old rubric status. |
| Provisional · Old rubric | A provisional assessment whose saved rubric is no longer canonical. Review it against the current rubric before saving or approving. |
| Bulk review | A filtered, paginated set of response cards with inline editing and actions on selected page items or all fetched results. Supports every assessment status. |
| Queue review | One-response-at-a-time review, including AI candidate comparison and Copy to assessment. |
| Assessment history | The expandable record of saved content, score, rubric, source candidate, actor, time, and approval state for each revision. Approval alone is not a human content edit. |
| Report preview | A live, authenticated rendering from current grading state. It does not create a student link. |
| Released report | A report available through its stable student link. |
Grading state versus AI agreement¶
Provisional (shown as P in the grading matrix) means a saved assessment awaits human approval. AI agreement or human action can create it; AI agreement does not endorse later human edits. Approved assessments count as current approval only against the canonical rubric. Revoked saves always appear in Needs review; generation remains a separate activity indicator.
Queue review offers as approved or as provisional with Save and continue. Bulk review offers Save and approve or Save as provisional. Both workflows save against the current rubric; saving as provisional removes existing final approval. Revocation retains saved content and history. In Bulk review, status pills communicate state and Provenance → Show details explains origin and revisions; Queue review uses its guidance note and Assessment history. See the grading guide for actions, confirmations, and conflict recovery.
Common processing states¶
- Queued means waiting to start.
- Running or Processing means work has begun.
- Cancelling or Cancellation pending means cancellation was requested; completion is not yet confirmed.
- Succeeded or Complete means the requested work finished.
- Completed with issues means processing finished but produced incidents requiring review.
- Failed means the work did not complete. The visible detail should guide retry or correction.
- Cancelled means cancellation is complete.
Refreshing a progress page does not restart the work.
Destructive versus reversible controls¶
- Deactivating a student is reversible; permanent deletion is available only when the student has no exam or packet history.
- Archiving a print batch hides the batch but leaves packets, scans, grading, and reports unchanged.
- Archiving a packet removes it from matching and grading while preserving scan evidence; it is reversible.
- Deleting a scan upload permanently removes its uploaded file and derived page, response, incident, and related grading artifacts.
- Replacing accepted work after grading requires typed confirmation and permanently removes grading artifacts for that packet/question.
- Restoring a published exam version overwrites the current draft with a copy of that version; it does not modify the published version.
- Deleting a course or exam is permanent and requires an exact typed confirmation.