Chapter 14

Exams & Results

school_adminprincipalsubject_teacher

Overview

An exam moves through one deliberate pipeline: define what a subject's marks are actually made of, create the exam and add its subjects, let the subject teacher enter and submit marks once the exam has been conducted, have the Principal review and approve (or send back) each subject, then publish. Nothing reaches a student or parent until every subject in the exam has been approved and the exam is explicitly published. This chapter walks all of it for Golden Jubilee CBSE's Unit Test 1, Class 6, subject English — then finishes with the separate Exam Seating Arrangement screen.

Key concepts

  • Marks StructureA reusable template of named mark components for a subject — e.g. "Written 80, Viva 20" — optionally scoped to one class. It exists purely to pre-fill the Add Subject form; it is never enforced. A school's exam board (CBSE, ICSE, KSEAB…) suggests a starting Internal/External split, but every component's name, maximum, and pass mark is fully editable, and components can be added or removed freely.
  • ComponentOne named, gradable part of a subject's marks on a specific exam — the actual live fields a teacher fills in, copied from the Marks Structure at the moment the subject was added (or built from scratch if no structure applies). Editing a Marks Structure later never changes an exam subject that already copied from it.
  • Exam Subject statusEach subject on an exam carries its own approval status — pending → submitted → approved — independently of every other subject on the same exam. A Principal can reject a submitted subject back to pending with a reason.
  • Publish & LockAn exam-wide action, only available once every subject on the exam is approved. Publishing makes results visible to students and parents and simultaneously locks all marks against further teacher edits.

Prerequisites

The class, its subjects, and the subject teacher's Teacher-Subject Mapping must already exist (Chapters 2 and 6). This walkthrough uses the same Class 6 roster Chapter 6 mapped English to.

Each stage gates the next — a subject teacher cannot submit before the exam date, and the exam cannot publish until every one of its subjects has been approved.

14.1 Marks Structure — board-suggested, fully custom

Before creating an exam, an Admin can define a Marks Structure per subject: a named set of components with their own maximum and pass marks. It is entirely optional and entirely editable — a subject with just one component, or five, is equally valid. This structure only pre-fills the Add Subject form later; it is copied, never linked.

The Marks Structure screen before any structure has been defined
Figure 14.175. Marks Structure — empty.
The New Structure form for English with two custom components: Written (80 marks, 28 pass) and Viva (20 marks, 8 pass)
Figure 14.176. A new structure for English: two fully custom components, Written (80/28) and Viva (20/8) — not a fixed Theory/Practical/Internal split.
The saved Marks Structure listed for English
Figure 14.177. Saved — ready to pre-fill the next exam subject added for English.
A suggestion, not a constraint

When the school's exam board has real Class 10 figures configured (Chapter 1), the New Structure form offers them as a one-click starting point. Nothing stops an Admin from renaming, removing, or adding components on top of that suggestion — or ignoring it and building the structure from a blank state.

14.2 Create the exam & add subjects

The Create Exam form for Class 6, Unit Test 1
Figure 14.178. Creating Unit Test 1 for Class 6.
Unit Test 1 listed on the Exam Schedule screen
Figure 14.179. The exam created and listed on the Exam Schedule.
The Add Subject form for English, pre-filled from the Marks Structure with Written and Viva components
Figure 14.180. Add Subject — English, pre-filled from Section 12.1's structure. Every component here can still be renamed, removed, or added to before saving.
English added to the exam with status Pending
Figure 14.181. English added — status Pending, awaiting its exam date.

14.3 Mark entry & submission

The subject teacher's Mark Entry grid only opens once the subject's exam date has passed — there is no separate "mark as conducted" step. Columns are generated dynamically from that subject's own components, so a subject with three components shows three score fields per student.

The Mark Entry grid for English, empty, with dynamic Written and Viva columns
Figure 14.182. Mark Entry for English — the grid's columns match the subject's own components exactly.
Marks entered for every student in the class
Figure 14.183. Marks entered for the whole class and saved.
The subject submitted for approval, grid now read-only for the teacher
Figure 14.184. Submitted for approval — the grid becomes read-only for the teacher until a Principal acts on it.
Submission requires a complete roster

Submit for Approval is blocked with the exact list of missing students until every student in the class has either a mark in every component or is explicitly marked absent. A partially-filled grid cannot be submitted by accident.

14.4 Principal review: approve, reject & publish

The Principal's Exam Subjects panel showing English awaiting approval
Figure 14.185. The Principal's Exam Subjects panel — English awaiting review.
English approved
Figure 14.186. Approved. Several submitted subjects on the same exam can be mass-approved together.
Approve, or reject back to the teacher?

A Principal reviewing a submitted subject makes one of two calls:

Approve
Marks look correct

Status becomes approved and the subject now counts toward the exam's publish-readiness.

Reject
Something needs fixing

A reason is required. Status returns to pending, the teacher's grid re-opens, and the subject must be corrected and resubmitted.

The exam published and locked once every subject is approved
Figure 14.187. Publish — enabled only because every subject on this exam is now approved. Publishing also locks marks against further edits.
Publish is exam-wide, not per-subject

An exam with several subjects cannot publish while even one is still short of approved — the Publish action reports exactly which subjects are still pending.

14.5 Results & report cards

The Results View screen for Unit Test 1, Class 6
Figure 14.188. Results View — the published class list.
An individual student's report card, with a Marks Breakdown column listing each component
Figure 14.189. A student's own report card — each subject's Marks Breakdown lists exactly the components that subject was configured with.

14.6 Exam seating arrangement

Seating is a separate, standalone screen: configure exam rooms once, then generate a seat-by-seat plan for any exam using whichever ordering strategy fits (roll number, alphabetical, interleaved-by-class, or random), and finalise it once it's confirmed.

A room, Main Hall, added with 40 seats
Figure 14.190. A room added — Main Hall, 40 seats.
A generated seating plan for Unit Test 1 in Main Hall, roll-number order
Figure 14.191. A seating plan generated for Unit Test 1 in Main Hall, roll-number order.
The seating plan finalised, with per-room plan and attendance-sheet PDF downloads available
Figure 14.192. Finalised — the plan and attendance sheet are now downloadable as PDFs, and invigilators can be assigned per room below.
Seating is independent of the approval workflow

A seating plan can be generated and finalised at any point once the exam exists — it does not wait on mark entry, submission, approval, or publish.