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, Grade, and Reports. Later draft edits do not change it. |
| Canonical / administration version | The published version used by ordinary Print, Scan, 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 | An agreed AI assessment eligible for bulk human review. It is incomplete until an authorized person approves it. |
| Final assessment | The current saved grading decision for one packet and gradeable question. It may still require re-review after a rubric change. |
| 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. |
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.